From 45fde3268926a8619a221fbf4b062d178b9c13fd Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Sun, 17 Dec 2023 17:15:54 +0100
Subject: [PATCH] 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 | 22 +++++++++++++---------
 pages/common/pnmtopalm.md | 24 ++++++++++++++++++++++++
 2 files changed, 37 insertions(+), 9 deletions(-)
 create mode 100644 pages/common/pnmtopalm.md

diff --git a/pages/common/palmtopnm.md b/pages/common/palmtopnm.md
index 1fe4d8ea46..c818426fe8 100644
--- a/pages/common/palmtopnm.md
+++ b/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}}`
diff --git a/pages/common/pnmtopalm.md b/pages/common/pnmtopalm.md
new file mode 100644
index 0000000000..018d22e738
--- /dev/null
+++ b/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}}`