graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPLDFO - Load Font

GPLDFO (fdid, csid, font, option)

Purpose

Use GPLDFO to load a font definition of a geometric text font to the specified font directory. The specified character set/font pair is taken from a disk accessible by the graPHIGS API shell and sent to the specified font directory in the nucleus. If the specified font definition already exists in the font directory, it is replaced by the new one.

Once a font definition of a geometric text font is loaded in the font directory, and the font directory has been associated to a workstation, the character set/font pair may be activated to a workstation. Font definitions that reside in a font directory take precedence over font definitions that are accessible by the nucleus when they are activated to the workstation. Font directories are primarily intended for networked environments.

Parameters

fdid -- specified by user, fullword integer

Font directory 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)

option -- specified by user, fullword integer

Font option (2=IBM_DEFINED_RANGE,3=USER_DEFINED_RANGE ) This parameter specifies what portion of the font definition should be loaded and has its meaning only for the IBM defined double byte character sets. For other character sets, this parameter is ignored.

Error Codes

75: TEXT FONT VALUE IS INVALID
242: SPECIFIED FONT DIRECTORY DOES NOT EXIST
245: FONT OPTION IS INVALID
542: CHARACTER SET IDENTIFIER IS INVALID

Related Subroutines

GPACFO: Activate Font
GPAFDW: Associate Font Directory with Workstation
GPCRFD: Create Font Directory
GPDLFO: Delete Font

RCP code

201345281 (X'0C004901')