The graPHIGS Programming Interface : Subroutine Reference

Chapter 11. Font Subroutines

Font subroutines let the application program manage a workstation's font resources.

Through the use of Font directories, fonts may be loaded to the directory and shared by workstation resources.

GPACFO - Activate Font

GPACFO (wsid, csid, font)

Purpose

Use GPACFO to activate a geometric text font to the specified workstation. If the specified character set/font pair is already active, this subroutine is ignored.

The character set/font pair is searched for first in the font directory associated with the workstation (if one exists) and then in the nucleus font disk system.

Activation of a character set/font readies it for use by text primitives. Font 1 of the primary character set is always active.

The maximum number of simultaneously active fonts on a workstation is determined by the workstation's font pool size. For more information on available fonts, see The graPHIGS Programming Interface: Technical Reference

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

csid -- specified by user, fullword integer

Character set identifier.

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

font -- specified by user, fullword integer

Font number (>=1)

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
75: TEXT FONT VALUE IS INVALID
542: CHARACTER SET IDENTIFIER IS INVALID
559: FONT POOL SIZE EXCEEDED ON WORKSTATION
563: CHARACTER SET/FONT COMBINATION IS NOT AVAILABLE FOR GEOMETRIC TEXT
647: UNICODE IS NOT SUPPORTED ON THE SPECIFIED WORKSTATION

Related Subroutines

GPDAFO: Deactivate Font
GPLDFO: Load Font
GPQFO: Inquire Active Fonts
GPQFP: Inquire Font Pool Size

RCP code

201337346 (X'0C002A02')