CombineTransform function (wingdi.h)

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

Syntax

BOOL CombineTransform(
  [out] LPXFORM     lpxfOut,
  [in]  const XFORM *lpxf1,
  [in]  const XFORM *lpxf2
);

Parameters

[out] lpxfOut

A pointer to an XFORM structure that receives the combined transformation.

[in] lpxf1

A pointer to an XFORM structure that specifies the first transformation.

[in] lpxf2

A pointer to an XFORM structure that specifies the second transformation.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

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.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

Coordinate Space and Transformation Functions

Coordinate Spaces and Transformations Overview

GetWorldTransform

ModifyWorldTransform

SetWorldTransform

XFORM