Overview
Sources
Libraries
Images API

Focal Point Position Y focal-point-y

Specify the vertical y position of the focal point for the image.

Values

This parameter accepts floats values in the range 0.0 to 1.0. With 0.0 as the vertical top border of the image and 1.0 as the bottom border.

The default value for this parameter is 0.5, which matches the vertical center of the image.

Examples

The red crosshair representing the position of the default focal point can be seen by setting the focal-point-debug parameter to true:

GET
https://assets.imglab-cdn.net/beach.jpeg?focal-point-debug=true
x px

We can then set a value of 0.8 for focal-point-y using focal-point-y=0.8:

GET
https://assets.imglab-cdn.net/beach.jpeg?focal-point-y=0.8&focal-point-debug=true
x px

Once we have positioned the focal point where we want it, we can crop the image to be centred on the focal point using mode=crop and crop=focalpoint parameters:

GET
https://assets.imglab-cdn.net/beach.jpeg?mode=crop&crop=focalpoint&focal-point-y=0.8&focal-point-debug=true
x px

Finally, we can either remove the focal-point-debug parameter or set its value to false to stop the crosshair appearing over the image:

GET
https://assets.imglab-cdn.net/beach.jpeg?mode=crop&crop=focalpoint&focal-point-y=0.8
x px