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
    cgCreateArraySamplerState returns a handle to the newly created CGstate.
    If there is an error, NULL is returned.

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

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

EXAMPLES
    *to-be-written*

ERRORS
    CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context does not refer
    to a valid context.

    CG_INVALID_PARAMETER_ERROR is generated if name is NULL or not a valid
    identifier, as well as 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
    the cgCreateSamplerState manpage, the cgGetStateName manpage, the
    cgGetStateType manpage, the cgIsState manpage, the cgSetStateCallbacks
    manpage, the cgGLRegisterStates manpage

