NAME
    cgGetParameterValueir - get the value of any numeric parameter

SYNOPSIS
      #include <Cg/cg.h>

      int cgGetParameterValueir( CGparameter param, 
                                 int nelements,
                                 int * v );

PARAMETERS
    param   The parameter whose value will be retrieved.

    nelements
            The number of elements in array v.

    v       Destination buffer into which the parameter values will be
            written.

RETURN VALUES
    The total number of values written to v is returned.

DESCRIPTION
    cgGetParameterValueir allows the application to get the value of any
    numeric parameter or parameter array.

    The given parameter must be a scalar, vector, matrix, or a (possibly
    multidimensional) array of scalars, vectors, or matrices.

    Any matrices referenced by param will be copied in row-major order.

    If v is smaller than the total number of values in the given source
    parameter, CG_NOT_ENOUGH_DATA_ERROR is generated.

    The total number of values in a parameter, ntotal, may be computed as
    follow:

                int nrows = cgGetParameterRows(param);
                int ncols = cgGetParameterColumns(param);
                int asize = cgGetArrayTotalSize(param);
                int ntotal = nrows*ncols;
                if (asize > 0) ntotal *= asize;

EXAMPLES
    *to-be-written*

ERRORS
    CG_INVALID_PARAM_HANDLE_ERROR is generated if the handle param is
    invalid.

    CG_INVALID_POINTER_ERROR is generated if v is NULL.

    CG_NOT_ENOUGH_DATA_ERROR is generated if nelements is less than the
    total size of param.

    CG_NON_NUMERIC_PARAMETER_ERROR is generated if param is of a non-numeric
    type.

HISTORY
    cgGetParameterValueir was introduced in Cg 1.4.

SEE ALSO
    the cgGetParameterValue manpage, the cgSetParameterValue manpage, the
    cgGetParameterRows manpage, the cgGetParameterColumns manpage, the
    cgGetArrayTotalSize manpage

