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-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |