images.Hue
Returns an image filter that rotates the hue of an image.
- Syntax
- images.Hue SHIFT
- Returns
- images.filter
Usage
The images.Hue function returns an image filter that rotates the hue of an image. The hue of a color is its position on the color wheel, measured in degrees, where 0 is red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, and 300 is magenta. The filter moves every color in the image by the same angle around the wheel, without changing its lightness or saturation. To replace the colors of an image with a single hue instead, use the images.Colorize function.
Arguments
SHIFT- (
float) The angle, in degrees, by which to rotate the hue, typically in the range[-180, 180]. A positive value moves each color toward the next hue on the color wheel, such as red toward yellow, and a negative value moves it the other way, such as red toward magenta. A value of180or-180replaces each color with its opposite, such as red with cyan or blue with yellow. A value of0has no effect. Values outside the range[-180, 180]wrap around the color wheel, so420is the same as60.
Examples
{{ $filter := images.Hue -15 }}Applying the filter with the images.Filter function:
{{ with resources.Get "images/original.jpg" }}
{{ with . | images.Filter $filter }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}Applying the filter with the Filter method on a Resource object:
{{ with resources.Get "images/original.jpg" }}
{{ with .Filter $filter }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}This is the original image:

This is the processed image:

Last updated:
November 17, 2026
:
content: Apply style guide to images functions (e302e964f)
Improve this page