Name

cgD3D10SetManageTextureParameters - set the manage texture parameters flag for a context

Synopsis

#include <Cg/cgD3D10.h>

void cgD3D10SetManageTextureParameters( CGcontext context,
                                        CGbool flag );

Parameters

context

The context in which the automatic texture management behavior will be changed.

flag

A boolean switch which controls automatic texture management by the runtime.

Return Values

None.

Description

By default, cgD3D10 does not manage any texture state in D3D. It is up to the user to enable and disable textures using D3D. This behavior is the default to avoid conflicts with texture state on geometry that's rendered with the fixed function pipeline or without cgD3D10.

If automatic texture management is desired, cgD3D10SetManageTextureParameters may be called with flag set to CG_TRUE before cgD3D10BindProgram is called. Whenever cgD3D10BindProgram is called, the cgD3D10 runtime will make all the appropriate texture parameter calls on the application's behalf.

Calling cgD3D10SetManageTextureParameters with flag set to CG_FALSE will disable automatic texture management.

NOTE: When cgD3D10SetManageTextureParameters is set to CG_TRUE, applications should not make texture state change calls to D3D after calling cgD3D10BindProgram, unless the application is trying to override some parts of cgD3D10's texture management.

Examples

// Enable automatic texture management
cgD3D10SetManageTextureParmeters( pCtx, CG_TRUE );

Errors

None.

History

cgD3D10SetManageTextureParameters was introduced in Cg 2.1.

See Also

cgD3D10GetManageTextureParameters, cgD3D10BindProgram