[RFC] Documentation: Add ISP feature support matrix
diff mbox series

Message ID 20250923125125.3452787-1-jai.luthra@ideasonboard.com
State New
Headers show
Series
  • [RFC] Documentation: Add ISP feature support matrix
Related show

Commit Message

Jai Luthra Sept. 23, 2025, 12:51 p.m. UTC
Add a new living document presenting a matrix of image processing
feature support across all currently supported platforms in libcamera.

This will hopefuly help in answering questions like is HDR supported
with Software ISP or is Auto Focus supported on Raspberry Pi?

This matrix will be regularly updated as new features and platforms are
added.

Signed-off-by: Jai Luthra <jai.luthra@ideasonboard.com>
---
This matrix is a WIP, as you may see with the number of "?" unknown
cells, thus marked this patch as an RFC, to get some early feedback.

Also most users also care about if their particular sensor is well
supported (and tuned) by libcamera for a particular platform. That is
out-of-scope for this particular patch, but would be quite nice to have
at some point.
---
 Documentation/index.rst              |   1 +
 Documentation/isp-feature-matrix.rst | 238 +++++++++++++++++++++++++++
 2 files changed, 239 insertions(+)
 create mode 100644 Documentation/isp-feature-matrix.rst

--
2.51.0

Comments

Naushir Patuck Sept. 23, 2025, 2:13 p.m. UTC | #1
Hi Jai,

Some updates for BCM2711 / 2712 marked below:

On Tue, 23 Sept 2025 at 13:51, Jai Luthra <jai.luthra@ideasonboard.com>
wrote:

> Add a new living document presenting a matrix of image processing
> feature support across all currently supported platforms in libcamera.
>
> This will hopefuly help in answering questions like is HDR supported
> with Software ISP or is Auto Focus supported on Raspberry Pi?
>
> This matrix will be regularly updated as new features and platforms are
> added.
>
> Signed-off-by: Jai Luthra <jai.luthra@ideasonboard.com>
> ---
> This matrix is a WIP, as you may see with the number of "?" unknown
> cells, thus marked this patch as an RFC, to get some early feedback.
>
> Also most users also care about if their particular sensor is well
> supported (and tuned) by libcamera for a particular platform. That is
> out-of-scope for this particular patch, but would be quite nice to have
> at some point.
> ---
>  Documentation/index.rst              |   1 +
>  Documentation/isp-feature-matrix.rst | 238 +++++++++++++++++++++++++++
>  2 files changed, 239 insertions(+)
>  create mode 100644 Documentation/isp-feature-matrix.rst
>
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index febd4e13..a74b8668 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -9,6 +9,7 @@
>     Introduction <self>
>     Feature Requirements <feature_requirements>
>     Runtime configuration <runtime_configuration>
> +   ISP feature support matrix <isp-feature-matrix>
>     Application Writer's Guide <guides/application-developer>
>     Python Bindings <python-bindings>
>     Public API <public-api/index>
> diff --git a/Documentation/isp-feature-matrix.rst
> b/Documentation/isp-feature-matrix.rst
> new file mode 100644
> index 00000000..ca0a67bd
> --- /dev/null
> +++ b/Documentation/isp-feature-matrix.rst
> @@ -0,0 +1,238 @@
> +.. SPDX-License-Identifier: CC-BY-SA-4.0
> +
> +libcamera ISP Feature Support Matrix
> +=====================================
> +
> +The following table shows the current status of ISP feature support across
> +different platforms in libcamera.
> +
> +.. list-table:: ISP Feature Support by Platform
> +   :header-rows: 1
> +   :stub-columns: 1
> +
> +   * - Feature
> +     - i.MX8MP (RKISP)
> +     - BCM2711 (Raspberry Pi 4)
> +     - BCM2712 (Raspberry Pi 5)
> +     - Intel IPU3
> +     - Mali C55
> +     - Software ISP (CPU)
> +
> +   * - Auto Gain Control Stats (AGC)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Auto Focus (AF)
> +     - 🛠️ (CDAF)
> +     - ✅ (PDAF with IMX708)
> +     - ✅ (PDAF with IMX708)
>

Should be CDAF/PDAF for 2711 and 2712.  I would probably remove IMX708 from
this as well.


> +     - ✅ (CDAF)
> +     - 🚫
> +     - ❓
> +
> +   * - HDR Stitching
> +     - ✅
> +     - ✅
>

For 2711, this is strictly software only.


> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Companding
> +     - ✅
> +     - 🚫
> +     - 🚫
>

Should be  ✅  for 2712.


> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - Black Level Subtraction (BLS)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Lens Shading Correction (LSC)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +
> +   * - Auto Whitebalance (AWB)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Defective Pixel Correction (DPC)
> +     - ✅
> +     - ❓
> +     - ✅
>

Should be  ✅  for 2711 and 2712.


> +     - 🚫
> +     - ✅
> +     - ❓
> +
> +   * - 2D Noise Filtering
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Local Tone Mapping
> +     - 🛠️
> +     - 🚫
> +     - 🚫
>

Should be  ✅  for 2712.


> +     - 🚫
> +     - 🚫
> +     - ❓
> +
> +   * - Demosaicing
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Chromatic Aberration Correction (CAC)
> +     - 🛠️
> +     - 🚫
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Sharpening
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Chroma Noise Reduction
> +     - 🚫
> +     - ❓
> +     - ❓
>

Should be  ✅  for both 2711 and 2712.


> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - 3D Noise Filtering
> +     - 🚫
> +     - 🚫
> +     - 🚫
>

Should be  ✅  for 2712.

Regards,
Naush


> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Color Correction Matrix (CCM)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Global Tone Mapping
> +     - 🛠️
> +     - ✅
> +     - ✅
> +     - ✅
> +     - 🛠️
> +     - ❓
> +
> +   * - Gamma Correction
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ✅
> +
> +   * - Color Space Conversion
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - ❓
> +     - ✅
> +
> +   * - Image Stabilization
> +     - 🛠️
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - Scaling
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - ✅
> +     - ✅
> +
> +   * - Multi-context
> +     - 🚫
> +     - 🛠️
> +     - 🛠️
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +Status Definitions
> +------------------
> +
> +✅ **Supported**
> +    Feature is fully implemented and working in libcamera.
> +
> +🛠️ **Needs Development**
> +    Feature is planned or being developed and may have partial or no
> +    functionality.
> +
> +🚫 **No Hardware**
> +    The underlying hardware does not support this feature.
> +
> +❓ **Unknown**
> +    Support status is unclear or has not been determined yet.
> +
> +Platform Notes
> +--------------
> +
> +* **i.MX8MP (RKISP)**: Uses the Rockchip ISP IP core integrated in the NXP
> +  i.MX8MP SoC
> +* **BCM2711/BCM2712**: Broadcom SoCs used in Raspberry Pi 4 and 5
> respectively
> +* **Intel IPU3**: Intel Image Processing Unit version 3
> +* **Mali C55**: ARM's camera ISP IP core
> +* **Software ISP (CPU)**: CPU-based image processing pipeline for
> platforms
> +  without hardware ISP
> +
> +Contributing
> +------------
> +
> +This feature matrix is maintained by the libcamera community and is
> updated as
> +new features are implemented or new platforms are supported.
> +
> +**Updating the Matrix**
> +    When adding support for a new ISP feature or platform (SoC), please
> update
> +    this matrix as part of the same patch or series. Ensure that the
> feature
> +    support status for all relevant platforms reflects the changes
> introduced.
> +
> +**Reporting Updates**
> +    If you notice any inaccuracies or outdated information in this matrix,
> +    please open an issue or submit a patch. Refer to the contributing
> +    guidelines in the :doc:`contributing` guide.
> --
> 2.51.0
>
>
Kieran Bingham Sept. 24, 2025, 10:41 a.m. UTC | #2
Quoting Jai Luthra (2025-09-23 13:51:23)
> Add a new living document presenting a matrix of image processing
> feature support across all currently supported platforms in libcamera.
> 
> This will hopefuly help in answering questions like is HDR supported
> with Software ISP or is Auto Focus supported on Raspberry Pi?
> 
> This matrix will be regularly updated as new features and platforms are
> added.
> 
> Signed-off-by: Jai Luthra <jai.luthra@ideasonboard.com>
> ---
> This matrix is a WIP, as you may see with the number of "?" unknown
> cells, thus marked this patch as an RFC, to get some early feedback.
> 
> Also most users also care about if their particular sensor is well
> supported (and tuned) by libcamera for a particular platform. That is
> out-of-scope for this particular patch, but would be quite nice to have
> at some point.

Yes, I'd love to see the corresponding table get started for sensor
modules/types too!

Thanks for working on this.

> ---
>  Documentation/index.rst              |   1 +
>  Documentation/isp-feature-matrix.rst | 238 +++++++++++++++++++++++++++
>  2 files changed, 239 insertions(+)
>  create mode 100644 Documentation/isp-feature-matrix.rst
> 
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index febd4e13..a74b8668 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -9,6 +9,7 @@
>     Introduction <self>
>     Feature Requirements <feature_requirements>
>     Runtime configuration <runtime_configuration>
> +   ISP feature support matrix <isp-feature-matrix>
>     Application Writer's Guide <guides/application-developer>
>     Python Bindings <python-bindings>
>     Public API <public-api/index>
> diff --git a/Documentation/isp-feature-matrix.rst b/Documentation/isp-feature-matrix.rst
> new file mode 100644
> index 00000000..ca0a67bd
> --- /dev/null
> +++ b/Documentation/isp-feature-matrix.rst
> @@ -0,0 +1,238 @@
> +.. SPDX-License-Identifier: CC-BY-SA-4.0
> +
> +libcamera ISP Feature Support Matrix
> +=====================================
> +
> +The following table shows the current status of ISP feature support across
> +different platforms in libcamera.
> +
> +.. list-table:: ISP Feature Support by Platform
> +   :header-rows: 1
> +   :stub-columns: 1
> +
> +   * - Feature
> +     - i.MX8MP (RKISP)
> +     - BCM2711 (Raspberry Pi 4)
> +     - BCM2712 (Raspberry Pi 5)
> +     - Intel IPU3
> +     - Mali C55
> +     - Software ISP (CPU)
> +
> +   * - Auto Gain Control Stats (AGC)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Auto Focus (AF)
> +     - 🛠️ (CDAF)
> +     - ✅ (PDAF with IMX708)
> +     - ✅ (PDAF with IMX708)
> +     - ✅ (CDAF)
> +     - 🚫
> +     - ❓
> +
> +   * - HDR Stitching
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Companding
> +     - ✅
> +     - 🚫
> +     - 🚫
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - Black Level Subtraction (BLS)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Lens Shading Correction (LSC)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +
> +   * - Auto Whitebalance (AWB)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Defective Pixel Correction (DPC)
> +     - ✅
> +     - ❓
> +     - ✅
> +     - 🚫
> +     - ✅
> +     - ❓
> +
> +   * - 2D Noise Filtering
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Local Tone Mapping
> +     - 🛠️
> +     - 🚫
> +     - 🚫
> +     - 🚫
> +     - 🚫
> +     - ❓
> +
> +   * - Demosaicing
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Chromatic Aberration Correction (CAC)
> +     - 🛠️
> +     - 🚫
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Sharpening
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Chroma Noise Reduction
> +     - 🚫
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - 3D Noise Filtering
> +     - 🚫
> +     - 🚫
> +     - 🚫
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Color Correction Matrix (CCM)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Global Tone Mapping
> +     - 🛠️
> +     - ✅
> +     - ✅
> +     - ✅
> +     - 🛠️
> +     - ❓
> +
> +   * - Gamma Correction
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ✅
> +
> +   * - Color Space Conversion
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - ❓
> +     - ✅
> +
> +   * - Image Stabilization
> +     - 🛠️
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - Scaling
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - ✅
> +     - ✅
> +
> +   * - Multi-context
> +     - 🚫
> +     - 🛠️
> +     - 🛠️
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +Status Definitions
> +------------------
> +
> +✅ **Supported**
> +    Feature is fully implemented and working in libcamera.
> +
> +🛠️ **Needs Development**
> +    Feature is planned or being developed and may have partial or no
> +    functionality.
> +
> +🚫 **No Hardware**
> +    The underlying hardware does not support this feature.
> +
> +❓ **Unknown**
> +    Support status is unclear or has not been determined yet.
> +
> +Platform Notes
> +--------------
> +
> +* **i.MX8MP (RKISP)**: Uses the Rockchip ISP IP core integrated in the NXP
> +  i.MX8MP SoC

I'm not sure we can call it the Rockchip ISP IP core integrated in the
NXP SoC.

Rockchip's IP is not integrated in NXP - but the ISP8000Nano which has a
shared heritage as the Rockchip ISP.

--
Kieran


> +* **BCM2711/BCM2712**: Broadcom SoCs used in Raspberry Pi 4 and 5 respectively
> +* **Intel IPU3**: Intel Image Processing Unit version 3
> +* **Mali C55**: ARM's camera ISP IP core
> +* **Software ISP (CPU)**: CPU-based image processing pipeline for platforms
> +  without hardware ISP
> +
> +Contributing
> +------------
> +
> +This feature matrix is maintained by the libcamera community and is updated as
> +new features are implemented or new platforms are supported.
> +
> +**Updating the Matrix**
> +    When adding support for a new ISP feature or platform (SoC), please update
> +    this matrix as part of the same patch or series. Ensure that the feature
> +    support status for all relevant platforms reflects the changes introduced.
> +
> +**Reporting Updates**
> +    If you notice any inaccuracies or outdated information in this matrix,
> +    please open an issue or submit a patch. Refer to the contributing
> +    guidelines in the :doc:`contributing` guide.
> --
> 2.51.0
>
Barnabás Pőcze Sept. 25, 2025, 11:43 a.m. UTC | #3
Hi

2025. 09. 23. 14:51 keltezéssel, Jai Luthra írta:
> Add a new living document presenting a matrix of image processing
> feature support across all currently supported platforms in libcamera.
> 
> This will hopefuly help in answering questions like is HDR supported
> with Software ISP or is Auto Focus supported on Raspberry Pi?
> 
> This matrix will be regularly updated as new features and platforms are
> added.
> 
> Signed-off-by: Jai Luthra <jai.luthra@ideasonboard.com>
> ---
> This matrix is a WIP, as you may see with the number of "?" unknown
> cells, thus marked this patch as an RFC, to get some early feedback.
> 
> Also most users also care about if their particular sensor is well
> supported (and tuned) by libcamera for a particular platform. That is
> out-of-scope for this particular patch, but would be quite nice to have
> at some point.
> ---
>   Documentation/index.rst              |   1 +
>   Documentation/isp-feature-matrix.rst | 238 +++++++++++++++++++++++++++
>   2 files changed, 239 insertions(+)
>   create mode 100644 Documentation/isp-feature-matrix.rst

This is missing an update to `Documentation/meson.build:docs_sources`.
Otherwise I think the table looks good (looks-wise, I cannot say anything
about the content) both in light and dark themes; and even if the view port
width is small, it can be scrolled vertically.


> 
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index febd4e13..a74b8668 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -9,6 +9,7 @@
>      Introduction <self>
>      Feature Requirements <feature_requirements>
>      Runtime configuration <runtime_configuration>
> +   ISP feature support matrix <isp-feature-matrix>
>      Application Writer's Guide <guides/application-developer>
>      Python Bindings <python-bindings>
>      Public API <public-api/index>
> diff --git a/Documentation/isp-feature-matrix.rst b/Documentation/isp-feature-matrix.rst
> new file mode 100644
> index 00000000..ca0a67bd
> --- /dev/null
> +++ b/Documentation/isp-feature-matrix.rst
> @@ -0,0 +1,238 @@
> +.. SPDX-License-Identifier: CC-BY-SA-4.0
> +
> +libcamera ISP Feature Support Matrix
> +=====================================
> +
> +The following table shows the current status of ISP feature support across
> +different platforms in libcamera.
> +
> +.. list-table:: ISP Feature Support by Platform
> +   :header-rows: 1
> +   :stub-columns: 1
> +
> +   * - Feature
> +     - i.MX8MP (RKISP)
> +     - BCM2711 (Raspberry Pi 4)
> +     - BCM2712 (Raspberry Pi 5)
> +     - Intel IPU3
> +     - Mali C55
> +     - Software ISP (CPU)
> +
> +   * - Auto Gain Control Stats (AGC)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Auto Focus (AF)
> +     - 🛠️ (CDAF)
> +     - ✅ (PDAF with IMX708)
> +     - ✅ (PDAF with IMX708)
> +     - ✅ (CDAF)
> +     - 🚫
> +     - ❓
> +
> +   * - HDR Stitching
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Companding
> +     - ✅
> +     - 🚫
> +     - 🚫
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - Black Level Subtraction (BLS)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Lens Shading Correction (LSC)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +
> +   * - Auto Whitebalance (AWB)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Defective Pixel Correction (DPC)
> +     - ✅
> +     - ❓
> +     - ✅
> +     - 🚫
> +     - ✅
> +     - ❓
> +
> +   * - 2D Noise Filtering
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Local Tone Mapping
> +     - 🛠️
> +     - 🚫
> +     - 🚫
> +     - 🚫
> +     - 🚫
> +     - ❓
> +
> +   * - Demosaicing
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Chromatic Aberration Correction (CAC)
> +     - 🛠️
> +     - 🚫
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Sharpening
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Chroma Noise Reduction
> +     - 🚫
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - 3D Noise Filtering
> +     - 🚫
> +     - 🚫
> +     - 🚫
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +   * - Color Correction Matrix (CCM)
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ✅
> +
> +   * - Global Tone Mapping
> +     - 🛠️
> +     - ✅
> +     - ✅
> +     - ✅
> +     - 🛠️
> +     - ❓
> +
> +   * - Gamma Correction
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - 🛠️
> +     - ✅
> +
> +   * - Color Space Conversion
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - ❓
> +     - ✅
> +
> +   * - Image Stabilization
> +     - 🛠️
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +     - ❓
> +
> +   * - Scaling
> +     - ✅
> +     - ✅
> +     - ✅
> +     - ❓
> +     - ✅
> +     - ✅
> +
> +   * - Multi-context
> +     - 🚫
> +     - 🛠️
> +     - 🛠️
> +     - ❓
> +     - 🛠️
> +     - ❓
> +
> +Status Definitions
> +------------------
> +
> +✅ **Supported**
> +    Feature is fully implemented and working in libcamera.
> +
> +🛠️ **Needs Development**
> +    Feature is planned or being developed and may have partial or no
> +    functionality.
> +
> +🚫 **No Hardware**
> +    The underlying hardware does not support this feature.
> +
> +❓ **Unknown**
> +    Support status is unclear or has not been determined yet.
> +
> +Platform Notes
> +--------------
> +
> +* **i.MX8MP (RKISP)**: Uses the Rockchip ISP IP core integrated in the NXP
> +  i.MX8MP SoC
> +* **BCM2711/BCM2712**: Broadcom SoCs used in Raspberry Pi 4 and 5 respectively
> +* **Intel IPU3**: Intel Image Processing Unit version 3
> +* **Mali C55**: ARM's camera ISP IP core
> +* **Software ISP (CPU)**: CPU-based image processing pipeline for platforms
> +  without hardware ISP

I think I would omit the "for platforms without hardware ISP" part because it can also
be used if the ISP is just not supported, and even then, one can use it even if
the platform would otherwise be supported.


Regards,
Barnabás Pőcze


> +
> +Contributing
> +------------
> +
> +This feature matrix is maintained by the libcamera community and is updated as
> +new features are implemented or new platforms are supported.
> +
> +**Updating the Matrix**
> +    When adding support for a new ISP feature or platform (SoC), please update
> +    this matrix as part of the same patch or series. Ensure that the feature
> +    support status for all relevant platforms reflects the changes introduced.
> +
> +**Reporting Updates**
> +    If you notice any inaccuracies or outdated information in this matrix,
> +    please open an issue or submit a patch. Refer to the contributing
> +    guidelines in the :doc:`contributing` guide.
> --
> 2.51.0
>

Patch
diff mbox series

diff --git a/Documentation/index.rst b/Documentation/index.rst
index febd4e13..a74b8668 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -9,6 +9,7 @@ 
    Introduction <self>
    Feature Requirements <feature_requirements>
    Runtime configuration <runtime_configuration>
+   ISP feature support matrix <isp-feature-matrix>
    Application Writer's Guide <guides/application-developer>
    Python Bindings <python-bindings>
    Public API <public-api/index>
diff --git a/Documentation/isp-feature-matrix.rst b/Documentation/isp-feature-matrix.rst
new file mode 100644
index 00000000..ca0a67bd
--- /dev/null
+++ b/Documentation/isp-feature-matrix.rst
@@ -0,0 +1,238 @@ 
+.. SPDX-License-Identifier: CC-BY-SA-4.0
+
+libcamera ISP Feature Support Matrix
+=====================================
+
+The following table shows the current status of ISP feature support across
+different platforms in libcamera.
+
+.. list-table:: ISP Feature Support by Platform
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - Feature
+     - i.MX8MP (RKISP)
+     - BCM2711 (Raspberry Pi 4)
+     - BCM2712 (Raspberry Pi 5)
+     - Intel IPU3
+     - Mali C55
+     - Software ISP (CPU)
+
+   * - Auto Gain Control Stats (AGC)
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+
+   * - Auto Focus (AF)
+     - 🛠️ (CDAF)
+     - ✅ (PDAF with IMX708)
+     - ✅ (PDAF with IMX708)
+     - ✅ (CDAF)
+     - 🚫
+     - ❓
+
+   * - HDR Stitching
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+     - 🛠️
+     - ❓
+
+   * - Companding
+     - ✅
+     - 🚫
+     - 🚫
+     - ❓
+     - ❓
+     - ❓
+
+   * - Black Level Subtraction (BLS)
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+
+   * - Lens Shading Correction (LSC)
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+
+   * - Auto Whitebalance (AWB)
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+
+   * - Defective Pixel Correction (DPC)
+     - ✅
+     - ❓
+     - ✅
+     - 🚫
+     - ✅
+     - ❓
+
+   * - 2D Noise Filtering
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+     - 🛠️
+     - ❓
+
+   * - Local Tone Mapping
+     - 🛠️
+     - 🚫
+     - 🚫
+     - 🚫
+     - 🚫
+     - ❓
+
+   * - Demosaicing
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+
+   * - Chromatic Aberration Correction (CAC)
+     - 🛠️
+     - 🚫
+     - ✅
+     - ❓
+     - 🛠️
+     - ❓
+
+   * - Sharpening
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+     - 🛠️
+     - ❓
+
+   * - Chroma Noise Reduction
+     - 🚫
+     - ❓
+     - ❓
+     - ❓
+     - ❓
+     - ❓
+
+   * - 3D Noise Filtering
+     - 🚫
+     - 🚫
+     - 🚫
+     - ❓
+     - 🛠️
+     - ❓
+
+   * - Color Correction Matrix (CCM)
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+     - ✅
+
+   * - Global Tone Mapping
+     - 🛠️
+     - ✅
+     - ✅
+     - ✅
+     - 🛠️
+     - ❓
+
+   * - Gamma Correction
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+     - 🛠️
+     - ✅
+
+   * - Color Space Conversion
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+     - ❓
+     - ✅
+
+   * - Image Stabilization
+     - 🛠️
+     - ❓
+     - ❓
+     - ❓
+     - ❓
+     - ❓
+
+   * - Scaling
+     - ✅
+     - ✅
+     - ✅
+     - ❓
+     - ✅
+     - ✅
+
+   * - Multi-context
+     - 🚫
+     - 🛠️
+     - 🛠️
+     - ❓
+     - 🛠️
+     - ❓
+
+Status Definitions
+------------------
+
+✅ **Supported**
+    Feature is fully implemented and working in libcamera.
+
+🛠️ **Needs Development**
+    Feature is planned or being developed and may have partial or no
+    functionality.
+
+🚫 **No Hardware**
+    The underlying hardware does not support this feature.
+
+❓ **Unknown**
+    Support status is unclear or has not been determined yet.
+
+Platform Notes
+--------------
+
+* **i.MX8MP (RKISP)**: Uses the Rockchip ISP IP core integrated in the NXP
+  i.MX8MP SoC
+* **BCM2711/BCM2712**: Broadcom SoCs used in Raspberry Pi 4 and 5 respectively
+* **Intel IPU3**: Intel Image Processing Unit version 3
+* **Mali C55**: ARM's camera ISP IP core
+* **Software ISP (CPU)**: CPU-based image processing pipeline for platforms
+  without hardware ISP
+
+Contributing
+------------
+
+This feature matrix is maintained by the libcamera community and is updated as
+new features are implemented or new platforms are supported.
+
+**Updating the Matrix**
+    When adding support for a new ISP feature or platform (SoC), please update
+    this matrix as part of the same patch or series. Ensure that the feature
+    support status for all relevant platforms reflects the changes introduced.
+
+**Reporting Updates**
+    If you notice any inaccuracies or outdated information in this matrix,
+    please open an issue or submit a patch. Refer to the contributing
+    guidelines in the :doc:`contributing` guide.