[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPCRFD - Create Font Directory

GPCRFD (fdid, ncid, fdtype, fddesc)

Purpose

Use GPCRFD to create a font directory and attach it to your application. A font directory allows your application to send geometric text font files to a nucleus. The graPHIGS API uses these files to display geometric text on a workstation. (To accomplish this, your application must also associate the font directory to the workstation and activate the font on the workstation)

This subroutine is not required unless your application needs to replace the font files of the nucleus. By default, a workstation has access to the font files that reside on the nucleus. When overriding a nucleus font file, your application creates a font directory to store the font file that is to be loaded from your application's set of fonts. (For more information about fonts, see The graPHIGS Programming Interface: Understanding Concepts

Parameters

fdid -- specified by user, fullword integer

Font directory identifier.

ncid -- specified by user, fullword integer

Nucleus identifier.

fdtype -- specified by user, fullword integer

Font directory type (1=NORMAL )

fddesc -- specified by user, variable data

Font directory descriptor. This parameter includes font directory type dependent data. For the font directory type set to 1=NORMAL , no descriptive data is required; therefore, this parameter must be specified with a value of zero.

Error Codes

202
SPECIFIED NUCLEUS DOES NOT EXIST
217
RESOURCE CREATION REQUEST EXCEEDS NUCLEUS TABLE CAPACITY
241
SPECIFIED FONT DIRECTORY IDENTIFIER ALREADY IS IN USE
243
SPECIFIED FONT DIRECTORY TYPE IS NOT SUPPORTED

Related Subroutines

GPACFO
Activate Font
GPAFDW
Associate Font Directory with Workstation
GPDTR
Detach Resource
GPLDFO
Load Font
GPQNCR
Inquire Nucleus Resource Identifier

RCP code

201341185 (X'0C003901')


[ Previous | Next | Contents | Glossary | Home | Search ]