NAME
xutops - configuration file format.
AVAILABILITY
SUNWulec
DESCRIPTION
The following describes the format and contents of the con-
figuration file for xutops(1).
Lines must begin with a valid keyword (directive). Argu-
ments to a keyword must appear on the same line as the key-
word. Line that begin with a # character are treated as a
comment. Numeric arguments that begin with 0x are inter-
preted as hexadecimal, with a leading 0 as octal, otherwise
as decimal. The following is a list of valid keywords and
their meaning.
mapfont label file
Associates the font identified by file with the label
label. Mapfont entries must proceed mapucs2 and
cnvucs2 entries.
mapucs2 m n label
Maps a range of UCS-2 values as specified by m,n to the
font identified by label. You may specificy '-' for n
if n is the same as m.
cnvucs2 label function shared-object-file
Identifies the name of a function which can be found in
the shared-object-file to be used for converting UCS-2
values to X11 bitmap font indexes for the font identi-
fied by label.
pointsize n
Sets the default point-size to n points. By default the
point-size is set to 10.
tabstops n
Sets tabstops to every n character positions.
spacingchar n
Defines the UCS-2 value which will be interpreted as
the spacing-character. When encountered, the output-
point will be moved forward by the width of the spacing
character. The width of the spacing-character is taken
from metric information supplied by the font. For
aligning the output, spacing-character width is taken
as the base width for characters, overriding the width
information obtained from the character metrix for each
font. Single column characters will be of the exact
width as that of spacingchar and double column
characters double the width. By default the spacing-
character is defined as the SPACE character (UCS-2
0x20).
spacingwidth n
Explicitly defines the value of the spacing-character's
spacing-width. This value overrides the metric infor-
mation supplied by the font for the spacing-character.
Usage of this option should be cautiously exercised as
spacingwidth is the base width of all other characters.
referencechar n
Defines the UCS-2 value to use as the reference charac-
ter. By default this is defined to be UCS-2 value 0x20,
the SPACE character. If the available fonts do not
define the SPACE character, you must select another
character which is defined. Which one is selected is
irrelevant providing its font metrics are correct.
nobitmapRC n
Defines the no-bitmap-replacement character as the
character that corresponds to the UCS-2 value specified
by n.
undefinedRC n
Defines the undefined-ucs2-replacement character as the
character that corresponds to the UCS-2 value specified
by n.
illegalucs2RC n
Defines the illegal-ucs2-replacement character as the
character that corresponds to the UCS-2 value specified
by n.
nonidenticalRC n
Defines the non-identical-replacement character as the
character that corresponds to the UCS-2 value specified
by n.
nongraphicalRC n
Defines the non-graphical-replacement character as the
character that corresponds to the UCS-2 value specified
by n.
The following is an example configuration file:
pointsize 10
tabstops 8
spacingchar 0x20
referencecharr 0x20
nobitmapRC 0x3f
undefinedRC 0x2d
illegalucs2RC 0x3f
illegalutf8RC 0x3f
nonidenticalRC 0x3f
nongraphicalRC 0x3f
#
# mapfont entries have to be specified before mapucs2 and cnvucs2 entries.
#
mapfont iso88591 /usr/openwin/lib/X11/fonts/75dpi/courR18.pcf.Z
mapfont iso88592 /usr/openwin/lib/locale/iso_8859_2/X11/fonts/75dpi/CourierCE18.pcf.Z
mapfont iso88594 /usr/openwin/lib/locale/iso_8859_4/X11/fonts/75dpi/LucidaSansTypBal12.pcf.Z
mapfont iso88595 /usr/openwin/lib/locale/iso_8859_5/X11/fonts/75dpi/CourierCY18.pcf.Z
mapfont iso88597 /usr/openwin/lib/locale/iso_8859_7/X11/fonts/75dpi/CourierGrk18.pcf.Z
mapfont iso88599 /usr/openwin/lib/locale/iso_8859_9/X11/fonts/75dpi/CourierTu18.pcf.Z
mapfont jisx0201 /usr/openwin/lib/locale/ja/X11/fonts/75dpi/gotmrk24.pcf.Z
mapfont jisx0208 /usr/openwin/lib/locale/ja/X11/fonts/75dpi/gotm24.pcf.Z
mapfont johap92 /usr/openwin/lib/locale/ko.UTF-8/X11/fonts/75dpi/rgothic24.pcf.Z
mapfont gb2312 /usr/openwin/lib/locale/zh/X11/fonts/75dpi/song24.pcf.Z
mapfont big5 /usr/openwin/lib/locale/zh_TW.BIG5/X11/fonts/75dpi/Ming-Light-big5-24.pcf.Z
mapfont fallback /usr/openwin/lib/locale/en_US.UTF-8/X11/fonts/misc/splmt24.pcf.Z
mapucs2 0x0000 0x00FF iso88591
mapucs2 0x0100 0x0101 iso88594
mapucs2 0x0102 0x0107 iso88592
mapucs2 0x0108 0x010B fallback
mapucs2 0x010C 0x0111 iso88592
mapucs2 0x0112 - fallback
mapucs2 0x0113 - gb2312
mapucs2 0x0114 0x0117 fallback
mapucs2 0x0118 0x011B iso88592
mapucs2 0x011C 0x011D fallback
mapucs2 0x011E 0x011F iso88599
mapucs2 0x0120 0x0125 fallback
mapucs2 0x0126 0x0127 johap92
mapucs2 0x0128 0x012A fallback
mapucs2 0x012B - gb2312
mapucs2 0x012C 0x012F fallback
mapucs2 0x0130 0x0131 iso88599
mapucs2 0x0132 0x0133 johap92
mapucs2 0x0134 0x0137 fallback
cnvucs2 iso88591 _xuiso88591 /usr/lib/lp/locale/en_US.UTF-8/xutops/xuiso88591.so
cnvucs2 iso88592 _xuiso88592 /usr/lib/lp/locale/en_US.UTF-8/xutops/xuiso88592.so
cnvucs2 iso88594 _xuiso88594 /usr/lib/lp/locale/en_US.UTF-8/xutops/xuiso88594.so
cnvucs2 iso88595 _xuiso88595 /usr/lib/lp/locale/en_US.UTF-8/xutops/xuiso88595.so
cnvucs2 iso88597 _xuiso88597 /usr/lib/lp/locale/en_US.UTF-8/xutops/xuiso88597.so
cnvucs2 iso88599 _xuiso88599 /usr/lib/lp/locale/en_US.UTF-8/xutops/xuiso88599.so
cnvucs2 big5 _xu2big5 /usr/lib/lp/locale/en_US.UTF-8/xutops/xubig5.so
cnvucs2 gb2312 _xu2gb2312 /usr/lib/lp/locale/en_US.UTF-8/xutops/xugb2312.so
cnvucs2 jisx0201 _xu2jis0201 /usr/lib/lp/locale/en_US.UTF-8/xutops/xujisx0201.so
cnvucs2 jisx0208 _xu2jis0208 /usr/lib/lp/locale/en_US.UTF-8/xutops/xujisx0208.so
cnvucs2 johap92 _xu2johap92 /usr/lib/lp/locale/en_US.UTF-8/xutops/xujohap92.so
cnvucs2 fallback _xu2fallback /usr/lib/lp/locale/en_US.UTF-8/xutops/xufallback.so
CONVERSION MODULES
The conversion module has one function that xutops will call
when it needs to convert a UCS-2 value. The value returned
by _function is used by xutops as an index into an X11 bit-
map font. The API for the function is:
int _function(ushort_t ucs2)
Xutops reserves the error return values -1 and -2, for the
error conditions 'IIllegal UCS-2 Value' and 'Non-Identical
Character', respectively (see xutops(1), Ignore and Replace
Options).
NOTES
A new conversion module called xufallback.so is added to the
default system configuration file, the purpose being to act
as a filler module in the existing config file for code
ranges which does not have fonts defined in the locale.
There are three different cases that the fallback module
handle:
single column substitution
If assigned for a codepoint which represent a single
column character in the Unicode standard and for which
no font is defined in the current locale, present a
single column width box character for that codepoint.
double column substitution
If assigned for a codepoint which represent a double
column character in the Unicode standard and for which
no font is defined in the current locale, present a
double column width box character for that codepoint.
no glyph substitution
If assigned for a codepoint which does not have a char-
acter defined in the Unicode standard, provide a
replacement character for that codepoint. Currently it
is a single column 'slashed box' character.
Within the code range contained by a fallback module, the
ignore/replace options given in the command line or replace-
ment options given within the configuration file will not
work.
SEE ALSO
xutops(1)
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |