Cg OpenGL Runtime API              cgGLSetStateMatrixParameter(3)



NAME
     cgGLSetStateatrixParameter - set the values of a matrix
     parameter to a matrix in the OpenGL state

SYNOPSIS
       #include 

       void cgGLSetStateMatrixParameter( CGparameter param,
                                         CGLenum matrix,
                                         CGLenum transform );


PARAMETERS
     param   The matrix parameter that will be set.

     matrix  An enumerant indicating which matrix should be
             retrieved from the OpenGL state.  Must be one of the
             following :

             ]o CGLMODELVIEWMATRIX
             ]o CGLPROJECTIONMATRIX
             ]o CGLTEXTUREMATRIX
             ]o CGLMODELVIEWPROJECTIONMATRIX
     transform
             An enumerant indicating an optional transformation
             that may be applied to the matrix before it is set.
             Must be one of the following :

             ]o CGLMATRIXIDENTITY
             ]o CGLMATRIXTRANSPOSE
             ]o CGLMATRIXINVERSE
             ]o CGLMATRIXINVERSETRANSPOSE

RETURN VALUES
     None.

DESCRIPTION
     cgGLSetStateatrixParameter sets a matrix parameter to the
     values retrieved from an OpenGL state matrix.  The state
     matrix to retrieve is indicated by matrix, which may be one
     of the following :

     ]o CGLMODELVIEWMATRIX
         Get the current modelview matrix.

     ]o CGLPROJECTIONMATRIX
         Get the current projection matrix.

     ]o CGLTEXTUREMATRIX
         Get the current texture matrix.





Cg Toolkit 2.1            Last change:                          1






Cg OpenGL Runtime API              cgGLSetStateMatrixParameter(3)



     ]o CGLMODELVIEWPROJECTIONMATRIX
         Get the concatenated modelview and projection matrices.

     The transform parameter specifies an optional transformation
     which will be applied to the retrieved matrix before setting
     the values in the parameter.  transform must be one of the
     following :

     ]o CGLMATRIXIDENTITY
         Don't apply any transform, leaving the matrix as is.

     ]o CGLMATRIXTRANSPOSE
         Transpose the matrix.

     ]o CGLMATRIXINVERSE
         Invert the matrix.

     ]o CGLMATRIXINVERSETRANSPOSE
         Transpose and invert the matrix.

     cgGLSetStateatrixParameter may only be called with a
     uniform matrix parameter.  If the size of the matrix is less
     than 4x4, the upper left corner of the matrix that fits into
     the given matrix parameter will be returned.

EXAMPLES
     to-be-written

ERORS
     CGINVALIDPROFILEROR is generated if param's profile is
     not a supported OpenGL profile.

     CGNOTMATRIXPARAMEROR is generated if param is not a
     matrix parameter.

     CGINVALIDENUMERANTEROR is generated if either matrix or
     transform is not one of the allowed enumerant values.

     CGINVALIDPARAMHANDLEROR is generated if param is not a
     valid parameter.

     CGINVALIDPARAMETEREROR is generated if the parameter
     fails to set for any other reason.

HISTORY
     cgGLSetStateatrixParameter was introduced in Cg 1.1.

SEE ALSO
     cgGLSetMatrixParameter, cgGLGetMatrixParameter






Cg Toolkit 2.1            Last change:                          2