Windows Dev Center

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ModifyWorldTransform function

The ModifyWorldTransform function changes the world transformation for a device context using the specified mode.

Syntax


BOOL ModifyWorldTransform(
  _In_  HDC   hdc,
  _In_  const XFORM *lpXform,
  _In_  DWORD iMode
);

Parameters

hdc [in]

A handle to the device context.

lpXform [in]

A pointer to an XFORM structure used to modify the world transformation for the given device context.

iMode [in]

Specifies how the transformation data modifies the current world transformation. This parameter must be one of the following values.

ValueMeaning
MWT_IDENTITY

Resets the current world transformation by using the identity matrix. If this mode is specified, the XFORM structure pointed to by lpXform is ignored.

MWT_LEFTMULTIPLY

Multiplies the current transformation by the data in the XFORM structure. (The data in the XFORM structure becomes the left multiplicand, and the data for the current transformation becomes the right multiplicand.)

MWT_RIGHTMULTIPLY

Multiplies the current transformation by the data in the XFORM structure. (The data in the XFORM structure becomes the right multiplicand, and the data for the current transformation becomes the left multiplicand.)

 

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The ModifyWorldTransform function will fail unless graphics mode for the specified device context has been set to GM_ADVANCED by previously calling the SetGraphicsMode function. Likewise, it will not be possible to reset the graphics mode for the device context to the default GM_COMPATIBLE mode, unless world transform has first been reset to the default identity transform by calling SetWorldTransform or ModifyWorldTransform.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Coordinate Spaces and Transformations Overview
Coordinate Space and Transformation Functions
GetWorldTransform
SetWorldTransform
SetGraphicsMode
XFORM

 

 

Community Additions

Show:
© 2015 Microsoft