Added PerspectiveTransform

Author: radarhere

Tests/test_image_transform.py

@@ -16,6 +16,8 @@ def test_sanity(self):
 
         transform = ImageTransform.AffineTransform(seq[:6])
         im.transform((100, 100), transform)
+        transform = ImageTransform.PerspectiveTransform(seq[:8])
+        im.transform((100, 100), transform)
         transform = ImageTransform.ExtentTransform(seq[:4])
         im.transform((100, 100), transform)
         transform = ImageTransform.QuadTransform(seq[:8])

docs/reference/ImageTransform.rst

@@ -19,6 +19,11 @@ The :py:mod:`~PIL.ImageTransform` module contains implementations of
     :undoc-members:
     :show-inheritance:
 
+.. autoclass:: PerspectiveTransform
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 .. autoclass:: ExtentTransform
     :members:
     :undoc-members:

src/PIL/ImageTransform.py

@@ -63,6 +63,26 @@ class AffineTransform(Transform):
     method = Image.Transform.AFFINE
 
 
+class PerspectiveTransform(Transform):
+    """
+    Define a perspective image transform.
+
+    This function takes an 8-tuple (a, b, c, d, e, f, g, h). For each pixel
+    (x, y) in the output image, the new value is taken from a position
+    ((a x + b y + c) / (g x + h y + 1), (d x + e y + f) / (g x + h y + 1)) in
+    the input image, rounded to nearest pixel.
+
+    This function can be used to scale, translate, rotate, and shear the
+    original image.
+
+    See :py:meth:`.Image.transform`
+
+    :param matrix: An 8-tuple (a, b, c, d, e, f, g, h).
+    """
+
+    method = Image.Transform.PERSPECTIVE
+
+
 class ExtentTransform(Transform):
     """
     Define a transform to extract a subregion from an image.