Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 8 - QuickDraw GX Mathematics / QuickDraw GX Mathematics Reference

Mapping Functions / Manipulating and Applying Mappings

NormalizeMapping

You can use the NormalizeMapping function to normalize a mapping.

gxMapping *NormalizeMapping(gxMapping *target);

*target

A pointer to the mapping to be normalized. On return, it is the normalized mapping.

function result

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

DESCRIPTION

The NormalizeMapping function normalizes the target mapping. If the mapping's perspective elements (u and v) are 0, each element of the mapping is divided by element w (target->[2][2]). If the mapping has a nonzero perspective, each element is shifted to ensure that fract1/2 < |u| + |v| +(|w| >> 15) < =fract1.

ERRORS, WARNINGS, AND NOTICES

Errors

mapping_is_nil