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

> ## Name

> cgD3D9GetOptimalOptions - get the best set of compiler options for a profile

> ## Synopsis

>     #include <Cg/cgD3D9.h>

>     char const ** cgD3D9GetOptimalOptions( CGprofile profile );

> ## Parameters

> profile
>   The profile whose optimal arguments are requested.

> ## Return Values

> Returns a null-terminated array of strings representing the optimal set of compiler options for profile.

> Returns NULL if no D3D device is currently set.

> ## Description

> cgD3D9GetOptimalOptions returns the best set of compiler options for a given profile. This is an expanded interface function because it needs to know about the D3D device to determine the most optimal options.

> The elements of the returned array are meant to be used as part of the args parameter to cgCreateProgram or cgCreateProgramFromFile.

> The returned string does not need to be destroyed by the application. However, the contents could change if the function is called again for the same profile but a different D3D device.

> ## Examples

>     const char* vertOptions[]  = { myCustomArgs,
>                                    cgD3D9GetOptimalOptions(vertProfile),
>                                    NULL };

>     // create the vertex shader
>     CGprogram myVS = cgCreateProgramFromFile( context,
>                                               CG_SOURCE,
>                                               "vshader.cg",
>                                               vertProfile,
>                                               "VertexShader",
>                                               vertOptions);

> ## Errors

> None.

> ## History

> cgD3D9GetOptimalOptions was introduced in Cg 1.1.

> ## See Also

> cgD3D9GetLatestVertexProfile, cgD3D9GetLatestPixelProfile, cgCreateProgram, cgCreateProgramFromFile