C# Class Axiom.Graphics.GpuProgramParameters

Collects together the program parameters used for a GpuProgram.

Gpu program state includes constant parameters used by the program, and bindings to render system state which is propagated into the constants by the engine automatically if requested.

GpuProgramParameters objects should be created through the GpuProgramManager and may be shared between multiple GpuProgram instances. For this reason they are managed using a shared pointer, which will ensure they are automatically deleted when no program is using them anymore.

Different types of GPU programs support different types of constant parameters. For example, it's relatively common to find that vertex programs only support floating point constants, and that fragment programs only support integer (fixed point) parameters. This can vary depending on the program version supported by the graphics card being used. You should consult the documentation for the type of low level program you are using, or alternatively use the methods provided on Capabilities to determine the options.

Another possible limitation is that some systems only allow constants to be set on certain boundaries, e.g. in sets of 4 values for example. Again, see Capabilities for full details.

Inheritance: DisposableObject

Afficher le fichier Open project: mono-soc-2011/axiom Class Usage Examples

Protected Properties

Свойство	Type	Description
AutoConstantDictionary	AutoConstantDefinition[]
autoAddParamName	bool
autoConstantList	AutoConstantEntryList
floatConstants	FloatConstantEntryList
ignoreMissingParameters	bool
intConstants	IntConstantEntryList
namedParams	AxiomCollection
paramTypeList	List
tmpVals	float[]
transposeMatrices	bool

Private Properties

Свойство	Type	Description
SetLogicalIndexes	void

Méthodes publiques

Méthode	Description
AddParameterToDefaultsList ( GpuProgramParameterType type, string name ) : void
ClearAutoConstantType ( ) : void	Clears all the existing automatic constants.
Clone ( ) : GpuProgramParameters
CopyConstantsFrom ( GpuProgramParameters source ) : void	Copies the values of all constants (including auto constants) from another GpuProgramParameters object.
CopyMatchingNamedConstantsFrom ( GpuProgramParameters source ) : void
FindNamedConstantDefinition ( string name, bool throwExceptionIfNotFound ) : GpuConstantDefinition	Find a constant definition for a named parameter. This method returns null if the named parameter did not exist, unlike GetConstantDefinition which is more strict; unless you set the last parameter to true.
GetAutoConstantDefinition ( int idx, AutoConstantDefinition &def ) : bool	gets the auto constant definition using an index into the auto constant definition array. If the index is out of bounds then false is returned;
GetAutoConstantDefinition ( string name, AutoConstantDefinition &def ) : bool	Gets the auto constant definition associated with name if found else returns false
GetFloatConstant ( int i ) : FloatConstantEntry
GetFloatPointer ( int physicalIndex ) : float[]
GetIntConstant ( int i ) : IntConstantEntry
GetIntPointer ( int physicalIndex ) : int[]
GetNameByIndex ( int index ) : string	Given an index, this function will return the name of the parameter at that index.
GetNamedFloatConstant ( string name ) : FloatConstantEntry	Gets a Named Float Constant entry if the name is found otherwise returns a null.
GetNamedIntConstant ( string name ) : IntConstantEntry	Gets a Named Int Constant entry if the name is found otherwise returns a null.
GetParamIndex ( string name ) : int	Gets the constant index of the specified named param.
GpuProgramParameters ( ) : System	Default constructor.
IncPassIterationNumber ( ) : void
MapParamNameToIndex ( string name, int index ) : void	Maps a parameter name to the specified constant index.
SetAutoConstant ( AutoConstantEntry entry ) : void	Overloaded method.
SetAutoConstant ( int index, AutoConstantType type ) : void	Sets up a constant which will automatically be updated by the engine. Vertex and fragment programs often need parameters which are to do with the current render state, or particular values which may very well change over time, and often between objects which are being rendered. This feature allows you to set up a certain number of predefined parameter mappings that are kept up to date for you.
SetAutoConstant ( int index, AutoConstantType type, float extraInfo ) : void	Overloaded method.
SetAutoConstant ( int index, AutoConstantType type, int extraInfo ) : void	Overloaded method.
SetConstant ( int index, ColorEx color ) : void	Sends 4 packed floating-point RGBA color values to the program.
SetConstant ( int index, Matrix4 val ) : void	Sends a multiple value constant floating-point parameter to the program. This method is made virtual to allow GpuProgramManagers, or even individual GpuProgram implementations to supply their own implementation if need be. An example would be where a Matrix needs to be transposed to row-major format before passing to the hardware.
SetConstant ( int index, Matrix4 matrices, int count ) : void	Sends a multiple matrix values to the program.
SetConstant ( int index, Vector3 val ) : void	Sends 3 packed floating-point values to the program.
SetConstant ( int index, Vector4 val ) : void	Sends 4 packed floating-point values to the program.
SetConstant ( int index, float value ) : void	Provides a way to pass in a single float
SetConstant ( int index, float f0, float f1, float f2, float f3 ) : void	Optimize the most common case of setting constant consisting of four floats
SetConstant ( int index, int ints ) : void	Sets an array of int values starting at the specified index.
SetConstantFromTime ( int index, float factor ) : void
SetIntConstant ( int index, int value ) : void	Provides a way to pass in the technique pass number
SetNamedAutoConstant ( string name, AutoConstantType type ) : void
SetNamedAutoConstant ( string name, AutoConstantType type, int extraInfo ) : void	Sets up a constant which will automatically be updated by the engine. Vertex and fragment programs often need parameters which are to do with the current render state, or particular values which may very well change over time, and often between objects which are being rendered. This feature allows you to set up a certain number of predefined parameter mappings that are kept up to date for you.
SetNamedConstant ( string name, ColorEx color ) : void	Sends 4 packed floating-point RGBA color values to the program.
SetNamedConstant ( string name, Matrix4 val ) : void	Sends a multiple value constant floating-point parameter to the program.
SetNamedConstant ( string name, Matrix4 matrices, int count ) : void	Sends multiple matrices into a program.
SetNamedConstant ( string name, Vector3 val ) : void	Sends 3 packed floating-point values to the program.
SetNamedConstant ( string name, Vector4 val ) : void	Sends 4 packed floating-point values to the program.
SetNamedConstant ( string name, float val ) : void
SetNamedConstant ( string name, int val ) : void
SetNamedConstantFromTime ( string name, float factor ) : void
SetNamedConstants ( GpuNamedConstants constantDefs ) : void
UpdateAutoParams ( AutoParamDataSource source, GpuParamVariability mask ) : void	Update automatic parameters.
UpdateAutoParamsLightsOnly ( AutoParamDataSource source ) : void	Updates the automatic light parameters based on the details provided.
UpdateAutoParamsNoLights ( AutoParamDataSource source ) : void	Updates the automatic parameters (except lights) based on the details provided.

Private Methods

Méthode	Description
SetLogicalIndexes ( GpuLogicalBufferStruct floatIndexMap, GpuLogicalBufferStruct intIndexMap ) : void

Method Details

AddParameterToDefaultsList() public méthode

public AddParameterToDefaultsList ( GpuProgramParameterType type, string name ) : void
type	GpuProgramParameterType
name	string
Résultat	void

ClearAutoConstantType() public méthode

Clears all the existing automatic constants.

public ClearAutoConstantType ( ) : void
Résultat	void

Clone() public méthode

public Clone ( ) : GpuProgramParameters
Résultat	GpuProgramParameters

CopyConstantsFrom() public méthode

Copies the values of all constants (including auto constants) from another GpuProgramParameters object.

public CopyConstantsFrom ( GpuProgramParameters source ) : void
source	GpuProgramParameters	Set of params to use as the source.
Résultat	void

CopyMatchingNamedConstantsFrom() public méthode

public CopyMatchingNamedConstantsFrom ( GpuProgramParameters source ) : void
source	GpuProgramParameters
Résultat	void

FindNamedConstantDefinition() public méthode

Find a constant definition for a named parameter. This method returns null if the named parameter did not exist, unlike GetConstantDefinition which is more strict; unless you set the last parameter to true.

public FindNamedConstantDefinition ( string name, bool throwExceptionIfNotFound ) : GpuConstantDefinition
name	string	The name to look up
throwExceptionIfNotFound	bool
Résultat	GpuConstantDefinition

GetAutoConstantDefinition() public static méthode

gets the auto constant definition using an index into the auto constant definition array. If the index is out of bounds then false is returned;

public static GetAutoConstantDefinition ( int idx, AutoConstantDefinition &def ) : bool
idx	int	The auto constant index
def	AutoConstantDefinition
Résultat	bool

GetAutoConstantDefinition() public static méthode

Gets the auto constant definition associated with name if found else returns false

public static GetAutoConstantDefinition ( string name, AutoConstantDefinition &def ) : bool
name	string	The name of the auto constant
def	AutoConstantDefinition
Résultat	bool

GetFloatConstant() public méthode

public GetFloatConstant ( int i ) : FloatConstantEntry
i	int
Résultat	FloatConstantEntry

GetFloatPointer() public méthode

public GetFloatPointer ( int physicalIndex ) : float[]
physicalIndex	int
Résultat	float[]

GetIntConstant() public méthode

public GetIntConstant ( int i ) : IntConstantEntry
i	int
Résultat	IntConstantEntry

GetIntPointer() public méthode

public GetIntPointer ( int physicalIndex ) : int[]
physicalIndex	int
Résultat	int[]

GetNameByIndex() public méthode

Given an index, this function will return the name of the parameter at that index.

public GetNameByIndex ( int index ) : string
index	int	Index of the parameter to look up.
Résultat	string

GetNamedFloatConstant() public méthode

Gets a Named Float Constant entry if the name is found otherwise returns a null.

public GetNamedFloatConstant ( string name ) : FloatConstantEntry
name	string	Name of the constant to retreive.
Résultat	FloatConstantEntry

GetNamedIntConstant() public méthode

Gets a Named Int Constant entry if the name is found otherwise returns a null.

public GetNamedIntConstant ( string name ) : IntConstantEntry
name	string	Name of the constant to retreive.
Résultat	IntConstantEntry

GetParamIndex() public méthode

Gets the constant index of the specified named param.

public GetParamIndex ( string name ) : int
name	string	/// Name of the param. ///
Résultat	int

GpuProgramParameters() public méthode

Default constructor.

public GpuProgramParameters ( ) : System
Résultat	System

IncPassIterationNumber() public méthode

public IncPassIterationNumber ( ) : void
Résultat	void

MapParamNameToIndex() public méthode

Maps a parameter name to the specified constant index.

public MapParamNameToIndex ( string name, int index ) : void
name	string	Name of the param.
index	int	Constant index of the param.
Résultat	void

SetAutoConstant() public méthode

Overloaded method.

public SetAutoConstant ( AutoConstantEntry entry ) : void
entry	AutoConstantEntry
Résultat	void

SetAutoConstant() public méthode

Sets up a constant which will automatically be updated by the engine.

Vertex and fragment programs often need parameters which are to do with the current render state, or particular values which may very well change over time, and often between objects which are being rendered. This feature allows you to set up a certain number of predefined parameter mappings that are kept up to date for you.

public SetAutoConstant ( int index, AutoConstantType type ) : void
index	int	/// The location in the constant list to place this updated constant every time /// it is changed. Note that because of the nature of the types, we know how big the /// parameter details will be so you don't need to set that like you do for manual constants. ///
type	AutoConstantType	The type of automatic constant to set.
Résultat	void

SetAutoConstant() public méthode

Overloaded method.

public SetAutoConstant ( int index, AutoConstantType type, float extraInfo ) : void
index	int	/// The location in the constant list to place this updated constant every time /// it is changed. Note that because of the nature of the types, we know how big the /// parameter details will be so you don't need to set that like you do for manual constants. ///
type	AutoConstantType	The type of automatic constant to set.
extraInfo	float	If the constant type needs more information (like a light index) put it here.
Résultat	void

SetAutoConstant() public méthode

Overloaded method.

public SetAutoConstant ( int index, AutoConstantType type, int extraInfo ) : void
index	int	/// The location in the constant list to place this updated constant every time /// it is changed. Note that because of the nature of the types, we know how big the /// parameter details will be so you don't need to set that like you do for manual constants. ///
type	AutoConstantType	The type of automatic constant to set.
extraInfo	int	If the constant type needs more information (like a light index) put it here.
Résultat	void

SetConstant() public méthode

Sends 4 packed floating-point RGBA color values to the program.

public SetConstant ( int index, ColorEx color ) : void
index	int	Index of the contant register.
color	Axiom.Core.ColorEx	Structure containing 4 packed RGBA color values.
Résultat	void

SetConstant() public méthode

Sends a multiple value constant floating-point parameter to the program.

This method is made virtual to allow GpuProgramManagers, or even individual GpuProgram implementations to supply their own implementation if need be. An example would be where a Matrix needs to be transposed to row-major format before passing to the hardware.

public SetConstant ( int index, Matrix4 val ) : void
index	int	Index of the contant register.
val	Axiom.Math.Matrix4	Structure containing 3 packed float values.
Résultat	void

SetConstant() public méthode

Sends a multiple matrix values to the program.

public SetConstant ( int index, Matrix4 matrices, int count ) : void
index	int	Index of the contant register.
matrices	Axiom.Math.Matrix4	Values to set.
count	int	Number of matrices to set
Résultat	void

SetConstant() public méthode

Sends 3 packed floating-point values to the program.

public SetConstant ( int index, Vector3 val ) : void
index	int	Index of the contant register.
val	Vector3	Structure containing 3 packed float values.
Résultat	void

SetConstant() public méthode

Sends 4 packed floating-point values to the program.

public SetConstant ( int index, Vector4 val ) : void
index	int	Index of the contant register.
val	Vector4	Structure containing 4 packed float values.
Résultat	void

SetConstant() public méthode

Provides a way to pass in a single float

public SetConstant ( int index, float value ) : void
index	int	Index of the contant register to start at.
value	float
Résultat	void

SetConstant() public méthode

Optimize the most common case of setting constant consisting of four floats

public SetConstant ( int index, float f0, float f1, float f2, float f3 ) : void
index	int	Index of the contant register to start at.
f0	float	The floats.
f1	float	The floats.
f2	float	The floats.
f3	float	The floats.
Résultat	void

SetConstant() public méthode

Sets an array of int values starting at the specified index.

public SetConstant ( int index, int ints ) : void
index	int	Index of the contant register to start at.
ints	int	Array of ints.
Résultat	void

SetConstantFromTime() public méthode

public SetConstantFromTime ( int index, float factor ) : void
index	int
factor	float
Résultat	void

SetIntConstant() public méthode

Provides a way to pass in the technique pass number

public SetIntConstant ( int index, int value ) : void
index	int	Index of the contant register to start at.
value	int	Value of the constant.
Résultat	void

SetNamedAutoConstant() public méthode

public SetNamedAutoConstant ( string name, AutoConstantType type ) : void
name	string
type	AutoConstantType
Résultat	void

SetNamedAutoConstant() public méthode

Sets up a constant which will automatically be updated by the engine.

public SetNamedAutoConstant ( string name, AutoConstantType type, int extraInfo ) : void
name	string	/// Name of the param. ///
type	AutoConstantType	/// The type of automatic constant to set. ///
extraInfo	int	/// Any extra information needed by the auto constant (i.e. light index, etc). ///
Résultat	void

SetNamedConstant() public méthode

Sends 4 packed floating-point RGBA color values to the program.

public SetNamedConstant ( string name, ColorEx color ) : void
name	string	Name of the param.
color	Axiom.Core.ColorEx	Structure containing 4 packed RGBA color values.
Résultat	void

SetNamedConstant() public méthode

Sends a multiple value constant floating-point parameter to the program.

public SetNamedConstant ( string name, Matrix4 val ) : void
name	string	Name of the param.
val	Axiom.Math.Matrix4	Structure containing 3 packed float values.
Résultat	void

SetNamedConstant() public méthode

Sends multiple matrices into a program.

public SetNamedConstant ( string name, Matrix4 matrices, int count ) : void
name	string	Name of the param.
matrices	Axiom.Math.Matrix4	Array of matrices.
count	int
Résultat	void

SetNamedConstant() public méthode

Sends 3 packed floating-point values to the program.

public SetNamedConstant ( string name, Vector3 val ) : void
name	string	Name of the param.
val	Vector3	Structure containing 3 packed float values.
Résultat	void

SetNamedConstant() public méthode

Sends 4 packed floating-point values to the program.

public SetNamedConstant ( string name, Vector4 val ) : void
name	string	Name of the contant register.
val	Vector4	Structure containing 4 packed float values.
Résultat	void

SetNamedConstant() public méthode

public SetNamedConstant ( string name, float val ) : void
name	string
val	float
Résultat	void

SetNamedConstant() public méthode

public SetNamedConstant ( string name, int val ) : void
name	string
val	int
Résultat	void

SetNamedConstantFromTime() public méthode

public SetNamedConstantFromTime ( string name, float factor ) : void
name	string
factor	float
Résultat	void

SetNamedConstants() public méthode

public SetNamedConstants ( GpuNamedConstants constantDefs ) : void
constantDefs	GpuNamedConstants
Résultat	void

UpdateAutoParams() public méthode

Update automatic parameters.

public UpdateAutoParams ( AutoParamDataSource source, GpuParamVariability mask ) : void
source	AutoParamDataSource	The source of the parameters
mask	GpuParamVariability	A mask of GpuParamVariability which identifies which autos will need updating
Résultat	void

UpdateAutoParamsLightsOnly() public méthode

Updates the automatic light parameters based on the details provided.

public UpdateAutoParamsLightsOnly ( AutoParamDataSource source ) : void
source	AutoParamDataSource	/// A source containing all the updated data to be made available for auto updating /// the GPU program constants. ///
Résultat	void

UpdateAutoParamsNoLights() public méthode

Updates the automatic parameters (except lights) based on the details provided.

public UpdateAutoParamsNoLights ( AutoParamDataSource source ) : void
source	AutoParamDataSource	/// A source containing all the updated data to be made available for auto updating /// the GPU program constants. ///
Résultat	void

Property Details

AutoConstantDictionary protected_oe static_oe property

protected static AutoConstantDefinition[] AutoConstantDictionary
Résultat	AutoConstantDefinition[]

autoAddParamName protected_oe property

Flag to indicate if names not found will be automatically added.

protected bool autoAddParamName
Résultat	bool

autoConstantList protected_oe property

List of automatically updated parameters.

protected AutoConstantEntryList autoConstantList
Résultat	AutoConstantEntryList

floatConstants protected_oe property

Table of Vector4 constants by index.

protected FloatConstantEntryList floatConstants
Résultat	FloatConstantEntryList

ignoreMissingParameters protected_oe property

protected bool ignoreMissingParameters
Résultat	bool

intConstants protected_oe property

Packed list of integer constants

protected IntConstantEntryList intConstants
Résultat	IntConstantEntryList

namedParams protected_oe property

Lookup of constant indicies for named parameters.

protected AxiomCollection namedParams
Résultat	AxiomCollection

paramTypeList protected_oe property

protected List paramTypeList
Résultat	List

tmpVals protected_oe property

Temp array for use when passing constants around.

protected float[] tmpVals
Résultat	float[]

transposeMatrices protected_oe property

Specifies whether matrices need to be transposed prior to being sent to the hardware.

protected bool transposeMatrices
Résultat	bool