NAME
cgSetParameterVariability - set a parameter's variability
SYNOPSIS
#include <Cg/cg.h> void cgSetParameterVariability(CGparameter param, CGenum vary);PARAMETERS
- param
Specifies the parameter.
- vary
The variability the param will be set to.
DESCRIPTION
cgSetParameterVariability allows the application to change the variability of a parameter.
Currently parameters may not be changed to or from CG_VARYING variability. However parameters of CG_UNIFORM and CG_LITERAL variability may be changed.
Valid values for vary include :
- CG_UNIFORM
A uniform parameter is one whose value does not change with each invocation of a program, but whose value can change between groups of program invocations.
- CG_LITERAL
A literal parameter is folded out at compile time. Making a uniform parameter literal will often make a program more efficient at the expense of requiring a compile every time the value is set.
- CG_DEFAULT
By default, the variability of a parameter will be overridden by the a source parameter connected to it unless it is changed with cgSetParameterVariability. If it is set to CG_DEFAULT it will restore the default state of assuming the source parameters variability.
RETURN VALUES
This function does not return a value.
ERRORS
CG_INVALID_PARAM_HANDLE_ERROR is generated if the handle param is invalid.
CG_INVALID_ENUMERANT_ERROR is generated if vary is not a valid enumerant.
CG_INVALID_PARAMETER_VARIABILITY_ERROR is generated if the parameter could not be changed to the variability indicated by vary.
SEE ALSO