Name

PEXViewMappingMatrix2D

Synopsis

int PEXViewMappingMatrix2D(PEXCoord2D ∗frame, PEXCoord2D ∗viewport, PEXMatrix3x3 matrix_return)

Arguments

framearray of 2 2D VRC locations which mark a rectangle to be mapped into the NPC subvolume. 

viewportarray of 2 2D NPC coordinates with z = 0 specifying lower left and upper right of the "viewport". 

matrix_return
matrix in which result is stored

Returns

Zero if successful; otherwise, one of the following:

PEXBadLimits
PEXBadViewport

Description

This function is a 2D shorthand version of PEXViewMappingMatrix with the following parameters assumed:

front plane distance = 1
back plane distance = 0
view plane distance = 0
viewport z range = [0,1]
projection type = parallel
x-y coordinates of projection reference point = center of view window,
    z coordinate = 1.0.

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

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

Errors

None

See Also

PEXViewMappingMatrix, PEXViewOrientationMatrix, PEXViewOrientationMatrix2D