imdisplay

Langue: en

Version: 06 February 2009 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

imdisplay - generate/display/save composite images interactively

SYNOPSIS

imdisplay FileName_or_TransformOption [ ... ]

DESCRIPTION

imdisplay is a S-Lang / Gtk utility which accepts an arbitrary number of images as input and by default renders them stacked upon one another, respecting transparency. The composite image may be easily tiled or scaled, as well as automatically scrolled for images too large to fit reasonably within your display. Alternatively, the panes option may be used to display each image within its own window, tiled either vertically or horizontally. imdisplay may be used as either a self-contained executable script or as a S-Lang function. When invoked as function (e.g. from the slsh prompt or a S-Lang script) the input images may be specified as either filenames, raw S-Lang arrays, or GdkPixbufs. When invoked from the operating system command line the input images must be filenames. If any input image in a composite contains an alpha channel (transparency) then the rendered result will as well.

imdisplay supports a wide variety of input file formats, including JPEG, PNG, GIF, XPM, TIFF, animations, and (optionally) the FITS file format popular in astronomy. The rendered result may also be saved to a variety of formats, including JPEG, PNG, and FITS. The range of supported formats depends upon how Gtk and SLgtk were compiled.

Optional strings specifying basic transformations may be included within the input arguments. Most of these are performed on the composite image just prior to display, and include:

    flip                 Mirror the image vertically
 
    flop                 Mirror the image horizontally
 
    size=<geometry>      Resize the image; geometry may be either
                                 be a scaling percentage or an absolute
                                 pixel size, such as 150x200% or 100x300;
                                 when only one value is provided it will
                                 be applied to both axes of the
 
    fill=<rule>          How to fill new space created in image display
                              window when it is enlarged; may be one of
 
                                 none    no fill; keep original image
                                 tile    fill with consecutive image copies
                                 scale   fill by enlarging image to fit
 
    panes=<layout>       How to display multiple images; layout may be one of
 
                                 one | single    composite all images into
                                                         one window (the default)
                                 horiz[ontal]    tile images horizontally
                                 vert[ical]      tile images vertically
 
                                 No compositing is performed for horizontal or
                                 or vertical tiling.
 

At launch all of the windows created by imdisplay will be chained: e.g. the control window will be chained to the window of the last image loaded, meaning that the controller will follow the image window around onscreen when the latter is moved; when the controller is moved its new gravity (i.e. placement relative to the image) will be remembered. An entire vertical (or horizontal) tiling of windows may be moved simply by moving its top- (or left-) most window. To disable chaining, ensure that the slave window you wish to unchain has focus, then hold down the SHIFT key while moving the slave. This will disconnect the slave from its own master, but leave intact any chains in which the slave is itself a master.

AUTHOR

The author of SLgtk and imdisplay is Michael S. Noble <mnoble@space.mit.edu>. Rafael Laboissiere <rafael@debian.org> created the SLgtk package for Debian and helped author this man page.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL

SEE ALSO

On Debian systems the reference manual for SLgtk can be found at /usr/share/doc/slang-gtk/slgtk.txt.gz. It is also available in HTML, PDF, and text formats on the SLgtk website.