{
    "mode": "man",
    "parameter": "fstopgm",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/fstopgm/1/json",
    "generated": "2026-06-02T19:34:32Z",
    "synopsis": "fstopgm [fsfile]",
    "sections": {
        "NAME": {
            "content": "fstopgm - convert a Usenix FaceSaver(tm) file into a portable graymap\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "fstopgm [fsfile]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Reads a Usenix FaceSaver(tm) file as input.  Produces a portable graymap as output.\n\nFaceSaver(tm)  files  sometimes  have  rectangular pixels.  While fstopgm won't re-scale them\ninto square pixels for you, it will give you the precise pnmscale command that  will  do  the\njob.  Because of this, reading a FaceSaver(tm) image is a two-step process.  First you do:\nfstopgm > /dev/null\nThis  will  tell  you  whether you need to use pnmscale.  Then use one of the following pipe‐\nlines:\nfstopgm | pgmnorm\nfstopgm | pnmscale -whatever | pgmnorm\nTo go to PBM, you want something more like one of these:\nfstopgm | pnmenlarge 3 | pgmnorm | pgmtopbm\nfstopgm | pnmenlarge 3 | pnmscale <whatever> | pgmnorm | pgmtopbm\nYou want to enlarge when going to a bitmap because otherwise you lose  information;  but  en‐\nlarging by more than 3 does not look good.\n\nFaceSaver is a registered trademark of Metron Computerware Ltd. of Oakland, CA.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "pgmtofs(1), pgm(5), pgmnorm(1), pnmenlarge(1), pnmscale(1), pgmtopbm(1)\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Copyright (C) 1989 by Jef Poskanzer.\n\n\n\n06 April 89                                  fstopgm(1)",
            "subsections": []
        }
    },
    "summary": "fstopgm - convert a Usenix FaceSaver(tm) file into a portable graymap",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "pgmtofs",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pgmtofs/1/json"
        },
        {
            "name": "pgm",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/pgm/5/json"
        },
        {
            "name": "pgmnorm",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pgmnorm/1/json"
        },
        {
            "name": "pnmenlarge",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pnmenlarge/1/json"
        },
        {
            "name": "pnmscale",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pnmscale/1/json"
        },
        {
            "name": "pgmtopbm",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pgmtopbm/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Convert a Usenix FaceSaver file into a PGM image.",
        "examples": [
            {
                "description": "Convert the specified Usenix FaceSaver file into a PGM image",
                "command": "fstopgm {{path/to/input.fs}} > {{path/to/output.pgm}}"
            }
        ]
    }
}