Search…
⌃K

Padding

With Claid you can control how much space there's around the object. padding allows you to achieve a consistent look for visuals across your platform. This is an essential operation for eCommerce where the frame around the goods is essential for a visual experience.
With Claid API you can control the surrounding space using padding operation, where you can pass a value as a percentage or multiple values for each of the 4 sides. The padding cannot be more than half the width/height.
Examples: "10%","30%","5% 25%".
Let's explore the simple example where we just need to add padding around the picture:
{
"input": "https://staging.claid.ai/assets/cms/shoe_example_05fb154a3a/shoe_example_05fb154a3a.png",
"operations": {
"padding": "30%"
}
}
In this request, Claid preserves the actual image size, hence squeezing the image and filling the surrounding space with padding.
But let's consider more use cases.
Background Removal
Safe Zones
Most eCommerce platforms will require photos to have a white background. Claid has a feature that automatically crops out the product image and leaves the background entirely white.
But it's not enough just to remove the background because the resulting object will be trimmed to borders. Controlling the empty space surrounding the product image would add a more natural look and help meet the platform's requirements.
Let's assume that we need to remove the background and specify the amount of the surrounding space:
{
"input": "https://staging.claid.ai/static/0190d55e7097dfad9239168a5cc2cfae/36f6d/E_com_Input_Enhancement_AI_Color_3e806177ae.webp",
"operations": {
"background": {
"remove": {
"clipping": true
}
},
"padding": "20%"
}
}
We specify the clipping background removal operation to crop the background up to the foreground object, so the start of padding will be counted from the borders of the object.
If the output sizes are not specified, Claid uses the source width and height, squeezing the shoe to satisfy the padding value.
Also, you can control the color of the background, please see the Background section.
An image can be shown to users on different pages squeezed with different dimensions. In general, objects are still visible after image transformations, but non-standard borders can be dropped from the visible area.
Squeezed images on different pages
With Claid, you can specify the Safe Zone for objects, setting up the padding from horizontal and vertical sides as the minimum borders. You can enumerate horizontal and vertical paddings via a space separator, e.g. "10% 25%".
Let's explore an example of the resized image with removed background and compare the result with and without safe zones:
{
"input": "https://staging.claid.ai/ecommerce-images/safe-zones/",
"operations": {
"resizing": {
"fit": "canvas",
"width": 1600,
"height": 900,
},
"background": {
"remove": {
"clipping": true
}
},
"padding": "10% 25%"
}
}
An example image
The square frame on top of the processed image without safe zones, padding is "10%
The square frame on top of the processed image with safe zones, padding is "10% 25%"
We see that Claid uses our sizes and adjusts the object largeness to fit the required padding value.
On the left side, we can observe the image that would not be correctly shown on a preview page due to the one-side padding. It's better to specify padding for both sides so the image would definitely fit on different pages as shown on the image on the right side.
Please note that Claid automatically detects and customizes the smaller side padding to meet the required dimensions.
Last modified 3mo ago