graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQART - Inquire Rendering Targets

GPQART (wstype, errind, totnum)

Note:

This subroutine is a Workstation Description Table (WDT) inquiry. For an overview, see "WDT Inquiries"

Purpose

Use GPQART to inquire the number of rendering targets that are available on the specified workstation for explicit control by an application. A rendering target is a repository for the 'picture' produced by rendering primitives and their attributes. Rendering targets may be frame buffers or disk files. Implicit in the workstation type is the type of rendering target that is available on the workstation. A workstation does not support multiple types of rendering targets.

Each available rendering target on a workstation has an associated identifier. The identifiers are from one to totnum (which is the total number of rendering targets available on the workstation). When you open a workstation, the current displayed rendering target and the current selected rendering target are the same.

Parameters

wstype -- specified by user, 8-byte character string

Workstation type.

errind -- specified by user, fullword integer

Error indicator. If the error indicator is zero, the request has been completed. Otherwise, one of the following errors exists:

23: SPECIFIED WORKSTATION TYPE DOES NOT EXIST
548: SPECIFIED WORKSTATION TYPE CANNOT BE LOADED

totnum -- returned by the graPHIGS API, fullword integer

Total number of rendering targets available for explicit control by the application. (Zero indicates that there are no rendering targets are available for explicit control by the application.)

Error Codes

None

Related Subroutines

None

RCP code

201339415 (X'0C003217')