Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 8 - QuickDraw GX Mathematics / QuickDraw GX Mathematics Reference

Mapping Functions / Modifying Mappings

MoveMappingTo

You can use the MoveMappingTo function to assign specific values to the horizontal and vertical translation factors of a mapping.

gxMapping *MoveMappingTo(gxMapping *target, Fixed hPosition, 
                           Fixed vPosition);

target

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

hPosition

The horizontal translation to be assigned to the target mapping.

vPosition

The vertical translation to be assigned to the target mapping.

function result

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

DESCRIPTION

The MoveMappingTo function postmultiplies the target mapping by a mapping that assigns hPosition to the x translation and vPosition to the y translation of the target mapping. This function sets the translational origin of the mapping; the point (0, 0), when postmultiplied by the mapping that results from this function, will be at location (hPosition, vPosition).

ERRORS, WARNINGS, AND NOTICES

Errors

mapping_is_nil

SEE ALSO

The use of the MoveMappingTo function is described in the section "Translation to a Specified Point" beginning on page 8-18.