xpreview Command

Purpose

Displays troff files on an X display.

Syntax

xpreview -BackingStore BackingStoreType ] [  -page Number ] [  ToolKitFlag ... ] {  File}

Description

The xpreview command is an AIXwindows 2.1- and Motif2.1-based application that displays output from the troff command on an AIXwindows display. The troff command output file must be prepared for the devX100 device.

The user interface contains the standard AIXwindows interface controls for calling the root menu, iconifying the window, and setting the window to full screen size. The interface also includes a main window with a scrollable display area for text. Use the pushbuttons for Next, Previous, Goto Page, Print Page, Print File, and Newfile to manipulate the viewing document.

Mouse button three actuates a popup menu for configuring print capabilities. The menu includes an option to set the command line and another to select a printer queue. The command line dialog box expects command line input through the troff command. For example,

pic -Tibm3816 troff-input-file |tbl|troff -mm -Tibm3816

is an acceptable command line. The printer queue option displays a list of configured printer queues. If this option is not selected, the xpreview command uses the system-defined default queue.

When you are previewing an input file, the Print Page and Print File buttons require command line input. Note that once a printer queue is selected, it remains selected for the duration of the viewing session, or until an alternate printer queue is selected.

Fonts supported for the devX100 device in European locales are:

The xpreview command supports the following font sizes: 8, 10, 14, 18, 24, 30, and 36.

The xpreview command does not display files resulting from the troff command constructed for a device other than those described in this document.

To preview a file on a certain device, the xpreview command requires the fonts found in the following directories:

Multibyte Support

The xpreview command supports multibyte locales. Also, to display Japanese characters, Japanese 16-dot fonts (part of the Japanese BSL package) and 24- and 32-dot fonts (part of the AIXwindows font package) must be installed. To display Korean characters, Korean fonts (part of the Korean BSL package) must be installed.

Japanese support currently includes the following font sets:

Korean support currently includes the following font sets:

Flags

The xpreview command accepts the standard X Toolkit command line flags, as well as the following flags:

Item Description
- Requires input to be read from standard input.
-help Indicates that a brief summary of the allowed command line flags should be printed.
-BackingStore BackingStoreType The -BackingStore flag causes the server to save the window contents so that when it is scrolled around the viewport, the window is painted from contents saved in server backing store. Redisplays of the drawing window can take up to a second or so. The BackingStoreType parameter can have one of the following values: Always, WhenMapped or NotUseful.
Tip: Enter a space between the -BackingStore flag and its BackingStoreType parameter.
Requirement: Use of this flag requires that the server be started with backing store enabled.
-page Number Specifies the page number of the document to be first displayed.
ToolKitFlag The following standard X Toolkit flags are commonly used with the xpreview command:
-bg Color
Specifies the color to use for the background of the window. The default is white.
-bg Color
Specifies the color to use for the background of the window. The default is white.
-fg Color
Specifies the color to use for displaying text. The default is black.
-geometry Geometry
Specifies the preferred size and position of the window.
-display Host:Display
Specifies the X server to contact.
-xrm ResourceString
Specifies a resource string to be used.
File Specifies the file to be printed.

Examples

  1. To build files output by the troff command into files that are suitable for use with the xpreview command, enter the following commands:
    troff-TX100 troff-input | xpreview
    pic -TX100 pic-troff-input | tbl | troff -man -TX100 | xpreview
  2. To build files output by the troff command into files that are suitable for use with the Japanese language version of the xpreview command, enter the following commands:
    LANG=ja_JP
    troff -TX100 troff-input | xpreview -
    pic -TX100 pic-troff-input | tbl | troff -man -TX100 \
            | xpreview -

Files

Item Description
/usr/lib/X11/app-defaults/XPreview Contains user-configurable applications defaults file.
/usr/lib/X11/Ja_JP/app-defaults/XPreview Contains user-configurable applications default file for the Japanese (IBM-932) locale.
/usr/lib/X11/ja_JP/app-defaults/XPreview Contains user-configurable applications default file for the Japanese (IBM-eucJP) locale.
/usr/lib/X11/ko_KR/app-defaults/XPreview Contains user-configurable applications default file for the Korean locale.
/usr/lib/X11/zh_TW/app-defaults/XPreview Contains user-configurable applications default file for the Traditional Chinese locale.
/usr/lib/font/devX100 Contains troff fonts for devX100 devices.
/usr/lib/X11/fonts Contains X fonts for 100 dpi devices.
/usr/lib/X11/fonts/JP Contains X fonts for multi-byte characters.
/usr/lib/X11/fonts/JP Contains X fonts for Japanese characters.