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)SyntaxApplies a Gaussian blur effect, reduces image noise and detail levels.
?effects=blur(12)
brightness
integer
brightness(brightnessLevel)SyntaxIncreases or reduces the image brightness. The colour space used for this is HSL.
?effects=brightness(50)
channelExchange
enum
channelExchange(colorChannelSwap)SyntaxSwap RGB color channels.
?effects=channelExchange(BGR)
channelLevel
parameter array
channelLevel(channel,min,max)SyntaxIncreases 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)SyntaxSets 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)SyntaxApplies the specified color filter to the image.
?effects=channelRGBFilter(0088ff)
channelSelect
enum
channelSelect(channel)SyntaxDisplays only the information contained in the selected channel.
?effects=channelselect(red)
colorize
parameter array
colorize(hue,saturation,lightness)SyntaxApplies 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)SyntaxApplies 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)SyntaxIncreases or reduces the image contrast.
?effects=contrast(30)
desaturate
enum
desaturate(method)SyntaxDesaturates the specified image property.
?effects=desaturate(average)
distort
float array
distort(tlx,tly,trx,try,brx,bry,blx,bly)SyntaxPerforms 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)SyntaxFills the image with the specified color considering the alpha channel if it exists in the image.
?effects=fill(4400ffff)
flip
enum
flip(direction)SyntaxFlips the image horizontally or vertically.
?effects=flip(horizontal)
gamma
parameter array
gamma(gammaValue,channel)SyntaxReduces or increases the image gamma.
?effects=gamma(5.0,red)
glow
integer
glow(glowLevel)SyntaxAdds 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)SyntaxMaps a defined gradient over a grayed image.
?effects=gradientMap(average,FF60F0C2)
hsl
parameter array
hsl(hue,saturation,lightness,channel)SyntaxAllows 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)SyntaxInverts one channel, all channels or the brightness of the image.
?effects=invert(brightness)
matte
rgb hex
matte(color)SyntaxRemoves transparency and renders all translucent pixel against the matte color.
?effects=matte(00ffff)
noise
parameter array
noise(amount,strength,monochrome)SyntaxAdds noise to the image.
?effects=noise(50,70,true)
opaque
opaque()SyntaxRemoves the Alpha Channel from an image if it exists.
?effects=opaque()
overlays
parameter array
overlays(image(opacity,position,xOffset,yOffset))SyntaxAdds an overlay to the image. This effect is always applied before all other effects.
&height=200)
?&renderer=overlay&overlays=_service/demo_watermark.png(90,CC,0,0)
pad
parameter array
pad(position,color)SyntaxPads 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)SyntaxCreates 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)SyntaxApplies 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)SyntaxChanges the image saturation.
?effects=saturation(HSL,-50)
select
parameter array
select(command,range,rangeParameters)SyntaxLimit 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()SyntaxMakes the image look like a sepia toned photo.
?effects=sepia()
sharpen
integer
sharpen(strength)SyntaxSharpens the image using a Gaussian unsharpen algorithm. Especially details and contours will be highlighted.
?effects=sharpen(50)
solarize
solarize()SyntaxApplies a solarize effect that negates all pixels above a certain value. Solarization allows the alienation of images.
?effects=solarize()
temperature
integer
temperature(colorTemperature)SyntaxChanges the image color temperature.
?effects=temperature(-70)
threshold
parameter array
threshold(levelLow,levelHigh,color1,color2)SyntaxReduces the color range of the images by applying a threshold filter.
?effects=threshold(55,170,E05555,E3E85B)
transparency
integer
transparency(transparencyLevel)SyntaxAdds 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)