Name

cgGetEffectParameterBySemantic - get the a parameter in an effect via its semantic

Synopsis

#include <Cg/cg.h>

CGparameter cgGetEffectParameterBySemantic( CGeffect effect,
                                            const char * semantic );

Parameters

effect

The effect from which to retrieve the parameter.

semantic

The name of the semantic.

Return Values

Returns the CGparameter object in effect that has the given semantic.

Returns NULL if effect is invalid or does not have any parameters with the given semantic.

Description

cgGetEffectParameterBySemantic returns the parameter in an effect which is associated with the given semantic. It multiple parameters in the effect have this semantic, an arbitrary one of them will be returned.

Examples

to-be-written

Errors

CG_INVALID_EFFECT_HANDLE_ERROR is generated if effect is not a valid effect.

CG_INVALID_PARAMETER_ERROR is generated if semantic is NULL or the empty string.

History

cgGetEffectParameterBySemantic was introduced in Cg 1.4.

See Also

cgGetNamedEffectParameter