Support and Documentation

Focus points

A focus point is an image's ideal vertical and horizontal center after cropping. You can specify focus points using the following techniques:

If you know that an image's subject is always centered in the middle (as in time-lapse photography), you can return that coordinate in a Focus object. This technique ensures Brightspot generates crops around the image's native center.

import com.psddev.cms.image.Focus;
import com.psddev.cms.image.FocusCalculator;
import com.psddev.dari.util.ObjectUtils;
import com.psddev.dari.util.StorageItem;

public class CenterFocusCalculator implements FocusCalculator { 1

    @Override
    public Focus getFocus(StorageItem storageItem) {
        Map<String, Object> metaData = storageItem.getMetadata();
        
        double imageWidth = ObjectUtils.to(double.class, metaData.get("width")); 2
        double imageHeight = ObjectUtils.to(double.class, metaData.get("height"));
        Focus centerFocus = new Focus(imageWidth / 2, imageHeight / 2);

        System.out.println("Focus, x-coordinate " + centerFocus.getX()); 3
        System.out.println("Focus, y-coordinate " + centerFocus.getY());
        return centerFocus;
    }

}

1

Declares this view model implements the FocusCalculator interface.

2

Retrieves the image's width and height from the metadata, divides each in half, and returns both values in a Focus object.

3

Prints the focus point to the console.

Focus, x-coordinate 200.0
Focus, y-coordinate 131.0