graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPVOP - Set View Output Priority

GPVOP (wsid, view, refview, flag)

Purpose

Use GPVOP to modify the output priority of the given view in relation to another view on the specified workstation.

The application draws the contents of the lower priority view before the contents of a higher priority view. The highest priority view defaults to a view of zero. This subroutine only changes the output priority of a view. This can produce visual changes on the display.

When the application updates the workstation, the graPHIGS API sets the current view output priority for the specified view to the requested values.

Note:

The Set View Priority (GPVP) subroutine is treated as a simultaneous invocation of the Set View Input Priority (GPVIP) and the Set View Output Priority (GPVOP) subroutines.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

view -- specified by user, fullword integer

View index (>=0)

refview -- specified by user, fullword integer

Reference view index (>=0)

flag -- specified by user, fullword integer

Relative priority of the specified view with respect to the reference view (1=HIGHER, 2=LOWER )

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
59: VIEW INDEX VALUE < ZERO
155: VIEW PRIORITY REFERENCE NUMBER IS INVALID
323: VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
333: RELATIVE VIEW PRIORITY VALUE IS INVALID

Related Subroutines

GPQRVO: Inquire Requested View Table Entries Output
GPVIP: Set View Input Priority
GPVP: Set View Priority

RCP code

201330691 (X'0C001003')