Brightness

​

How to use

The brightness transformation allows you to adjust the overall brightness of an image.

Pass the following query param to the API endpoint:

brightness=amount

Where:

• amount is the percentage to increase or decrease the image brightness.

For example: brightness=50 or brightness=-30

​

Parameter

amount: The percentage to adjust the brightness. This parameter accepts integer values from -100 to 100:

• Positive values increase brightness
• Negative values decrease brightness
• 0 leaves the brightness unchanged (default)
• -100 results in a completely black image
• 100 produces a completely white image

​

Effect of Brightness Adjustment

• Increasing brightness makes the overall image lighter.
• Decreasing brightness makes the overall image darker.
• Extreme brightness adjustments can lead to loss of detail in very light or very dark areas.

This transformation is useful for correcting under- or over-exposed images, enhancing details in dark areas, or creating specific mood effects.

​

Original Image

​

Image with Increased Brightness

​

Image with Decreased Brightness

​

Best Practices

• Use moderate brightness adjustments (e.g., -30 to 30) for subtle corrections.
• Be cautious with high brightness values as they may lead to loss of detail in highlights.
• When decreasing brightness, be aware that shadow details may become less visible.
• Consider the overall exposure of your image when adjusting brightness - overexposed images may benefit from decreased brightness, while underexposed images may need increased brightness.
• Combine brightness adjustments with other transformations like contrast or saturation for more comprehensive image enhancements.
• When preparing images for print, keep in mind that bright screens may make images appear brighter than they will in print.

​

Note

The effect of brightness adjustment can vary depending on the original image. Images that are already very bright or very dark may show more dramatic changes with brightness adjustments. It’s often useful to make small, incremental adjustments to achieve the desired effect.