NAME
    cgCreateArraySamplerState - create an array-typed sampler state
    definition

SYNOPSIS
      #include <Cg/cg.h>

      CGstate cgCreateArraySamplerState( CGcontext context,
                                         const char * name,
                                         CGtype type,
                                         int nelements );

PARAMETERS
    context   The context in which to define the sampler state.

    name      The name of the new sampler state.

    type      The type of the new sampler state.

    nelements The number of elements in the array.

RETURN VALUES
    Returns a handle to the newly created CGstate.

    Returns NULL if there is an error.

DESCRIPTION
    cgCreateArraySamplerState adds a new array-typed sampler state
    definition to context. All state in sampler_state blocks must have been
    defined ahead of time via a call to cgCreateSamplerState or
    cgCreateArraySamplerState before adding an effect file to the context.

    Applications will typically call cgSetStateCallbacks shortly after
    creating a new state with cgCreateArraySamplerState.

EXAMPLES
    *to-be-written*

ERRORS
    CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context is not a valid
    context.

    CG_INVALID_PARAMETER_ERROR is generated if name is NULL or not a valid
    identifier, if type is not a simple scalar, vector, or matrix-type, or
    if nelements is not a positive number.

HISTORY
    cgCreateArraySamplerState was introduced in Cg 1.4.

SEE ALSO
    cgCreateSamplerState, cgGetStateName, cgGetStateType, cgIsState,
    cgSetStateCallbacks, cgGLRegisterStates

