Skip to main content

Effects

With &effects you can add various effects to the image URL.

Effect Examples

Pad Effect

&effects=pad(CC,hexcolor) pads the image to the desired size and places the actual images on the coloured canvas at the given position.

//yourdomain.com/fsi/server?type=image&source=images/samples/sample2.jpg&width=600&height=300&effects=pad(CC,EEEEEE)

normal SSI with Pad defined

Changing Background Color

&effects=Matte(hexcolor) changes the background of transparent png images.

//yourdomain.com/fsi/server?type=image&source=images/samples/sample.jpg&width=300&effects=Matte(F5EE77)

normal SSI with background color defined

Changing Color

A more complex example is when the image contains alpha channels:

//yourdomain.com/fsi/server?type=image&source=images/samples/sample.jpg&width=300&effects=Matte(FFFFFF),select(Add,Alpha,1), colorize(76,50,0)

normal SSI with alpha channel color defined

blur

integer

Applies an unsharping effect

blur(blurLevel)
Syntax
blurLevel
0
Minimum
100
Maximum

Applies a Gaussian blur effect, reduces image noise and detail levels.

Sample Blur
Blur effect
?effects=blur(12)

brightness

integer

Changes brightness in HSL mode

brightness(brightnessLevel)
Syntax
brightnessLevel
-100
Minimum
100
Maximum

Increases or reduces the image brightness. The colour space used for this is HSL.

Sample Brightness
Brightness effect
?effects=brightness(50)

channelExchange

enum

Swap color channels

channelExchange(colorChannelSwap)
Syntax
colorChannelSwap
RBG | BGR | BRG | GRB | GBR
Values

Swap RGB color channels.

Sample ChannelExchange
ChannelExchange effect
?effects=channelExchange(BGR)

channelLevel

parameter array

Limit channel level threshold

channelLevel(channel,min,max)
Syntax
channel
all | red | green | blue
Values
min
0
Minimum
255
Maximum
max
0
Minimum
255
Maximum

Increases or decreases all color values of the selected channel until they are in the specified range.

Sample ChannelLevel
ChannelLevel effect
?effects=channelLevel(red,120,160)

channelLevelTrunk

parameter array

Trunk color channels

channelLevelTrunk(channel,min,max,pad)
Syntax
channel
all | red | green | blue
Values
min
0
Minimum
255
Maximum
max
0
Minimum
255
Maximum
pad
0
Minimum
255
Maximum

Sets all color values of the selected channel outside the specified range to the pad value.

Sample ChannelLevelTrunk
ChannelLevelTrunk effect
?effects=channelLevelTrunk(blue,0,50,50)

channelRGBfilter

rgb hex

Color filter

channelRGBfilter(color)
Syntax
color
rrggbb
rgb hex

Applies the specified color filter to the image.

Sample ChannelRGBfilter
ChannelRGBfilter effect
?effects=channelRGBFilter(0088ff)

channelSelect

enum

Selecting info of one channel

channelSelect(channel)
Syntax
channel
red | green | blue | hue | saturation | brightness
Values

Displays only the information contained in the selected channel.

Sample ChannelSelect
ChannelSelect effect
?effects=channelselect(red)

colorize

parameter array

Colorize image

colorize(hue,saturation,lightness)
Syntax
hue
0
Minimum
360
Maximum
saturation
0
Minimum
100
Maximum
lightness
0
Minimum
100
Maximum

Applies a colorize effect to the image. This makes it possible to give a general color impression to the image.

Sample Colorize
Colorize effect
?effects=colorize(200,100,0)

colorOverlay

parameter array

Applies a color overlay

colorOverlay(blendmode,color,opacity)
Syntax
blendmode
Normal | Dissolve | Exclusion | Difference | Hardmix | PinLight | LinearLight | VividLight | HardLight | SoftLight | Overlay | LighterColor | LinearDodgeAdd | ColorDodge | Screen | Lighten | DarkenColor | LinearBurn | ColorBurn | Multiply | Darken | Divide | GrainExtract | GrainMerge | Substract | LuminosityHSL | ColorHSL | SaturationHSL | HueHSL | LuminosityHSB | ColorHSB | SaturationHSB | HueHSB
Values
color
rrggbb
rgb hex
opacity
0
Minimum
100
Maximum

Applies a color overlay to the image using the specified color and blend mode. By using one or perhaps several different effects, many changes in coloration can be achieved.

Sample ColorOverlay
ColorOverlay effect
?effects=colorOverlay(Difference,00aeff,50)

contrast

integer

Changes image contrast

contrast(contrastLevel)
Syntax
contrastLevel
-100
Minimum
100
Maximum

Increases or reduces the image contrast.

Sample Contrast
Contrast effect
?effects=contrast(30)

desaturate

enum

Desaturating the image

desaturate(method)
Syntax
method
average | lightness | luminosity | saturation
Values

Desaturates the specified image property.

Sample Desaturate
Desaturate effect
?effects=desaturate(average)

distort

float array

Image distortion with coordinates

distort(tlx,tly,trx,try,brx,bry,blx,bly)
Syntax
top left
0.0,0.0
Minimum
1.0,1.0
Maximum
top right
0.0,0.0
Minimum
1.0,1.0
Maximum
bottom right
0.0,0.0
Minimum
1.0,1.0
Maximum
bottom left
0.0,0.0
Minimum
1.0,1.0
Maximum

Performs a perspective distortion by moving the image corners to the new specified coordinates. The first two values are the upper left corner, based on a value of 0-1 on the X- and Y-axis. The following corners are to be entered clockwise.

Sample Distort
Distort effect
?effects=distort(0.13,0,0.88,0,1.08,1.13,-0.07,1.13)

fill

argb hex

Image fill

fill(color)
Syntax
color
aarrggbb
argb hex

Fills the image with the specified color considering the alpha channel if it exists in the image.

Sample Fill
Fill effect
?effects=fill(4400ffff)

flip

enum

Flips image

flip(direction)
Syntax
direction
horizontal | vertical
Values

Flips the image horizontally or vertically.

Sample Flip
Flip effect
?effects=flip(horizontal)

gamma

parameter array

Change image gamma

gamma(gammaValue,channel)
Syntax
gammaValue
0
Minimum
10
Maximum
channel
all | red | green | blue
Values

Reduces or increases the image gamma.

Sample Gamma
Gamma effect
?effects=gamma(5.0,red)

glow

integer

Applies an glow effect

glow(glowLevel)
Syntax
glowLevel
0
Minimum
100
Maximum

Adds a glow effect to the image by enlarging and summarizing all bright areas, so you have the impression the image shines.

Sample Glow
Glow effect
?effects=glow(15)

gradientMap

parameter array

Adds a gradient map

gradientMap(method,color)
Syntax
method
average | lightness | luminosity
Values
color
aarrggbb
argb hex

Maps a defined gradient over a grayed image.

Sample GradientMap
GradientMap effect
?effects=gradientMap(average,FF60F0C2)

hsl

parameter array

Changes HSL of image channel

hsl(hue,saturation,lightness,channel)
Syntax
hue
-180
Minimum
180
Maximum
saturation
-100
Minimum
100
Maximum
lightness
-100
Minimum
100
Maximum
channel
all | red | yellow | green | cyan | blue | magenta
Values

Allows increase or decrease of the hue, saturation and lightness of a specified image channel.

Sample HSL
HSL effect
?effects=hsl(90,100,0,all)

invert

enum

Inverting channel or brightness

invert(channel/brightness)
Syntax
channel/brightness
brightness | all | red | green | blue | alpha
Values

Inverts one channel, all channels or the brightness of the image.

Sample Invert
Invert effect
?effects=invert(brightness)

matte

rgb hex

Applies matte color

matte(color)
Syntax
color
rrggbb
rgb hex

Removes transparency and renders all translucent pixel against the matte color.

Sample Matte
Matte effect
?effects=matte(00ffff)

noise

parameter array

Adds noise

noise(amount,strength,monochrome)
Syntax
amount
0
Minimum
100
Maximum
strength
0
Minimum
100
Maximum
monochrome
true | false
Values

Adds noise to the image.

Sample Noise
Noise effect
?effects=noise(50,70,true)

opaque

Removes alpha channel

opaque()
Syntax

Removes the Alpha Channel from an image if it exists.

Sample Opaque
Opaque effect
?effects=opaque()

overlays

parameter array

Adds overlay

overlays(image(opacity,position,xOffset,yOffset))
Syntax
image
path/to/image
Asset path
opacity
0
Minimum
100
Maximum
position
TL | TC | TR | CL | CC | CR | BL | BC | BR
Values
xOffset
0
integer
yOffset
0
integer

Adds an overlay to the image. This effect is always applied before all other effects.

Sample Overlays
Overlays effect
?&renderer=overlay&overlays=_service/demo.png(90,CC,0,0)

pad

parameter array

Adds pad color around image

pad(position,color)
Syntax
position
TL | TC | TR | CL | CC | CR | BL | BC | BR
Values
color
aarrggbb
argb hex

Pads the image to fit the requested size exactly, placing the actual image on the colored canvas at the specified position.

Sample Pad
Pad effect
?&effects=pad(cc,ff00ffff)

pixelize

integer

Applies an pixel effect

pixelize(pixelizeStrength)
Syntax
pixelizeStrength
0
Minimum
100
Maximum

Creates a pixel effect by reducing the image details. The pixel colors adapt to the most common used color around each pixel, resulting in a tile effect.

Sample Pixelize
Pixelize effect
?effects=pixelize(9)

posterize

integer

Applies an posterize effect

posterize(threshold)
Syntax
threshold
0
Minimum
255
Maximum

Applies a posterize effect, reducing the image to a limited number of color levels. Posterize is a separation of the tonal values with a simultaneous tonal value reduction.

Sample Posterize
Posterize effect
?effects=posterize(2)

saturation

parameter array

Changes saturation

saturation(mode,strength)
Syntax
mode
HSL | YIQ
Values
strength
-100
Minimum
100
Maximum

Changes the image saturation.

Sample Saturation
Saturation effect
?effects=saturation(HSL,-50)

select

parameter array

Limits effects to an alpha channel

select(command,range,rangeParameters)
Syntax
command
New | Add | Sub | Clear | Invert
Values
range
Path | Alpha | Rect
Values
rangeParameters
see below
Selection

Limit subsequent effects to image regions using clipping paths and/or alpha channels. Supported commands:

  • New: clears old and starts a new selection.
  • Add: adds region to existing selection.
  • Sub: subtracts region from existing selection.
  • Clear: clears the current selection.
  • Invert: inverts the current selection.

The New, Add and Sub commands require a range with appropriate rangeparameters.

Possible range values are:

  • Path: Selects a path defined in the image. Requires the number of the path as range parameter.
  • Alpha: Selects one of the alpha channels defined in the image. Requires the number of the alpha channel as range parameter.
  • Rect: Selects a rectangular region within the image. Requires the rectangle coordinates as range parameters.
Sample Select
Select effect
?effects=select(New,Alpha,1),colorize(200,100,0)

sepia

Adds sepia effect

sepia()
Syntax

Makes the image look like a sepia toned photo.

Sample Sepia
Sepia effect
?effects=sepia()

sharpen

integer

Applies a sharpen effect

sharpen(strength)
Syntax
strength
0
Minimum
100
Maximum

Sharpens the image using a Gaussian unsharpen algorithm. Especially details and contours will be highlighted.

Sample Sharpen
Sharpen effect
?effects=sharpen(50)

solarize

Adds solarize effect

solarize()
Syntax

Applies a solarize effect that negates all pixels above a certain value. Solarization allows the alienation of images.

Sample Solarize
Solarize effect
?effects=solarize()

temperature

integer

Applies a temperature effect

temperature(colorTemperature)
Syntax
colorTemperature
-100
Minimum
100
Maximum

Changes the image color temperature.

Sample Temperature
Temperature effect
?effects=temperature(-70)

threshold

parameter array

Applies threshold filter.

threshold(levelLow,levelHigh,color1,color2)
Syntax
levelLow
0
Minimum
255
Maximum
levelHigh
0
Minimum
255
Maximum
color1
rrggbb
rgb hex
color2
rrggbb
rgb hex

Reduces the color range of the images by applying a threshold filter.

Sample Threshold
Threshold effect
?effects=threshold(55,170,E05555,E3E85B)

transparency

integer

Adds transparency

transparency(transparencyLevel)
Syntax
transparencyLevel
0
Minimum
100
Maximum

Adds transparency to the image. If the image contains an alpha channel it will be strengthened. If there is no alpha channel in the image, then one will be created.

Sample Transparency
Transparency effect
?effects=transparency(70)