ipaste(1G)

NAME
     ipaste - display an image

SYNOPSIS
     ipaste [-f] [-n] [-sx] [-o xorg yorg] imgfile

DESCRIPTION
     ipaste 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.
     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".