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 /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 or 2x or x3... 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

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