TRANSFORM_CTM

short Escape(hdc, TRANSFORM_CTM, 36,lpMatrix, NULL)

The TRANSFORM_CTM printer 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).

Parameters

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.

Return Value

The return value is nonzero if the escape was successful and zero if it was unsuccessful.

Comments

This escape is used only by PostScript printer drivers.

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.