cgGetSupportedProfile

> # NAME

> cgGetSupportedProfile - get a supported profile by index

> # SYNOPSIS

>       #include <Cg/cg.h>

>       CGprofile cgGetSupportedProfile( int index );

> # PARAMETERS

> index

>   The index for the supported profile.

> # RETURN VALUES

> Returns the supported CGprofile at position index.

> Returns the CG_PROFILE_UNKNOWN if an error occurs.

> # DESCRIPTION

> cgGetSupportedProfile retrieves by index a profile supported by this version of the Cg library. The number of supported profiles can be found using cgGetNumSupportedProfiles.

> Note that a profile may be recognized by Cg but not supported by the platform on which the application is currently running. A graphics API specific routine such as cgGLIsProfileSupported must still be used to determine if the current GPU and driver combination supports a given profile.

> # EXAMPLES

>         CGprofile profile;
>         int nProfiles;
>         int ii;

>         nProfiles = cgGetNumSupportedProfiles();
>         printf("NumSupportedProfiles: %i\n", nProfiles);

>         for (ii=0; ii<nProfiles; ++ii) {
>             profile = cgGetSupportedProfile(ii);
>             printf("SupportedProfile %i: %s %i\n", ii, cgGetProfileString(profile), profile);
>         }

> # ERRORS

> CG_INVALID_PARAMETER_ERROR is generated if index is less than 0 or greater than or equal to the number of supported profiles returned by cgGetNumSupportedProfiles.

> # HISTORY

> cgGetSupportedProfile was introduced in Cg 2.2.

> # SEE ALSO

> cgGetNumSupportedProfiles, cgIsProfileSupported, cgGetProfileProperty, cgGLIsProfileSupported, cgD3D9IsProfileSupported, cgD3D10IsProfileSupported, cgGetProfileString, cgGetProfile