NAME xutops - UTF-8 to PostScript(Reg.) display support utility. AVAILABILITY SUNWulec SYNOPSIS xutops [options] [file] DESCRIPTION Xutops is used to prepare UTF-8 formatted data for display on PostScript compatible devices. If no file is specified, xutops reads from standard-in. Results are written to standard-out. By default, xutops assumes a paper (device) size of 8 1/2" x 11" inches, margins set 1/4" from the edges, and a point size of 10. The PostScript descriptions of characters generated by xutops are rendered using X11 PCF bitmap fonts. PCF font files may be either compressed or uncompressed. Both pro- portional and fixed fonts are supported. Xutops may be con- figured to support additional PCF fonts without having to recompile or relink xutops, for details, see xutops(5). The font used to render a particular UCS-2 character is described by mappings contained in xutops's configuration file (see, xutops(5)). The default configuration file is /usr/lib/lp/locale/locale-name/xutops/xutops.conf, where locale-name corresponds to the name of the user's current locale as determined by setlocale(3). If the file ~/.xutops/locale-name/xutops.conf exist, it will be used instead. OPTONS The follow options are supported by xutops. The option flag in parenthesis is an alias for the option flag being described. -configfile file (-cf): Use file as the configuration file for xutops. -landscape (-ls): Orient the output such that printing occurrs parallel to the longer edge of the paper. -locale locale (-lc): Use locale as the name of the locale in which xutops will run. Primarily for use with printing filters (see lp(1), lpfilter(1)). -tabstops n (-ts): Set tabstops to every n character positions. -paperwidth n (-pw): Describes the width of the paper as n inches -pageheigth n (-ph): Describes the height of the paper as n inches. -topmargin n (-tm): Set the top-margin n inches from the top of the paper. -botmargin n (-bm): Set the bottom-margin n inches from the bottom of the paper. -leftmargin n (-lm): Set the left-margin n inches from the left side of the paper. -rightmargin n (-rm): Set the right-margin n inches from the right side of the paper. -pointsize n (-ps): Set the point-size of the output text to be n points. -xscale n[+-] (-xs): The x-axis scale factor is set to n, where n is a real number. When n is followed by + or -, the computed x- axis scale factor is increased (+), or decreased (-), by n. This option can be used to correct for display peculiarites of the font and/or output device. -yscale n[+-] (-ys): Same as -xscale save that it applies to the y-axis. -charwidth n[+-] (-cw): The width metric information for each character will be set to n, where n is a real number. When n is followed by + or -, the supplied font metric width value is increased (+), or decreased (-) by n. -ignoreundef (-iu): Ignore UTF-8 sequences in the input stream which have not been mapped by a mapucs2 directive in the confi- guration file. -replaceundef [n] (-ru): Replace UTF-8 sequences in the input stream which have not been mapped by a mapucs2 directive in the confi- guration file with the undefined-ucs2-replacement char- acter. -ignoreillutf8 (-i8): Ignore illegal UTF-8 sequences in the input stream. -replaceillutf8 [n] (-r8): Replace illegal UTF-8 sequences in the input stream with the illegal-utf8-replacement character. -ignoreillucs2 (-i2): Ignore UTF-8 sequences in the input stream which map to illegal UCS-2 values. -replaceillucs2 [n] (-r2): Replace the UTF-8 sequence in the input stream which maps to an illegal UCS-2 value with the illegal-ucs2- replacement character. -ingorenobitmap (-ib): Ignore UTF-8 sequences in the input stream for which there is no bitmap defined in an X11 bitmap font. -replacenobitmap [n] (-rb): Replace UTF-8 sequences in the input stream for which there is no bitmap defined in an X11 bitmap font with the no-bitmap-replacement character -ignorenonident (-in): Ignore a UTF-8 sequence in the input stream which does not map to an identical character in the corresponding font. -replacenonident [n] (-rn): Replace a UTF-8 sequence in the input stream which does not map to an identical character in the corresponding font with the non-identical-replacement character. -ignorenongraph (-ig): Ignore UTF-8 sequences in the input stream which map to non-graphical (non-printing) characters. -replacenongraph [n] (-rg): Replace UTF-8 sequences in the input stream which map to non-graphical (non-printting) characters with the non-graphical-replacement character. USAGE Ignore and Replace Options Xutops recognizes a number of error conditions that can arise with respect to the UTF-8 input stream. In such cases xutops will take one of three actions. 1) Report the error condition and exit. This is the defaul action. 2) Ignore the error condition and begin processing of the next UTF-8 input sequence. 3) Replace the offending UTF-8 input sequence with a replacement character. Each of the error conditions may have a unique replacement character. By default, the '-' charac- ter is used as the replacement character. If the replacment character cannot be substituted, xutops will exit with an error. The error conditions for which ignore and replace options apply are the following: Illegal UTF-8 Sequence: This condition arises when a sequence of bytes in the input stream does not adhere to the UTF-8 standard. Illegal UCS-2 Value: This condition arises when the UTF-8 input sequence does not correspond to a character which has been defined by the UCS-2 standard or is outside the range of legal UCS-2 values (0x0 - 0xffff). Undefined UCS-2 Character: This condition arises when the UTF-8 input sequence cannot be associated with a range of values that have been specified by a mapucs2 directive in the configura- tion file. No Bitmap Available: This condition arises when the UTF-8 input sequence is mapped to a location in an X11 bitmap font for which a bitmap has not been defined. Non-Identical Character: This condition arises when a UTF-8 input sequence can- not be converted by the conversion routine (as speci- fied by the cnvucs2 directive) to an identical charac- ter in the destination font (as specified by the mapucs2 directive). Non-Graphical Character: This condistion arises when a UTF-8 input sequence maps to a non-graphical (non-printing) character. UCS-2 values in the range, n < 0x20, 0x7e < n < 0x9f, are considered non-graphical. Motion characters are exempt from being considered non-graphical. Motion Characters Xutops interprets certain UTF-8 input sequences as motion characters. These characters are used to position the current point on the output device where printing will occur next. NewLine (UCS-2 0xa): Move the current output-point to the next line on the page at the beginning of the left-margin. If the next line would exceed the bottom-margin, then begin a new page. Horizontal Tab (UCS-2 0x9): Move the current output-point to the next tabstop. If this would cause the output point to exceed the right-margin, a NewLine will be started. By default tabstops are set to every 8 character positions. FormFeed (UCS-2 0xc): Moves the output-point to the top- left-margin of the next page. BackSpace (UCS-2 0x8): Move the output-point back by spacing-width points. The output-point will not be moved beyond the beginning of the line. SEE ALSO lp(1), lpfilter(1M), xutops(5). FILES /usr/lib/lp/locale/locale-name/xutops/*.so UCS-2 to X11 bitmap font index conversion modules. /usr/lib/lp/locale-name/xutops/xutops.conf System per-locale configuration file. ~/.xutops/locale-name/xutops.conf User per-locale configuratoin file.
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |