{ "mode": "man", "parameter": "pamx", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pamx/1/json", "generated": "2026-08-06T16:41:22Z", "synopsis": "", "sections": { "NAME": { "content": "pamx - display Netpbm image in X Window System window\n\n", "subsections": [] }, "SYNOPSIS": { "content": "", "subsections": [ { "name": "pamx", "content": "[-fullscreen] [-install] [-private] [-fit] [-pixmap] [-verbose] [-display=x-display] [-ti‐\ntle=text] [-foreground=color] [-background=color] [-border=color] [-geometry=x-geometry-\nstring] [-visual=name] netpbmfile\n\nAll options can be abbreviated to their shortest unique prefix. You may use two hyphens in‐\nstead of one to designate an option. You may use either white space or an equals sign be‐\ntween an option name and its value.\n\n" } ] }, "DESCRIPTION": { "content": "This program is part of Netpbm(1).\n\npamx displays a Netpbm image in an X Window System window. It is like a very simple version\nof the classic X image viewer xloadimage.\n\nIf you don't specify the input file netpbmfile, the input is from Standard Input. The input\nimage can be any Netpbm image format. If the input is a multi-image stream, pamx ignores all\nbut the first image.\n\npamx is not the best choice for general purpose viewing of images, because it is a tradi‐\ntional simple Netpbm building block. It is a good thing to build into other programs and can\nbe useful for debugging more complex systems, but you can get much more powerful viewers that\ncan display Netpbm images. For example, xloadimage, xli, xzgv, and any web browser.\n\nThe program xwud (X Window Undump) is part of the X Window System and performs the same basic\ndisplay function, though with input in the special X Window Dump format (for which Netpbm has\nconverters).\n\nThe initial window is at most 90% of the size of the display unless the window manager does\nnot correctly handle window size requests or if you've used the -fullscreen option. You may\nmove the image around in the window by dragging with the first mouse button. The cursor will\nindicate which directions you may drag, if any. You may exit the window by typing 'q' or\ncontrol-C when the keyboard focus is on the window.\n\nppmsvgalib is a similar program that displays an image on a Linux system without the need for\nthe X Window System.\n\n\n", "subsections": [] }, "X RESOURCE CLASS": { "content": "pamx uses the resource class name Xloadimage for window managers which need this resource\nset. This is, of course, the same resource class that the conventional viewer program xload‐\nimage uses.\n\n\n", "subsections": [] }, "OPTIONS": { "content": "In addition to the options common to all programs based on libnetpbm (most notably -quiet,\nsee \u001b]8;;index.html#commonoptions\u001b\\ Common Options\u001b]8;;\u001b\\ ), pamx recognizes the following command line options:\n\n\n", "subsections": [ { "name": "-border=_", "content": "This sets the background portion of the window which is not covered by any images to\nbe color.\n\n" }, { "name": "-display=_", "content": "This names the X display in which to put the window. E.g. 0:0.\n\n" }, { "name": "-fit", "content": "technicolor effects when the colormap focus is inside the image window, but it may re‐\nduce the quality of the displayed image.\n\n" }, { "name": "-fullscreen", "content": "Use the entire screen to display the image.\n\n" }, { "name": "-geometry=_ - -", "content": "This sets the size and position of the window in which pamx displays the image.\n\nBy default, the window size exactly matches the image size, except that if you don't\nspecify -fullscreen, the maximum is 90% of the screen dimensions.\n\n" }, { "name": "-install", "content": "Forcibly install the image's colormap when the window is focused. This violates ICCCM\nstandards and only exists to allow operation with naive window managers. Use this op‐\ntion only if your window manager does not install colormaps properly.\n\n" }, { "name": "-pixmap", "content": "Force the use of a pixmap as backing-store. This is provided for servers where back‐\ning-store is broken (such as some versions of the AIXWindows server). It may improve\nscrolling performance on servers which provide backing-store.\n\n" }, { "name": "-private", "content": "Force pamx to use of a private colormap. By default, pamx allocates colors shared un‐\nless there are not enough colors available.\n\n" }, { "name": "-verbose", "content": "Causes pamx to print various information about what it's doing to Standard Error.\n\n" }, { "name": "-visual=_", "content": "Force the use of a specific visual type to display an image. By default, pamx tries\nto pick the best available image for a particular image type. The available visual\ntypes are: DirectColor, TrueColor, PseudoColor, StaticColor, GrayScale, and Stat‐\nicGray. You may use the shortest unique prefix of these names, and case is not sig‐\nnificant.\n\n" }, { "name": "-background=_", "content": "Use color as the background color instead of the default (usually white but this de‐\npends on the image type) if you are transferring a monochrome image to a color dis‐\nplay.\n\n" }, { "name": "-foreground=_", "content": "Use color as the foreground color instead of black if you are transferring a mono‐\nchrome image to a color display. You can also use this to invert the foreground and\nbackground colors of a monochrome image.\n\n" }, { "name": "-title=_", "content": "Set the title bar title of the window. Default is the file name of the input file, or\n\"stdin\" if the image is from Standard Input.\n\n\n\n" } ] }, "SEE ALSO": { "content": "ppmsvgalib(1), pam(1), pnm(1), xzgv, xwud, xloadimage, xli\n\n\n", "subsections": [] }, "AUTHOR": { "content": "pamx is by Bryan Henderson, in March 2006, based on xloadimage by Jim Frost, Centerline Soft‐\nware, jimf@centerline.com, 1989-1993.\n\nJim's code contained the following copyright notice and license:\n\n\nCopyright 1989, 1993 Jim Frost\n\n\nPermission to use, copy, modify, distribute, and sell this software and its documenta‐\ntion for any purpose is hereby granted without fee, provided that the above copyright\nnotice appear in all copies and that both that copyright notice and this permission\nnotice appear in supporting documentation. The author makes no representations about\nthe suitability of this software for any purpose. It is provided \"as is\" without ex‐\npress or implied warranty.\n\n\nTHE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IM‐\nPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE AUTHOR BE LI‐\nABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RE‐\nSULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLI‐\nGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PER‐\nFORMANCE OF THIS SOFTWARE.\n\n\nLots of other people contributed to Xloadimage, and they are listed in the file COPYRIGHT in\nthe source code.\n\n\n", "subsections": [] }, "HISTORY": { "content": "pamx was new in Netpbm 10.34 (May 2006).\n\npamx is essentially based on the classic X displayer program xloadimage by Jim Frost, 1989.\nBryan Henderson stripped it down and adapted it to Netpbm in March 2006.\n\nThe following features of xloadimage are left out of pamx, to be more compatible with\nNetpbm's philosophy of simple building blocks. Note that there are other programs in Netpbm\nthat do most of these things:\n\n\n• zoom in/out\n\n• ability to accept formats other than Netpbm\n\n• image transformations (brightening, clipping, rotating, etc)\n\n• decompressing and other decoding of input\n\n• ability to display on the root window\n\n• slide show\n\n\npamx also differs from xloadimage in that it uses Libnetpbm.\n\nThere is virtually no code from xloadimage actually in pamx, because Bryan rewrote it all to\nmake it easier to understand.\n", "subsections": [] }, "DOCUMENT SOURCE": { "content": "This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master\ndocumentation is at\n\nhttp://netpbm.sourceforge.net/doc/pamx.html\n\nnetpbm documentation 02 July 2011 Pamx User Manual(1)", "subsections": [] } }, "summary": "pamx - display Netpbm image in X Window System window", "flags": [ { "flag": "", "long": null, "arg": null, "description": "This sets the background portion of the window which is not covered by any images to be color." }, { "flag": "", "long": null, "arg": null, "description": "This names the X display in which to put the window. E.g. 0:0." }, { "flag": "", "long": null, "arg": null, "description": "technicolor effects when the colormap focus is inside the image window, but it may re‐ duce the quality of the displayed image." }, { "flag": "", "long": null, "arg": null, "description": "Use the entire screen to display the image." }, { "flag": "", "long": null, "arg": null, "description": "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." }, { "flag": "", "long": null, "arg": null, "description": "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 op‐ tion only if your window manager does not install colormaps properly." }, { "flag": "", "long": null, "arg": null, "description": "Force the use of a pixmap as backing-store. This is provided for servers where back‐ ing-store is broken (such as some versions of the AIXWindows server). It may improve scrolling performance on servers which provide backing-store." }, { "flag": "", "long": null, "arg": null, "description": "Force pamx to use of a private colormap. By default, pamx allocates colors shared un‐ less there are not enough colors available." }, { "flag": "", "long": null, "arg": null, "description": "Causes pamx to print various information about what it's doing to Standard Error." }, { "flag": "", "long": null, "arg": null, "description": "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 Stat‐ icGray. You may use the shortest unique prefix of these names, and case is not sig‐ nificant." }, { "flag": "", "long": null, "arg": null, "description": "Use color as the background color instead of the default (usually white but this de‐ pends on the image type) if you are transferring a monochrome image to a color dis‐ play." }, { "flag": "", "long": null, "arg": null, "description": "Use color as the foreground color instead of black if you are transferring a mono‐ chrome image to a color display. You can also use this to invert the foreground and background colors of a monochrome image." }, { "flag": "", "long": null, "arg": null, "description": "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." } ], "examples": [], "see_also": [ { "name": "ppmsvgalib", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/ppmsvgalib/1/json" }, { "name": "pam", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pam/1/json" }, { "name": "pnm", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/pnm/1/json" } ] }