Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 8 - QuickDraw GX Mathematics / QuickDraw GX Mathematics Reference

Mapping Functions / Modifying Mappings

MoveMapping

You can use the MoveMapping function to change the horizontal and vertical translation factors of a mapping by given amounts.

gxMapping *MoveMapping(gxMapping *target, Fixed hOffset, 
                        Fixed vOffset);

target

A pointer to the mapping to be modified. On return, points to the modified mapping.

hOffset

The horizontal translation to add to the mapping.

vOffset

The vertical translation to add to the mapping.

function result

A pointer to the modified mapping, which is also the target mapping.

DESCRIPTION

The MoveMapping function postmultiplies the target mapping by a mapping that adds hOffset to the x translation and vOffset to the y translation of the target mapping.

Passing the result of this function to the GXMapShape function is equivalent to calling the GXMapShape function and then calling the GXMoveShape function.

ERRORS, WARNINGS, AND NOTICES

Errors

mapping_is_nil

SEE ALSO

The use of the MoveMapping function is described in the section "Translation by a Relative Amount" beginning on page 8-17.

The GXMapShape and GXMoveShape functions are described in the chapter "Transform Objects" in Inside Macintosh: QuickDraw GX Objects.