RESTORE_CTM

Syntax

short Escape(hDC, RESTORE_CTM, NULL, NULL, NULL)

This escape restores the previously saved current transformation matrix.

The current transformation matrix controls the manner in which coordinates are translated, rotated, and scaled by the device. By using matrices, an application can combine these operations in any order to produce the desired mapping for a particular picture.

Parameter Type/Description  

hDC HDC Identifies the device context.  

Return Value

The return value specifies the number of SAVE_CTM escape calls without a corresponding RESTORE_CTM call. If the escape is unsuccessful, the return value is –1.

Comments

Applications should not make any assumptions about the initial contents of the current transformation matrix.

This escape uses a matrix specification based on the Microsoft OS/2 Presentation Manager graphics programming interface (GPI) model, which is an integer-coordinate system similar to the system which GDI uses.