Stitching images¶
New in version 4.0.
This resource provides an easy way of stitching images together. The result is cached in memory (and Memcached if it is activated in the configuration properties) for 3 hours.
It can be used with any image content and is not bound to be used with material imported in Vidispine. However, a typical usage of this service would be to assemble together representative thumbnails from several items of a collection.
Note
This request must go to http://server:8080/APInoauth/ instead of the usual http://server:8080/API/
Note
For a better quality rendering configure your Vidispine to use ImageMagick, see Configuration properties!
Note
Don’t forget to URL encode all parameters!
Stitching images¶
Stitch images¶
-
GET
/APInoauth/stitch
¶ Query Parameters: - uri – Multiple uri instances of the images to use.
For example:
uri=img1.png&uri=img2.png&uri=img3.png
... - geometry – Optional geometry of the collage.
For example,
100x50+10+10
will first downscale every image to fit in 100x50 then add a 10 pixels padding. If no parameter is specified, the original dimensions are used. - tile – The tiling strategy.
Examples are
2x2
or2x
orx3
... If no parameter is specified, the system will try find the best alignment. - format – The format of the output image, default is PNG.
- background – The color of the background, default is white.
Color can be specified as hex values (
0xffffff
,#ffffff
) or as name (white
).none
will create an image with transparent background (PNG only).
Produces: - image/png , image/jpeg – The stitched image
- uri – Multiple uri instances of the images to use.
For example:
Example¶
GET /stitch?uri=http%3A%2F%2Fvidispine.com%2Fsites%2Fall%2Fthemes%2Fvidispine%2Flogo.png&uri=http%3A%2F%2Fvidispine.com%2Fsites%2Fall%2Fthemes%2Fvidispine%2Flogo.png&uri=http%3A%2F%2Fvidispine.com%2Fsites%2Fall%2Fthemes%2Fvidispine%2Flogo.png&uri=http%3A%2F%2Fvidispine.com%2Fsites%2Fall%2Fthemes%2Fvidispine%2Flogo.png&geometry=100x50%2B10&background=0xf5f7f8