{ "content": [ { "type": "text", "text": "# ppmtoxpm (info)\n\n## NAME\n\nppmtoxpm - convert a portable pixmap into an X11 pixmap\n\n## SYNOPSIS\n\nppmtoxpm [-name=xpmname] [-rgb=rgb-textfile] [-alphamask=pgmfile] [ppm-\nfile]\nMinimum unique abbrevations are acceptable.\n\n## DESCRIPTION\n\nReads a portable pixmap as input. Produces X11 pixmap (version 3) as\noutput which can be loaded directly by the XPM library.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS**\n- **LIMITATIONS**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "ppmtoxpm", "section": "", "mode": "info", "summary": "ppmtoxpm - convert a portable pixmap into an X11 pixmap", "synopsis": "ppmtoxpm [-name=xpmname] [-rgb=rgb-textfile] [-alphamask=pgmfile] [ppm-\nfile]\nMinimum unique abbrevations are acceptable.", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [], "examples": [], "see_also": [ { "name": "ppmcolormask", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/ppmcolormask/1/json" }, { "name": "xpmtoppm", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/xpmtoppm/1/json" }, { "name": "ppm", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/ppm/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 5, "subsections": [] }, { "name": "DESCRIPTION", "lines": 12, "subsections": [] }, { "name": "OPTIONS", "lines": 35, "subsections": [] }, { "name": "LIMITATIONS", "lines": 6, "subsections": [] }, { "name": "SEE ALSO", "lines": 3, "subsections": [] }, { "name": "AUTHOR", "lines": 22, "subsections": [] } ], "sections": { "NAME": { "content": "ppmtoxpm - convert a portable pixmap into an X11 pixmap\n", "subsections": [] }, "SYNOPSIS": { "content": "ppmtoxpm [-name=xpmname] [-rgb=rgb-textfile] [-alphamask=pgmfile] [ppm-\nfile]\n\nMinimum unique abbrevations are acceptable.\n", "subsections": [] }, "DESCRIPTION": { "content": "Reads a portable pixmap as input. Produces X11 pixmap (version 3) as\noutput which can be loaded directly by the XPM library.\n\nFor example, to convert the file \"dot\" (found in /usr/include/X11/bit-\nmaps), from xbm to xpm one could specify\n\nxbmtopbm dot | ppmtoxpm -name dot\n\nor, with a rgb text file (in the local directory)\n\nxbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt\n", "subsections": [] }, "OPTIONS": { "content": "-name=xpmname\nThe -name option allows you to specify the prefix string which\nis printed in the resulting XPM output. If not specified, will\ndefault to the filename (without extension) of the ar-\ngument. If you do not specify -name or ppmfile, (i.e. your in-\nput is from Standad Input), the prefix string defaults to the\nstring noname.\n\nrgb=rgb-textfile\nThe -rgb option allows you to specify an X11 rgb text file for\nthe lookup of color name mnemonics. This rgb text file is typi-\ncally the /usr/lib/X11/rgb.txt of the MIT X11 distribution, but\nany file using the same format may be used. When specified and\na RGB value from the ppm input matches a RGB value from the\n, then the corresponding color name mnemonic is\nprinted in the XPM's colormap. If you don't specify -rgb or if\nthe RGB values don't match, then ppmtoxpm produces the color\nspecifications in the #RGB, #RRGGBB, #RRRGGGBBB, or #RRRRGGGG-\nBBBB hexadecimal format.\n\n-alphamask=pgmfile\nThis option names a PGM file to use as an alpha (transparency)\nmask. The file must contain an image the same dimensions as the\ninput image. ppmtoxpm marks as transparent any pixel whose po-\nsition in the alpha mask image is at most half white.\n\nIf you don't specify -alphamask, ppmtoxpm makes all pixels in\nthe output opaque.\n\nppmcolormask is one way to generate an alpha mask file. You\nmight also generate it by extracting transparency information\nfrom an XPM file with the -alphaout option to xpmtoppm. There\nare similar options on other Netpbm converters that convert from\nformats that include transparency information too.\n", "subsections": [] }, "LIMITATIONS": { "content": "An option to match the closest (rather than exact) color name mnemonic\nfrom the rgb text would be a desirable enhancement.\n\nTruncation of the least significant bits of a RGB value may result in\nnonexact matches when performing color name mnemonic lookups.\n", "subsections": [] }, "SEE ALSO": { "content": "ppmcolormask(1), xpmtoppm(1), ppm(5)\nXPM Manual by Arnaud Le Hors lehors@mirsa.inria.fr\n", "subsections": [] }, "AUTHOR": { "content": "Copyright (C) 1990 by Mark W. Snitily.\n\nPermission to use, copy, modify, and distribute this software and its\ndocumentation for any purpose and without fee is hereby granted, pro-\nvided that the above copyright notice appear in all copies and that\nboth that copyright notice and this permission notice appear in sup-\nporting documentation. This software is provided \"as is\" without ex-\npress or implied warranty.\n\nThis tool was developed for Schlumberger Technologies, ATE Division,\nand with their permission is being made available to the public with\nthe above copyright notice and permission notice.\n\nUpgraded to XPM2 by\nPaul Breslaw, Mecasoft SA, Zurich, Switzerland (paul@mecazh.uu.ch)\nThu Nov 8 16:01:17 1990\n\nUpgraded to XPM version 3 by\nArnaud Le Hors (lehors@mirsa.inria.fr)\nTue Apr 9 1991\n\nTue Apr 9 1991 ppmtoxpm(1)", "subsections": [] } } } }