Added thumbnail() demonstration image

python-pillow · Sep 27, 2023 · ac86175 · ac86175
1 parent ac9d818
commit ac86175
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 7 deletions.
diff --git a/docs/example/image_thumbnail.png b/docs/example/image_thumbnail.png
diff --git a/docs/reference/ImageOps.rst b/docs/reference/ImageOps.rst
@@ -40,13 +40,18 @@ Resize relative to a given size
         ImageOps.fit(im, size).save("imageops_fit.png")
         ImageOps.pad(im, size, color="#f00").save("imageops_pad.png")
 
-+------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|      | :meth:`contain`                            | :meth:`cover`                            | :meth:`fit`                            | :meth:`pad`                            |
-+======+============================================+==========================================+========================================+========================================+
-|Size  | (100, 100)                                 | (150, 150)                               | (150, 100)                             | (150, 100)                             |
-+------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
-|Image | .. image:: ../example/imageops_contain.png | .. image:: ../example/imageops_cover.png | .. image:: ../example/imageops_fit.png | .. image:: ../example/imageops_pad.png |
-+------+------------+-------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
+        # thumbnail() can also be used,
+        # but will modify the image object in place
+        im.thumbnail(size)
+        im.save("imageops_pad.png")
+
++------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
+|      | :py:meth:`~PIL.Image.Image.thumbnail`     | :meth:`contain`                            | :meth:`cover`                            | :meth:`fit`                            | :meth:`pad`                            |
++======+===========================================+============================================+==========================================+========================================+========================================+
+|Size  | (100, 100)                                | (100, 100)                                 | (150, 150)                               | (150, 100)                             | (150, 100)                             |
++------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
+|Image | .. image:: ../example/image_thumbnail.png | .. image:: ../example/imageops_contain.png | .. image:: ../example/imageops_cover.png | .. image:: ../example/imageops_fit.png | .. image:: ../example/imageops_pad.png |
++------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
 
 .. autofunction:: contain
 .. autofunction:: cover