cgSetMultiDimArraySize

> # NAME

> cgSetMultiDimArraySize - sets the size of a resizable multi-dimensional array parameter

> # SYNOPSIS

>       #include <Cg/cg.h>

>       void cgSetMultiDimArraySize( CGparameter param,
>                                    const int * sizes );

> # PARAMETERS

> param

>   The array parameter handle.

> sizes

>   An array of sizes for each dimension of the array.

> # RETURN VALUES

> None.

> # DESCRIPTION

> cgSetMultiDimArraySize sets the size of each dimension of resizable multi-dimensional array parameter param. sizes must be an array that has N number of elements where N is equal to the result of cgGetArrayDimension.

> # EXAMPLES

> If you have Cg program with a parameter like this :

>       /* ... */

>       float4 main(float4 myarray[][][])
>       {
>         /* ... */
>       }

> You can set the sizes of each dimension of the myarray array parameter like so :

>       const int sizes[] = { 3, 2, 4 };
>       CGparameter myArrayParam =
>         cgGetNamedProgramParameter(program, CG_PROGRAM, "myarray");

>       cgSetMultiDimArraySize(myArrayParam, sizes);

> # ERRORS

> CG_INVALID_PARAM_HANDLE_ERROR is generated if param is not a valid parameter.

> CG_ARRAY_PARAM_ERROR is generated if param is not an array parameter.

> CG_INVALID_POINTER_ERROR is generated if sizes is NULL.

> CG_INVALID_PARAMETER_ERROR is generated if any value in sizes is less than or equal to 0.

> CG_PARAMETER_IS_NOT_RESIZABLE_ARRAY_ERROR is generated if param is not a resizable array.

> # HISTORY

> cgSetMultiDimArraySize was introduced in Cg 1.2.

> # SEE ALSO

> cgGetArraySize, cgGetArrayDimension, cgSetArraySize