Focal Crop and Resize

[GarethSomers]

This PR introduces a new focalCropAndResize method to complement the existing focalCrop functionality.

Problem

Since version 3 the result of the focalCrop has changed: #245

Previously focalCrop would work similar to say ->fit(fit: Fit::Max, ...) but centered on the focal point.

Currently focalCrop accepts $cropCenterX and $cropCenterY which seems to have changed to pixels instead of percentages.

The documentation for focalCrop also appears outdated; still referencing percentages, zoom, $focalX and $focalY (instead of $cropCenterX / $cropCenterY). I can see the upgrade guide references the removal of the $zoom parameter.

Solution

To solve this problem I've created a new method focalCropAndResize and intended to match the behaviour in v2.

Unlike focalCrop it:

• Uses percentages to describe focal point
• First crops the entire photo using the intended aspect ratio similar to Fit:Max, and using the provided focal point as an anchor.
• It will then resize the image to the intended width / height.

This is useful when you want to preserve the full context of an image while still enforcing a specific aspect ratio around a focal point.

Comparison

Original Focal point @ 0:0 Size: 1600x1600
focalCrop
focalCropAndResize

[timvandijck]

Nice PR thank you! Also thanks for the examples in the PR!