pamditherbw: edit page; atktopbm, pamenlarge, pbmreduce, pbmtext, pbmtextps, pbmtoatk, pbmtobbnbg; add pages (#12236)

* pamditherbw: edit page; atktopbm, pamenlarge, pbmreduce, pbmtext, pbmtextps, pbmtoatk, pbmtobbnbg; add pages

---------

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

pages/common/atktopbm.md

@@ -0,0 +1,9 @@
+# atktopbm
+
+> Convert a Andrew Toolkit raster object to a PBM image.
+> See also: `pbmtoatk`.
+> More information: <https://netpbm.sourceforge.net/doc/atktopbm.html>.
+
+- Convert a Andrew Toolkit raster object to a PBM image:
+
+`atktopbm {{path/to/image.atk}} > {{path/to/output.pbm}}`

pages/common/pamditherbw.md

@@ -1,6 +1,7 @@
 # pamditherbw
 
 > Apply dithering to a greyscale image, i.e. turn it into a pattern of black and white pixels that look the same as the original greyscale.
+> See also: `pbmreduce`.
 > More information: <https://netpbm.sourceforge.net/doc/pamditherbw.html>.
 
 - Read a PGM image, apply dithering and save it to a file:

pages/common/pamenlarge.md

@@ -0,0 +1,13 @@
+# pamenlarge
+
+> Enlarge a PAM image by duplicating pixels.
+> See also: `pbmreduce`, `pamditherbw`, `pbmpscale`.
+> More information: <https://netpbm.sourceforge.net/doc/pamenlarge.html>.
+
+- Enlarge the specified image by the specified factor:
+
+`pamenlarge -scale {{N}} {{path/to/image.pam}} > {{path/to/output.pam}}`
+
+- Enlarge the specified image by the specified factors horizontally and vertically:
+
+`pamenlarge -xscale {{XN}} -yscale {{YN}} {{path/to/image.pam}} > {{path/to/output.pam}}`

pages/common/pbmreduce.md

@@ -0,0 +1,17 @@
+# pbmreduce
+
+> Proportionally reduce a PBM image.
+> See also: `pamenlarge`, `pamditherbw`.
+> More information: <https://netpbm.sourceforge.net/doc/pbmreduce.html>.
+
+- Reduce the specified image by the specified factor:
+
+`pbmreduce {{N}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+
+- Use simple thresholding when reducing:
+
+`pbmreduce -threshold {{N}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`
+
+- Use the specified threshold for all quantizations:
+
+`pbmreduce -value {{0.6}} {{N}} {{path/to/image.pbm}} > {{path/to/output.pbm}}`

pages/common/pbmtext.md

@@ -0,0 +1,21 @@
+# pbmtext
+
+> Render text as a PBM image.
+> See also: `pbmtextps`.
+> More information: <https://netpbm.sourceforge.net/doc/pbmtext.html>.
+
+- Render a single line of text as a PBM image:
+
+`pbmtext "{{Hello World!}}" > {{path/to/output.pbm}}`
+
+- Render multiple lines of text as a PBM image:
+
+`echo "{{Hello\nWorld!}}" | pbmtext > {{path/to/output.pbm}}`
+
+- Render text using a custom font supplied as a PBM file:
+
+`pbmtext -font {{path/to/font.pbm}} "{{Hello World!}}" > {{path/to/output.pbm}}`
+
+- Specify the number of pixels between characters and lines:
+
+`echo "{{Hello\nWorld!}}" | pbmtext -space {{3}} -lspace {{10}} > {{path/to/output.pbm}}`

pages/common/pbmtextps.md

@@ -0,0 +1,21 @@
+# pbmtextps
+
+> Render text as a PBM image using PostScript.
+> See also: `pbmtext`.
+> More information: <https://netpbm.sourceforge.net/doc/pbmtextps.html>.
+
+- Render a single line of text as a PBM image:
+
+`pbmtextps "{{Hello World!}}" > {{path/to/output.pbm}}`
+
+- Specify the font and font size:
+
+`pbmtextps -font {{Times-Roman}} -fontsize {{30}}  "{{Hello World!}}" > {{path/to/output.pbm}}`
+
+- Specify the desired left and top margins:
+
+`pbmtextps -leftmargin {{70}} -topmargin {{162}}  "{{Hello World!}}" > {{path/to/output.pbm}}`
+
+- Do not output the rendered text as a PBM image, but a PostScript program that would create this image:
+
+`pbmtextps -dump-ps "{{Hello World!}}" > {{path/to/output.ps}}`

pages/common/pbmtoatk.md

@@ -0,0 +1,9 @@
+# pbmtoatk
+
+> Convert a PBM image to an Andrew Toolkit raster object.
+> See also: `atktopbm`.
+> More information: <https://netpbm.sourceforge.net/doc/pbmtoatk.html>.
+
+- Convert a PBM image to an Andrew Toolkit raster object:
+
+`pbmtoatk {{path/to/image.pbm}} > {{path/to/output.atk}}`

pages/common/pbmtobbnbg.md

@@ -0,0 +1,12 @@
+# pbmtobbnbg
+
+> Convert a PBM image to a BitGraph graphic.
+> More information: <https://netpbm.sourceforge.net/doc/pbmtobbnbg.html>.
+
+- Convert a PBM image to a BitGraph terminal Display Pixel Data sequence:
+
+`pbmtobbnbg < {{path/to/image.pbm}} > {{path/to/output.dpd}}`
+
+- Specify the rasterop:
+
+`pbmtobbnbg {{3}} < {{path/to/image.pbm}} > {{path/to/output.dpd}}`