EVALUATE VIEW MAPPING MATRIX

PEVAL_VIEW_MAP_MATRIX

CALL SEQUENCE

void peval_view_map_matrix(

const Pview_map	*mapping	/* view mapping	*/
Pint	*error_ind	/* (out) error indicator	*/
Pmatrix	result	/* (out) view mapping matrix	*/

)

TYPES

typedef struct {
	Plimit 	win;	/* window limits in VRC	*/
	Plimit	proj_vp;	/* viewport limits in NPC	*/
} Pview_map;

typedef Pfloat Pmatrix[3][3];

typedef struct {
	Pfloat	x_min;	/* minimum x 	*/
	Pfloat	x_max;	/* maximum x 	*/
	Pfloat	y_min;	/* minimum y 	*/
	Pfloat	y_max;	/* maximum y 	*/
} Plimit;

PHIGS STATE

EFFECT

Returns a homogeneous 3 x 3 matrix allowing a 2D view reference coordinate (VRC) space window to be projected into a 2D viewport in normalized projection coordinate (NPC) space.

The window defined in VRC is a rectangle parallel to the U and V axes with coordinate N = 0.

The viewport into which the window is projected is defined by mapping in NPC. The viewport is a rectangle defined in NPC where Z = 0 and the sides are parallel to the X and Y axes.

ERRORS

2

Ignoring function, function requires state (PHOP, *,*,*)

151

Ignoring function, invalid window: XMIN>>=XMAX, YMIN>>=YMAX, ZMIN>>ZMAX, UMIN>>=UMAX or VMIN>>=VMAX

152

Ignoring function, invalid viewport: XMIN>>=XMAX, YMIN>>=YMAX or ZMIN>>ZMAX

155

Ignoring function, the projection viewport limits are not within NPC range

SEE ALSO

set view representation, evaluate view orientation matrix