You can use your own custom image as a mask for cropping by adding an overlay and using the 'cutter' transformation flag.
Using the API (in Ruby): :overlay => "my_shape", :flags => "cutter".
In URLs: l_my_shape,fl_cutter.
For example, the following PNG image was uploaded to Cloudinary with the 'hexagon_sample' public ID.
http://res.cloudinary.com/demo/image/upload/hexagon_sample.png
Now you can use this image with the cutter flag. For example, applying on an image with the 'sample' public ID:
http://res.cloudinary.com/demo/image/upload/w_173,h_200,c_fill/l_hexagon_sample,fl_cutter/sample.png
You can also add the relative flag to automatically adjust the dimensions of the mask to match the resulting image you need. For example:
http://res.cloudinary.com/demo/image/upload/w_300/l_hexagon_sample,fl_cutter.relative,w_1.0,h_1.0/sample.png
The mask image can be a semi-transparent PNG file to make the edges more smooth.
Here's such an uploaded mask:
http://res.cloudinary.com/demo/image/upload/hexagon_feather_sample.png
And here's a sample result while creating a 200x220 face detection based thumbnail of an uploaded images:
http://res.cloudinary.com/demo/image/upload/w_200,h_220,c_thumb,g_face/l_hexagon_feather_sample,fl_cutter/face_left.png
Comments
2 comments
Following this example I get hexagonal image with a white background instead of a transparent one. I have uploaded the same image you provide here as a mask.
Hi Daniel, can you please share a URL example which demonstrates the issue? if you rather keep it private, please feel free to open a support ticket with all the necessary information.
Please sign in to leave a comment.