graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQFO - Inquire Active Fonts

GPQFO (wsid, start, number, errind, nfont, lcsid, lfont)

Note:

This subroutine is a Workstation State List (WSL) inquiry. For an overview, see "WSL Inquiries"

Purpose

Use GPQFO to inquire the currently active geometric character set and font identifiers, that is, the geometric font pool contents, for the specified workstation.

The graPHIGS API returns data indicating the total quantity of active geometric fonts and their character set and font identifiers.

If the inquired information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the error indicator is 543 (the start value exceeds the extent of the available data), then only the total number (totnum) parameter is set. If the inquired information is unavailable, then the error indicator (errind) contains an error number indicating the reason, and the values returned in the output parameters are unpredictable.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

start -- specified by user, fullword integer

Starting member of the list of active fonts (>=1)

number -- specified by user, fullword integer

Number of active fonts requested (>=0)

errind -- returned by the graPHIGS API, fullword integer

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

25: SPECIFIED WORKSTATION DOES NOT EXIST
538: START VALUE < ONE
539: REQUESTED NUMBER < ZERO
543: START EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED

nfont -- returned by the graPHIGS API, fullword integer

Total number of active geometric fonts.

lcsid -- returned by the graPHIGS API, array of fullword integers.

List of active geometric character set identifiers. The output array must be large enough to contain the requested data.

See Appendix A. "Character Set and Font Identifiers" for more information.

lfont -- returned by the graPHIGS API, array of fullword integers.

List of active geometric fonts. The output array must be large enough to contain the requested data.

Note: Entry x of the lcsid list and entry x of the lfont list combine to describe entry x of the active geometric font pool on the specified workstation.

Error Codes

None

Related Subroutines

GPACFO: Activate Font
GPDAFO: Deactivate Font
GPLDFO: Load Font

RCP code

201336598 (X'0C002716')