image(1) X Version 11 (5 May 1989) image(1)
NAME
image - displays image files in an X11 window
SYNOPSIS
image [-options] filename[s]
DESCRIPTION
image is an X client that displays and animates image files
in a window. You can display the following types of image
files with image:
*.img EGAPaint image files
*.sc? EGAPaint screen files
*.pcc ZSoft cut files
*.pcx ZSoft picture files
*.dmp X window dump files
*.mac MacPaint image files
*.pib Professional Image Board files
*.amg IFF Interleaved Bitmap files and Amiga Amin files
*.iff IFF Interleaved Bitmap files and Amiga Anim files
For example:
image kitten.mac
To close the window, move the cursor into it and press the
middle mouse button.
To enter multiple file names, separate them with blanks.
You may use UNIX wildcard characters, too. Press the middle
mouse button to cycle through multiple files, one at a time.
The window closes when you complete the last image.
You can also animate IFF Amiga Anim (animation) files with
image. These are specially formatted files that create a
series of moving images when you run them with image. Just
type:
image filename
and image animates the images in the image window until you
press the middle mouse button.
The -a option lets you animate a series of images having the
same colormap, width, and height. Refer to "OPTIONS" below
for more information on animating a series of images.
Your cursor must be in the image window for the correct
colors.
To rotate the color palette forward, or in, move the cursor
into the image window and press the "I" key. To rotate the
Page 1 (printed 10/4/89)
image(1) X Version 11 (5 May 1989) image(1)
color palette backward, or out, move the cursor into the
image window and press the "O" key. Press the "N" key to
stop rotation. Press "0" to "9" to change the speed of
rotation. "0" is the fastest. The numbers "1" to "9"
specify tenths of a second.
To crop an area and save it to a .dmp file, use the left
mouse button to mark the upper left corner. Then use the
right mouse button to mark the lower right corner. As you
mark the second corner, you hear three beeps. This signals
that the area you cropped is being dumped to a file. The
file has the same name as the original image file, with the
extension .dmp. You can mark the corners in any order. If
you mark a corner and then wish to remove the mark, press
the middle mouse button.
Your display should be as "deep" as the image file you name.
For example, if you have a monochrome display (depth is one
plane) you can only display images that are one plane deep.
On an EGA display, you can use image with images from one to
four planes deep.
OPTIONS
-display display
The -display option, if present, must be first. See
X(1).
-i filename
Inverts the black and white in monochrome images.
(With color images, it gives you a different set of
colors.)
-c filename
Installs its own color map when the cursor enters the
image window and uninstalls it when the cursor leaves
the image window. (Some window managers install a
color map; some don't.) This option toggles.
-e.extension filename
Provides a file type that overrides the file's
extension if missing or incorrect. For example, if you
have a MacPaint file named lion, you can display it
with the command:
image -e.mac lion
Do not put a space between -e and the extension. The
extension must be one of those listed in the
DESCRIPTION, above. If you use the -e option with no
extension, image uses the image file's extension to
determine the file type.
Page 2 (printed 10/4/89)
image(1) X Version 11 (5 May 1989) image(1)
You may intermix all options except for the -display option,
which must be first. Options apply to all following
filenames. For example:
image lion.mac -i kitten.mac puma.mac -i kat.mac
In this example, lion.mac is not inverted, kitten.mac and
puma.mac are inverted, and kat.mac is not inverted.
-a filename
Animates a set of images you specify. All of the
images must be the same width, height, and depth and
have the same colormap. For example:
image -a image1.iff image2.iff image3.iff image4.iff image5.iff
When you use this option with a series of images, it
animates the images in sequential order and continues
to do so until you tell it to stop.
-s filename
Runs animations in synchronous mode. This slows down
the animations a little, but it also allows image to
respond more quickly to commands. For example, if you
do not specify this option it takes longer for the
image to go away after you close the window.
LIMITATIONS
image has been tested running the PC Xsight Server on
monochrome, EGA, and VGA displays and running the Xsight
server on an EGA display.
image cannot display Amiga files with more than 16 colors.
If you want to display such a file, you must convert it to
use 16 colors or less before moving the file to .
image cannot animate files containing more than 100 frames.
This program is also limited by the memory of your server.
The number of animation frames it can handle depends on your
server's available memory.
image currently supports only the "short delta" animation
compression format for Amiga animation files.
WARNING
If you specify an image file incorrectly (e.g., an Amiga
file as kitten.mac), the result is unpredictable.
SEE ALSO
The latest revision of "EA IFF 85" Standard for Interchange
Format Files, for more information on .iff and .amg files.
This document is available from Commodore Computers.
Page 3 (printed 10/4/89)
image(1) X Version 11 (5 May 1989) image(1)
AUTHOR
Locus Computing Corporation.
Page 4 (printed 10/4/89)