gpi12.hlp (Table of Contents; Topic list)
GpiQueryDefaultViewMatrix (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPITRANSFORMS
 
BOOL GpiQueryDefaultViewMatrix(hps, cElements, pmatlf)
HPS hps;             /* presentation-space handle                      */
LONG cElements;      /* number of elements                             */
PMATRIXLF pmatlf;    /* address of structure for transformation matrix */
 
The GpiQueryDefaultViewMatrix function retrieves the current default viewing
transformation.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
cElements  Specifies the number of elements in the transformation to
           retrieve. It must be an integer in the range 0 through 9.
 
pmatlf     Points to a MATRIXLF structure that receives the elements of the
           default viewing transformation matrix.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
the following:
 
     PMERR_INV_HPS
     PMERR_INV_LENGTH_OR_COUNT
     PMERR_PS_BUSY
 
See Also
 
GpiSetDefaultViewMatrix, MATRIXLF