{ "content": [ { "type": "text", "text": "# ppmtoacad (man)\n\n## NAME\n\nppmtoacad - convert portable pixmap to AutoCAD database or slide\n\n## SYNOPSIS\n\nppmtoacad [-dxb] [-poly] [-background colour] [-white] [-aspect ratio] [-8] [ppmfile]\n\n## DESCRIPTION\n\nReads a portable pixmap as input. Produces an AutoCAD® slide file or binary database import\n(.dxb) file as output. If no ppmfile is specified, input is read from standard input.\n\n## TLDR\n\n> Convert a PPM image to an AutoCAD database or slide.\n\n- Convert a PPM image to an AutoCAD slide:\n `ppmtoacad {{path/to/file.ppm}} > {{path/to/file.acad}}`\n- Convert a PPM image to an AutoCAD binary database import file:\n `ppmtoacad {{-d|-dxb}} {{path/to/file.ppm}} > {{path/to/file.dxb}}`\n- Restrict the colors in the output to 8 RGB shades:\n `ppmtoacad -8 {{path/to/file.ppm}} > {{path/to/file.dxb}}`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (6 subsections)\n- **BUGS**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "ppmtoacad", "section": "", "mode": "man", "summary": "ppmtoacad - convert portable pixmap to AutoCAD database or slide", "synopsis": "ppmtoacad [-dxb] [-poly] [-background colour] [-white] [-aspect ratio] [-8] [ppmfile]", "tldr_summary": "Convert a PPM image to an AutoCAD database or slide.", "tldr_examples": [ { "description": "Convert a PPM image to an AutoCAD slide", "command": "ppmtoacad {{path/to/file.ppm}} > {{path/to/file.acad}}" }, { "description": "Convert a PPM image to an AutoCAD binary database import file", "command": "ppmtoacad {{-d|-dxb}} {{path/to/file.ppm}} > {{path/to/file.dxb}}" }, { "description": "Restrict the colors in the output to 8 RGB shades", "command": "ppmtoacad -8 {{path/to/file.ppm}} > {{path/to/file.dxb}}" } ], "tldr_source": "official", "flags": [ { "flag": "", "long": null, "arg": null, "description": "DXBIN command and, once loaded, becomes part of the AutoCAD geometrical database and can be viewed and edited like any other object. Each sequence of identical pixels be‐ comes a separate object in the database; this can result in very large AutoCAD drawing files. However, if you want to trace over a bitmap, it lets you zoom and pan around the bitmap as you wish." }, { "flag": "", "long": null, "arg": null, "description": "Normally each row of pixels is represented by an AutoCAD line entity. If -poly is se‐ lected, the pixels are rendered as filled polygons. If the slide is viewed on a dis‐ play with higher resolution than the source pixmap, this will cause the pixels to ex‐ pand instead of appearing as discrete lines against the screen background colour. Re‐ grettably, this representation yields slide files which occupy more disc space and take longer to display." }, { "flag": "", "long": null, "arg": null, "description": "Most AutoCAD display drivers can be configured to use any available colour as the screen background. Some users perfer a black screen background, others white, while splinter groups advocate burnt ocher, tawny puce, and shocking grey. Discarding pix‐ els whose closest AutoCAD colour representation is equal to the background colour can substantially reduce the size of the AutoCAD database or slide file needed to repre‐ sent a bitmap. If no -background colour is specified, the screen background colour is assumed to be black. Any AutoCAD colour number may be specified as the screen back‐ ground; colour numbers are assumed to specify the hues defined in the standard AutoCAD 256 colour palette." }, { "flag": "", "long": null, "arg": null, "description": "a short-cut. Specifying -white is identical in effect to -background 7." }, { "flag": "", "long": null, "arg": null, "description": "If the source pixmap had non-square pixels, the ratio of the pixel width to pixel height should be specified as ratio. The resulting slide or .dxb file will be cor‐ rected so that pixels on the AutoCAD screen will be square. For example, to correct an image made for a 320x200 VGA/MCGA screen, specify -aspect 0.8333." }, { "flag": "-8", "long": null, "arg": null, "description": "All flags can be abbreviated to their shortest unique prefix." } ], "examples": [], "see_also": [ { "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": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 3, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-dxb", "lines": 6 }, { "name": "-poly -dxb", "lines": 7 }, { "name": "-background", "lines": 10 }, { "name": "-white", "lines": 2 }, { "name": "-aspect", "lines": 5 }, { "name": "-8", "lines": 2, "flag": "-8" } ] }, { "name": "BUGS", "lines": 16, "subsections": [] }, { "name": "SEE ALSO", "lines": 3, "subsections": [] }, { "name": "AUTHOR", "lines": 18, "subsections": [] } ], "sections": { "NAME": { "content": "ppmtoacad - convert portable pixmap to AutoCAD database or slide\n", "subsections": [] }, "SYNOPSIS": { "content": "ppmtoacad [-dxb] [-poly] [-background colour] [-white] [-aspect ratio] [-8] [ppmfile]\n", "subsections": [] }, "DESCRIPTION": { "content": "Reads a portable pixmap as input. Produces an AutoCAD® slide file or binary database import\n(.dxb) file as output. If no ppmfile is specified, input is read from standard input.\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-dxb", "content": "DXBIN command and, once loaded, becomes part of the AutoCAD geometrical database and\ncan be viewed and edited like any other object. Each sequence of identical pixels be‐\ncomes a separate object in the database; this can result in very large AutoCAD drawing\nfiles. However, if you want to trace over a bitmap, it lets you zoom and pan around\nthe bitmap as you wish.\n" }, { "name": "-poly -dxb", "content": "Normally each row of pixels is represented by an AutoCAD line entity. If -poly is se‐\nlected, the pixels are rendered as filled polygons. If the slide is viewed on a dis‐\nplay with higher resolution than the source pixmap, this will cause the pixels to ex‐\npand instead of appearing as discrete lines against the screen background colour. Re‐\ngrettably, this representation yields slide files which occupy more disc space and\ntake longer to display.\n" }, { "name": "-background", "content": "Most AutoCAD display drivers can be configured to use any available colour as the\nscreen background. Some users perfer a black screen background, others white, while\nsplinter groups advocate burnt ocher, tawny puce, and shocking grey. Discarding pix‐\nels whose closest AutoCAD colour representation is equal to the background colour can\nsubstantially reduce the size of the AutoCAD database or slide file needed to repre‐\nsent a bitmap. If no -background colour is specified, the screen background colour is\nassumed to be black. Any AutoCAD colour number may be specified as the screen back‐\nground; colour numbers are assumed to specify the hues defined in the standard AutoCAD\n256 colour palette.\n" }, { "name": "-white", "content": "a short-cut. Specifying -white is identical in effect to -background 7.\n" }, { "name": "-aspect", "content": "If the source pixmap had non-square pixels, the ratio of the pixel width to pixel\nheight should be specified as ratio. The resulting slide or .dxb file will be cor‐\nrected so that pixels on the AutoCAD screen will be square. For example, to correct\nan image made for a 320x200 VGA/MCGA screen, specify -aspect 0.8333.\n" }, { "name": "-8", "content": "All flags can be abbreviated to their shortest unique prefix.\n", "flag": "-8" } ] }, "BUGS": { "content": "AutoCAD has a fixed palette of 256 colours, distributed along the hue, lightness, and satura‐\ntion axes. Pixmaps which contain many nearly-identical colours, or colours not closely ap‐\nproximated by AutoCAD's palette, may be poorly rendered.\n\nppmtoacad works best if the system displaying its output supports the full 256 colour AutoCAD\npalette. Monochrome, 8 colour, and 16 colour configurations will produce less than optimal\nresults.\n\nWhen creating a .dxb file or a slide file with the -poly option, ppmtoacad finds both verti‐\ncal and horizontal runs of identical pixels and consolidates them into rectangular regions to\nreduce the size of the output file. This is effective for images with large areas of con‐\nstant colour but it's no substitute for true raster to vector conversion. In particular,\nthin diagonal lines are not optimised at all by this process.\n\nOutput files can be huge.\n", "subsections": [] }, "SEE ALSO": { "content": "AutoCAD Reference Manual: Slide File Format and Binary Drawing Interchange (DXB) Files,\nppm(5)\n", "subsections": [] }, "AUTHOR": { "content": "John Walker\nAutodesk SA\nAvenue des Champs-Montants 14b\nCH-2074 MARIN\nSuisse/Schweiz/Svizzera/Svizra/Switzerland\nUsenet: kelvin@Autodesk.com\nFax: 038/33 88 15\nVoice: 038/33 76 33\n\nPermission to use, copy, modify, and distribute this software and its documentation for any\npurpose and without fee is hereby granted, without any conditions or restrictions. This\nsoftware is provided ``as is'' without express or implied warranty.\n\nAutoCAD and Autodesk are registered trademarks of Autodesk, Inc.\n\n\n\n10 October 1991 ppmtoacad(1)", "subsections": [] } } } }