Show Menu
TOPICS×

Dynamic Media image profiles

When uploading images, you can automatically crop the image upon upload by applying an image profile to the folder.
Smart Crop is available only in Dynamic Media - Scene7 mode.

Crop options

You have two image cropping options to choose from and an option for automating the creation of color and image swatches.
Option When to use Description
Pixel Crop Bulk crop images based on dimensions only.
To use this option, select Pixel Crop from the Cropping Options drop-down list.
To crop from the sides of an image, you enter the number of pixels to crop from any side or each side of the image. How much of the image is cropped depends on the ppi (pixels per inch) setting in the image file.
An Image Profile pixel crop renders in the following manner:
  • Values are Top, Bottom, Left, and Right.
  • Top left is considered 0,0 and the pixel crop is calculated from there.
  • Crop starting point: Left is X and Top is Y
  • Horizontal calculation: horizontal pixel dimension of original image minus Left and then minus Right.
  • Vertical calculation: vertical pixel height minus Top, and then minus Bottom.
For example, suppose you have a 4000 x 3000 pixel image. You use values: Top=250; Bottom=500; Left=300; Right=700.
From Top Left (300,250) crop using the fill space of (4000-300-700, 3000-250-500, or 3000,2250).
Smart Crop Bulk crop images based on their visual focal point.
Smart Crop uses the power of artificial intelligence in Adobe Sensei to quickly automate the cropping of images in bulk. Smart Crop automatically detects and crops to the focal point in any image to capture the intended point of interest, regardless of screen size.
To use Smart Crop, select Smart Crop from the Cropping Options drop-down list, then to the right of Responsive Image Crop, enable (turn on) the feature.
The default breakpoint sizes of Large, Medium, and Small generally cover the full range of sizes that most images are used on mobile and tablet devices, desktops, and banners. If desired, you can edit the default names of Large, Medium, and Small.
To add more breakpoints, click Add Crop ; to delete a crop, click the Garbage Can icon.
Color and Image Swatch Bulk generate an image swatch for each image.
Note : Smart Swatch is not supported in Dynamic Media Classic.
Automatically locate and generate high-quality swatches from product images that show color or texture.
To use Color and Image Swatch, select Smart Crop from the Cropping Options drop-down list, then to the right of Color and Image Swatch, enable (turn on) the feature. Enter a pixel value in the Width and Height text boxes.
While all image crops are available from the Renditions rail, swatches are only used by way of the Copy URL feature. Note that you must use your own viewing component to render the swatch on your site. (The exception to this is carousel banners. Dynamic Media provides the viewing component for the swatch used in carousel banners.)
Using image swatches
The URL for image swatches is straightforward. That is:
/is/image/company/<asset_name>:Swatch
where :Swatch is appended to the asset request.
Using color swatches
To use color swatches, you make a req=userdata request with the following:
/is/image/<company_name>/<swatch_asset_name>:Swatch?req=userdata
For example, the following is a swatch asset in Dynamic Media Classic (Scene7):
https://my.company.com:8080/is/image/DemoCo/Sleek:Swatch
and here is the swatch asset's corresponding req=userdata URL:
https://my.company.com:8080/is/image/DemoCo/Sleek:Swatch?req=userdata
The req=userdata response is as follows:
SmartCropDef=Swatch SmartCropHeight=200.0 SmartCropRect=0.421671,0.389815,0.0848564,0.0592593,200,200 SmartCropType=Swatch SmartCropWidth=200.0 SmartSwatchColor=0xA56DB2
You can also request a req=userdata response in either XML or JSON format, as in the following respective URL examples:
https:// my.company.com :8080/is/image/DemoCo/Sleek:Swatch?req=userdata,json https://my.company.com:8080/is/image/DemoCo/Sleek:Swatch?req=userdata,xml
Note : You must create your own WCM component to request a color swatch and parse the SmartSwatchColor attribute, represented by a 24-bit RGB hexidecimal value.

Unsharp Mask

You use Unsharp Mask to fine-tune a sharpening filter effect on the final downsampled image. You can control intensity of effect, radius of the effect (measured in pixels), and a threshold of contrast that will be ignored. This effect uses the same options as Adobe Photoshop’s “Unsharp Mask” filter.
Unsharp mask is only applied to downscaled renditions within the PTIFF (pyramid tiff) that are downsampled more than 50%. That means that the largest-sized renditions within the ptiff are not affected by unsharp mask whereas smaller-sized renditions such as thumbnails are altered (and will show the unsharp mask).
In Unsharp Mask , you have the following filtering options:
Option Description
Amount Controls the amount of contrast applied to edge pixels. The default is 1.75. For high-resolution images, you can increase it to as high as 5. Think of Amount as a measure of filter intensity. Range is 0-5.
Radius Determines the number of pixels surrounding the edge pixels that affect the sharpening. For high-resolution images, enter from 1 through 2. A low value sharpens only the edge pixels; a high value sharpens a wider band of pixels. The correct value depends on the size of the image. The default value is 0.2. Range is 0-250.
Threshold
Determines the range of contrast to ignore when the unsharp mask filter is applied. In other words, this option determines how different the sharpened pixels must be from the surrounding area before they are considered edge pixels and are sharpened. To avoid introducing noise, experiment with values between 0-255.
Sharpening is described in Sharpening Images .

Creating Dynamic Media image profiles

To define advanced processing parameters for other asset types, see Configuring Asset Processing .
To create Dynamic Media image profiles :
  1. Tap the AEM logo and navigate to Tools > Assets > Image Profiles .
  2. Tap Create to add a new image profile.
  3. Enter a profile name, and values for unsharp mask, crop, or swatch, or both.
    You may find it helpful to use a profile name that is specific to its intended purpose. For example, if you want to create a profile that generates swatches only--that is, Smart Crop is disable (turned off) and Color and Image Swatch is enabled (turned on)--you could use the profile name "Smart Swatches".
  4. Tap Save . The newly created profile appears in the list of available profiles.

Editing or deleting Dynamic Media image profiles

  1. Tap the AEM logo and navigate to Tools > Assets > Image Profiles .
  2. Select the image profile you want to edit or remove. To edit it, select Edit Image Processing Profile . To remove it, select Delete Image Processing Profile .
  3. If editing, save the changes. If deleting, confirm that you want to remove the profile.

Applying a Dynamic Media image profile to folders

When you assign an image profile to a folder, any subfolders automatically inherit the profile from its parent folder. This means that you can assign only one image profile to a folder. As such, consider carefully the folder structure of where you upload, store, use, and archive assets.
If you assigned a different image profile to a folder, the new profile overrides the previous profile. The previously existing folder assets remain unchanged. The new profile is applied on the assets that are added to the folder later.
Folders that have a profile assigned to it are indicated in the user interface by the name of the profile appearing in the card.
When you add smart crop to an existing image profile, you need to re-trigger the DAM Update Asset workflow if you want to generate crops for existing assets in your asset repository.
You can apply image profiles to specific folders or globally to all assets.

Applying Dynamic Media image profiles to specific folders

You can apply an image profile to a folder from within the Tools menu or if you are in the folder, from Properties . This section describes how to apply image profiles to folders both ways.
Folders that have a profile already assigned to it are indicated by the display of the profile's name directly below the folder name.

Applying Dynamic Media image profiles to folders from Profiles user interface

  1. Tap the AEM logo and navigate to Tools > Assets > Image Profiles .
  2. Select the image profile that you want to apply to a folder or multiple folders.
  3. Tap Apply Processing Profile to Folder(s) and select the folder or multiple folders you want use to receive the newly uploaded assets and tap/click Apply . Folders that have a profile already assigned to it are indicated by the display of the profile's name directly below the folder name.

Applying Dynamic Media image profiles to folders from Properties

  1. Tap the AEM logo and navigate to Assets and then to the folder that you want to apply an image profile to.
  2. On the folder, tap the check mark to select it and then tap Properties .
  3. Tap the Image Profiles tab. From the Profile Name drop-down list, select the profile, then tap Save & Close . Folders that have a profile already assigned to it are indicated by the display of the profile's name directly below the folder name.

Applying an Dynamic Media image profile globally

In addition to applying a profile to a folder, you can also apply one globally so that any content uploaded into AEM assets in any folder has the selected profile applied.
To apply an Dynamic Media image profile globally :
  1. Do one of the following:
    • Navigate to https://<AEM server>/mnt/overlay/dam/gui/content/assets/foldersharewizard.html/content/dam and apply the appropriate profile and tap Save .
    • Navigate to CRXDE Lite to the following node: /content/dam/jcr:content .
      Add the property imageProfile:/conf/global/settings/dam/adminui-extension/imageprofile/<name of image profile> and tap Save All .

Editing the smart crop or smart swatch of a single image

Smart Crop is available only in Dynamic Media - Scene7 mode.
You can manually realign or resize the smart crop window of an image to further refine its focal point.
After you edit a smart crop and save, the change is propagated everywhere you use the crop for the specific images.
You can re-run smart crop to generate the additional crops again, if required.
To edit the smart crop or smart swatch of a single image :
  1. Tap the AEM logo and navigate to Assets , then to the folder that has a smart crop or smart swatch image profile applied to it.
  2. Tap the folder to open its contents.
  3. Tap the image whose smart crop or smart swatch you want to adjust.
  4. On the toolbar, tap Smart Crop .
  5. Do any of the following:
    • Near the upper-right corner of the page, drag the slider bar left or right to increase or decrease the image display, respectively.
    • On the image, drag a corner handle to adjust the size of the viewable area of the crop or swatch.
    • On the image, drag the box/swatch to a new location. You can only edit image swatches; color swatches are static.
    • Above the image, tap Revert to undo all your edits and restore the original crop or swatch.
  6. Near the upper-right corner of the page, tap Save , then tap Close to return to the folder of assets.

Editing the smart crop or smart swatch of multiple images

After you apply an image profile—containing Smart Crop—to a folder, all images in that folder have a crop applied to them. If desired, you can manually realign or resize the smart crop window in multiple images to further refine their focal point.
After you edit a smart crop and save, the change is propagated everywhere you use the crop for the specific images.
You can re-run smart crop to generate the additional crops again, if required.
To edit the smart crop or smart swatch of multiple images :
  1. Tap the AEM logo and navigate to Assets , then to a folder that has a smart crop or smart swatch image profile applied to it.
  2. On the folder, tap the More Actions (...) icon, then tap Smart Crop .
  3. On the Edit Smart Crops page, do any of the following:
    • Adjust the viewing size of images on the page.
      To the right of the breakpoint name drop-down list, drag the slider bar left or right to change the size of the viewable image display.
    • Filter the list of viewable images based on breakpoint names. In the example below, the images are filtered on the breakpoint name "Medium".
      Near the upper-right corner of the page, from the drop-down list, select a breakpoint name to filter on what images you see. (See the image above.)
    • Resize the smart crop box. Do any one of the following:
      • If the image has a smart crop or a smart swatch only, on the image, drag the corner handle of the crop box to adjust the size of the viewable area of the crop.
      • If the image has both a smart crop and a smart swatch, on the image, drag the corner handle of the crop box to adjust the size of the viewable area of the crop. Or, tap or click the smart swatch below the image (color swatches are static), then drag the corner handle of the crop box to adjust the size of the viewable area of the swatch.
    • Move the smart crop box. Do any one of the following:
      • If the image has a smart crop or a smart swatch only, on the image, drag the crop box to a new location.
      • If the image has both a smart crop and a smart swatch, on the image, drag the smart crop box to a new location. Or, tap or click the smart swatch below the image (color swatches are static), then drag the smart swatch crop box to a new location.
    • Undo all your edits and restore the original smart crop or smart swatch (applies to the current editing session only).
      Tap Revert above the image.
  4. Near the upper-right corner of the page, tap Save . then tap Close to return to the folder of assets.

Removing an image profile from folders

When you remove an image profile from a folder, any subfolders automatically inherit the removal of the profile from its parent folder. However, any processing of files that has occurred within the folders remains intact.
You can remove an image profile from a folder from within the Tools menu or if you are in the folder, from Properties . This section describes how to remove image profiles from folders both ways.

Removing Dynamic Media image profiles from folders by way of Profiles user interface

  1. Tap the AEM logo and navigate to Tools > Assets > Image Profiles .
  2. Select the image profile that you want to remove from a folder or multiple folders.
  3. Tap Remove Processing Profile from Folder(s) and select the folder or multiple folders you want use to remove the profile from and tap Remove .
    You can confirm that the image profile is no longer applied to a folder because the name no longer appears below the folder name.

Removing Dynamic Media image profiles from folders by way of Properties

  1. Tap the AEM logo and navigate Assets and then to the folder that you want to remove an image profile from.
  2. On the folder, tap the check mark to select it, then tap Properties .
  3. Select the Image Profiles tab.
  4. From the Profile Name drop-down menu, select None , then tap Save & Close .
    Folders that have a profile already assigned to it are indicated by the display of the profile's name directly below the folder name.