Janez Urevc (@slashrsm)

• senior engineer and team lead at MD Systems
• Active member of Drupal community since 2009
• Lead of the D8 media initiative
• ex Examiner.com

Biggest company contributor

Remote: Office not required

I am always happy to help!

Alexander Ross

Drupal: @bleen | Twitter: @bleen18

• Director of Software Engineering at NBCUniversal
• Active member of Drupal community since 2006
• One of the organizers of Drupal NYC
• … always hiring

Gratuitous photo of my kid

What we learned

• A lot of modules with very different approaches to image cropping
• … but they all share a nearly identical strategy for storing the crop data
• … hard to switch between modules (custom migration needed)
• … waste of resources

Fix the situation for Drupal 8!

Crop API is born...

• Attempt to standardize cropping storage and image effects
• … uses Entity system - Crop is an entity
• … standard (swappable) storage
• … easy to work with
• … automated tests
• … basic image effects provided
• … bundlable
• … fieldable
• … drupal.org/project/crop

Create a Crop entity...

$crop = \Drupal\crop\Entity\Crop::create([
      'type' => 'dummy_crop_type',
      'entity_id' => $file->id(),
      'entity_type' => $file->getEntityTypeId(),
      'x' => '100',
      'y' => '150',
      'width' => '200',
      'height' => '250',
]);
$crop->save();
      

Find and use a Crop entity...

$crop = \Drupal\crop\Entity\Crop::findCrop($uri, $crop_type);
$size = $crop->getSize();
$position = $crop->getPosition();

// Anchor (top-left corner) is calculated on the fly.
$anchor = $crop->getAnchor();
      

Other features...

• aspect ratio definition
• soft size limit
• hard size limit

Basic image effect

• finds crop and applies it
• can be chained with other effects (scale & crop, scale, ...)
• can be overriden to achieve custom behaviour
• … or you can implement your own from scratch

Focal point

Focal Point allows editors to specify the most important part of an image before cropping occurs.

Demo

Advanced Image Crop

Advanced Image Crop allows editors to define how an image should be cropeed for each defined image preset.

Let's discuss how we plan to use Crop API during our D8 upgrade of this module.

Demo

Image widget crop

Image widget crop

• created by Alexandre Mallet - @woprrr
• Drupal 8 only
• adopted by NP8 - enterprise Drupal 8 media distribution (presentation on Moday - media summit!)
• uses Cropper - A simple jQuery image cropping plugin
• drupal.org/project/image_widget_crop

Demo