{
    "mode": "man",
    "parameter": "ppmspread",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/ppmspread/1/json",
    "generated": "2026-10-22T10:04:42Z",
    "synopsis": "ppmspread amount [ppmfile] [-randomseed=integer]",
    "sections": {
        "NAME": {
            "content": "ppmspread - displace a PPM image's pixels by a random amount\n\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "ppmspread amount [ppmfile] [-randomseed=integer]\n\n\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "This program is part of Netpbm(1).\n\nppmspread  reads  a  PPM image as input and moves every pixel around a random bit relative to\nits original position. amount determines by how many pixels a pixel is to be moved around  at\nmost.\n\nPictures  processed  with  this  filter will seem to be somewhat dissolved or unfocussed (al‐\nthough they appear more coarse than images processed by something like pnmconvol).\n\nThe randomness in the image is limited before Netpbm 10.37 (December 2006) -- if you run  the\nprogram twice in the same second, you may get identical output.\n\n\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "In  addition  to  the options common to all programs based on libnetpbm (most notably -quiet,\nsee  Common Options ), ppmspread recognizes the following command line options:\n\n\n\n",
            "subsections": [
                {
                    "name": "-randomseed=_",
                    "content": "This is the seed for the random number generator that generates the pixels.\n\nUse this to ensure you get the same image on separate invocations.\n\nThis option was new in Netpbm 10.94 (March 2021).\n\n\n\n\n"
                }
            ]
        },
        "SEE ALSO": {
            "content": "ppm(1), pnmconvol(1)\n\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Copyright (C) 1993 by Frank Neumann\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/ppmspread.html\n\nnetpbm documentation                        06 March 2021                   Ppmspread User Manual(1)",
            "subsections": []
        }
    },
    "summary": "ppmspread - displace a PPM image's pixels by a random amount",
    "flags": [
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "This is the seed for the random number generator that generates the pixels. Use this to ensure you get the same image on separate invocations. This option was new in Netpbm 10.94 (March 2021)."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "ppm",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/ppm/1/json"
        },
        {
            "name": "pnmconvol",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/pnmconvol/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Displace the pixels in a PPM image by a randomized amount.",
        "examples": [
            {
                "description": "Displace the pixels in a PPM image by a randomized amount that is at most `a`",
                "command": "ppmspread {{a}} {{path/to/input_file.ppm}} > {{path/to/output_file.ppm}}"
            },
            {
                "description": "Specify a seed to a the pseudo-random number generator",
                "command": "ppmspread {{a}} {{path/to/input_file.ppm}} {{-r|-randomseed}} {{seed}} > {{path/to/output_file.ppm}}"
            }
        ]
    }
}