int PEXXCToNPCTransform( PEXNPCSubVolume *npc_sub_volume, PEXDeviceCoord *viewport, unsigned int window_height, PEXMatrix transform_return )
Zero if successful; otherwise, one of the following:
Invoke PEXXCToNPCTransform compute a transformation matrix to map a drawable point (XC) to NPC coordinates, using the specified NPC subvolume, DC viewport, and drawable height.
The returned transformation matrix first transforms the x and y coordinates of points to device coordinates (DC), leaving the z coordinate unmodified. It then applies the viewport-to-subvolume transformation to all coordinates of the resulting points, producing three-dimensional NPC points.
When specifying NPC and DC, the x, y and z limits must be as follows:
xmin < xmax, ymin < ymax, zmin <= zmax
None.
For a list of miscellaneous transformation utilities, see Miscellaneous Transformation Utilities. For a list of related topics, see PEXlib Utilities.