From dfa023251c4be1634d23d36f7294f2b8e34216ec Mon Sep 17 00:00:00 2001
From: Juri Dispan <juri.dispan@posteo.net>
Date: Sun, 17 Dec 2023 17:28:38 +0100
Subject: [PATCH] fiascotopnm, pnmtofiasco: add pages (#11752)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* fiascotopnm, pnmtofiasco: add pages

* Apply suggestions from code review

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

* Update pages/common/pnmtofiasco.md

Co-authored-by: pixel häußler <pixel+github@chrissx.de>

---------

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: pixel häußler <pixel+github@chrissx.de>
---
 pages/common/fiascotopnm.md | 24 ++++++++++++++++++++++++
 pages/common/pnmtofiasco.md | 20 ++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 pages/common/fiascotopnm.md
 create mode 100644 pages/common/pnmtofiasco.md

diff --git a/pages/common/fiascotopnm.md b/pages/common/fiascotopnm.md
new file mode 100644
index 000000000..b71dbd516
--- /dev/null
+++ b/pages/common/fiascotopnm.md
@@ -0,0 +1,24 @@
+# fiascotopnm
+
+> Convert a compressed FIASCO file to a PNM image.
+> More information: <https://netpbm.sourceforge.net/doc/fiascotopnm.html>.
+
+- Convert a compressed FIASCO file to a PNM file or in the case of video streams multiple PNM files:
+
+`fiascotopnm {{path/to/file.fiasco}} -o {{output_file_basename}}`
+
+- Use fast decompression, resulting in a slightly decreased quality of the output file(s):
+
+`fiascotopnm --fast {{path/to/file.fiasco}} -o {{output_file_basename}}`
+
+- Load the options to be used from the specified configuration file:
+
+`fiascotopnm --config {{path/to/fiascorc}} {{path/to/file.fiasco}} -o {{output_file_basename}}`
+
+- Magnify the decompressed image(s) by a factor of 2^n:
+
+`fiascotopnm --magnify {{n}} {{path/to/file.fiasco}} -o {{output_file_basename}}`
+
+- Smooth the decompressed image by the specified amount:
+
+`fiascotopnm --smooth {{n}} {{path/to/file.fiasco}} -o {{output_file_basename}}`
diff --git a/pages/common/pnmtofiasco.md b/pages/common/pnmtofiasco.md
new file mode 100644
index 000000000..bcb5483c5
--- /dev/null
+++ b/pages/common/pnmtofiasco.md
@@ -0,0 +1,20 @@
+# pnmtofiasco
+
+> Convert a PNM image to a compressed FIASCO file.
+> More information: <https://netpbm.sourceforge.net/doc/pnmtofiasco.html>.
+
+- Convert a PNM image to a compressed FIASCO file:
+
+`pnmtofiasco {{path/to/file.pnm}} > {{path/to/file.fiasco}}`
+
+- Specify the [i]nput files through a pattern:
+
+`pnmtofiasco --image-name "{{img[01-09+1].pnm}}" > {{path/to/file.fiasco}}`
+
+- Specify the compression quality:
+
+`pnmtofiasco --quality {{quality_level}} {{path/to/file.pnm}} > {{path/to/file.fiasco}}`
+
+- Load the options to be used from the specified configuration file:
+
+`pnmtofiasco --config {{path/to/fiascorc}} {{path/to/file.pnm}} > {{path/to/file.fiasco}}`