From 47ebb8788acce100371207ea37ac731b239e3e32 Mon Sep 17 00:00:00 2001 From: Andrew Murray Date: Fri, 18 Apr 2025 22:55:21 +1000 Subject: [PATCH 1/4] Added list of third party plugins --- docs/handbook/appendices.rst | 1 + docs/handbook/third-party-plugins.rst | 18 ++++++++++++++++++ 2 files changed, 19 insertions(+) create mode 100644 docs/handbook/third-party-plugins.rst diff --git a/docs/handbook/appendices.rst b/docs/handbook/appendices.rst index 347a8848b37..c20d8bc8bb2 100644 --- a/docs/handbook/appendices.rst +++ b/docs/handbook/appendices.rst @@ -8,4 +8,5 @@ Appendices image-file-formats text-anchors + third-party-plugins writing-your-own-image-plugin diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst new file mode 100644 index 00000000000..f49dd2389e6 --- /dev/null +++ b/docs/handbook/third-party-plugins.rst @@ -0,0 +1,18 @@ +Third Party Plugins +=================== + +Pillow uses a plugin model which allows users to add their own +decoders and encoders to the library, without any changes to the library +itself. + +Here is a list of PyPI projects that offer additional plugins: + + * :pypi:`DjvuRleImagePlugin`: Plugin for the DjVu RLE image format as defined in the DjVuLibre docs. + * :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library. + * :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL. + * :pypi:`pillow-heif`: Python bindings to libheif for working with HEIF images. + * :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11. + * :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings. + * :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format. + * :pypi:`pillow-svg`: Implements basic SVG read support. Currently supports basic paths, shapes, and text. + * :pypi:`raw-pillow-opener`: Simple camera raw opener, based on the rawpy library. From 283dc46a4c16444a1ce4dc48d627b8f2c0190814 Mon Sep 17 00:00:00 2001 From: Andrew Murray <3112309+radarhere@users.noreply.github.com> Date: Sat, 19 Apr 2025 19:25:06 +1000 Subject: [PATCH 2/4] Updated pillow-svg description Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --- docs/handbook/third-party-plugins.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst index f49dd2389e6..e0cb9a34790 100644 --- a/docs/handbook/third-party-plugins.rst +++ b/docs/handbook/third-party-plugins.rst @@ -14,5 +14,5 @@ Here is a list of PyPI projects that offer additional plugins: * :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11. * :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings. * :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format. - * :pypi:`pillow-svg`: Implements basic SVG read support. Currently supports basic paths, shapes, and text. + * :pypi:`pillow-svg`: Implements basic SVG read support. Supports basic paths, shapes, and text. * :pypi:`raw-pillow-opener`: Simple camera raw opener, based on the rawpy library. From f1c0843ec387e22ced3debaeae2abae3625aa0ac Mon Sep 17 00:00:00 2001 From: Andrew Murray Date: Sat, 19 Apr 2025 20:27:53 +1000 Subject: [PATCH 3/4] Removed indentation from list --- docs/handbook/third-party-plugins.rst | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst index e0cb9a34790..d77dee2d5de 100644 --- a/docs/handbook/third-party-plugins.rst +++ b/docs/handbook/third-party-plugins.rst @@ -7,12 +7,12 @@ itself. Here is a list of PyPI projects that offer additional plugins: - * :pypi:`DjvuRleImagePlugin`: Plugin for the DjVu RLE image format as defined in the DjVuLibre docs. - * :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library. - * :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL. - * :pypi:`pillow-heif`: Python bindings to libheif for working with HEIF images. - * :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11. - * :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings. - * :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format. - * :pypi:`pillow-svg`: Implements basic SVG read support. Supports basic paths, shapes, and text. - * :pypi:`raw-pillow-opener`: Simple camera raw opener, based on the rawpy library. +* :pypi:`DjvuRleImagePlugin`: Plugin for the DjVu RLE image format as defined in the DjVuLibre docs. +* :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library. +* :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL. +* :pypi:`pillow-heif`: Python bindings to libheif for working with HEIF images. +* :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11. +* :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings. +* :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format. +* :pypi:`pillow-svg`: Implements basic SVG read support. Supports basic paths, shapes, and text. +* :pypi:`raw-pillow-opener`: Simple camera raw opener, based on the rawpy library. From a4e091636afea690f0a1124a66461f91296657ad Mon Sep 17 00:00:00 2001 From: Andrew Murray <3112309+radarhere@users.noreply.github.com> Date: Mon, 21 Apr 2025 16:24:54 +1000 Subject: [PATCH 4/4] Updated heading Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> --- docs/handbook/third-party-plugins.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst index d77dee2d5de..a189a5773c7 100644 --- a/docs/handbook/third-party-plugins.rst +++ b/docs/handbook/third-party-plugins.rst @@ -1,4 +1,4 @@ -Third Party Plugins +Third-party plugins =================== Pillow uses a plugin model which allows users to add their own