Overview

The Gentics Portal | java supports all image manipulation operations supported by Gentics Mesh. The endpoints image manipulation are the same as for the Gentics Image Store offered by the Gentics CMS.

All requests starting with /GenticsImageStore/ will be handled by the respective Gentics Image Store handler.

Restrictions

Only images in the formats PNG, JPEG, BMP and GIF can be resized via the Gentics Image Store. Furthermore, animated GIFs should not be resized this way, because all but the first frame in the animation will be discarded.

Resizing

An image accessible via the path /path/to/image.png can be resized with a request to

/GenticsImageStore/[width]/[height]/[mode]/path/to/image.png

where width and height are the desired dimensions in pixels, and mode is one of

  • prop: Proportional resizing, the aspect ratio of the image will be preserved

  • force: Forced resizing, the aspect ratio of the original image will not be preserved

  • smart: Crop image before resizing to correct the aspect ratio

For more information about the different modes see the description of the Mesh resizing options.

Cropping

An image accessible via the path /path/to/image.png can be cropped (and resized) with a request to

/GenticsImageStore/[width]/[height]/cropandresize/[mode]/[topleft_x]/[topleft_y]/[cropwidth]/[cropheight]/path/to/image.png

After cropping the image will be resized to the specified width and height where mode has the same meaning as described above.

For more information about the different modes have a look at the respective Mesh documentation.