pambackground, pamstretch-gen, pamstretch, pbmclean, pbmmask, pbmpage, pbmpscale: add pages (#12237)

* pambackground, pamstretch-gen, pamstretch, pbmclean, pbmmask, pbmpage, pbmpscale: add pages

* add missing linefeed

* Update pages/common/pamstretch.md

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* Apply suggestions from code review

Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>

---------

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>

pages/common/pambackground.md

@@ -0,0 +1,9 @@
+# pambackground
+
+> Create a mask of the background in a PAM image.
+> See also: `pbmmask`.
+> More information: <https://netpbm.sourceforge.net/doc/pambackground.html>.
+
+- Create a mask of the background in a PAM image:
+
+`pambackground {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pamstretch-gen.md

@@ -0,0 +1,9 @@
+# pamstretch-gen
+
+> Scale up a PAM image by decimal values.
+> See also: `pamstretch`, `pamenlarge`, `pamscale`.
+> More information: <https://netpbm.sourceforge.net/doc/pamstretch-gen.html>.
+
+- Scale up a PAM image by the specified decimal factor:
+
+`pamstretch-gen {{N}} {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pamstretch.md

@@ -0,0 +1,13 @@
+# pamstretch
+
+> Scale up a PAM image by interpolating between pixels.
+> See also: `pamstretch-gen`, `pamenlarge`, `pamscale`.
+> More information: <https://netpbm.sourceforge.net/doc/pamstretch.html>.
+
+- Scale up a PAM image by an integer factor:
+
+`pamstretch {{N}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+
+- Scale up a PAM image by the specified factors in the horizontal and vertical directions:
+
+`pamstretch -xscale {{XN}} -yscale {{YN}} {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pbmclean.md

@@ -0,0 +1,16 @@
+# pbmclean
+
+> Clean up a PBM image by erasing isolated black and white pixels.
+> More information: <https://netpbm.sourceforge.net/doc/pbmclean.html>.
+
+- Clean up a PBM image by erasing isolated black and white pixels:
+
+`pbmclean {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+
+- Clean up only black/white pixels:
+
+`pbmclean -{{black|white}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+
+- Specify the minimum number of neighbouring pixels of the same color in order for a pixel not to be considered isolated:
+
+`pbmclean -minneighbours {{3}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`

pages/common/pbmmask.md

@@ -0,0 +1,13 @@
+# pbmmask
+
+> Create a mask bitmap from a regular bitmap.
+> See also: `pambackground`.
+> More information: <https://netpbm.sourceforge.net/doc/pbmmask.html>.
+
+- Create a mask bitmap separating background from foreground:
+
+`pbmmask {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+
+- Expand the generated mask by one pixel:
+
+`pbmmask -expand {{path/to/image.pbm}} > {{path/to/output.pbm}}`

pages/common/pbmpage.md

@@ -0,0 +1,16 @@
+# pbmpage
+
+> Generate a test pattern for printing.
+> More information: <https://netpbm.sourceforge.net/doc/pbmpage.html>.
+
+- Generate a test pattern for printing onto US standard paper:
+
+`pbmpage > {{path/to/file.pbm}}`
+
+- Generate a test pattern for printing onto A4 paper:
+
+`pbmpage -a4 > {{path/to/file.pbm}}`
+
+- Specify the pattern to use:
+
+`pbmpage {{1|2|3}} > {{path/to/file.pbm}}`

pages/common/pbmpscale.md

@@ -0,0 +1,9 @@
+# pbmpscale
+
+> Enlarge a PBM image with edge smoothing.
+> See also: `pamenlarge`.
+> More information: <https://netpbm.sourceforge.net/doc/pbmpscale.html>.
+
+- Enlarge a PBM image by the specified factor with edge smoothing:
+
+`pbmpscale {{N}} {{path/to/image.pbm}} > {{path/to/file.pbm}}`