GET
/
transform

How to use

The hue transformation allows you to adjust the hue of an image by rotating the color wheel.

Pass the following query param to the API endpoint:

hue=angle

Where:

  • angle is the rotation angle in degrees.

For example: hue=30

Parameter

angle: The angle in degrees to rotate the hue. This parameter accepts integer values:

  • Positive values rotate the hue clockwise.
  • Negative values rotate the hue counterclockwise.
  • A full rotation is 360 degrees.

Effect of Hue Adjustment

  • Changes the colors in the image by rotating them around the color wheel.
  • Can be used to create dramatic color shifts or subtle adjustments.
  • Does not affect the brightness or saturation of the image.
  • A rotation of 180 degrees will invert the colors.

This transformation is particularly useful for creative color adjustments or correcting color casts in images.

Original Image

URL : https://www.thunderimage.com/sample/yosemite.jpg

Image with Hue Rotated 90 Degrees

URL: /transform?url=https://www.thunderimage.com/sample/yosemite.jpg&hue=90

Image with Hue Rotated -45 Degrees

URL: /transform?url=https://www.thunderimage.com/sample/yosemite.jpg&hue=-45

Best Practices

  • Use small angle adjustments (e.g., -30 to 30 degrees) for subtle color corrections.
  • Larger angle adjustments can be used for creative effects or dramatic color changes.
  • Remember that hue rotation affects all colors in the image; consider using masks or selective adjustments for more precise control.
  • Combine hue adjustments with saturation and brightness adjustments for comprehensive color manipulation.
  • When correcting color casts, try to identify the color of the cast and rotate the hue by the opposite amount.

Note

The hue transformation changes the colors of the image but does not affect its overall brightness or contrast. For more comprehensive color adjustments, consider combining hue with other color transformations like saturation and brightness.

Authorizations

x-api-key
string
headerrequired

API key required for authentication

Query Parameters

url
string
required

The URL of the image to be transformed.

hue
integer

The angle in degrees to rotate the hue. Positive values rotate clockwise, negative values rotate counterclockwise.

Required range: -360 < x < 360

Response

200 - image/jpeg

The transformed image in JPEG format.