short Escape(hDC, TRANSFORM_CTM, 36,lpMatrix, NULL)
This escape modifies the current transformation matrix. The current transformation matrix controls the manner in which coordinates are translated, rotated, and scaled by the device. By using matrices, you can combine these operations in any order to produce the desired mapping for a particular picture.
The new current transformation matrix will contain the product of the matrix referenced by the lpMatrix parameter and the previous current transformation matrix (CTM = M * CTM).
| Parameter | Type/Description |
| hDC | HDC Identifies the device context. | |
| lpMatrix | LPSTR Points to a 3-by-3 array of 32-bit integer values specifying the new transformation matrix. Entries in the matrix are scaled to represent fixed-point real numbers. Each matrix entry is scaled by 65,536. The high-order word of the entry contains the whole integer portion, and the low-order word contains the fractional portion. |
The return value is TRUE if the escape was successful and FALSE if it was unsuccessful.
When an application modifies the current transformation matrix, it must specify the clipping rectangle by issuing the SET_CLIP_BOX escape.
Applications should not make any assumptions about the initial value of the current transformation matrix.
The matrix specification used for this escape is based on the Microsoft OS/2 Presentation Manager graphics programming interface (GPI) model, which is an integer-coordinate system similar to the one used by GDI.