Man Pages

pamx(1) - phpMan pamx(1) - phpMan

Command: man perldoc info search(apropos)  


Pamx User Manual(0)                                        Pamx User Manual(0)



NAME
       pamx - display Netpbm image in X Window System window


SYNOPSIS
       pamx

       [-fullscreen]  [-install]  [-private]  [-fit]  [-pixmap]  [-verbose] [-display=x-display] [-title=text] [-fore-
       ground=color] [-background=color] [-border=color] [-geometry=x-geometry-string] [-visual=name] netpbm_file

       All options can be abbreviated to their shortest unique prefix.  You may use two hyphens instead of one to des-
       ignate an option.  You may use either white space or an equals sign between an option name and its value.


DESCRIPTION
       This program is part of Netpbm(1).

       pamx  displays  a Netpbm image in an X Window System window.  It is like a very simple version of the classic X
       image viewer xloadimage.

       If you don't specify the input file netpbm_file, the input is from Standard Input.  The input image can be  any
       Netpbm image format.  If the input is a multi-image stream, pamx ignores all but the first image.

       pamx  is  not  the best choice for general purpose viewing of images, because it is a traditional simple Netpbm
       building block.  It is a good thing to build into other programs and can be useful for debugging  more  complex
       systems,  but  you can get much more powerful viewers that can display Netpbm images.  For example, xloadimage,
       xli, xzgv, and any web browser.

       The initial window is at most 90% of the size of the display unless the window manager does not correctly  han-
       dle window size requests or if you've used the -fullscreen option.  You may move the image around in the window
       by dragging with the first mouse button.  The cursor will indicate which directions you may drag, if any.   You
       may exit the window by typing 'q' or control-C when the keyboard focus is on the window.

       ppmsvgalib is a similar program that displays an image on a Linux system without the need for the X Window Sys-
       tem.



X RESOURCE CLASS
       pamx uses the resource class name Xloadimage for window managers which need this resource  set.   This  is,  of
       course, the same resource class that the conventional viewer program xloadimage uses.


OPTIONS
       -border=color
              This sets the background portion of the window which is not covered by any images to be color.


       -display=display_name
              This names the X display in which to put the window.  E.g. 0:0.


       -fit   Force  image  to  use  the  default  visual and colormap.  This is useful if you do not want technicolor
              effects when the colormap focus is inside the image window, but it may reduce the quality  of  the  dis-
              played image.


       -fullscreen
              Use the entire screen to display the image.


       -geometry=WxH[{+,-}X{+,-}Y
              This sets the size and position of the window in which pamx displays the image.

              By  default,  the  window  size  exactly  matches  the  image  size,  except  that  if you don't specify
              -fullscreen, the maximum is 90% of the screen dimensions.


       -install
              Forcibly install the image's colormap when the window is focused.  This  violates  ICCCM  standards  and
              only  exists to allow operation with naive window managers.  Use this option only if your window manager
              does not install colormaps properly.


       -pixmap
              Force the use of a pixmap as backing-store.  This is provided for servers where backing-store is  broken
              (such as some versions of the AIXWindows server).  It may improve scrolling performance on servers which
              provide backing-store.


       -private
              Force pamx to use of a private colormap.  By default, pamx allocates colors shared unless there are  not
              enough colors available.


       -verbose
              Causes pamx to print various information about what it's doing to Standard Error.


       -visual=visual_name
              Force  the  use  of a specific visual type to display an image.  By default, pamx tries to pick the best
              available image for a particular image type.  The available visual types  are:  DirectColor,  TrueColor,
              PseudoColor,  StaticColor,  GrayScale,  and StaticGray.  You may use the shortest unique prefix of these
              names, and case is not significant.


       -background=color
              Use color as the background color instead of the default (usually white but this depends  on  the  image
              type) if you are transferring a monochrome image to a color display.


       -foreground=color
              Use color as the foreground color instead of black if you are transferring a monochrome image to a color
              display.  You can also use this to invert the foreground and background colors of a monochrome image.


       -title=text
              Set the title bar title of the window.  Default is the file name of the input file, or  'stdin'  if  the
              image is from Standard Input.




SEE ALSO
       ppmsvgalib(1), pam(1), pnm(1), xzgv, xloadimage, xli


AUTHOR
       pamx  is by Bryan Henderson, in March 2006, based on xloadimage by Jim Frost, Centerline Software, jimf@center-
       line.com, 1989-1993.

       Jim's code contained the following copyright notice and license:


              Copyright 1989, 1993 Jim Frost


              Permission to use, copy, modify, distribute, and sell this software and its documentation for  any  pur-
              pose  is  hereby  granted without fee, provided that the above copyright notice appear in all copies and
              that both that copyright notice and this permission notice  appear  in  supporting  documentation.   The
              author  makes no representations about the suitability of this software for any purpose.  It is provided
              "as is" without express or implied warranty.


              THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL  IMPLIED  WARRANTIES  OF
              MERCHANTABILITY  AND FITNESS, IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSE-
              QUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,  WHETHER  IN  AN
              ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
              PERFORMANCE OF THIS SOFTWARE.


       Lots of other people contributed to Xloadimage, and they are listed in the file COPYRIGHT in the source code.


HISTORY
       pamx was new in Netpbm 10.34 (May 2006).

       pamx is essentially based on the classic X displayer program xloadimage by Jim Frost,  1989.   Bryan  Henderson
       stripped it down and adapted it to Netpbm in March 2006.

       The  following  features  of xloadimage are left out of pamx, to be more compatible with Netpbm's philosophy of
       simple building blocks.  Note that there are other programs in Netpbm that do all of these things:


       ?      slide show

       ?      zoom in/out

       ?      ability to accept formats other than Netpbm

       ?      ability to display on the root window

       ?      image transformations (brightening, clipping, rotating, etc)

       ?      decompressing and other decoding of input


              pamx also differs from xloadimage in that it uses Libnetpbm.

       There is virtually no code from xloadimage actually in pamx, because Bryan rewrote it all to make it easier  to
       understand.



netpbm documentation             25 March 2006             Pamx User Manual(0)