IPASTE(1G)IPASTE(1G)NAMEipaste - display an image
SYNOPSISipaste [-f] [-n] [-sx] [-o xorg yorg] imgfile
DESCRIPTIONipaste is a utility that displays images stored using the image library
"libimage.a". ipaste reads pixel values, image dimensions and other
relevant data from the file imgfile via calls to the image library.
ipaste then displays the image in a window. On machines with few bit
planes, ipaste dithers the image.
The -f option causes ipaste to run in the foreground. Normally, ipaste
forks off a background process to display the image while the foreground
process exits back to the command line. With this option the image is
displayed by the foreground process.
The -n option pastes the image without any window manager border. When
the image is viewed in this way, access to the window frame and its
buttons is disabled as the frame itself is not visible. However the X
window menu can still be popped up under 4Dwm by pressing the left Ctrl-
Shift keys simultaneously and then RIGHTMOUSE when the cursor is on top
of the image. The Minimize/Stow and Quit menu items give the same
results as the control buttons on the visible window frame. Moving the
image around can still be accomplished via the Move menu item, or by
pressing down the left Ctrl-Shift keys simultaneously, then pressing
MIDDLEMOUSE, and then moving the mouse.
The -sx option pastes the image with a white border or frame surrounding
it in the style of a Polaroid SX (TM) photograph. This option, like -n,
disables the window manager border.
The -o xorg yorg option automatically pastes the image at a position on
the screen (absolute screen coordinates) that has as its origin (xorg,
yorg).
Pressing the Esc key on the keyboard will automatically quit out of
ipaste now. This is a nice short-cut when the image you are viewing is
borderless (i.e. has been pasted up using the -n option). However, due
the way the Xserver works with auto-repeat keys on the keyboard (like
Esc), if you hold down the Escape key too long, and your current ipaste
window has another ipaste window underneath it, you will now find the
second ipaste window will also exit. Be careful when you use the "Esc"
key shortcut.
In the world of X, the easiest way to get access to the 4Dwm window
manager menu while over an ipaste window (or any GL client)--so you can
quit out of ipaste in this fashion--is to press either "Alt" key and then
press RIGHTMOUSE. This is the easiest way to stow, or iconize the image
and the safest way to quite out of a ipaste'd borderless window.
Page 1
IPASTE(1G)IPASTE(1G)
The four arrow keys (LEFTARROWKEY, DOWNARROWKEY, RIGHTARROWKEY,
UPARROWKEY) can now be used to scoot the ipaste window to the left, down,
right, or up as long as the cursor is on top of the ipaste window when
you press one of these keys.
Caution: ipaste will NOT work with image files made using the old gl
program dither. For these dithered types of images (8 bits deep) you
will need to first use fromdi to convert them from dithered into RGB
format, and then can use ipaste to display them. fromdi.c lives in
/usr/people/4Dgifts/iristools/imgtools, and the executable is in the
moregltools subsystem on the EOE2 software product.
NOTES
On machines having less than 24 bits available for RGB display, the
displayed image may appeared to have lost some quality. This occurs when
the image that was saved was in colormap mode. The pixel color index is
expanded into the full RGB information. When redisplayed, the RGB
information is dithered on these machines to approximate the original
image.
Under 4Dwm there is a constraint on the minimum width a window can have.
This affects users of ipaste(1G) who try to view image files which have
an xsize of less than 75 pixels. Quoting from the "OSF/Motif
Programmer's Guide", Version 1.1, Section 11.4.2.3, The Title Bar:
The title bar, which may include a title area, window menu button, and
minimize and maximize buttons, is constrained so that all components in
the title bar are always visible. This necessitates a minimum frame size
and, by extension, a minimum size for your application's window. The
size of the components in the title bar depends upon the size of the font
you choose for the title area text.
As a user shrinks your client window horizontally, space is removed from
the title area first. As the window is resized smaller, title text is
clipped from the right. The absolute minimum size of the title bar is
equal to the size of the buttons in the title bar, plus a title area
equivalent to the width of one title bar button.
The standard minimum-width window size in 4Dwm is 100 pixels. This is
based on the fact that SGI's buttons (which live in the area of the title
bar) are 25 pixels wide. The min size is calculated to be "buttonSize *
4" (assuming the buttons are of uniform size). Since ipaste has no
"maximize" button, the min size is "buttonSize * 3".
Page 2
