[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPVCH - Set View Characteristics

GPVCH (wsid, view, window, near, far, shield, shldci, border, brdrci, active)

Purpose

Use GPVCH to set the characteristics of the specified view. These characteristics include: clipping indicators, appearance of the viewport, and a value indicating whether or not the view is displayed.

The values specified are stored in the requested view table entries. The corresponding current values in the view table entry are set to the requested values when the workstation is updated.

The clipping indicators determine to which boundaries the contents of the view are clipped. The shielding indicator determines whether the content of lower priority views may be displayed within the boundaries of the specified view. The border indicator and color specify whether a border is to be drawn around the viewport, and if it is, its color. The view active flag determines whether the view and its contents are displayed.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

view -- specified by user, fullword integer

View index (>=1) Index of view table entry to be loaded.

window -- specified by user, fullword integer

Window clipping indicator (1=NOCLIP, 2=CLIP )

near -- specified by user, fullword integer

Near clipping indicator (1=NOCLIP, 2=CLIP )

far -- specified by user, fullword integer

Far clipping indicator (1=NOCLIP, 2=CLIP )

shield -- specified by user, fullword integer

Shielding indicator (1=OFF, 2=ON )

shldci -- specified by user, fullword integer

Shielding color index (>=0)

border -- specified by user, fullword integer

View border indicator (OFF, 2=ON )

brdrci -- specified by user, fullword integer

Border color index (>=0)

active -- specified by user, fullword integer

View active flag for output (1=INACTIVE, 2=ACTIVE )

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
59
VIEW INDEX VALUE < ZERO
92
COLOR INDEX < ZERO
93
COLOR INDEX VALUE(S) EXCEED WORKSTATION TABLE CAPACITY
323
VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
332
CLIP INDICATOR VALUE IS INVALID
507
SHIELDING INDICATOR VALUE IS INVALID
508
VIEW ACTIVE FLAG VALUE IS INVALID
518
VIEW ZERO CANNOT BE MODIFIED
547
VIEW BORDER INDICATOR IS INVALID

Related Subroutines

GPXVR
Set Extended View Representation

RCP code

201330433 (X'0C000F01')


[ Previous | Next | Contents | Glossary | Home | Search ]