pnmtopalm: add page; palmtopnm: modify page (#11751)

* palmtopnm, pnmtopalm: add pages

* move to common

* fix typos

* Update pages/common/palmtopnm.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/common/pnmtopalm.md

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

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

pages/common/palmtopnm.md

@@ -1,20 +1,24 @@
 # palmtopnm
 
-> Convert a Palm Bitmap file to a PNM image.
+> Convert a Palm bitmap file to a PNM image.
 > More information: <https://netpbm.sourceforge.net/doc/palmtopnm.html>.
 
-- Generate the PNM image as output, for a Palm Bitmap file as input:
+- Convert a Palm bitmap to a PNM image:
 
-`palmtopnm {{path/to/file.palm}}`
+`palmtopnm {{path/to/file.palm}} > {{path/to/file.pnm}}`
 
-- Display various information about the input Palm Bitmap file and process:
+- Display information about the input file:
 
-`palmtopnm -verbose {{path/to/file.palm}}`
+`palmtopnm -verbose {{path/to/file.palm}} > {{path/to/file.pnm}}`
 
-- Generate a histogram of colours in the input Palm Bitmap file to `stderr`:
+- Convert the n'th rendition of the image contained in the input file:
 
-`palmtopnm -showhist {{path/to/file.palm}}`
+`palmtopnm -rendition {{n}} {{path/to/file.palm}} > {{path/to/file.pnm}}`
 
-- Display version:
+- Write a histogram of the colors in the input file to `stdout`:
 
-`palmtopnm -version`
+`palmtopnm -showhist {{path/to/file.palm}} > {{path/to/file.pnm}}`
+
+- Output the transparent color of the input image if set:
+
+`palmtopnm -transparent {{path/to/file.palm}}`

pages/common/pnmtopalm.md

@@ -0,0 +1,24 @@
+# pnmtopalm
+
+> Convert a PNM image to a Palm bitmap.
+> More information: <https://netpbm.sourceforge.net/doc/pnmtopalm.html>.
+
+- Convert a PNM image to a Palm bitmap:
+
+`pnmtopalm {{path/to/file.pnm}} > {{path/to/file.palm}}`
+
+- Specify the color depth of the resulting bitmap:
+
+`pnmtopalm -depth {{1|2|4|8|16}} {{path/to/file.pnm}} > {{path/to/file.palm}}`
+
+- Choose a compression method for the resulting bitmap:
+
+`pnmtopalm -{{scanline_compression|rle_compression|packbits_compression}} {{path/to/file.pnm}} > {{path/to/file.palm}}`
+
+- Build a custom colormap and include it in the resulting bitmap:
+
+`pnmtopalm -colormap {{path/to/file.pnm}} > {{path/to/file.palm}}`
+
+- Specify the bitmap's density:
+
+`pnmtopalm -density {{72|108|144|216|288}} {{path/to/file.pnm}} > {{path/to/file.palm}}`