Frame extraction API
To extract an individual frame out of a 360 view, use the following syntax:
http://fast.imajize.com/[UUID]/frames/[FRAME_NUMBER]/[KEY1]_[VALUE1];[KEY2]_[VALUE2].[FORMAT]
Please note: when calling an individual URL for the first time, it may take a moment to render the image. Subsequent calls will be cached and load immediately.
Frame
You may specify a frame directly by providing its frame number:
https://fast.imajize.com/6438673/frames/19/w_1024.jpg
Instead of specifying a frame number, you may also use a percentage or degree value, such as 50p or 180d, which renders the 50% or 180degree facing image of your 360 view.
The following 2 examples render the same image as the URL above, based on a different format to identify the frame number:
https://fast.imajize.com/6438673/frames/50p/w_1024.jpg
https://fast.imajize.com/6438673/frames/180deg/w_1024.jpg
To modify the resulting image and add transformations, you may use one of the following modifiers:
w
Sets the width
Allowed Arguments: Any number between 1 and 5120
Example: https://fast.imajize.com/6438673/frames/10/w_1024.jpg
h
Sets the height
Allowed Arguments: Any number between 1 and 5120
Example: https://fast.imajize.com/6438673/frames/10/h_1024.jpg
q
Sets the quality
Allowed Arguments: Any number between 1 and 100
Example: https://fast.imajize.com/6438673/frames/10/w_1024;q_50.jpg
format
Sets the format
Allowed Arguments: jpg, png, webp
Example: https://fast.imajize.com/6438673/frames/10/w_1024;w_1024.png
fit
Sets how the image fits into the provided width and height
Allowed Arguments: inside, contain
(defaults to inside)
inside
: resize the image to be as large as possible while ensuring its dimensions are less than or equal to both those specified while preserving the aspect ratio.
contain
: contain the image within the given dimensions while preserving aspect ratio. Adds the specified background color to the remaining space.
Example: https://fast.imajize.com/6438673/frames/10/w_1024;h_1960;fit_contain.jpg
background
Sets the background color, applied when fit: contain
is chosen.
Allowed Arguments: Any hexadecimal color value without the # sign.
Example: https://fast.imajize.com/6438673/frames/10/w_1024;h_1960;fit_contain;background_FF0000.jpg
crop
Sets the crop
Allowed Arguments: trim
Example: https://fast.imajize.com/6438673/frames/10/w_1024;crop_trim.jpg
extend
Extends the canvas size equally to all sides.
Allowed Arguments: Any value between 1 and 5120. The total resulting dimensions may not exceed 5120 (width or height).
Example: https://fast.imajize.com/6438673/frames/10/w_1024;extend_150.jpg
extend.top, extend.right, extend.bottom, extend.left
Extends the canvas size equally to an individual side.
Allowed Arguments: Any value between 1 and 5120. The total resulting dimensions may not exceed 5120 (width or height).
Example: https://fast.imajize.com/6438673/frames/10/w_1024;extend.top_150.jpg
Example: https://fast.imajize.com/6438673/frames/10/w_1024;extend.right_150.jpg
extend.background
Extends the canvas using the given background color.
Allowed Arguments: Any hexadecimal color value without the # sign.
Example: https://fast.imajize.com/6438673/frames/10/w_1024;extend_150;extend.background_FF0000.jpg