NAME

VI_Font, VI_GetFont, VI_DropFont − select and manipulate fonts

SYNOPSIS

VI_Font(fontid)
int fontid;/∗ font ID ∗/

VI_GetFont(name,fontid)
char ∗name;/∗ font name ∗/
short ∗fontid;/∗ font ID ∗/

VI_DropFont(fontid)
int fontid;/∗ ID of font to release ∗/

DESCRIPTION

Fonts are stored in files, which are loaded into the workstation memory when requested by applications using VI_GetFont.  Once a font is loaded, it is kept in memory until the program ends, unless explicitly dropped with VI_DropFont. 

VI_GetFontLoads the specified font into memory, if it is not already present.  If the font is successfully loaded, the font ID is returned.  Setting the current font to this ID with VI_Font causes subsequent strings to be displayed in the font. 

VI_FontSelects the font with the specified font ID.  Font IDs range from 0 to 255 and are returned by calls to VI_GetFont. 

VI_DropFontDrops the specified font from memory.  The application should not attempt to use the font ID again.  If the font is required, a new font ID should be generated by a request to VI_GetFont. 

NOTE

VI_Font applies only to the IBM Academic Information Systems experimental display. 

SEE ALSO

string(3G)

DIAGNOSTICS

If VI_GetFont returns a font ID of 0, either the font could not be found, or it did not fit in memory.  If the font did not fit in memory, a message will be sent to stderr. 

PRPQs 5799-WZQ/5799-PFF: IBM/4.3  —  30 Sep 1985