Overview
Sources
Libraries
Images API

Shape shape

Specifies the form or shape mask image that will be applied to the image.

Values

Accepted values for this parameter are ellipse, round, circly or a valid imglab URL with a custom shape image mask to be used.

For more information on how to specify URLs visit the URL values section.

Ellipse

In this example we apply an ellipse mask shape over a cropped version of our source image using shape=ellipse parameter:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=ellipse
Woman posing cropped image and with an ellipse shape mask applied.
x px

Shape masks will adapt to fit the complete dimensions of the source image. In this example we are using a wider crop of our source image and applying shape=ellipse again:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=ellipse
Woman posing wide cropped image with a ellipse shape mask applied.
x px

Round

In this example we are applying a rounded box as shape mask image with shape=round parameter to our cropped source image:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=round
Woman posing cropped image with a round borders shape mask applied.
x px

It is possible to set a different radius with round-radius parameter. In this example we set a bigger radius of 60 with round-radius=60 parameter:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=round&round-radius=60
Woman posing cropped image with a round borders shape mask applied and a round radius factor of 60.
x px

Circly

Circly is a mix shape mask between a rounded box and a circle. In this example we are applying it with shape=circly parameter:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=circly
Woman posing cropped image with a circly shape mask applied.
x px

Custom Shape Image

A custom shape mask image can be used. In this example we are specifying a custom shape image named shape.svg available at our source and specifying png as the format output. The final parameter will be shape=shape.svg?format=png:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=shape.svg%3Fformat%3Dpng
Woman posing cropped image with a custom shape mask applied.
x px

Here we are applying the same custom shape mask to a wider cropped version of our source image:

GET
https://assets.imglab-cdn.net/woman-03.jpeg?shape=shape.svg%3Fformat%3Dpng
Woman posing wide cropped image with a custom shape mask applied.
x px

The easier way to define your own shape mask images is to create an image with a black filled geometry and a transparent background; like the one that we are using in these examples:

GET
https://assets.imglab-cdn.net/shape.svg?format=png
Custom SVG shape mask image used on previous examples.
x px

In order to don't lose resolution when resized we recommend to use vectorial formats like SVG to define your own custom shape mask images.