CombineTransform

The CombineTransform function concatenates two world-space to page-space transformations.

BOOL CombineTransform(
  LPXFORM lpxformResult,  // pointer to combined transformation
  CONST XFORM *lpxform1,  // pointer to first transformation
  CONST XFORM *lpxform2   // pointer to second transformation
);
 

Parameters

lpxformResult

Pointer to an XFORM structure that receives the combined transformation.

lpxform1

Pointer to an XFORM structure that identifies the first transformation.

lpxform2

Pointer to an XFORM structure that identifies the second transformation.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Windows NT: To get extended error information, call GetLastError.

Remarks

Applying the combined transformation has the same effect as applying the first transformation and then applying the second transformation.

The three transformations need not be distinct. For example, lpxform1 can point to the same XFORM structure as lpxformResult.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Coordinate Spaces and Transformations Overview, Coordinate Space and Transformation Functions, GetWorldTransform, ModifyWorldTransform, SetWorldTransform, XFORM