cgCopyEffect
Keywords: cgCopyEffect, NVIDIA, NVIDIA Cg Toolkit, Cg Toolkit, Shader, Shader Programming, GPU Shader Programming, GPU Program

> ## Name

> cgCopyEffect - make a copy of an effect

> ## Synopsis

>     #include <Cg/cg.h>

>     CGeffect cgCopyEffect( CGeffect effect );

> ## Parameters

> effect
>   The effect object to be copied.

> ## Return Values

> Returns a copy of effect on success.

> Returns NULL if effect is invalid or the copy fails.

> ## Description

> cgCopyEffect creates a new effect object that is a copy of effect and adds it to the same context as effect.

> Note: Currently cgCopyEffect does not work and therefore will always returns NULL.

> ## Examples

>       CGeffect effectCopy = cgCopyEffect(effect);

> ## Errors

> CG_INVALID_EFFECT_HANDLE_ERROR is generated if effect is not a valid effect.

> ## History

> cgCopyEffect was introduced in Cg 2.0.

> cgCopyEffect is not operational as of Cg 3.0.

> ## See Also

> cgCreateEffect, cgCreateEffectFromFile, cgDestroyEffect