This is an automated email from the ASF dual-hosted git repository.
linguini pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
The following commit(s) were added to refs/heads/master by this push:
new 32a8caf66b5 documentation: JPEGResizeTool application and libjpeg
32a8caf66b5 is described below
commit 32a8caf66b50541fc160c2b74046df61ad5d44f6
Author: Kevin Witteveen (MartiniMarter) <[email protected]>
AuthorDate: Sun Oct 26 12:39:17 2025 +0100
documentation: JPEGResizeTool application and libjpeg
Signed-off-by: Kevin Witteveen (MartiniMarter) <[email protected]>
---
.../applications/graphics/jpegresizetool/index.rst | 39 ++++++++++++++++++++++
.../applications/graphics/libjpeg/index.rst | 33 ++++++++++++++++--
2 files changed, 69 insertions(+), 3 deletions(-)
diff --git a/Documentation/applications/graphics/jpegresizetool/index.rst
b/Documentation/applications/graphics/jpegresizetool/index.rst
new file mode 100644
index 00000000000..9d9827c4448
--- /dev/null
+++ b/Documentation/applications/graphics/jpegresizetool/index.rst
@@ -0,0 +1,39 @@
+================
+JPEG Resize Tool
+================
+
+A lightweight utility for resizing JPEG images using parameters from the
``libjpeg`` library.
+This tool serves both as a simple example of how to use ``libjpeg`` and as a
practical scriptable resizer.
+
+Usage
+=====
+
+.. code-block:: bash
+
+ jpegresize <input.jpg> <output.jpg> <scale> <quality>
+
+Arguments
+---------
+
+- **input.jpg** — Path to the input JPEG image.
+- **output.jpg** — Path to the resized output image.
+- **scale** — Shrinking denominator. Currently, ``libjpeg`` supports values
``1``, ``2``, ``4``, or ``8``.
+ For example, a value of ``8`` reduces the image dimensions by a factor of 8.
+- **quality** — JPEG quality factor from ``0`` to ``100``.
+ - Above **80%**: compression is nearly unnoticeable.
+ - Around **20%**: strong compression artifacts appear.
+
+Example
+=======
+
+Shrink an image by 8× with 20% quality:
+
+.. code-block:: bash
+
+ jpegresize /sd/IMAGES/000000a1.jpg /sd/TEMP/THUMBS/000000a1.jpg 8 20
+
+Notes
+=====
+
+- This example assumes ``libjpeg`` is available in your build environment.
+- The tool is designed for simplicity and small-footprint image processing on
embedded systems or automation scripts.
diff --git a/Documentation/applications/graphics/libjpeg/index.rst
b/Documentation/applications/graphics/libjpeg/index.rst
index 726770892a2..f44104c5611 100644
--- a/Documentation/applications/graphics/libjpeg/index.rst
+++ b/Documentation/applications/graphics/libjpeg/index.rst
@@ -1,3 +1,30 @@
-=======================================
-``libjpeg`` libjpeg JPEG image encoding
-=======================================
+==========================================
+``libjpeg`` JPEG image encoding library
+==========================================
+
+``libjpeg`` is an open-source library that provides functionality for encoding
and decoding images in the JPEG format.
+It implements the baseline JPEG standard and is commonly used in image-related
applications and utilities.
+
+Including the library
+=====================
+
+To use ``libjpeg`` in a C program, include the main header:
+
+.. code-block:: c
+
+ #include <jpeglib.h>
+
+Configuration
+=============
+
+Support for ``libjpeg`` must be enabled in Kconfig:
+
+ CONFIG_LIBJPEG=y
+
+Example
+=======
+
+NuttX provides an example application that demonstrates how to encode, decode,
and resize JPEG images using ``libjpeg``.
+It can be found under:
+
+``apps/graphics/jpgresizetool``
