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.

Possible keys and their allowed values are:


w

Sets the width

Allowed Arguments: Any number between 1 and 5120

Example: https://fast.imajize.com/6438673/frames/10/w_1024.jpg

→ Preview


h

Sets the height

Allowed Arguments: Any number between 1 and 5120

Example: https://fast.imajize.com/6438673/frames/10/h_1024.jpg

→ Preview


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

→ Preview


format

Sets the format

Allowed Arguments: jpg, png, webp

Example: https://fast.imajize.com/6438673/frames/10/w_1024;w_1024.png

→ Preview


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

→ Preview


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

→ Preview


crop

Sets the crop

Allowed Arguments: trim

Example: https://fast.imajize.com/6438673/frames/10/w_1024;crop_trim.jpg

→ Preview


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

→ Preview


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

→ Preview

Example: https://fast.imajize.com/6438673/frames/10/w_1024;extend.right_150.jpg

→ Preview


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

→ Preview

Still need help? Contact Us Contact Us