Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPITRANSFORMS
 
BOOL GpiQuerySegmentTransformMatrix(hps, idSegment, cElements, pmatlf)
HPS hps;             /* presentation-space handle                */
LONG idSegment;      /* segment identifier                       */
LONG cElements;      /* number of elements                       */
PMATRIXLF pmatlf;    /* address of structure for matrix elements */
 
The GpiQuerySegmentTransformMatrix function retrieves one or more elements
of the segment-transformation matrix for the segment specified by
idSegment.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hps        Identifies the presentation space.
 
idSegment  Specifies the segment identifier.
 
cElements  Specifies the number of elements to retrieve. It must be an
           integer value in the range 0 through 9.
 
pmatlf     Points to the MATRIXLF structure that receives the 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
one of the following:
 
     PMERR_INV_HPS
     PMERR_INV_LENGTH_OR_COUNT
     PMERR_INV_MICROPS_FUNCTION
     PMERR_INV_SEG_NAME
     PMERR_PS_BUSY
     PMERR_SEG_NOT_FOUND
 
See Also
 
GpiSetSegmentTransformMatrix, WinGetLastError, MATRIXLF
 
                                      ♦