{ "content": [ { "type": "text", "text": "# ppmtoicr (info)\n\n## NAME\n\nppmtoicr - convert a portable pixmap into NCSA ICR format\n\n## SYNOPSIS\n\nppmtoicr [-windowname name] [-expand expand] [-display display] [-rle]\n[ppmfile]\n\n## DESCRIPTION\n\nReads a portable pixmap file as input. Produces an NCSA Telnet Inter-\nactive Color Raster graphic file as output. If ppmfile is not sup-\nplied, ppmtoicr will read from standard input.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (2 subsections)\n- **EXAMPLES**\n- **BUGS**\n- **SEE ALSO**\n- **AUTHOR**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "ppmtoicr", "section": "", "mode": "info", "summary": "ppmtoicr - convert a portable pixmap into NCSA ICR format", "synopsis": "ppmtoicr [-windowname name] [-expand expand] [-display display] [-rle]\n[ppmfile]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": null, "arg": null, "description": "Output will be displayed in name (Default is to use ppm- file or \"untitled\" if standard input is read.) -expandexpand Output will be expanded on display by factor expand (For example, a value of 2 will cause four pixels to be dis- played for every input pixel.)" }, { "flag": "", "long": null, "arg": null, "description": "Output will be displayed on screen numbered display -rle Use run-length encoded format for display. (This will nearly always result in a quicker display, but may skew the colormap.)" } ], "examples": [ "To display a ppm file using the protocol:", "ppmtoicr ppmfile", "This will create a window named ppmfile on the display with the correct", "dimensions for ppmfile, create and download a colormap of up to 256", "colors, and download the picture into the window. The same effect may", "be achieved by the following sequence:", "ppmtoicr ppmfile > filename", "cat filename", "To display a GIF file using the protocol in a window titled after the", "input file, zoom the displayed image by a factor of 2, and run-length", "encode the data:", "giftopnm giffile | ppmtoicr -w giffile -r -e 2" ], "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": 3, "subsections": [] }, { "name": "DESCRIPTION", "lines": 16, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-windownamename", "lines": 7 }, { "name": "-displaydisplay", "lines": 6 } ] }, { "name": "EXAMPLES", "lines": 13, "subsections": [] }, { "name": "BUGS", "lines": 5, "subsections": [] }, { "name": "SEE ALSO", "lines": 5, "subsections": [] }, { "name": "AUTHOR", "lines": 4, "subsections": [] } ], "sections": { "NAME": { "content": "ppmtoicr - convert a portable pixmap into NCSA ICR format\n", "subsections": [] }, "SYNOPSIS": { "content": "ppmtoicr [-windowname name] [-expand expand] [-display display] [-rle]\n[ppmfile]\n", "subsections": [] }, "DESCRIPTION": { "content": "Reads a portable pixmap file as input. Produces an NCSA Telnet Inter-\nactive Color Raster graphic file as output. If ppmfile is not sup-\nplied, ppmtoicr will read from standard input.\n\nInteractive Color Raster (ICR) is a protocol for displaying raster\ngraphics on workstation screens. The protocol is implemented in NCSA\nTelnet for the Macintosh version 2.3. The ICR protocol shares charac-\nteristics of the Tektronix graphics terminal emulation protocol. For\nexample, escape sequences are used to control the display.\n\nppmtoicr will output the appropriate sequences to create a window of\nthe dimensions of the input pixmap, create a colormap of up to 256 col-\nors on the display, then load the picture data into the window.\n\nNote that there is no icrtoppm tool - this transformation is one way.\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-windownamename", "content": "Output will be displayed in name (Default is to use ppm-\nfile or \"untitled\" if standard input is read.)\n\n-expandexpand Output will be expanded on display by factor expand (For\nexample, a value of 2 will cause four pixels to be dis-\nplayed for every input pixel.)\n" }, { "name": "-displaydisplay", "content": "Output will be displayed on screen numbered display\n\n-rle Use run-length encoded format for display. (This will\nnearly always result in a quicker display, but may skew\nthe colormap.)\n" } ] }, "EXAMPLES": { "content": "To display a ppm file using the protocol:\nppmtoicr ppmfile\nThis will create a window named ppmfile on the display with the correct\ndimensions for ppmfile, create and download a colormap of up to 256\ncolors, and download the picture into the window. The same effect may\nbe achieved by the following sequence:\nppmtoicr ppmfile > filename\ncat filename\nTo display a GIF file using the protocol in a window titled after the\ninput file, zoom the displayed image by a factor of 2, and run-length\nencode the data:\ngiftopnm giffile | ppmtoicr -w giffile -r -e 2\n", "subsections": [] }, "BUGS": { "content": "The protocol uses frequent fflush calls to speed up display. If the\noutput is saved to a file for later display via cat, drawing will be\nmuch slower. In either case, increasing the Blocksize limit on the dis-\nplay will speed up transmission substantially.\n", "subsections": [] }, "SEE ALSO": { "content": "ppm(5)\n\nNCSA Telnet for the Macintosh, University of Illinois at Urbana-Cham-\npaign (1989)\n", "subsections": [] }, "AUTHOR": { "content": "Copyright (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU), Prince-\nton University Computing and Information Technology.\n\n30 July 1990 ppmtoicr(1)", "subsections": [] } } } }