Ogre::GpuProgramParameters Class Reference
[Materials]

Collects together the program parameters used for a GpuProgram. More...

#include <OgreGpuProgramParams.h>

Inheritance diagram for Ogre::GpuProgramParameters:

Classes
struct	AutoConstantDefinition
	Structure defining an auto constant that's available for use in a parameters object. More...
class	AutoConstantEntry
	Structure recording the use of an automatic parameter. More...
Public Types
enum	AutoConstantType { ACT_WORLD_MATRIX, ACT_INVERSE_WORLD_MATRIX, ACT_TRANSPOSE_WORLD_MATRIX, ACT_INVERSE_TRANSPOSE_WORLD_MATRIX, ACT_WORLD_MATRIX_ARRAY_3x4, ACT_WORLD_MATRIX_ARRAY, ACT_WORLD_DUALQUATERNION_ARRAY_2x4, ACT_WORLD_SCALE_SHEAR_MATRIX_ARRAY_3x4, ACT_VIEW_MATRIX, ACT_INVERSE_VIEW_MATRIX, ACT_TRANSPOSE_VIEW_MATRIX, ACT_INVERSE_TRANSPOSE_VIEW_MATRIX, ACT_PROJECTION_MATRIX, ACT_INVERSE_PROJECTION_MATRIX, ACT_TRANSPOSE_PROJECTION_MATRIX, ACT_INVERSE_TRANSPOSE_PROJECTION_MATRIX, ACT_VIEWPROJ_MATRIX, ACT_INVERSE_VIEWPROJ_MATRIX, ACT_TRANSPOSE_VIEWPROJ_MATRIX, ACT_INVERSE_TRANSPOSE_VIEWPROJ_MATRIX, ACT_WORLDVIEW_MATRIX, ACT_INVERSE_WORLDVIEW_MATRIX, ACT_TRANSPOSE_WORLDVIEW_MATRIX, ACT_INVERSE_TRANSPOSE_WORLDVIEW_MATRIX, ACT_WORLDVIEWPROJ_MATRIX, ACT_INVERSE_WORLDVIEWPROJ_MATRIX, ACT_TRANSPOSE_WORLDVIEWPROJ_MATRIX, ACT_INVERSE_TRANSPOSE_WORLDVIEWPROJ_MATRIX, ACT_RENDER_TARGET_FLIPPING, ACT_VERTEX_WINDING, ACT_FOG_COLOUR, ACT_FOG_PARAMS, ACT_SURFACE_AMBIENT_COLOUR, ACT_SURFACE_DIFFUSE_COLOUR, ACT_SURFACE_SPECULAR_COLOUR, ACT_SURFACE_EMISSIVE_COLOUR, ACT_SURFACE_SHININESS, ACT_LIGHT_COUNT, ACT_AMBIENT_LIGHT_COLOUR, ACT_LIGHT_DIFFUSE_COLOUR, ACT_LIGHT_SPECULAR_COLOUR, ACT_LIGHT_ATTENUATION, ACT_SPOTLIGHT_PARAMS, ACT_LIGHT_POSITION, ACT_LIGHT_POSITION_OBJECT_SPACE, ACT_LIGHT_POSITION_VIEW_SPACE, ACT_LIGHT_DIRECTION, ACT_LIGHT_DIRECTION_OBJECT_SPACE, ACT_LIGHT_DIRECTION_VIEW_SPACE, ACT_LIGHT_DISTANCE_OBJECT_SPACE, ACT_LIGHT_POWER_SCALE, ACT_LIGHT_DIFFUSE_COLOUR_POWER_SCALED, ACT_LIGHT_SPECULAR_COLOUR_POWER_SCALED, ACT_LIGHT_DIFFUSE_COLOUR_ARRAY, ACT_LIGHT_SPECULAR_COLOUR_ARRAY, ACT_LIGHT_DIFFUSE_COLOUR_POWER_SCALED_ARRAY, ACT_LIGHT_SPECULAR_COLOUR_POWER_SCALED_ARRAY, ACT_LIGHT_ATTENUATION_ARRAY, ACT_LIGHT_POSITION_ARRAY, ACT_LIGHT_POSITION_OBJECT_SPACE_ARRAY, ACT_LIGHT_POSITION_VIEW_SPACE_ARRAY, ACT_LIGHT_DIRECTION_ARRAY, ACT_LIGHT_DIRECTION_OBJECT_SPACE_ARRAY, ACT_LIGHT_DIRECTION_VIEW_SPACE_ARRAY, ACT_LIGHT_DISTANCE_OBJECT_SPACE_ARRAY, ACT_LIGHT_POWER_SCALE_ARRAY, ACT_SPOTLIGHT_PARAMS_ARRAY, ACT_DERIVED_AMBIENT_LIGHT_COLOUR, ACT_DERIVED_SCENE_COLOUR, ACT_DERIVED_LIGHT_DIFFUSE_COLOUR, ACT_DERIVED_LIGHT_SPECULAR_COLOUR, ACT_DERIVED_LIGHT_DIFFUSE_COLOUR_ARRAY, ACT_DERIVED_LIGHT_SPECULAR_COLOUR_ARRAY, ACT_LIGHT_NUMBER, ACT_LIGHT_CASTS_SHADOWS, ACT_SHADOW_EXTRUSION_DISTANCE, ACT_CAMERA_POSITION, ACT_CAMERA_POSITION_OBJECT_SPACE, ACT_TEXTURE_VIEWPROJ_MATRIX, ACT_TEXTURE_VIEWPROJ_MATRIX_ARRAY, ACT_TEXTURE_WORLDVIEWPROJ_MATRIX, ACT_TEXTURE_WORLDVIEWPROJ_MATRIX_ARRAY, ACT_SPOTLIGHT_VIEWPROJ_MATRIX, ACT_SPOTLIGHT_VIEWPROJ_MATRIX_ARRAY, ACT_SPOTLIGHT_WORLDVIEWPROJ_MATRIX, ACT_CUSTOM, ACT_TIME, ACT_TIME_0_X, ACT_COSTIME_0_X, ACT_SINTIME_0_X, ACT_TANTIME_0_X, ACT_TIME_0_X_PACKED, ACT_TIME_0_1, ACT_COSTIME_0_1, ACT_SINTIME_0_1, ACT_TANTIME_0_1, ACT_TIME_0_1_PACKED, ACT_TIME_0_2PI, ACT_COSTIME_0_2PI, ACT_SINTIME_0_2PI, ACT_TANTIME_0_2PI, ACT_TIME_0_2PI_PACKED, ACT_FRAME_TIME, ACT_FPS, ACT_VIEWPORT_WIDTH, ACT_VIEWPORT_HEIGHT, ACT_INVERSE_VIEWPORT_WIDTH, ACT_INVERSE_VIEWPORT_HEIGHT, ACT_VIEWPORT_SIZE, ACT_VIEW_DIRECTION, ACT_VIEW_SIDE_VECTOR, ACT_VIEW_UP_VECTOR, ACT_FOV, ACT_NEAR_CLIP_DISTANCE, ACT_FAR_CLIP_DISTANCE, ACT_PASS_NUMBER, ACT_PASS_ITERATION_NUMBER, ACT_ANIMATION_PARAMETRIC, ACT_TEXEL_OFFSETS, ACT_SCENE_DEPTH_RANGE, ACT_SHADOW_SCENE_DEPTH_RANGE, ACT_SHADOW_COLOUR, ACT_TEXTURE_SIZE, ACT_INVERSE_TEXTURE_SIZE, ACT_PACKED_TEXTURE_SIZE, ACT_TEXTURE_MATRIX, ACT_LOD_CAMERA_POSITION, ACT_LOD_CAMERA_POSITION_OBJECT_SPACE, ACT_LIGHT_CUSTOM }
	Defines the types of automatically updated values that may be bound to GpuProgram parameters, or used to modify parameters on a per-object basis. More...
enum	ACDataType { ACDT_NONE, ACDT_INT, ACDT_REAL }
	Defines the type of the extra data item used by the auto constant. More...
enum	ElementType { ET_INT, ET_REAL }
	Defines the base element type of the auto constant. More...
typedef vector < AutoConstantEntry >::type	AutoConstantList
typedef vector < GpuSharedParametersUsage > ::type	GpuSharedParamUsageList
typedef ConstVectorIterator < AutoConstantList >	AutoConstantIterator
Public Member Functions
	GpuProgramParameters ()
	~GpuProgramParameters ()
	GpuProgramParameters (const GpuProgramParameters &oth)
	Copy constructor.
GpuProgramParameters &	operator= (const GpuProgramParameters &oth)
	Operator = overload.
void	_setNamedConstants (const GpuNamedConstantsPtr &constantmap)
	Internal method for providing a link to a name->definition map for parameters.
void	_setLogicalIndexes (const GpuLogicalBufferStructPtr &floatIndexMap, const GpuLogicalBufferStructPtr &intIndexMap)
	Internal method for providing a link to a logical index->physical index map for parameters.
bool	hasNamedParameters () const
	Does this parameter set include named parameters?
bool	hasLogicalIndexedParameters () const
	Does this parameter set include logically indexed parameters?
void	setConstant (size_t index, const Vector4 &vec)
	Sets a 4-element floating-point parameter to the program.
void	setConstant (size_t index, Real val)
	Sets a single floating-point parameter to the program.
void	setConstant (size_t index, const Vector3 &vec)
	Sets a 4-element floating-point parameter to the program via Vector3.
void	setConstant (size_t index, const Matrix4 &m)
	Sets a Matrix4 parameter to the program.
void	setConstant (size_t index, const Matrix4 *m, size_t numEntries)
	Sets a list of Matrix4 parameters to the program.
void	setConstant (size_t index, const float *val, size_t count)
	Sets a multiple value constant floating-point parameter to the program.
void	setConstant (size_t index, const double *val, size_t count)
	Sets a multiple value constant floating-point parameter to the program.
void	setConstant (size_t index, const ColourValue &colour)
	Sets a ColourValue parameter to the program.
void	setConstant (size_t index, const int *val, size_t count)
	Sets a multiple value constant integer parameter to the program.
void	_writeRawConstants (size_t physicalIndex, const float *val, size_t count)
	Write a series of floating point values into the underlying float constant buffer at the given physical index.
void	_writeRawConstants (size_t physicalIndex, const double *val, size_t count)
	Write a series of floating point values into the underlying float constant buffer at the given physical index.
void	_writeRawConstants (size_t physicalIndex, const int *val, size_t count)
	Write a series of integer values into the underlying integer constant buffer at the given physical index.
void	_readRawConstants (size_t physicalIndex, size_t count, float *dest)
	Read a series of floating point values from the underlying float constant buffer at the given physical index.
void	_readRawConstants (size_t physicalIndex, size_t count, int *dest)
	Read a series of integer values from the underlying integer constant buffer at the given physical index.
void	_writeRawConstant (size_t physicalIndex, const Vector4 &vec, size_t count=4)
	Write a 4-element floating-point parameter to the program directly to the underlying constants buffer.
void	_writeRawConstant (size_t physicalIndex, Real val)
	Write a single floating-point parameter to the program.
void	_writeRawConstant (size_t physicalIndex, int val)
	Write a single integer parameter to the program.
void	_writeRawConstant (size_t physicalIndex, const Vector3 &vec)
	Write a 3-element floating-point parameter to the program via Vector3.
void	_writeRawConstant (size_t physicalIndex, const Matrix4 &m, size_t elementCount)
	Write a Matrix4 parameter to the program.
void	_writeRawConstant (size_t physicalIndex, const Matrix4 *m, size_t numEntries)
	Write a list of Matrix4 parameters to the program.
void	_writeRawConstant (size_t physicalIndex, const ColourValue &colour, size_t count=4)
	Write a ColourValue parameter to the program.
GpuConstantDefinitionIterator	getConstantDefinitionIterator (void) const
	Gets an iterator over the named GpuConstantDefinition instances as defined by the program for which these parameters exist.
const GpuConstantDefinition &	getConstantDefinition (const String &name) const
	Get a specific GpuConstantDefinition for a named parameter.
const GpuNamedConstants &	getConstantDefinitions () const
	Get the full list of GpuConstantDefinition instances.
const GpuLogicalBufferStructPtr &	getFloatLogicalBufferStruct () const
	Get the current list of mappings from low-level logical param indexes to physical buffer locations in the float buffer.
size_t	getFloatLogicalIndexForPhysicalIndex (size_t physicalIndex)
	Retrieves the logical index relating to a physical index in the float buffer, for programs which support that (low-level programs and high-level programs which use logical parameter indexes).
size_t	getIntLogicalIndexForPhysicalIndex (size_t physicalIndex)
	Retrieves the logical index relating to a physical index in the int buffer, for programs which support that (low-level programs and high-level programs which use logical parameter indexes).
const GpuLogicalBufferStructPtr &	getIntLogicalBufferStruct () const
	Get the current list of mappings from low-level logical param indexes to physical buffer locations in the integer buffer.
const FloatConstantList &	getFloatConstantList () const
	Get a reference to the list of float constants.
float *	getFloatPointer (size_t pos)
	Get a pointer to the 'nth' item in the float buffer.
const float *	getFloatPointer (size_t pos) const
	Get a pointer to the 'nth' item in the float buffer.
const IntConstantList &	getIntConstantList () const
	Get a reference to the list of int constants.
int *	getIntPointer (size_t pos)
	Get a pointer to the 'nth' item in the int buffer.
const int *	getIntPointer (size_t pos) const
	Get a pointer to the 'nth' item in the int buffer.
const AutoConstantList &	getAutoConstantList () const
	Get a reference to the list of auto constant bindings.
void	setAutoConstant (size_t index, AutoConstantType acType, size_t extraInfo=0)
	Sets up a constant which will automatically be updated by the system.
void	setAutoConstantReal (size_t index, AutoConstantType acType, Real rData)
void	setAutoConstant (size_t index, AutoConstantType acType, uint16 extraInfo1, uint16 extraInfo2)
	Sets up a constant which will automatically be updated by the system.
void	_setRawAutoConstant (size_t physicalIndex, AutoConstantType acType, size_t extraInfo, uint16 variability, size_t elementSize=4)
	As setAutoConstant, but sets up the auto constant directly against a physical buffer index.
void	_setRawAutoConstantReal (size_t physicalIndex, AutoConstantType acType, Real rData, uint16 variability, size_t elementSize=4)
	As setAutoConstantReal, but sets up the auto constant directly against a physical buffer index.
void	clearAutoConstant (size_t index)
	Unbind an auto constant so that the constant is manually controlled again.
void	setConstantFromTime (size_t index, Real factor)
	Sets a named parameter up to track a derivation of the current time.
void	clearAutoConstants (void)
	Clears all the existing automatic constants.
AutoConstantIterator	getAutoConstantIterator (void) const
	Gets an iterator over the automatic constant bindings currently in place.
size_t	getAutoConstantCount (void) const
	Gets the number of int constants that have been set.
AutoConstantEntry *	getAutoConstantEntry (const size_t index)
	Gets a specific Auto Constant entry if index is in valid range otherwise returns a NULL.
bool	hasAutoConstants (void) const
	Returns true if this instance has any automatic constants.
const AutoConstantEntry *	findFloatAutoConstantEntry (size_t logicalIndex)
	Finds an auto constant that's affecting a given logical parameter index for floating-point values.
const AutoConstantEntry *	findIntAutoConstantEntry (size_t logicalIndex)
	Finds an auto constant that's affecting a given logical parameter index for integer values.
const AutoConstantEntry *	findAutoConstantEntry (const String &paramName)
	Finds an auto constant that's affecting a given named parameter index.
const AutoConstantEntry *	_findRawAutoConstantEntryFloat (size_t physicalIndex)
	Finds an auto constant that's affecting a given physical position in the floating-point buffer.
const AutoConstantEntry *	_findRawAutoConstantEntryInt (size_t physicalIndex)
	Finds an auto constant that's affecting a given physical position in the integer buffer.
void	_updateAutoParams (const AutoParamDataSource *source, uint16 variabilityMask)
	Update automatic parameters.
void	setIgnoreMissingParams (bool state)
	Tells the program whether to ignore missing parameters or not.
void	setNamedConstant (const String &name, Real val)
	Sets a single value constant floating-point parameter to the program.
void	setNamedConstant (const String &name, int val)
	Sets a single value constant integer parameter to the program.
void	setNamedConstant (const String &name, const Vector4 &vec)
	Sets a Vector4 parameter to the program.
void	setNamedConstant (const String &name, const Vector3 &vec)
	Sets a Vector3 parameter to the program.
void	setNamedConstant (const String &name, const Matrix4 &m)
	Sets a Matrix4 parameter to the program.
void	setNamedConstant (const String &name, const Matrix4 *m, size_t numEntries)
	Sets a list of Matrix4 parameters to the program.
void	setNamedConstant (const String &name, const float *val, size_t count, size_t multiple=4)
	Sets a multiple value constant floating-point parameter to the program.
void	setNamedConstant (const String &name, const double *val, size_t count, size_t multiple=4)
	Sets a multiple value constant floating-point parameter to the program.
void	setNamedConstant (const String &name, const ColourValue &colour)
	Sets a ColourValue parameter to the program.
void	setNamedConstant (const String &name, const int *val, size_t count, size_t multiple=4)
	Sets a multiple value constant floating-point parameter to the program.
void	setNamedAutoConstant (const String &name, AutoConstantType acType, size_t extraInfo=0)
	Sets up a constant which will automatically be updated by the system.
void	setNamedAutoConstantReal (const String &name, AutoConstantType acType, Real rData)
void	setNamedAutoConstant (const String &name, AutoConstantType acType, uint16 extraInfo1, uint16 extraInfo2)
	Sets up a constant which will automatically be updated by the system.
void	setNamedConstantFromTime (const String &name, Real factor)
	Sets a named parameter up to track a derivation of the current time.
void	clearNamedAutoConstant (const String &name)
	Unbind an auto constant so that the constant is manually controlled again.
const GpuConstantDefinition *	_findNamedConstantDefinition (const String &name, bool throwExceptionIfMissing=false) const
	Find a constant definition for a named parameter.
size_t	_getFloatConstantPhysicalIndex (size_t logicalIndex, size_t requestedSize, uint16 variability)
	Gets the physical buffer index associated with a logical float constant index.
size_t	_getIntConstantPhysicalIndex (size_t logicalIndex, size_t requestedSize, uint16 variability)
	Gets the physical buffer index associated with a logical int constant index.
void	setTransposeMatrices (bool val)
	Sets whether or not we need to transpose the matrices passed in from the rest of OGRE.
bool	getTransposeMatrices (void) const
	Gets whether or not matrices are to be transposed when set.
void	copyConstantsFrom (const GpuProgramParameters &source)
	Copies the values of all constants (including auto constants) from another GpuProgramParameters object.
void	copyMatchingNamedConstantsFrom (const GpuProgramParameters &source)
	Copies the values of all matching named constants (including auto constants) from another GpuProgramParameters object.
void	incPassIterationNumber (void)
	increments the multipass number entry by 1 if it exists
bool	hasPassIterationNumber () const
	Does this parameters object have a pass iteration number constant?
size_t	getPassIterationNumberIndex () const
	Get the physical buffer index of the pass iteration number constant.
void	addSharedParameters (GpuSharedParametersPtr sharedParams)
	Use a set of shared parameters in this parameters object.
void	addSharedParameters (const String &sharedParamsName)
	Use a set of shared parameters in this parameters object.
bool	isUsingSharedParameters (const String &sharedParamsName) const
	Returns whether this parameter set is using the named shared parameter set.
void	removeSharedParameters (const String &sharedParamsName)
	Stop using the named shared parameter set.
void	removeAllSharedParameters ()
	Stop using all shared parameter sets.
const GpuSharedParamUsageList &	getSharedParameters () const
	Get the list of shared parameter sets.
void	_setRenderSystemData (const Any &data) const
	Internal method that the RenderSystem might use to store optional data.
const Any &	_getRenderSystemData () const
	Internal method that the RenderSystem might use to store optional data.
void	_copySharedParams ()
	Update the parameters by copying the data from the shared parameters.
void *	operator new (size_t sz, const char file, int line, const char func)
	operator new, with debug line info
void *	operator new (size_t sz)
void *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz, const char file, int line, const char func)
	array operator new, with debug line info
void *	operator new[] (size_t sz)
void	operator delete (void *ptr)
void	operator delete (void ptr, void )
void	operator delete (void ptr, const char , int, const char *)
void	operator delete[] (void *ptr)
void	operator delete[] (void ptr, const char , int, const char *)
Static Public Member Functions
static const AutoConstantDefinition *	getAutoConstantDefinition (const String &name)
	gets the auto constant definition associated with name if found else returns NULL
static const AutoConstantDefinition *	getAutoConstantDefinition (const size_t idx)
	gets the auto constant definition using an index into the auto constant definition array.
static size_t	getNumAutoConstantDefinitions (void)
	Returns the number of auto constant definitions.
Protected Member Functions
GpuLogicalIndexUse *	_getFloatConstantLogicalIndexUse (size_t logicalIndex, size_t requestedSize, uint16 variability)
	Gets the low-level structure for a logical index.
GpuLogicalIndexUse *	_getIntConstantLogicalIndexUse (size_t logicalIndex, size_t requestedSize, uint16 variability)
	Gets the physical buffer index associated with a logical int constant index.
uint16	deriveVariability (AutoConstantType act)
	Return the variability for an auto constant.
void	copySharedParamSetUsage (const GpuSharedParamUsageList &srcList)
Protected Attributes
FloatConstantList	mFloatConstants
	Packed list of floating-point constants (physical indexing).
IntConstantList	mIntConstants
	Packed list of integer constants (physical indexing).
GpuLogicalBufferStructPtr	mFloatLogicalToPhysical
	Logical index to physical index map - for low-level programs or high-level programs which pass params this way.
GpuLogicalBufferStructPtr	mIntLogicalToPhysical
	Logical index to physical index map - for low-level programs or high-level programs which pass params this way.
GpuNamedConstantsPtr	mNamedConstants
	Mapping from parameter names to def - high-level programs are expected to populate this.
AutoConstantList	mAutoConstants
	List of automatically updated parameters.
uint16	mCombinedVariability
	The combined variability masks of all parameters.
bool	mTransposeMatrices
	Do we need to transpose matrices?
bool	mIgnoreMissingParams
	flag to indicate if names not found will be ignored
size_t	mActivePassIterationIndex
	physical index for active pass iteration parameter real constant entry;
GpuSharedParamUsageList	mSharedParamSets
Any	mRenderSystemData
Static Protected Attributes
static AutoConstantDefinition	AutoConstantDictionary []

Detailed Description

Collects together the program parameters used for a GpuProgram.

Remarks:: 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 GpuProgram and may be shared between multiple Pass instances. For this reason they are managed using a shared pointer, which will ensure they are automatically deleted when no Pass is using them anymore.

: High-level programs use named parameters (uniforms), low-level programs use indexed constants. This class supports both, but you can tell whether named constants are supported by calling hasNamedParameters(). There are references in the documentation below to 'logical' and 'physical' indexes; logical indexes are the indexes used by low-level programs and represent indexes into an array of float4's, some of which may be settable, some of which may be predefined constants in the program. We only store those constants which have actually been set, therefore our buffer could have gaps if we used the logical indexes in our own buffers. So instead we map these logical indexes to physical indexes in our buffer. When using high-level programs, logical indexes don't necessarily exist, although they might if the high-level program has a direct, exposed mapping from parameter names to logical indexes. In addition, high-level languages may or may not pack arrays of elements that are smaller than float4 (e.g. float2/vec2) contiguously. This kind of information is held in the ConstantDefinition structure which is only populated for high-level programs. You don't have to worry about any of this unless you intend to read parameters back from this structure rather than just setting them.

Definition at line 592 of file OgreGpuProgramParams.h.

Member Typedef Documentation

typedef ConstVectorIterator<AutoConstantList> Ogre::GpuProgramParameters::AutoConstantIterator

Definition at line 1484 of file OgreGpuProgramParams.h.

typedef vector<AutoConstantEntry>::type Ogre::GpuProgramParameters::AutoConstantList

Definition at line 1119 of file OgreGpuProgramParams.h.

typedef vector<GpuSharedParametersUsage>::type Ogre::GpuProgramParameters::GpuSharedParamUsageList

Definition at line 1121 of file OgreGpuProgramParams.h.

Member Enumeration Documentation

enum Ogre::GpuProgramParameters::ACDataType

Defines the type of the extra data item used by the auto constant.

Enumerator:

ACDT_NONE	no data is required
ACDT_INT	the auto constant requires data of type int
ACDT_REAL	the auto constant requires data of type real

Definition at line 1048 of file OgreGpuProgramParams.h.

enum Ogre::GpuProgramParameters::AutoConstantType

Defines the types of automatically updated values that may be bound to GpuProgram parameters, or used to modify parameters on a per-object basis.

Enumerator:

ACT_WORLD_MATRIX	The current world matrix.
ACT_INVERSE_WORLD_MATRIX	The current world matrix, inverted.
ACT_TRANSPOSE_WORLD_MATRIX	Provides transpose of world matrix. Equivalent to RenderMonkey's "WorldTranspose".
ACT_INVERSE_TRANSPOSE_WORLD_MATRIX	The current world matrix, inverted & transposed.
ACT_WORLD_MATRIX_ARRAY_3x4	The current array of world matrices, as a 3x4 matrix, used for blending.
ACT_WORLD_MATRIX_ARRAY	The current array of world matrices, used for blending.
ACT_WORLD_DUALQUATERNION_ARRAY_2x4	The current array of world matrices transformed to an array of dual quaternions, represented as a 2x4 matrix.
ACT_WORLD_SCALE_SHEAR_MATRIX_ARRAY_3x4	The scale and shear components of the current array of world matrices.
ACT_VIEW_MATRIX	The current view matrix.
ACT_INVERSE_VIEW_MATRIX	The current view matrix, inverted.
ACT_TRANSPOSE_VIEW_MATRIX	Provides transpose of view matrix. Equivalent to RenderMonkey's "ViewTranspose".
ACT_INVERSE_TRANSPOSE_VIEW_MATRIX	Provides inverse transpose of view matrix. Equivalent to RenderMonkey's "ViewInverseTranspose".
ACT_PROJECTION_MATRIX	The current projection matrix.
ACT_INVERSE_PROJECTION_MATRIX	Provides inverse of projection matrix. Equivalent to RenderMonkey's "ProjectionInverse".
ACT_TRANSPOSE_PROJECTION_MATRIX	Provides transpose of projection matrix. Equivalent to RenderMonkey's "ProjectionTranspose".
ACT_INVERSE_TRANSPOSE_PROJECTION_MATRIX	Provides inverse transpose of projection matrix. Equivalent to RenderMonkey's "ProjectionInverseTranspose".
ACT_VIEWPROJ_MATRIX	The current view & projection matrices concatenated.
ACT_INVERSE_VIEWPROJ_MATRIX	Provides inverse of concatenated view and projection matrices. Equivalent to RenderMonkey's "ViewProjectionInverse".
ACT_TRANSPOSE_VIEWPROJ_MATRIX	Provides transpose of concatenated view and projection matrices. Equivalent to RenderMonkey's "ViewProjectionTranspose".
ACT_INVERSE_TRANSPOSE_VIEWPROJ_MATRIX	Provides inverse transpose of concatenated view and projection matrices. Equivalent to RenderMonkey's "ViewProjectionInverseTranspose".
ACT_WORLDVIEW_MATRIX	The current world & view matrices concatenated.
ACT_INVERSE_WORLDVIEW_MATRIX	The current world & view matrices concatenated, then inverted.
ACT_TRANSPOSE_WORLDVIEW_MATRIX	Provides transpose of concatenated world and view matrices. Equivalent to RenderMonkey's "WorldViewTranspose".
ACT_INVERSE_TRANSPOSE_WORLDVIEW_MATRIX	The current world & view matrices concatenated, then inverted & transposed.
ACT_WORLDVIEWPROJ_MATRIX	view matrices. The current world, view & projection matrices concatenated
ACT_INVERSE_WORLDVIEWPROJ_MATRIX	Provides inverse of concatenated world, view and projection matrices. Equivalent to RenderMonkey's "WorldViewProjectionInverse".
ACT_TRANSPOSE_WORLDVIEWPROJ_MATRIX	Provides transpose of concatenated world, view and projection matrices. Equivalent to RenderMonkey's "WorldViewProjectionTranspose".
ACT_INVERSE_TRANSPOSE_WORLDVIEWPROJ_MATRIX	Provides inverse transpose of concatenated world, view and projection matrices. Equivalent to RenderMonkey's "WorldViewProjectionInverseTranspose".
ACT_RENDER_TARGET_FLIPPING	render target related values -1 if requires texture flipping, +1 otherwise. It's useful when you bypassed projection matrix transform, still able use this value to adjust transformed y position.
ACT_VERTEX_WINDING	-1 if the winding has been inverted (e.g. for reflections), +1 otherwise.
ACT_FOG_COLOUR	Fog colour.
ACT_FOG_PARAMS	Fog params: density, linear start, linear end, 1/(end-start).
ACT_SURFACE_AMBIENT_COLOUR	Surface ambient colour, as set in Pass::setAmbient.
ACT_SURFACE_DIFFUSE_COLOUR	Surface diffuse colour, as set in Pass::setDiffuse.
ACT_SURFACE_SPECULAR_COLOUR	Surface specular colour, as set in Pass::setSpecular.
ACT_SURFACE_EMISSIVE_COLOUR	Surface emissive colour, as set in Pass::setSelfIllumination.
ACT_SURFACE_SHININESS	Surface shininess, as set in Pass::setShininess.
ACT_LIGHT_COUNT	The number of active light sources (better than gl_MaxLights).
ACT_AMBIENT_LIGHT_COLOUR	The ambient light colour set in the scene.
ACT_LIGHT_DIFFUSE_COLOUR	Light diffuse colour (index determined by setAutoConstant call).
ACT_LIGHT_SPECULAR_COLOUR	Light specular colour (index determined by setAutoConstant call).
ACT_LIGHT_ATTENUATION	Light attenuation parameters, Vector4(range, constant, linear, quadric).
ACT_SPOTLIGHT_PARAMS	Spotlight parameters, Vector4(innerFactor, outerFactor, falloff, isSpot) innerFactor and outerFactor are cos(angle/2) The isSpot parameter is 0.0f for non-spotlights, 1.0f for spotlights. Also for non-spotlights the inner and outer factors are 1 and nearly 1 respectively
ACT_LIGHT_POSITION	A light position in world space (index determined by setAutoConstant call).
ACT_LIGHT_POSITION_OBJECT_SPACE	A light position in object space (index determined by setAutoConstant call).
ACT_LIGHT_POSITION_VIEW_SPACE	A light position in view space (index determined by setAutoConstant call).
ACT_LIGHT_DIRECTION	A light direction in world space (index determined by setAutoConstant call).
ACT_LIGHT_DIRECTION_OBJECT_SPACE	A light direction in object space (index determined by setAutoConstant call).
ACT_LIGHT_DIRECTION_VIEW_SPACE	A light direction in view space (index determined by setAutoConstant call).
ACT_LIGHT_DISTANCE_OBJECT_SPACE	The distance of the light from the center of the object a useful approximation as an alternative to per-vertex distance calculations.
ACT_LIGHT_POWER_SCALE	Light power level, a single scalar as set in Light::setPowerScale (index determined by setAutoConstant call).
ACT_LIGHT_DIFFUSE_COLOUR_POWER_SCALED	Light diffuse colour pre-scaled by Light::setPowerScale (index determined by setAutoConstant call).
ACT_LIGHT_SPECULAR_COLOUR_POWER_SCALED	Light specular colour pre-scaled by Light::setPowerScale (index determined by setAutoConstant call).
ACT_LIGHT_DIFFUSE_COLOUR_ARRAY	Array of light diffuse colours (count set by extra param).
ACT_LIGHT_SPECULAR_COLOUR_ARRAY	Array of light specular colours (count set by extra param).
ACT_LIGHT_DIFFUSE_COLOUR_POWER_SCALED_ARRAY	Array of light diffuse colours scaled by light power (count set by extra param).
ACT_LIGHT_SPECULAR_COLOUR_POWER_SCALED_ARRAY	Array of light specular colours scaled by light power (count set by extra param).
ACT_LIGHT_ATTENUATION_ARRAY	Array of light attenuation parameters, Vector4(range, constant, linear, quadric) (count set by extra param).
ACT_LIGHT_POSITION_ARRAY	Array of light positions in world space (count set by extra param).
ACT_LIGHT_POSITION_OBJECT_SPACE_ARRAY	Array of light positions in object space (count set by extra param).
ACT_LIGHT_POSITION_VIEW_SPACE_ARRAY	Array of light positions in view space (count set by extra param).
ACT_LIGHT_DIRECTION_ARRAY	Array of light directions in world space (count set by extra param).
ACT_LIGHT_DIRECTION_OBJECT_SPACE_ARRAY	Array of light directions in object space (count set by extra param).
ACT_LIGHT_DIRECTION_VIEW_SPACE_ARRAY	Array of light directions in view space (count set by extra param).
ACT_LIGHT_DISTANCE_OBJECT_SPACE_ARRAY	Array of distances of the lights from the center of the object a useful approximation as an alternative to per-vertex distance calculations. (count set by extra param)
ACT_LIGHT_POWER_SCALE_ARRAY	Array of light power levels, a single scalar as set in Light::setPowerScale (count set by extra param).
ACT_SPOTLIGHT_PARAMS_ARRAY	Spotlight parameters array of Vector4(innerFactor, outerFactor, falloff, isSpot) innerFactor and outerFactor are cos(angle/2) The isSpot parameter is 0.0f for non-spotlights, 1.0f for spotlights. Also for non-spotlights the inner and outer factors are 1 and nearly 1 respectively. (count set by extra param)
ACT_DERIVED_AMBIENT_LIGHT_COLOUR	The derived ambient light colour, with 'r', 'g', 'b' components filled with product of surface ambient colour and ambient light colour, respectively, and 'a' component filled with surface ambient alpha component.
ACT_DERIVED_SCENE_COLOUR	The derived scene colour, with 'r', 'g' and 'b' components filled with sum of derived ambient light colour and surface emissive colour, respectively, and 'a' component filled with surface diffuse alpha component.
ACT_DERIVED_LIGHT_DIFFUSE_COLOUR	The derived light diffuse colour (index determined by setAutoConstant call), with 'r', 'g' and 'b' components filled with product of surface diffuse colour, light power scale and light diffuse colour, respectively, and 'a' component filled with surface diffuse alpha component.
ACT_DERIVED_LIGHT_SPECULAR_COLOUR	The derived light specular colour (index determined by setAutoConstant call), with 'r', 'g' and 'b' components filled with product of surface specular colour and light specular colour, respectively, and 'a' component filled with surface specular alpha component.
ACT_DERIVED_LIGHT_DIFFUSE_COLOUR_ARRAY	Array of derived light diffuse colours (count set by extra param).
ACT_DERIVED_LIGHT_SPECULAR_COLOUR_ARRAY	Array of derived light specular colours (count set by extra param).
ACT_LIGHT_NUMBER	The absolute light number of a local light index. Each pass may have a number of lights passed to it, and each of these lights will have an index in the overall light list, which will differ from the local light index due to factors like setStartLight and setIteratePerLight. This binding provides the global light index for a local index.
ACT_LIGHT_CASTS_SHADOWS	Returns (int) 1 if the given light casts shadows, 0 otherwise (index set in extra param).
ACT_SHADOW_EXTRUSION_DISTANCE	The distance a shadow volume should be extruded when using finite extrusion programs.
ACT_CAMERA_POSITION	The current camera's position in world space.
ACT_CAMERA_POSITION_OBJECT_SPACE	The current camera's position in object space.
ACT_TEXTURE_VIEWPROJ_MATRIX	The view/projection matrix of the assigned texture projection frustum.
ACT_TEXTURE_VIEWPROJ_MATRIX_ARRAY	Array of view/projection matrices of the first n texture projection frustums.
ACT_TEXTURE_WORLDVIEWPROJ_MATRIX	The view/projection matrix of the assigned texture projection frustum, combined with the current world matrix.
ACT_TEXTURE_WORLDVIEWPROJ_MATRIX_ARRAY	Array of world/view/projection matrices of the first n texture projection frustums.
ACT_SPOTLIGHT_VIEWPROJ_MATRIX	The view/projection matrix of a given spotlight.
ACT_SPOTLIGHT_VIEWPROJ_MATRIX_ARRAY	Array of view/projection matrix of a given spotlight.
ACT_SPOTLIGHT_WORLDVIEWPROJ_MATRIX	The view/projection matrix of a given spotlight projection frustum, combined with the current world matrix.
ACT_CUSTOM	A custom parameter which will come from the renderable, using 'data' as the identifier.
ACT_TIME	provides current elapsed time
ACT_TIME_0_X	Single float value, which repeats itself based on given as parameter "cycle time". Equivalent to RenderMonkey's "Time0_X".
ACT_COSTIME_0_X	Cosine of "Time0_X". Equivalent to RenderMonkey's "CosTime0_X".
ACT_SINTIME_0_X	Sine of "Time0_X". Equivalent to RenderMonkey's "SinTime0_X".
ACT_TANTIME_0_X	Tangent of "Time0_X". Equivalent to RenderMonkey's "TanTime0_X".
ACT_TIME_0_X_PACKED	Vector of "Time0_X", "SinTime0_X", "CosTime0_X", "TanTime0_X". Equivalent to RenderMonkey's "Time0_X_Packed".
ACT_TIME_0_1	Single float value, which represents scaled time value [0..1], which repeats itself based on given as parameter "cycle time". Equivalent to RenderMonkey's "Time0_1".
ACT_COSTIME_0_1	Cosine of "Time0_1". Equivalent to RenderMonkey's "CosTime0_1".
ACT_SINTIME_0_1	Sine of "Time0_1". Equivalent to RenderMonkey's "SinTime0_1".
ACT_TANTIME_0_1	Tangent of "Time0_1". Equivalent to RenderMonkey's "TanTime0_1".
ACT_TIME_0_1_PACKED	Vector of "Time0_1", "SinTime0_1", "CosTime0_1", "TanTime0_1". Equivalent to RenderMonkey's "Time0_1_Packed".
ACT_TIME_0_2PI	Single float value, which represents scaled time value [0..2*Pi], which repeats itself based on given as parameter "cycle time". Equivalent to RenderMonkey's "Time0_2PI".
ACT_COSTIME_0_2PI	Cosine of "Time0_2PI". Equivalent to RenderMonkey's "CosTime0_2PI".
ACT_SINTIME_0_2PI	Sine of "Time0_2PI". Equivalent to RenderMonkey's "SinTime0_2PI".
ACT_TANTIME_0_2PI	Tangent of "Time0_2PI". Equivalent to RenderMonkey's "TanTime0_2PI".
ACT_TIME_0_2PI_PACKED	Vector of "Time0_2PI", "SinTime0_2PI", "CosTime0_2PI", "TanTime0_2PI". Equivalent to RenderMonkey's "Time0_2PI_Packed".
ACT_FRAME_TIME	provides the scaled frame time, returned as a floating point value.
ACT_FPS	provides the calculated frames per second, returned as a floating point value.
ACT_VIEWPORT_WIDTH	viewport-related values Current viewport width (in pixels) as floating point value. Equivalent to RenderMonkey's "ViewportWidth".
ACT_VIEWPORT_HEIGHT	Current viewport height (in pixels) as floating point value. Equivalent to RenderMonkey's "ViewportHeight".
ACT_INVERSE_VIEWPORT_WIDTH	This variable represents 1.0/ViewportWidth. Equivalent to RenderMonkey's "ViewportWidthInverse".
ACT_INVERSE_VIEWPORT_HEIGHT	This variable represents 1.0/ViewportHeight. Equivalent to RenderMonkey's "ViewportHeightInverse".
ACT_VIEWPORT_SIZE	Packed of "ViewportWidth", "ViewportHeight", "ViewportWidthInverse", "ViewportHeightInverse".
ACT_VIEW_DIRECTION	view parameters This variable provides the view direction vector (world space). Equivalent to RenderMonkey's "ViewDirection".
ACT_VIEW_SIDE_VECTOR	This variable provides the view side vector (world space). Equivalent to RenderMonkey's "ViewSideVector".
ACT_VIEW_UP_VECTOR	This variable provides the view up vector (world space). Equivalent to RenderMonkey's "ViewUpVector".
ACT_FOV	This variable provides the field of view as a floating point value. Equivalent to RenderMonkey's "FOV".
ACT_NEAR_CLIP_DISTANCE	This variable provides the near clip distance as a floating point value. Equivalent to RenderMonkey's "NearClipPlane".
ACT_FAR_CLIP_DISTANCE	This variable provides the far clip distance as a floating point value. Equivalent to RenderMonkey's "FarClipPlane".
ACT_PASS_NUMBER	provides the pass index number within the technique of the active materil.
ACT_PASS_ITERATION_NUMBER	provides the current iteration number of the pass. The iteration number is the number of times the current render operation has been drawn for the active pass.
ACT_ANIMATION_PARAMETRIC	Provides a parametric animation value [0..1], only available where the renderable specifically implements it.
ACT_TEXEL_OFFSETS	Provides the texel offsets required by this rendersystem to map texels to pixels. Packed as float4(absoluteHorizontalOffset, absoluteVerticalOffset, horizontalOffset / viewportWidth, verticalOffset / viewportHeight)
ACT_SCENE_DEPTH_RANGE	Provides information about the depth range of the scene as viewed from the current camera. Passed as float4(minDepth, maxDepth, depthRange, 1 / depthRange)
ACT_SHADOW_SCENE_DEPTH_RANGE	Provides information about the depth range of the scene as viewed from a given shadow camera. Requires an index parameter which maps to a light index relative to the current light list. Passed as float4(minDepth, maxDepth, depthRange, 1 / depthRange)
ACT_SHADOW_COLOUR	Provides the fixed shadow colour as configured via SceneManager::setShadowColour; useful for integrated modulative shadows.
ACT_TEXTURE_SIZE	Provides texture size of the texture unit (index determined by setAutoConstant call). Packed as float4(width, height, depth, 1)
ACT_INVERSE_TEXTURE_SIZE	Provides inverse texture size of the texture unit (index determined by setAutoConstant call). Packed as float4(1 / width, 1 / height, 1 / depth, 1)
ACT_PACKED_TEXTURE_SIZE	Provides packed texture size of the texture unit (index determined by setAutoConstant call). Packed as float4(width, height, 1 / width, 1 / height)
ACT_TEXTURE_MATRIX	Provides the current transform matrix of the texture unit (index determined by setAutoConstant call), as seen by the fixed-function pipeline.
ACT_LOD_CAMERA_POSITION	Provides the position of the LOD camera in world space, allowing you to perform separate LOD calculations in shaders independent of the rendering camera. If there is no separate LOD camera then this is the real camera position. See Camera::setLodCamera.
ACT_LOD_CAMERA_POSITION_OBJECT_SPACE	Provides the position of the LOD camera in object space, allowing you to perform separate LOD calculations in shaders independent of the rendering camera. If there is no separate LOD camera then this is the real camera position. See Camera::setLodCamera.
ACT_LIGHT_CUSTOM	Binds custom per-light constants to the shaders.

Definition at line 598 of file OgreGpuProgramParams.h.

enum Ogre::GpuProgramParameters::ElementType

Defines the base element type of the auto constant.

Enumerator:

ET_INT
ET_REAL

Definition at line 1059 of file OgreGpuProgramParams.h.

Constructor & Destructor Documentation

Ogre::GpuProgramParameters::GpuProgramParameters ( )

Ogre::GpuProgramParameters::~GpuProgramParameters ( )

Definition at line 1169 of file OgreGpuProgramParams.h.

Ogre::GpuProgramParameters::GpuProgramParameters ( const GpuProgramParameters & oth )

Copy constructor.

Member Function Documentation

void Ogre::GpuProgramParameters::_copySharedParams ( )

Update the parameters by copying the data from the shared parameters.

Note:: This method may not actually be called if the RenderSystem supports using shared parameters directly in their own shared buffer; in which case the values should not be copied out of the shared area into the individual parameter set, but bound separately.

const GpuConstantDefinition* Ogre::GpuProgramParameters::_findNamedConstantDefinition	(	const String &	name,
		bool	throwExceptionIfMissing = `false`
	)			const

Find a constant definition for a named parameter.

Remarks:: 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.

Parameters:

	name	The name to look up
	throwExceptionIfMissing	If set to true, failure to find an entry will throw an exception.

const AutoConstantEntry* Ogre::GpuProgramParameters::_findRawAutoConstantEntryFloat ( size_t physicalIndex )

Finds an auto constant that's affecting a given physical position in the floating-point buffer.

const AutoConstantEntry* Ogre::GpuProgramParameters::_findRawAutoConstantEntryInt ( size_t physicalIndex )

Finds an auto constant that's affecting a given physical position in the integer buffer.

GpuLogicalIndexUse* Ogre::GpuProgramParameters::_getFloatConstantLogicalIndexUse	(	size_t	logicalIndex,
		size_t	requestedSize,
		uint16	variability
	)			`[protected]`

Gets the low-level structure for a logical index.

size_t Ogre::GpuProgramParameters::_getFloatConstantPhysicalIndex	(	size_t	logicalIndex,
		size_t	requestedSize,
		uint16	variability
	)

Gets the physical buffer index associated with a logical float constant index.

Note:: Only applicable to low-level programs.

Parameters:

	logicalIndex	The logical parameter index
	requestedSize	The requested size - pass 0 to ignore missing entries and return std::numeric_limits<size_t>::max()

GpuLogicalIndexUse* Ogre::GpuProgramParameters::_getIntConstantLogicalIndexUse	(	size_t	logicalIndex,
		size_t	requestedSize,
		uint16	variability
	)			`[protected]`

Gets the physical buffer index associated with a logical int constant index.

size_t Ogre::GpuProgramParameters::_getIntConstantPhysicalIndex	(	size_t	logicalIndex,
		size_t	requestedSize,
		uint16	variability
	)

Gets the physical buffer index associated with a logical int constant index.

Note:: Only applicable to low-level programs.

Parameters:

	logicalIndex	The logical parameter index
	requestedSize	The requested size - pass 0 to ignore missing entries and return std::numeric_limits<size_t>::max()

const Any& Ogre::GpuProgramParameters::_getRenderSystemData ( ) const

Internal method that the RenderSystem might use to store optional data.

Definition at line 1818 of file OgreGpuProgramParams.h.

void Ogre::GpuProgramParameters::_readRawConstants	(	size_t	physicalIndex,
		size_t	count,
		int *	dest
	)

Read a series of integer values from the underlying integer constant buffer at the given physical index.

Parameters:

	physicalIndex	The buffer position to start reading
	count	The number of ints to read
	dest	Pointer to a buffer to receive the values

void Ogre::GpuProgramParameters::_readRawConstants	(	size_t	physicalIndex,
		size_t	count,
		float *	dest
	)

Read a series of floating point values from the underlying float constant buffer at the given physical index.

Parameters:

	physicalIndex	The buffer position to start reading
	count	The number of floats to read
	dest	Pointer to a buffer to receive the values

void Ogre::GpuProgramParameters::_setLogicalIndexes	(	const GpuLogicalBufferStructPtr &	floatIndexMap,
		const GpuLogicalBufferStructPtr &	intIndexMap
	)

Internal method for providing a link to a logical index->physical index map for parameters.

void Ogre::GpuProgramParameters::_setNamedConstants ( const GpuNamedConstantsPtr & constantmap )

Internal method for providing a link to a name->definition map for parameters.

void Ogre::GpuProgramParameters::_setRawAutoConstant	(	size_t	physicalIndex,
		AutoConstantType	acType,
		size_t	extraInfo,
		uint16	variability,
		size_t	elementSize = `4`
	)

As setAutoConstant, but sets up the auto constant directly against a physical buffer index.

void Ogre::GpuProgramParameters::_setRawAutoConstantReal	(	size_t	physicalIndex,
		AutoConstantType	acType,
		Real	rData,
		uint16	variability,
		size_t	elementSize = `4`
	)

As setAutoConstantReal, but sets up the auto constant directly against a physical buffer index.

void Ogre::GpuProgramParameters::_setRenderSystemData ( const Any & data ) const

Internal method that the RenderSystem might use to store optional data.

Definition at line 1816 of file OgreGpuProgramParams.h.

void Ogre::GpuProgramParameters::_updateAutoParams	(	const AutoParamDataSource *	source,
		uint16	variabilityMask
	)

Update automatic parameters.

Parameters:

	source	The source of the parameters
	variabilityMask	A mask of GpuParamVariability which identifies which autos will need updating

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		const ColourValue &	colour,
		size_t	count = `4`
	)

Write a ColourValue parameter to the program.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	colour	The value to set
	count	The number of floats to write; if for example the uniform constant 'slot' is smaller than a Vector4

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		const Matrix4 *	m,
		size_t	numEntries
	)

Write a list of Matrix4 parameters to the program.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	numEntries	Number of Matrix4 entries

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		const Matrix4 &	m,
		size_t	elementCount
	)

Write a Matrix4 parameter to the program.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	m	The value to set
	elementCount	actual element count used with shader

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		const Vector3 &	vec
	)

Write a 3-element floating-point parameter to the program via Vector3.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	vec	The value to set

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		int	val
	)

Write a single integer parameter to the program.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	val	The value to set

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		Real	val
	)

Write a single floating-point parameter to the program.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	val	The value to set

void Ogre::GpuProgramParameters::_writeRawConstant	(	size_t	physicalIndex,
		const Vector4 &	vec,
		size_t	count = `4`
	)

Write a 4-element floating-point parameter to the program directly to the underlying constants buffer.

Note:: You can use these methods if you have already derived the physical constant buffer location, for a slight speed improvement over using the named / logical index versions.

Parameters:

	physicalIndex	The physical buffer index at which to place the parameter
	vec	The value to set
	count	The number of floats to write; if for example the uniform constant 'slot' is smaller than a Vector4

Referenced by Ogre::Renderable::_updateCustomGpuParameter(), and Ogre::RTShader::UniformParameter::setGpuParameter().

void Ogre::GpuProgramParameters::_writeRawConstants	(	size_t	physicalIndex,
		const int *	val,
		size_t	count
	)

Write a series of integer values into the underlying integer constant buffer at the given physical index.

Parameters:

	physicalIndex	The buffer position to start writing
	val	Pointer to a list of values to write
	count	The number of ints to write

void Ogre::GpuProgramParameters::_writeRawConstants	(	size_t	physicalIndex,
		const double *	val,
		size_t	count
	)

Write a series of floating point values into the underlying float constant buffer at the given physical index.

Parameters:

	physicalIndex	The buffer position to start writing
	val	Pointer to a list of values to write
	count	The number of floats to write

void Ogre::GpuProgramParameters::_writeRawConstants	(	size_t	physicalIndex,
		const float *	val,
		size_t	count
	)

Write a series of floating point values into the underlying float constant buffer at the given physical index.

Parameters:

	physicalIndex	The buffer position to start writing
	val	Pointer to a list of values to write
	count	The number of floats to write

Referenced by Ogre::RTShader::UniformParameter::setGpuParameter().

void Ogre::GpuProgramParameters::addSharedParameters ( const String & sharedParamsName )

Use a set of shared parameters in this parameters object.

Remarks:: Allows you to use a set of shared parameters to automatically update this parameter set.

Parameters:

sharedParamsName

The name of a shared parameter set as defined in GpuProgramManager

void Ogre::GpuProgramParameters::addSharedParameters ( GpuSharedParametersPtr sharedParams )

Use a set of shared parameters in this parameters object.

Remarks:: Allows you to use a set of shared parameters to automatically update this parameter set.

void Ogre::GpuProgramParameters::clearAutoConstant ( size_t index )

Unbind an auto constant so that the constant is manually controlled again.

void Ogre::GpuProgramParameters::clearAutoConstants ( void )

Clears all the existing automatic constants.

void Ogre::GpuProgramParameters::clearNamedAutoConstant ( const String & name )

Unbind an auto constant so that the constant is manually controlled again.

void Ogre::GpuProgramParameters::copyConstantsFrom ( const GpuProgramParameters & source )

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

Note:: This copes the internal storage of the paarameters object and therefore can only be used for parameters objects created from the same GpuProgram. To merge parameters that match from different programs, use copyMatchingNamedConstantsFrom.

void Ogre::GpuProgramParameters::copyMatchingNamedConstantsFrom ( const GpuProgramParameters & source )

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

Remarks:: This method iterates over the named constants in another parameters object and copies across the values where they match. This method is safe to use when the 2 parameters objects came from different programs, but only works for named parameters.

void Ogre::GpuProgramParameters::copySharedParamSetUsage ( const GpuSharedParamUsageList & srcList ) [protected]

uint16 Ogre::GpuProgramParameters::deriveVariability ( AutoConstantType act ) [protected]

Return the variability for an auto constant.

const AutoConstantEntry* Ogre::GpuProgramParameters::findAutoConstantEntry ( const String & paramName )

Finds an auto constant that's affecting a given named parameter index.

Note:: Only applicable to high-level programs.

const AutoConstantEntry* Ogre::GpuProgramParameters::findFloatAutoConstantEntry ( size_t logicalIndex )

Finds an auto constant that's affecting a given logical parameter index for floating-point values.

Note:: Only applicable for low-level programs.

const AutoConstantEntry* Ogre::GpuProgramParameters::findIntAutoConstantEntry ( size_t logicalIndex )

Finds an auto constant that's affecting a given logical parameter index for integer values.

Note:: Only applicable for low-level programs.

size_t Ogre::GpuProgramParameters::getAutoConstantCount ( void ) const

Gets the number of int constants that have been set.

Definition at line 1488 of file OgreGpuProgramParams.h.

static const AutoConstantDefinition* Ogre::GpuProgramParameters::getAutoConstantDefinition ( const size_t idx ) [static]

gets the auto constant definition using an index into the auto constant definition array.

If the index is out of bounds then NULL is returned;

Parameters:

idx

The auto constant index

static const AutoConstantDefinition* Ogre::GpuProgramParameters::getAutoConstantDefinition ( const String & name ) [static]

gets the auto constant definition associated with name if found else returns NULL

Parameters:

name

The name of the auto constant

AutoConstantEntry* Ogre::GpuProgramParameters::getAutoConstantEntry ( const size_t index )

Gets a specific Auto Constant entry if index is in valid range otherwise returns a NULL.

Parameters:

index

which entry is to be retrieved

AutoConstantIterator Ogre::GpuProgramParameters::getAutoConstantIterator ( void ) const

Gets an iterator over the automatic constant bindings currently in place.

const AutoConstantList& Ogre::GpuProgramParameters::getAutoConstantList ( ) const

Get a reference to the list of auto constant bindings.

Definition at line 1427 of file OgreGpuProgramParams.h.

const GpuConstantDefinition& Ogre::GpuProgramParameters::getConstantDefinition ( const String & name ) const

Get a specific GpuConstantDefinition for a named parameter.

Note:: Only available if this parameters object has named parameters.

GpuConstantDefinitionIterator Ogre::GpuProgramParameters::getConstantDefinitionIterator ( void ) const

Gets an iterator over the named GpuConstantDefinition instances as defined by the program for which these parameters exist.

Note:: Only available if this parameters object has named parameters.

const GpuNamedConstants& Ogre::GpuProgramParameters::getConstantDefinitions ( ) const

Get the full list of GpuConstantDefinition instances.

Note:: Only available if this parameters object has named parameters.

const FloatConstantList& Ogre::GpuProgramParameters::getFloatConstantList ( ) const

Get a reference to the list of float constants.

Definition at line 1415 of file OgreGpuProgramParams.h.

const GpuLogicalBufferStructPtr& Ogre::GpuProgramParameters::getFloatLogicalBufferStruct ( ) const

Get the current list of mappings from low-level logical param indexes to physical buffer locations in the float buffer.

Note:: Only applicable to low-level programs.

Definition at line 1393 of file OgreGpuProgramParams.h.

size_t Ogre::GpuProgramParameters::getFloatLogicalIndexForPhysicalIndex ( size_t physicalIndex )

Retrieves the logical index relating to a physical index in the float buffer, for programs which support that (low-level programs and high-level programs which use logical parameter indexes).

Returns:: std::numeric_limits<size_t>::max() if not found

const float* Ogre::GpuProgramParameters::getFloatPointer ( size_t pos ) const

Get a pointer to the 'nth' item in the float buffer.

Definition at line 1419 of file OgreGpuProgramParams.h.

float* Ogre::GpuProgramParameters::getFloatPointer ( size_t pos )

Get a pointer to the 'nth' item in the float buffer.

Definition at line 1417 of file OgreGpuProgramParams.h.

const IntConstantList& Ogre::GpuProgramParameters::getIntConstantList ( ) const

Get a reference to the list of int constants.

Definition at line 1421 of file OgreGpuProgramParams.h.

const GpuLogicalBufferStructPtr& Ogre::GpuProgramParameters::getIntLogicalBufferStruct ( ) const

Get the current list of mappings from low-level logical param indexes to physical buffer locations in the integer buffer.

Note:: Only applicable to low-level programs.

Definition at line 1413 of file OgreGpuProgramParams.h.

size_t Ogre::GpuProgramParameters::getIntLogicalIndexForPhysicalIndex ( size_t physicalIndex )

Retrieves the logical index relating to a physical index in the int buffer, for programs which support that (low-level programs and high-level programs which use logical parameter indexes).

Returns:: std::numeric_limits<size_t>::max() if not found

const int* Ogre::GpuProgramParameters::getIntPointer ( size_t pos ) const

Get a pointer to the 'nth' item in the int buffer.

Definition at line 1425 of file OgreGpuProgramParams.h.

int* Ogre::GpuProgramParameters::getIntPointer ( size_t pos )

Get a pointer to the 'nth' item in the int buffer.

Definition at line 1423 of file OgreGpuProgramParams.h.

static size_t Ogre::GpuProgramParameters::getNumAutoConstantDefinitions ( void ) [static]

Returns the number of auto constant definitions.

size_t Ogre::GpuProgramParameters::getPassIterationNumberIndex ( ) const

Get the physical buffer index of the pass iteration number constant.

Definition at line 1783 of file OgreGpuProgramParams.h.

const GpuSharedParamUsageList& Ogre::GpuProgramParameters::getSharedParameters ( ) const

Get the list of shared parameter sets.

bool Ogre::GpuProgramParameters::getTransposeMatrices ( void ) const

Gets whether or not matrices are to be transposed when set.

Definition at line 1742 of file OgreGpuProgramParams.h.

bool Ogre::GpuProgramParameters::hasAutoConstants ( void ) const

Returns true if this instance has any automatic constants.

Definition at line 1495 of file OgreGpuProgramParams.h.

bool Ogre::GpuProgramParameters::hasLogicalIndexedParameters ( ) const

Does this parameter set include logically indexed parameters?

Note:: Not mutually exclusive with hasNamedParameters since some high-level programs still use logical indexes to set the parameters on the rendersystem.

Definition at line 1191 of file OgreGpuProgramParams.h.

bool Ogre::GpuProgramParameters::hasNamedParameters ( ) const

Does this parameter set include named parameters?

Definition at line 1185 of file OgreGpuProgramParams.h.

bool Ogre::GpuProgramParameters::hasPassIterationNumber ( ) const

Does this parameters object have a pass iteration number constant?

Definition at line 1780 of file OgreGpuProgramParams.h.

void Ogre::GpuProgramParameters::incPassIterationNumber ( void )

increments the multipass number entry by 1 if it exists

bool Ogre::GpuProgramParameters::isUsingSharedParameters ( const String & sharedParamsName ) const

Returns whether this parameter set is using the named shared parameter set.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)			`[inherited]`

Definition at line 107 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete	(	void *	ptr,
		void *
	)			`[inherited]`

Definition at line 101 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr ) [inherited]

Definition at line 95 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[]	(	void *	ptr,
		const char *	,
		int	,
		const char *
	)			`[inherited]`

Definition at line 118 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void * ptr ) [inherited]

Definition at line 112 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		void *	ptr
	)			`[inherited]`

placement operator new

Definition at line 78 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz ) [inherited]

Definition at line 72 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)			`[inherited]`

operator new, with debug line info

Definition at line 67 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t sz ) [inherited]

Definition at line 90 of file OgreMemoryAllocatedObject.h.

template<class Alloc >

void* Ogre::AllocatedObject< Alloc >::operator new[]	(	size_t	sz,
		const char *	file,
		int	line,
		const char *	func
	)			`[inherited]`

array operator new, with debug line info

Definition at line 85 of file OgreMemoryAllocatedObject.h.

GpuProgramParameters& Ogre::GpuProgramParameters::operator= ( const GpuProgramParameters & oth )

Operator = overload.

void Ogre::GpuProgramParameters::removeAllSharedParameters ( )

Stop using all shared parameter sets.

void Ogre::GpuProgramParameters::removeSharedParameters ( const String & sharedParamsName )

Stop using the named shared parameter set.

void Ogre::GpuProgramParameters::setAutoConstant	(	size_t	index,
		AutoConstantType	acType,
		uint16	extraInfo1,
		uint16	extraInfo2
	)

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

Remarks:: 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.

Parameters:

	index	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.
	acType	The type of automatic constant to set
	extraInfo1	The first extra parameter required by the auto constant type
	extraInfo2	The first extra parameter required by the auto constant type

void Ogre::GpuProgramParameters::setAutoConstant	(	size_t	index,
		AutoConstantType	acType,
		size_t	extraInfo = `0`
	)

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

Remarks:: 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.

Parameters:

	index	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.
	acType	The type of automatic constant to set
	extraInfo	If the constant type needs more information (like a light index) put it here.

void Ogre::GpuProgramParameters::setAutoConstantReal	(	size_t	index,
		AutoConstantType	acType,
		Real	rData
	)

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const int *	val,
		size_t	count
	)

Sets a multiple value constant integer parameter to the program.

Remarks:: 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 RenderSystemCapabilities to determine the options.

Parameters:

	index	The logical constant index at which to place the parameter (each constant is a 4D integer)
	val	Pointer to the values to write, must contain 4*count ints
	count	The number of groups of 4 ints to write

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const ColourValue &	colour
	)

Sets a ColourValue parameter to the program.

Parameters:

	index	The logical constant index at which to place the parameter (each constant is a 4D float)
	colour	The value to set

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const double *	val,
		size_t	count
	)

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

Parameters:

	index	The logical constant index at which to start placing parameters (each constant is a 4D float)
	val	Pointer to the values to write, must contain 4*count floats
	count	The number of groups of 4 floats to write

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const float *	val,
		size_t	count
	)

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

Parameters:

	index	The logical constant index at which to start placing parameters (each constant is a 4D float)
	val	Pointer to the values to write, must contain 4*count floats
	count	The number of groups of 4 floats to write

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const Matrix4 *	m,
		size_t	numEntries
	)

Sets a list of Matrix4 parameters to the program.

Parameters:

	index	The logical constant index at which to start placing the parameter (each constant is a 4D float). NB since a Matrix4 is 16 floats long, so each entry will take up 4 indexes.
	m	Pointer to an array of matrices to set
	numEntries	Number of Matrix4 entries

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const Matrix4 &	m
	)

Sets a Matrix4 parameter to the program.

Parameters:

	index	The logical constant index at which to place the parameter (each constant is a 4D float). NB since a Matrix4 is 16 floats long, this parameter will take up 4 indexes.
	m	The value to set

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const Vector3 &	vec
	)

Sets a 4-element floating-point parameter to the program via Vector3.

Parameters:

	index	The logical constant index at which to place the parameter (each constant is a 4D float). Note that since you're passing a Vector3, the last element of the 4-element value will be set to 1 (a homogeneous vector)
	vec	The value to set

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		Real	val
	)

Sets a single floating-point parameter to the program.

Note:: This is actually equivalent to calling setConstant(index Vector4(val, 0, 0, 0)) since all constants are 4D.

Parameters:

	index	The logical constant index at which to place the parameter (each constant is a 4D float)
	val	The value to set

void Ogre::GpuProgramParameters::setConstant	(	size_t	index,
		const Vector4 &	vec
	)

Sets a 4-element floating-point parameter to the program.

Parameters:

	index	The logical constant index at which to place the parameter (each constant is a 4D float)
	vec	The value to set

void Ogre::GpuProgramParameters::setConstantFromTime	(	size_t	index,
		Real	factor
	)

Sets a named parameter up to track a derivation of the current time.

Parameters:

	index	The index of the parameter
	factor	The amount by which to scale the time value

void Ogre::GpuProgramParameters::setIgnoreMissingParams ( bool state )

Tells the program whether to ignore missing parameters or not.

Definition at line 1527 of file OgreGpuProgramParams.h.

void Ogre::GpuProgramParameters::setNamedAutoConstant	(	const String &	name,
		AutoConstantType	acType,
		uint16	extraInfo1,
		uint16	extraInfo2
	)

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

Remarks:: 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.

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	acType	The type of automatic constant to set
	extraInfo1	The first extra info required by this auto constant type
	extraInfo2	The first extra info required by this auto constant type

void Ogre::GpuProgramParameters::setNamedAutoConstant	(	const String &	name,
		AutoConstantType	acType,
		size_t	extraInfo = `0`
	)

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

Remarks:: 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.

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	acType	The type of automatic constant to set
	extraInfo	If the constant type needs more information (like a light index) put it here.

void Ogre::GpuProgramParameters::setNamedAutoConstantReal	(	const String &	name,
		AutoConstantType	acType,
		Real	rData
	)

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const int *	val,
		size_t	count,
		size_t	multiple = `4`
	)

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

: Some systems only allow constants to be set on certain boundaries, e.g. in sets of 4 values for example. The 'multiple' parameter allows you to control that although you should only change it if you know your chosen language supports that (at the time of writing, only GLSL allows constants which are not a multiple of 4).

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	val	Pointer to the values to write
	count	The number of 'multiples' of floats to write
	multiple	The number of raw entries in each element to write, the default is 4 so count = 1 would write 4 floats.

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const ColourValue &	colour
	)

Sets a ColourValue parameter to the program.

Parameters:

	name	The name of the parameter
	colour	The value to set

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const double *	val,
		size_t	count,
		size_t	multiple = `4`
	)

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

: Some systems only allow constants to be set on certain boundaries, e.g. in sets of 4 values for example. The 'multiple' parameter allows you to control that although you should only change it if you know your chosen language supports that (at the time of writing, only GLSL allows constants which are not a multiple of 4).

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	val	Pointer to the values to write
	count	The number of 'multiples' of floats to write
	multiple	The number of raw entries in each element to write, the default is 4 so count = 1 would write 4 floats.

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const float *	val,
		size_t	count,
		size_t	multiple = `4`
	)

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

: Some systems only allow constants to be set on certain boundaries, e.g. in sets of 4 values for example. The 'multiple' parameter allows you to control that although you should only change it if you know your chosen language supports that (at the time of writing, only GLSL allows constants which are not a multiple of 4).

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	val	Pointer to the values to write
	count	The number of 'multiples' of floats to write
	multiple	The number of raw entries in each element to write, the default is 4 so count = 1 would write 4 floats.

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const Matrix4 *	m,
		size_t	numEntries
	)

Sets a list of Matrix4 parameters to the program.

Parameters:

	name	The name of the parameter; this must be the first index of an array, for examples 'matrices[0]' NB since a Matrix4 is 16 floats long, so each entry will take up 4 indexes.
	m	Pointer to an array of matrices to set
	numEntries	Number of Matrix4 entries

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const Matrix4 &	m
	)

Sets a Matrix4 parameter to the program.

Parameters:

	name	The name of the parameter
	m	The value to set

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const Vector3 &	vec
	)

Sets a Vector3 parameter to the program.

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	index	The index at which to place the parameter NB this index refers to the number of floats, so a Vector3 is 3. Note that many rendersystems & programs assume that every floating point parameter is passed in as a vector of 4 items, so you are strongly advised to check with RenderSystemCapabilities before using this version - if in doubt use Vector4 or ColourValue instead (both are 4D).
	vec	The value to set

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		const Vector4 &	vec
	)

Sets a Vector4 parameter to the program.

Parameters:

	name	The name of the parameter
	vec	The value to set

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		int	val
	)

Sets a single value constant integer parameter to the program.

Remarks:: 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 RenderSystemCapabilities 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 RenderSystemCapabilities for full details.

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	val	The value to set

void Ogre::GpuProgramParameters::setNamedConstant	(	const String &	name,
		Real	val
	)

Sets a single value constant floating-point parameter to the program.

Remarks:: 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 RenderSystemCapabilities 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 RenderSystemCapabilities for full details.

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	val	The value to set

void Ogre::GpuProgramParameters::setNamedConstantFromTime	(	const String &	name,
		Real	factor
	)

Sets a named parameter up to track a derivation of the current time.

Note:: This named option will only work if you are using a parameters object created from a high-level program (HighLevelGpuProgram).

Parameters:

	name	The name of the parameter
	factor	The amount by which to scale the time value

void Ogre::GpuProgramParameters::setTransposeMatrices ( bool val )

Sets whether or not we need to transpose the matrices passed in from the rest of OGRE.

Remarks:: D3D uses transposed matrices compared to GL and OGRE; this is not important when you use programs which are written to process row-major matrices, such as those generated by Cg, but if you use a program written to D3D's matrix layout you will need to enable this flag.

Definition at line 1740 of file OgreGpuProgramParams.h.