Name

PEXNPCToXCTransform

Synopsis

int PEXNPCToXCTransform(PEXNPCSubVolume ∗npc_sub_volume, PEXDeviceCoord ∗viewport, unsigned int window_height, PEXMatrix transform_return)

Arguments

npc_sub_volume
A pointer to an NPC subvolume, typically that of a renderer resource

viewportAn array of two device coordinate points defining a viewport, typically that of a renderer resource.  The first point in the array is the lower-left corner of the viewport; the second point is the upper-right. 

window_height
The height of the drawable

transform_return
The returned transformation

Returns

Zero if successful; otherwise, one of the following:

PEXBadViewport - (xmin >= xmax, or ymin >= ymax, or zmin > zmax)
PEXBadSubVolume - (xmin >= xmax, or ymin >= ymax, or zmin > zmax)

Description

This function computes the transformation matrix to map an NPC point to a drawable coordinate (XC), using the specified NPC subvolume, DC viewport, and drawable height.  The returned transformation matrix first applies the subvolume-to-viewport transformation, then transforms the x and y coordinates of the resulting points to drawable coordinates, leaving the z coordinate in DC. 

When specifying NPC and DC, the X, Y and Z limits must be as follows:

xmin < xmax ,  ymin < ymax ,  zmin <= zmax

Errors

None

See Also

PEXNPCToXCTransform2D