EFFECT
The EFFECT
object allows to apply one or more of the
following effects to the image.
It has only one property: value
.
stdWrap is available for value
.
Syntax
Syntax
20 = EFFECT
20.value = <effect>=<value> | <effect>=<value>
All effects are defined as the effect only or as an effect/value pair inside
value
. Multiple effects or effect/value pairs are separated by
|
.
Example
EXT:site_package/Configuration/TypoScript/setup.typoscript
lib.image = IMAGE
lib.image {
file = GIFBUILDER
file {
XY = 1024,768
format = jpg
10 = IMAGE
10.file = fileadmin/image.jpg
20 = EFFECT
20.value = gamma=1.3 | flip | rotate=180
}
}
Effects
-
blur
- Data type
integer (1-99)
- Default
0
Blurs the edges inside the image.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = blur=10
-
charcoal
- Data type
integer (0-100)
- Default
0
Makes the image look as if it has been drawn with charcoal and defines
the intensity of that effect.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = charcoal=5
-
colors
- Data type
integer (2-255)
Defines the number of different colors to use in the image.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = colors=100
-
edge
- Data type
integer (0-99)
- Default
0
Detect edges within an image. This is a gray-scale operator, so it is
applied to each of the three color channels separately. The value defines
the radius for the edge detection.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = edge=8
-
emboss
Creates a relief effect: Creates highlights or shadows that replace
light and dark boundaries in the image.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = emboss
-
flip
Vertical flipping.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = flip
-
flop
Horizontal flipping.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = flop
-
gamma
- Data type
double (0.5 - 3.0)
- Default
1.0
Sets the gamma value.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = gamma=1.3
-
gray
The image is converted to gray tones.
Example:
This gives the image a slight wave and
renders it in gray.
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = wave=1,20 | gray
-
invert
Invert the colors.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = invert
-
rotate
- Data type
integer (0-360)
- Default
0
Number of degrees for a clockwise rotation.
Image dimensions will grow if needed, so that nothing is cut off from
the original image.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = rotate=180
-
sharpen
- Data type
integer (0-99)
- Default
0
Sharpens the edges inside the image.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = sharpen=12
-
shear
- Data type
integer (-90 - 90)
- Default
0
Number of degrees for a horizontal shearing. Horizontal shearing
slides one edge of the image along the X axis, creating a
parallelogram. Provide an integer between -90 and 90 for the number
of degrees.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = shear=-30
-
solarize
- Data type
integer (0-99)
- Default
0
Color reduction, "burning" the brightest colors black. The brighter the
color, the darker the solarized color is. This happens in photography when
chemical film is over exposed.
The value sets the grayscale level above which the color is negated.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = solarize=15
-
swirl
- Data type
integer (0-1000)
- Default
0
The image is swirled or spun from its center.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = swirl=200
-
wave
- Data type
integer,integer (both 0-99)
- Default
0,0
Provide values for the amplitude and the length of a wave, separated by
comma. All horizontal edges in the image will then be transformed by a wave
with the given amplitude and length.
Example:
EXT:site_package/Configuration/TypoScript/setup.typoscript
20 = EFFECT
20.value = wave=1,20