designate_character_set(3G)
NAME
designate_character_set − associate a G-set with a character set.
SYNOPSIS
C Syntax:
void designate_character_set ( fildes, chset, gset );
int fildes, gset;
char *chset;
FORTRAN77 Syntax:
subroutine designate_character_set ( fildes, chset, gset )
integer*4 fildes, gset
character*(*) chset
Pascal Syntax:
procedure designate_character_set ( fildes:integer;
chset:string255; gset:integer );
DESCRIPTION
Input Parameters
fildes Integer file descriptor returned by gopen when an I/O path to a graphics device is opened.
chset Name of a character set’s directory.
gset Selects one of the four G-sets (0 - 3). G-sets are discussed in the Starbase Graphics Techniques manual.
Discussion
designate_character_set inserts the string <sb-font> in front of the character set directory name specified by the chset parameter (the actual path names of the directories in angle brackets in this section depend on the file system structure; see the Graphics Administration Guide for details). The resulting path name is used to identify the character set to be associated with the G-set specified by the gset parameter.
The following character sets are supported by Starbase:
| chset | Name | Pathname |
| usascii | USASCII | <sb-font>/usascii |
| jisascii | JISASCII | <sb-font>/jisascii |
| katakana | Katakana | <sb-font>/katakana |
| hproman | HP Roman | <sb-font>/hproman |
| japanese | HP-15 Japanese | <sb-font>/japanese |
| japanese.euc | EUC Japanese | <sb-font>/japanese.euc |
| korean | Korean | <sb-font>/korean |
| chinese-s | Simplified Chinese | <sb-font>/chinese-s |
| chinese-t | Traditional Chinese | <sb-font>/chinese-t |
The actual path name for the font to be used is the concatenation of the character set path name and the font index. The font index is specified by the text_font_index procedure. This implies that the character set path name is a directory.
When the text switching mode is HP_8BIT, and the encoding scheme of the character set is HP_8BIT, only G0 and G1 can be set. The character sets for Asian languages (e.g., chinese-s, chinese-t, japanese, korean) are available from Hewlett-Packard as separate products except JISASCII and Katakana. JISASCII and Katakana are standard products of Starbase. Instead of using designate_character_set, selecting the character set is possible by defining a user-definable defaults file. See defaultsfile(4).
DEFAULTS
G0, G2 USASCII (as set in /etc/opt/starbase/defaults).
G1, G3 HP ROMAN (as set in /etc/opt/starbase/defaults).
SEE ALSO
Starbase Reference: text_font_index(3G), text_switching_mode(3G). Starbase Graphics Techniques: "Using Starbase Text". "Using Starbase Text".
Hewlett-Packard Company — November 03, 1994