![]() |
![]() |
![]() |
Used to set and query effects, and to choose techniques. An effect object can contain multiple techniques to render the same effect.
ID3DXEffect Members
ApplyParameterBlock Assign a state value to each effect parameter in a parameter block. Begin Starts an active technique. BeginParameterBlock Capture parameter effect state changes. BeginPass Begins a pass, within the active technique. CloneEffect Creates a clone of an effect. CommitChanges Propagate state changes that occur inside of an active pass to the device before rendering. End Ends an active technique. EndParameterBlock Stop capturing effect parameter state changes. EndPass End an active pass. FindNextValidTechnique Searches for the next valid technique, starting at the technique after the specified technique. GetAnnotation Gets the handle of an annotation. GetAnnotationByName Gets the handle of an annotation by looking up its name. GetBool Gets a BOOL value. GetBoolArray Gets an array of BOOL values. GetCurrentTechnique Gets the current technique. GetDesc Gets the effect description. GetDevice Retrieves the device associated with the effect. GetFloat Gets a floating point value. GetFloatArray Gets an array of floating point values. GetFunction Gets the handle of a function. GetFunctionByName Gets the handle of a function by looking up its name. GetFunctionDesc Gets a function description. GetInt Gets an integer. GetIntArray Gets an array of integers. GetMatrix Gets a nontransposed matrix. GetMatrixArray Gets an array of nontransposed matrices. GetMatrixPointerArray Gets an array of pointers to nontransposed matrices. GetMatrixTranspose Gets a transposed matrix. GetMatrixTransposeArray Gets an array of transposed matrices. GetMatrixTransposePointerArray Sets an array of pointers to transposed matrices. GetParameter Gets the handle of a top-level parameter or a structure member parameter. GetParameterByName Gets the handle of a top-level parameter or a structure member parameter by looking up its name. GetParameterBySemantic Gets the handle of a top-level parameter or a structure member parameter by looking up its semantic with a case-insensitive search. GetParameterDesc Gets a parameter or annotation description. GetParameterElement Get the handle of an array element parameter. GetPass Gets the handle of a pass. GetPassByName Gets the handle of a pass by looking up its name. GetPassDesc Gets a pass description. GetPixelShader Gets a pixel shader. GetPool Gets a pointer to the pool of shared parameters. GetStateManager Get the effect state manager. GetString Gets a string. GetTechnique Gets the handle of a technique. GetTechniqueByName Gets the handle of a technique by looking up its name. GetTechniqueDesc Gets a technique description. GetTexture Gets a texture. GetValue Get the value of an arbitrary parameter or annotation, including simple types, structs, arrays, strings, shaders and textures. This method can be used in place of nearly all the Getxxx calls in ID3DXBaseEffect. GetVector Gets a vector. GetVectorArray Gets an array of vectors. GetVertexShader Gets a vertex shader. IsParameterUsed Determines if a parameter is used by the technique. OnLostDevice Releases all references to video memory resources and deletes all state blocks. OnResetDevice Should be called after the device has been reset. SetArrayRange Set the range of an array to pass to the device. SetBool Sets a BOOL value. SetBoolArray Sets an array of Boolean values. SetFloat Sets a floating point value. SetFloatArray Sets an array of floating point values. SetInt Sets an integer. SetIntArray Sets an array of integers. SetMatrix Sets a non-transposed matrix. SetMatrixArray Sets an array of nontransposed matrices. SetMatrixPointerArray Sets an array of pointers to nontransposed matrices. SetMatrixTranspose Sets a transposed matrix. SetMatrixTransposeArray Sets an array of transposed matrices. SetMatrixTransposePointerArray Sets an array of pointers to transposed matrices. SetPixelShader Sets a pixel shader. SetStateManager Set the effect state manager. SetString Sets a string. SetTechnique Sets the active technique. SetTexture Sets a texture. SetValue Get the value of an arbitrary parameter or annotation, including simple types, structs, arrays, strings, shaders and textures. This method can be used in place of nearly all the Setxxx calls in ID3DXBaseEffect. SetVector Sets a vector. SetVectorArray Sets an array of vectors. SetVertexShader Sets a vertex shader. ValidateTechnique Validate a technique.
Remarks
The ID3DXEffect interface is obtained by calling D3DXCreateEffect, D3DXCreateEffectFromFile, or D3DXCreateEffectFromResource.
The LPD3DXEFFECT type is defined as a pointer to this interface.
typedef interface ID3DXEffect ID3DXEffect; typedef interface ID3DXEffect *LPD3DXEFFECT;
Interface Information
Stock Implementation d3d9.dll Custom Implementation No Inherits from ID3DXBaseEffect Header d3dx9effect.h Import library d3dx9.lib Minimum operating systems Windows 98
See Also
D3DXCreateEffect, D3DXCreateEffectFromFile, D3DXCreateEffectFromResource