NAME
    cgCreateArraySamplerState - create a new array-typed sampler state
    definition

SYNOPSIS
      #include <Cg/cg.h>

      CGstate cgCreateArraySamplerState(CGcontext cgfx, const char *name, CGtype type, int nelems);

PARAMETERS
    ctx     Specifies the context to define the sampler state in.

    name    Specifies the name of the new sampler state.

    type    Specifies the type of the new sampler state.

    nelems  Specifies the number of elements in the array.

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 the cgCreateArraySamplerState
    manpage.

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

RETURN VALUES
    cgCreateArraySamplerState returns a handle to the newly created CGstate.
    If there is an error, NULL is returned.

ERRORS
    CG_INVALID_CONTEXT_HANDLE_ERROR is generated if ctx 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 nelems is not a positive number.

SEE ALSO
    the cgCreateSamplerState manpage, the cgGetStateName manpage, the
    cgGetStateType manpage, the cgIsState manpage, the cgSetStateCallbacks
    manpage, and the cgGLRegisterStates manpage.

