NAME

fontswap_term0 − replace a Term0 font

SYNOPSIS

int fontswap_term0(fd,newpath,oldid);
int fd;
char *newpath;
int oldid;

DESCRIPTION

fd is an integer file descriptor for an opened Term0 window type device interface. 

newpath
path name to the new font.

oldid identifies the old font to be replaced. 

DISCUSSION

This routine causes the old TERM0 font with font id of oldid to be removed and replaced by a new one specified by newpath. 

All characters displayed in the old font are changed to use the new font.  If the old font was the base font, the new font becomes the base font.  If the old font was the alternate font and the new font is not a HP-15 (2-byte) font, the new font becomes the alternate font.  If the new font is a HP-15 font, an error will occur and the fonts will not be swapped.  HP-15 fonts cannot be the alternate font.  The font id of the new font is returned. 

HARDWARE DEPENDENCIES

Series 500:
Term0 routines do not support HP-15 (2-byte) fonts on Series 500.

SEE ALSO

fontload_term0(3W),fontreplaceall_term0(3W). 

DIAGNOSTICS

A return value of -1 indicates failure.  Otherwise, the fontid is returned.  It is an error for newpath to be NULL.  See errno(2) for more information.

Hewlett-Packard Company  —  HP-UX Release 8.0: January 1991