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)
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)
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)
blur
integer
blur(blurLevel)Syntax
Applies a Gaussian blur effect, reduces image noise and detail levels.
?effects=blur(12)
brightness
integer
brightness(brightnessLevel)Syntax
Increases or reduces the image brightness. The colour space used for this is HSL.
?effects=brightness(50)
channelExchange
enum
channelExchange(colorChannelSwap)Syntax
Swap RGB color channels.
?effects=channelExchange(BGR)
channelLevel
parameter array
channelLevel(channel,min,max)Syntax
Increases or decreases all color values of the selected channel until they are in the specified range.
?effects=channelLevel(red,120,160)
channelLevelTrunk
parameter array
channelLevelTrunk(channel,min,max,pad)Syntax
Sets all color values of the selected channel outside the specified range to the pad value.
?effects=channelLevelTrunk(blue,0,50,50)
channelRGBfilter
rgb hex
channelRGBfilter(color)Syntax
Applies the specified color filter to the image.
?effects=channelRGBFilter(0088ff)
channelSelect
enum
channelSelect(channel)Syntax
Displays only the information contained in the selected channel.
?effects=channelselect(red)
colorize
parameter array
colorize(hue,saturation,lightness)Syntax
Applies a colorize effect to the image. This makes it possible to give a general color impression to the image.
?effects=colorize(200,100,0)
colorOverlay
parameter array
colorOverlay(blendmode,color,opacity)Syntax
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.
?effects=colorOverlay(Difference,00aeff,50)
contrast
integer
contrast(contrastLevel)Syntax
Increases or reduces the image contrast.
?effects=contrast(30)
desaturate
enum
desaturate(method)Syntax
Desaturates the specified image property.
?effects=desaturate(average)
distort
float array
distort(tlx,tly,trx,try,brx,bry,blx,bly)Syntax
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.
?effects=distort(0.13,0,0.88,0,1.08,1.13,-0.07,1.13)
fill
argb hex
fill(color)Syntax
Fills the image with the specified color considering the alpha channel if it exists in the image.
?effects=fill(4400ffff)
flip
enum
flip(direction)Syntax
Flips the image horizontally or vertically.
?effects=flip(horizontal)
gamma
parameter array
gamma(gammaValue,channel)Syntax
Reduces or increases the image gamma.
?effects=gamma(5.0,red)
glow
integer
glow(glowLevel)Syntax
Adds a glow effect to the image by enlarging and summarizing all bright areas, so you have the impression the image shines.
?effects=glow(15)
gradientMap
parameter array
gradientMap(method,color)Syntax
Maps a defined gradient over a grayed image.
?effects=gradientMap(average,FF60F0C2)
hsl
parameter array
hsl(hue,saturation,lightness,channel)Syntax
Allows increase or decrease of the hue, saturation and lightness of a specified image channel.
?effects=hsl(90,100,0,all)
invert
enum
invert(channel/brightness)Syntax
Inverts one channel, all channels or the brightness of the image.
?effects=invert(brightness)
matte
rgb hex
matte(color)Syntax
Removes transparency and renders all translucent pixel against the matte color.
?effects=matte(00ffff)
noise
parameter array
noise(amount,strength,monochrome)Syntax
Adds noise to the image.
?effects=noise(50,70,true)
opaque
opaque()Syntax
Removes the Alpha Channel from an image if it exists.
?effects=opaque()
overlays
parameter array
overlays(image(opacity,position,xOffset,yOffset))Syntax
Adds an overlay to the image. This effect is always applied before all other effects.
?&renderer=overlay&overlays=_service/demo_watermark.png(90,CC,0,0)
pad
parameter array
pad(position,color)Syntax
Pads the image to fit the requested size exactly, placing the actual image on the colored canvas at the specified position.
?&effects=pad(cc,ff00ffff)
pixelize
integer
pixelize(pixelizeStrength)Syntax
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.
?effects=pixelize(9)
posterize
integer
posterize(threshold)Syntax
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.
?effects=posterize(2)
saturation
parameter array
saturation(mode,strength)Syntax
Changes the image saturation.
?effects=saturation(HSL,-50)
select
parameter array
select(command,range,rangeParameters)Syntax
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.
?effects=select(New,Alpha,1),colorize(200,100,0)
sepia
sepia()Syntax
Makes the image look like a sepia toned photo.
?effects=sepia()
sharpen
integer
sharpen(strength)Syntax
Sharpens the image using a Gaussian unsharpen algorithm. Especially details and contours will be highlighted.
?effects=sharpen(50)
solarize
solarize()Syntax
Applies a solarize effect that negates all pixels above a certain value. Solarization allows the alienation of images.
?effects=solarize()
temperature
integer
temperature(colorTemperature)Syntax
Changes the image color temperature.
?effects=temperature(-70)
threshold
parameter array
threshold(levelLow,levelHigh,color1,color2)Syntax
Reduces the color range of the images by applying a threshold filter.
?effects=threshold(55,170,E05555,E3E85B)
transparency
integer
transparency(transparencyLevel)Syntax
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.
?effects=transparency(70)