FEATURE: Add focal-point support for ImageVariants (crops) and Thumbnails

[mficzel]

In many cases the crops taken from the center of images are not optimal and important parts of an image get lost. This pr allows to specify a focal-point for imageVariants that is later on respected when crops of the imageVariant are generated.

The implementation uses an preliminary crop for images with a focalPoint that ensures:

• The target image is as large as possible inside the original image dimensions
• The focal point is as central as possible inside the generated image

In addition this change calculates the focal-point and image dimensions for async thumbnails on generation. That way async thumbnails can be rendered with full width and height informations which allows to make use of those informations in the rendering to prevent layout shifts or to specify the center of an object-fit css rule.

Resolves: #2296

Required Neos.UI Changes neos/neos-ui#3835

• The Neos.UI should be extended and allow to specify a focal point in the crop-image dialog. The given values should then be passed as focalPointX ?int and focalPointY ?int of the new ImageVariant that is created
  via endpoint neos/content/create-image-variant which points to \Neos\Neos\Controller\Backend\ContentController::createImageVariantAction
• The Image Preview in the Inspector should visualize an existing focal point

Review instructions

!!! By intention the focal point is not added to images in the media library (yet). The main reason for that is that this would require a mechanism to re-render all thumbnails of an asset if the focal point is changed. Also i personally see more value to specify the focal point by editors for a specific crop that is why the implementation cover ImageVariants and Thumbnails. If we see value in focal point support via media library we can add this in future !!!

The main part of this solution is that the calculation of the cropped dimensions was moved out from the ResizeImageAdjustment to a new ResizeDimensionCalculator where it can be accessed from other code like the ImageThumbnailGenerator and the ThumbnailService that need to know about image dimensions beforehand. The tests for the now deprecated methods in ResizeImageAdjustment are still in place to prove that the calculations are the same.

For now the generated thumbnails will get a small green circle rendered on the focal-point if a focal point was set. This allows to visually verify the results in a human understandable way. After approval this will be removed.

Also the tests with php 8.0 and 8.1 are failing since this will be rebased on to 8.4 once this branch is green again. I used 8.2 features that will not work with lower php versions.

Final Todos before merge - after review and general approval

• Remove the MarkPointAdjustment and the code using it in the ImageThumbnailGenerator
• Generate postgres db-migrations
• Rebase on to Neos 8.4 ... this is based on 8.3 as this branch is green at this time

Checklist

• Code follows the PSR-2 coding style
• Tests have been created, run and adjusted as needed
• The PR is created against the lowest maintained branch
• Reviewer - PR Title is brief but complete and starts with FEATURE|TASK|BUGFIX
• Reviewer - The first section explains the change briefly for change-logs
• Reviewer - Breaking Changes are marked with !!! and have upgrade-instructions

[mficzel]

close and reopen to reset ci

[mficzel]

This at least prooves that the tests are running for php 8.2 and 8.3. The failing Stan Tests correctly identifies that this core required php 8.2.

After #5188 is fixed this branch should be rebased on 8.4 and should become green.

[mficzel]

Converted to draft until 8.4 is green again and this can be rebased