{
    "mode": "man",
    "parameter": "ppmtoicr",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/ppmtoicr/1/json",
    "generated": "2026-05-30T05:15:43Z",
    "synopsis": "ppmtoicr [-windowname name] [-expand expand] [-display display] [-rle] [ppmfile]",
    "sections": {
        "NAME": {
            "content": "ppmtoicr - convert a portable pixmap into NCSA ICR format\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "ppmtoicr [-windowname name] [-expand expand] [-display display] [-rle] [ppmfile]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Reads  a  portable  pixmap  file  as input.  Produces an NCSA Telnet Interactive Color Raster\ngraphic file as output.  If ppmfile is not supplied, ppmtoicr will read from standard input.\n\nInteractive Color Raster (ICR) is a protocol for displaying raster  graphics  on  workstation\nscreens.  The  protocol is implemented in NCSA Telnet for the Macintosh version 2.3.  The ICR\nprotocol shares characteristics 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 the dimensions of the\ninput pixmap, create a colormap of up to 256 colors on the display,  then  load  the  picture\ndata into the window.\n\nNote that there is no icrtoppm tool - this transformation is one way.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-windowname",
                    "content": "Output  will  be  displayed in name (Default is to use ppmfile or \"untitled\" if\nstandard input is read.)\n"
                },
                {
                    "name": "-expand",
                    "content": "will cause four pixels to be displayed for every input pixel.)\n"
                },
                {
                    "name": "-display",
                    "content": "Output will be displayed on screen numbered display\n"
                },
                {
                    "name": "-rle",
                    "content": "quicker display, but may skew the 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 dimensions  for  ppm‐\nfile,  create  and download a colormap of up to 256 colors, and download the picture into the\nwindow. The same effect may be achieved by the following sequence:\nppmtoicr ppmfile > filename\ncat filename\nTo display a GIF file using the protocol in a window titled after the input  file,  zoom  the\ndisplayed image by a factor of 2, and run-length encode 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 output is saved to a file\nfor later display via cat, drawing will be much slower. In either case, increasing the Block‐\nsize limit on the display will speed up transmission substantially.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "",
            "subsections": [
                {
                    "name": "ppm(5)",
                    "content": "NCSA Telnet for the Macintosh, University of Illinois at Urbana-Champaign (1989)\n"
                }
            ]
        },
        "AUTHOR": {
            "content": "Copyright (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU), Princeton University Computing\nand Information Technology.\n\n\n\n30 July 1990                                 ppmtoicr(1)",
            "subsections": []
        }
    },
    "summary": "ppmtoicr - convert a portable pixmap into NCSA ICR format",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Output will be displayed in name (Default is to use ppmfile or \"untitled\" if standard input is read.)"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "will cause four pixels to be displayed for every input pixel.)"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "Output will be displayed on screen numbered display"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "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  ppm‐",
        "file,  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": []
}