summary refs log tree commit diff
path: root/synapse/media
diff options
context:
space:
mode:
authorMark Haines <mark.haines@matrix.org>2014-12-11 10:41:43 +0000
committerMark Haines <mark.haines@matrix.org>2014-12-11 10:41:43 +0000
commitead8fc5e388cf03b83b5470430a1c3d70af00df3 (patch)
tree25648b17f56e9462b14a6eeefa7eb6963911c785 /synapse/media
parentMake sure we pass a tuple to string '%' formatting (diff)
downloadsynapse-ead8fc5e388cf03b83b5470430a1c3d70af00df3.tar.xz
doc the thumbnail methods
Diffstat (limited to 'synapse/media')
-rw-r--r--synapse/media/v1/media_repository.py13
1 files changed, 11 insertions, 2 deletions
diff --git a/synapse/media/v1/media_repository.py b/synapse/media/v1/media_repository.py
index 2bd29d2288..a0dc56be4b 100644
--- a/synapse/media/v1/media_repository.py
+++ b/synapse/media/v1/media_repository.py
@@ -49,15 +49,24 @@ class MediaRepositoryResource(Resource):
 
            <media>
 
-    Clients can get thumbnails by supplying a desired width and height::
+    Clients can get thumbnails by supplying a desired width and height and
+    thumbnailing method::
 
         => GET /_matrix/media/v1
-                /thumbnail/<media-id>?width=<w>&height=<h> HTTP/1.1
+                /thumbnail/<media-id>?width=<w>&height=<h>&method=<m> HTTP/1.1
 
         <= HTTP/1.1 200 OK
            Content-Type: image/jpeg or image/png
 
            <thumbnail>
+
+    The thumbnail methods are "crop" and "scale". "scale" trys to return an
+    image where either the width or the height is smaller than the requested
+    size. The client should then scale and letterbox the image if it needs to
+    fit within a given rectangle. "crop" trys to return an image where the
+    width and height are close to the requested size and the aspect matches
+    the requested size. The client should scale the image if it needs to fit
+    within a given rectangle.
     """
 
     def __init__(self, hs):