True Crop
Categories
Component ID
2654392
Component name
True Crop
Component type
module
Maintenance status
Development status
Component security advisory coverage
not-covered
Downloads
791
Component created
Component changed
Component body
This module allows you to generate new images by cropping existing ones. Because the cropped images are first-class file entities, they will appear (and can be reused) anywhere else a regular image file would be.
The module integrates with the Manual Crop module for its user interface.
It also provides (within the Manual Crop interface) a list of "Related crops", showing all cropped images that descend from a common source. When editing an image or media field, a user can click on one of these related images to switch to using it in the field.
Before installing
Note the following:
- This module currently requires the latest development version of the Manual Crop module (the 7.x-1.5 release is not new enough).
- The module was initially developed for a specific Manual Crop configuration, and as such it may not work yet with all possible configuration settings of Manual Crop and other modules. See the issue queue for known problems. This is the primary reason the module currently only has an alpha release.
How to configure
- Decide the size of the cropped images you want to make.
- Go to "Administration » Configuration » Media » Image styles" and create at least one image style that is configured to use Manual Crop with your desired crop settings. Choose the crop settings to match the aspect ratio and size of where the image will eventually be displayed. (For example, if you plan to display your images with a 2x1 aspect ratio and largest size of 1200x600 pixels, you should set up the Manual Crop image style to use a 1200x600 pixel cropping region.)
- Edit the fields where you want the True Crop behavior to be used. Under the "Manual Crop" fieldset, click 'Enable' (to turn on the Manual Crop interface itself) and 'Use "True Crop"'. Then in the "Styles list" section, make sure the image style you created above is included. (Note that for best results, this should generally be the only image style that is included.) Select any other Manual Crop options you want to enable, and save.
- Now when you go to create your content and upload images for the field, the Manual Crop + True Crop interface will be enabled and available for you to use.
Credits
Contributions to the initial module code and technical architecture were made by David_Rothstein, chx, and alexjarvis.
