Image adjustments
Change how an image looks without changing its dimensions, using the Media Delivery API. These parameters cover colour space, sharpening, blur, noise reduction, gamma, background fill behind transparency, and the hue, saturation, and brightness controls.
Base URL pattern
The parameters on this page are appended to a Dynamic Media image URL. For the URL pattern and how parameters chain together, see the Media Delivery API guide.
cs — Color spaceLink copied!
Changes the colour space of the image.
| Value | Description |
|---|---|
rgb | RGB |
rgba | RGBA |
srgb | sRGB |
gray | Greyscale |
cmyk | CMYK |
ohta | OHTA |
lab | LAB |
xyz | XYZ |
hsb | Hue, saturation, brightness |
hsl | Hue, saturation, lightness |
unsharp — SharpenLink copied!
Sharpens the image by applying an unsharp mask, a standard image-processing technique that increases edge contrast.
Format: unsharp={radius},{sigma},{amount},{threshold}
| Component | Range | Description |
|---|---|---|
radius | 0–5 | Gaussian filter radius. 0 lets the system choose. |
sigma | 0.01–5 | Gaussian standard deviation |
amount | 1–300 | Percentage difference. Values above 100% are valid. |
threshold | 0–255 | Brightness threshold for sharpening |
Tip
Set amount to 1 to see the image with virtually no sharpening applied, then raise it again to compare.
cm — Composite modeLink copied!
Defines the composite operator when an image is applied on top of a background colour. This controls how the two are blended where they overlap - over, the default, simply places the image on top.
Supported values: over (default), colo, dark, diff, light, multi, cout, cover, copy (see cm=copy)
cm=copy — Remove alpha channelLink copied!
Removes the alpha channel from an image, leaving the colour data that was masked by the alpha channel visible.
Info
This feature must be provisioned on your account. To use cm=copy, contact your Customer Success Manager or Amplience Support.
Example:
bg - Background colourLink copied!
Sets the canvas background colour. Takes effect when the image is padded (upscale=padd) or the source image is transparent.
This example uses a transparent source image, so the colour fills behind the alpha channel. For the padded-canvas case, see upscale=padd.
Tip
The parameters here set the background colour at delivery time and never alter the master asset. To change the background of the asset itself as part of an automated workflow, use the Fill background, Normalize background and Remove background actions in Workforce flows.
blur - Gaussian blurLink copied!
Applies a Gaussian blur to the image. This softens detail evenly across the image, in the same way as the blur tool in a photo editor - the higher the sigma, the stronger the effect.
Format: blur={radius},{sigma}
| Component | Range | Description |
|---|---|---|
radius | 0–100 | Accuracy of the blur. Generally 2–3× sigma. |
sigma | 0–100 | Strength of the blur |
noiser - Noise reductionLink copied!
Removes noise from the image. Value is between 0 and 5. Higher values remove more noise but also smooth away more fine detail - noise reduction is always a trade-off between grain and sharpness, so use the lowest value that cleans up the visible noise.
This example uses a deliberately grainy source image, rendered at 500px so the grain stays visible in the preview. Drag to 0 to see the untouched grain, and above 3 to see the detail cost of heavy noise reduction:
gamma - Gamma correctionLink copied!
Adjusts the gamma of the image. Values below 1.0 darken the image; values above 1.0 lighten it.
hue, sat, bri - Hue, saturation, brightnessLink copied!
Adjusts the colour properties of the image. Each parameter can be specified independently. Values range from -100 to 100.
| Parameter | Description |
|---|---|
hue | Shifts the colour based on the hue scale |
sat | Adjusts the amount of grey (colour saturation) |
bri | Adjusts the brightness |
Tip
Adjust one slider at a time with the other two at 0 - hue in particular shifts every colour in the image at once, so small changes go a long way.