ximaging - raster graphics browser/viewer.
ximaging [options] [directory|file]
XImaging is a graphics image browser and viewer for Unix operating
systems running X11.
In addition to standard X toolkit options, following can be
specified on the command line:
- -browse
- Open a browser rather than a viewer window when the application is
launched without a file/directory argument.
- -pin
- Pin newly opened window so it won't be reused.
- -server
- Launch in the background and wait for IPC requests. (first instance in a
session launches as a server by default).
- -quiet
- Don't write anything to stdout.
- directory
- Directory containing images to browse.
- file
- Single image file name to be displayed.
- Browser
- The Browser window displays miniature previews of images contained within
a directory. The navigation bar displays the current location and may be
used to input a desired path directly.
- Items displayed in the view area 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 pop-up 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.
Double-clicking an image, or pressing enter when the view area is focused,
will display the selected file in a Viewer window.
- Navigation keys may be used to move the focus rectangle among the items.
Pressing the Space key toggles the selection state of the focused
item. Holding theShift key while moving the selection rectangle
extends the selection. The Tab key may be used to switch keyboard
focus between the view and the navigation bar.
- 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 its current state by choosing Pin This
from its Window 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.
- fastPanning
Boolean
- If set to True, up/down-sampling filter in the viewer will be temporarily
disabled when the image is being panned using the mouse. Only effective if
downsamplingFilter and/or upsamplingFilter resources are set
to True. Default value is False.
- keyPanAmount
Integer
- Amount of pixels by which the image in the Viewer is moved per key
press.
- largeCursors
Boolean
- Use large cursors. Default is False.
- largeToolbarIcons
Boolean
- Use large icons in toolbar buttons. Default is False. See also:
viewerToolbar resource.
- lockRotation
Boolean
- Keep rotation settings across images. Default is False.
- pinWindow
Boolean
- Pin newly opened windows by default so that it won't be reused. Default is
False.
- 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.
- showDirectories
Boolean
- Display sub-directories in a separate pane in the browser window. Default
is True.
- showDotFiles
Boolean
- Display files whose names are starting with a dot. Default is True.
- tileAspectRatio
Integer:Integer
- Aspect ratio of preview tiles in browser window. Default is 4:3.
- tileSize
small|medium|large
- Default size of preview tiles in browser window. Must be either
"small", "medium", or "large". NOTE:
Actual pixel values for these mnemonics are obtained from
tileSizeList and tileAspectRatio resources.
- tileSizeList
Integer, Integer, Integer
- Comma separated list of three (small, medium, large) tile size values in
pixels. The final size is calculated using the aspect ratio specified with
the tileAspectRatio resource.
- 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
False. NOTE: This option is only supported on true color
visuals.
- viewerToolbar
Boolean
- If set to True, a toolbar containing some of the most frequently
used commands will be shown in the viewer window. The default value 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.
JPEG Image (jpg, jpeg, jpe, jif, jfif, jfi)
MS-Windows Bitmap (bmp) - BMP V3+, uncompressed only
PC-Paintbrush V5 (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) - XMP3 only
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.