{
    "content": [
        {
            "type": "text",
            "text": "# asciitopgm (man)\n\n## NAME\n\nasciitopgm - convert ASCII graphics into a PGM\n\n## SYNOPSIS\n\nasciitopgm [-d divisor] height width [asciifile]\n\n## DESCRIPTION\n\nThis program is part of Netpbm(1).\n\n## TLDR\n\n> Convert ASCII graphics into a PGM file.\n\n- Read ASCII data as input and produce a PGM image with pixel values that are an approximation of the \"brightness\" of the ASCII characters:\n  `asciitopgm {{path/to/input_file}} > {{path/to/output_file.pgm}}`\n- Display version:\n  `asciitopgm {{-v|-version}}`\n\n*Source: tldr-pages*\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION** (1 subsections)\n- **OPTIONS** (1 subsections)\n- **SEE ALSO**\n- **AUTHOR**\n- **DOCUMENT SOURCE**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "asciitopgm",
        "section": "",
        "mode": "man",
        "summary": "asciitopgm - convert ASCII graphics into a PGM",
        "synopsis": "asciitopgm [-d divisor] height width [asciifile]",
        "tldr_summary": "Convert ASCII graphics into a PGM file.",
        "tldr_examples": [
            {
                "description": "Read ASCII data as input and produce a PGM image with pixel values that are an approximation of the \"brightness\" of the ASCII characters",
                "command": "asciitopgm {{path/to/input_file}} > {{path/to/output_file.pgm}}"
            },
            {
                "description": "Display version",
                "command": "asciitopgm {{-v|-version}}"
            }
        ],
        "tldr_source": "official",
        "flags": [
            {
                "flag": "-d",
                "long": null,
                "arg": null,
                "description": "Specify the value by which the blackness of an input character is divided. This is an integer value. Default value is 1. Larger values produce darker output images."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "pbmtoascii",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/pbmtoascii/1/json"
            },
            {
                "name": "pbmtext",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/pbmtext/1/json"
            },
            {
                "name": "pgm",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/pgm/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 21,
                "subsections": [
                    {
                        "name": "+ (plus),",
                        "lines": 11
                    }
                ]
            },
            {
                "name": "OPTIONS",
                "lines": 5,
                "subsections": [
                    {
                        "name": "-d _",
                        "lines": 6,
                        "flag": "-d"
                    }
                ]
            },
            {
                "name": "SEE ALSO",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DOCUMENT SOURCE",
                "lines": 6,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "asciitopgm - convert ASCII graphics into a PGM\n\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "asciitopgm [-d divisor] height width [asciifile]\n\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "This program is part of Netpbm(1).\n\nasciitopgm  reads ASCII data as input and produces a PGM image with pixel values which are an\napproximation of the \"brightness\" of the ASCII characters, assuming black-on-white  printing.\nIn other words, a capital M is very dark, a period is very light, and a space is white.\n\nObviously, asciitopgm assumes a certain font in assigning a brightness value to a character.\n\nasciitopgm  considers  ASCII control characters to be all white.  For a lower case character,\nIt assigns a special brightnesses which has nothing to do with what it  looks  like  printed.\nasciitopgm  takes  the ASCII character code from the lower 7 bits of each input byte.  But it\nwarns you if the most significant bit of any input byte is not zero.\n\nThe output image is height pixels high by width pixels  wide,  truncating  and  padding  with\nwhite on the right and bottom as necessary.\n\nThe divisor value is an integer (decimal) by which the blackness of an input character is di‐\nvided.  You can use this to adjust the brightness of the output: for example, if the image is\ntoo bright, increase the divisor.\n\nIn  a sort of reminiscence of Fortran line printer carriage control, where a line starts with",
                "subsections": [
                    {
                        "name": "+ (plus),",
                        "content": "row.   This  allows  a  larger range of gray values.  (In Fortran carriage control, the first\ncharacter of every line sent to the printer tells how much to advance the paper, with + mean‐\ning not at all, so that the rest of the characters on the line overstrike the ones already on\nthe paper.  What asciitopgm does is rather different in that asciitopgm does not reserve  the\nfirst character of every line that way.  If the first character is anything but +, asciitopgm\nconsiders it just to be first character of the image.\n\nIf  you're  looking  for something that creates an image of text, with that text specified in\nASCII, that is something quite different.  Use pbmtext for that.\n\n"
                    }
                ]
            },
            "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\\ ), asciitopgm recognizes the following command line option:\n\n\n",
                "subsections": [
                    {
                        "name": "-d _",
                        "content": "Specify the value by which the blackness of an input character is divided.  This is an\ninteger value.  Default value is 1.  Larger values produce darker output images.\n\n\n\n",
                        "flag": "-d"
                    }
                ]
            },
            "SEE ALSO": {
                "content": "pbmtoascii(1), pbmtext(1), pgm(1)\n\n",
                "subsections": []
            },
            "AUTHOR": {
                "content": "Wilson H. Bent. Jr. (whb@usc.edu)\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/asciitopgm.html\n\nnetpbm documentation                       20 January 2011                 Asciitopgm User Manual(1)",
                "subsections": []
            }
        }
    }
}