XIMAGING(1) General Commands Manual XIMAGING(1)


ximaging - raster graphics browser/viewer.


ximaging [options] [directory|file]


XImaging is a graphics image browser and viewer for Unix operating systems running X/CDE. The application consists of a Browser window where a list of reduced in size images is displayed, and a Viewer window where single images can be viewed in full size.


In addition to standard X toolkit options, following can be specified on the command line:
Open a browser rather than a viewer window when the application is launched without a file/directory argument.
Pin newly opened window so it won't be reused.
Only available on CDE. Launch in the background and wait for ToolTalk requests (first instance in a session launches as a server by default).
Don't write anything to stdout.


XImaging will launch a viewer window if a file name is specified on command line, or a browser window if a directory name is specified.
Directory containing images to browse.
Single image file name to be displayed.


The Browser window is used to display miniature previews of all raster images contained within a directory. The items can be selected and manipulated using either keyboard or mouse. MB1 click selects an item. The selection may be extended to another item by holding the Shift key, while clicking another item using MB1. Selection state of a single item may be toggled by clicking on it using MB1, while holding down the Control key. MB2 behaves the same way as MB1, except that it displays a popup menu with commonly used functions. Double- clicking an image with MB1 opens the file in the Viewer. Double-clicking the file name with MB1 posts the Rename dialog.
Navigation keys and the Tab key may be used to move the focus rectangle among the items. Pressing the Space key toggles the selection state of the focused item. Holding the Shift key while moving the selection rectangle extends the selection.
Basic file management functions, provided in the Edit menu, can be executed on selected items. Double clicking an item or pressing Return opens the selected file in the viewer.
The Viewer window is used to display single images, and provides functionality to zoom in and out, rotate, flip the image, and display multi-page images. Note that transformations applied to the image within the viewer are only temporary, since ximaging doesn't provide destructive image editing capabilities. The image, if larger than the view, may be panned either by holding MB1 pressed and dragging the image, or by pushing one of the direction keys on the keyboard.
Window Management
By default the last active browser or viewer window is reused when ximaging receives a file/directory open request, but every window can be configured to stay within it's current state by choosing Pin Window from its View menu. The initial value for this setting may also be specified as X resource (see RESOURCES) or using the -pin command line switch.


browse Boolean
Open a browser window rather than a viewer window when the application is launched without a file/directory argument. Default is False.
confirmFileRemoval Boolean
Ask before deleting files. Default is True.
downsamplingFilter Boolean
Apply filtering when down-sampling (zooming out) images in the viewer window. Results in better image quality if enabled, but is computationally intensive, especially on large images. The default value is True. NOTE: This option is only supported on true color visuals.
editCommand String
A command to be invoked when the Edit item is chosen from the File menu. The list of currently selected files will be appended to the end of the command string specified.
upsamplingFilter Boolean
Apply filtering when up-sampling (zooming in) images in the viewer window. Results in a smooth transition between zoomed-in pixels. Default value is True. NOTE: This option is only supported on true color visuals.
tileSizePresets Integer, Integer, Integer
Comma separated list of three (small, medium, large) tile size presets in pixels. The final size is calculated using the aspect ratio specified with the tileAspectRatio resource.
tileSize small|medium|large
Default size of preview tiles in browser window. Must be either small, medium, or large.
tileAspectRatio Integer:Integer
Aspect ratio of preview tiles in browser window. Default is 4:3.
quiet Boolean
Don't write anything to stdout. Default is False
refreshInterval Integer
Time interval in seconds at which ximaging checks for file and directory content changes. Default is 4 seconds.
pinWindow Boolean
Pin newly opened windows by default so that it won't be reused. Default is False.
keyPanAmount Integer
Amount of pixels by which the image in the Viewer is moved per key press.
lockRotation Boolean
Keep rotation settings across images. Default is False.
visualProgress Boolean
Display the image in the viewer window as it is being loaded. Default is True.
zoomFit Boolean
Shrink the image to fit the viewer window. Default is True.
zoomIncrement <1.1 - 4.0>
Specifies the increment value for the zoom-in/out function. Must be in the 1.1 - 4.0 range. Default is 1.6.


XImaging supports the CDE Media Exchange protocol. In order for other ToolTalk aware applications to be able to communicate with XImaging, a static Process Type and action/data type definitions must be added to the CDE type database. The distribution archive includes basic configuration files. See the CDEINTEG file for further information.


JPEG Image (jpg, jpeg, jpe, jif, jfif, jfi)
MS-Windows Bitmap (bmp)
PC-Paintbrush (pcx)
Portable Network Graphics (png)
Silicon Graphics Image (sgi, rgb, rgba, int, inta, bw)
Sun Microsystems Raster Image (ras, sun)
Tagged Image File (tif, tiff)
Truevision (tga, tpic)
X/CDE Bitmap (xbm, bm)
X/CDE Pixmap (xpm, pm)


XImaging was written and is maintained by: alx@fastestcode.org


XImaging doesn't provide file format conversion features. There are tools - e.g., ImageMagick (http://www.imagemagick.org) designed for this purpose.