NAME

SET VIEW INDEX − create a structure element containing a view index attribute

SYNOPSIS

C Syntax

void
pset_view_ind ( index )
Pintindex;view index

Required PHIGS Operating States

(PHOP, ∗, STOP, ∗)

DESCRIPTION

Purpose

SET VIEW INDEX creates a structure element containing a view index number, which selects an entry from the workstation’s view table.  The view representation selected maps primitives from World Coordinates to Normalized Projection Coordinates.  This attribute applies to all output primitives. 

If the current edit mode is INSERT, a SET VIEW INDEX element is inserted into the currently open structure after the element pointed to by the current element pointer. If the edit mode is REPLACE, the new SET VIEW INDEX element replaces the element pointed to by the element pointer.  In either case, the element pointer is updated to point to the new element. 

C Input Parameter

indexA view index for a view representation on the workstation. 

Execution

When the SET VIEW INDEX element is traversed, the ‘current view index’ value is set to the view index, which specifies an entry from the workstation’s view table.  The default view index is 0, and if the view index specified is not available on the workstation, view index 0 will be used. 

The view representation maps output primitives from World Coordinates to Normalized Projection Coordinates by:

•Applying a view orientation matrix to transform the primitives to the Viewing Reference Coordinate system (VRC),

•Applying a view mapping matrix to transform the primitives to the Normalized Projection Coordinate system (NPC), and

•Optionally clipping the primitives to specified clipping limits in NPC according to separate clipping indicators for the x, y, and z dimensions. 

A view representation is set using SET VIEW REPRESENTATION or SET VIEW REPRESENTATION 3.  See the descriptions of these functions for more information on the representations and their default values. 

ERRORS

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

114Ignoring function, the view index value is less than zero

SEE ALSO

SET VIEW REPRESENTATION (3P)
SET VIEW REPRESENTATION 3 (3P)

September 02, 1992