Crop method for retrieving URL & updated documentation.

Author: acoumb

src/Umbraco.Cms.Integrations.DAM.Aprimo/Models/ViewModels/AprimoMediaWithCropsViewModel.cs

@@ -12,14 +12,35 @@ public class AprimoMediaWithCropsViewModel
         /// </summary>
         /// <param name="name"></param>
         /// <returns>Crop URL</returns>
-        public string GetImageUrl(string name)
+        public string GetCropUrl(string name)
         {
             var crop = Crops.FirstOrDefault(p => p.Name == name);
             if (crop != null)
                 return crop.Url;
 
             return string.Empty;
         }
+
+        /// <summary>
+        /// Get image URL by size
+        /// </summary>
+        /// <param name="name"></param>
+        /// <returns>Crop URL</returns>
+        public string GetCropUrl(int? width, int? height)
+        {
+            if (!width.HasValue && !height.HasValue)
+                throw new ArgumentException("Width and height cannot be both NULL.");
+
+            var crop = width.HasValue && height.HasValue 
+                ? Crops.FirstOrDefault(p => p.ResizeWidth == width && p.ResizeHeight == height)
+                : (width.HasValue 
+                    ? Crops.FirstOrDefault(p => p.ResizeWidth == width)
+                    : Crops.FirstOrDefault(p => p.ResizeHeight == height));
+            if (crop != null)
+                return crop.Url;
+
+            return string.Empty;
+        }
     }
 
     public class AprimoMediaItemViewModel

src/Umbraco.Cms.Integrations.DAM.Aprimo/readme.md

@@ -76,4 +76,12 @@ Properties available from the strongly-typed model:
 - Title
 - Thumbnail
 - Crops
-- Asset fields
+- Asset fields
+
+### Working with Crops
+For the selected media asset you can retrieve the crops details using the `MediaWithCrops` object.
+ 
+It contains the details of the original asset, the list of available crops and a method to retrieve the crop URL based on name and width/height.
+
+### Working with fields
+The asset's fields are grouped in an object containing their label and a dictionary of values based on the available cultures for that asset.