ImageFX Reference
Use in VCL
Place filter component from ImageFX page to the form. Then you can use filter in code:
// Set source image - better to use 32-bit TBitmap, other
// TBitmap or TGraphic converted automatically.
MyFilter.Input := Image1.Picture.Graphic;
// Set Filter's values - possibility values see on this page
// Also params can be set in IDE
MyFilter.Phase := 10;
// Get result image (apply filter automatically)
Image2.Picture.Assign(MyFilter.Output));
Use in VGScene
You must have both VGScene and ImageFX sources. Add vg_imagefx.pas from ImageFX sources for VGScene's package and rebuild it. Now you can see all filters as VGScene's effect like Shadow or Glow in right click menu.Use in DXScene
You must have both DXScene and ImageFX sources. Add dx_vgimagefx.pas from ImageFX sources for DXScene's package and rebuild it. Now you can see all filters as DXScene's effect like Shadow or Glow in right click menu.Use in Graphics32
You can use GR32 filters in code:
MyFilter := TRipple32.Create(nil);
// Set source image - TBitmap32 object
MyFilter.Input := ImgView32.Bitmap;
// Set Filter's values - possibility values see on this page
// Also params can be set in IDE
MyFilter.Phase := 10;
// Get result image (apply filter automatically)
ImgView32.Bitmap.Assign(MyFilter.Output));
// Free filter
MyFilter.Free;
ImageFX Filters
Blur Category
BoxBlur
An effect that blurs.
Parameters
BlurAmount - The blur factor.
Default value: 1 Min value: 0.01 Max value: 10
Result
DirectionalBlur
An effect that blurs in a single direction.
Parameters
Angle - The direction of the blur (in degrees).
Default value: 0 Min value: 0 Max value: 360
BlurAmount - The scale of the blur (as a fraction of the input size).
Default value: 1 Min value: 0.01 Max value: 10
Result
RadialBlur
An effect that applies a radial blur to the input.
Parameters
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
BlurAmount - The scale of the blur (as a fraction of the input size).
Default value: 1 Min value: 0.01 Max value: 10
Result
GaussianBlur
An effect that GaussianBlurs.
Parameters
BlurAmount - The GaussianBlur factor.
Default value: 1 Min value: 0.01 Max value: 10
Result
Geometry Category
Crop
The size and shape of the cropped image depend on the rectangle you specify.
Parameters
LeftTop - Left-top corner of cropping rect
Default value: (0,0) Min value: (0,0) Max value: (65535,65535)
RightBottom - Left-top corner of cropping rect
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Result
AffineTransform
Applies an affine transform to an image.
Parameters
Center - The center point of the rotation.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Rotation - Rotation angle in degrees.
Default value: 0 Min value: -180 Max value: 180
Scale - Scale value as floating.
Default value: 1 Min value: 0.05 Max value: 4
Result
PerspectiveTransform
Applies an perspective transform to an image.
Parameters
TopLeft - Top left point of result transformation.
Default value: (0,0) Min value: (0,0) Max value: (65535,65535)
TopRight - Top right point of result transformation.
Default value: (300,0) Min value: (0,0) Max value: (65535,65535)
BottomRight - Bottom right point of result transformation.
Default value: (350,300) Min value: (0,0) Max value: (65535,65535)
BottomLeft - Bottom left point of result transformation.
Default value: (0,300) Min value: (0,0) Max value: (65535,65535)
Result
Distortion Category
Ripple
An effect that superimposes rippling waves upon the input.
Parameters
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Amplitude - The amplitude of the ripples.
Default value: 0.1 Min value: 0 Max value: 1
Frequency - The frequency of the ripples.
Default value: 70 Min value: 0 Max value: 100
Phase - The phase of the ripples.
Default value: 0 Min value: -20 Max value: 20
AspectRatio - The aspect ratio (width / height) of the input.
Default value: 1.5 Min value: 0.5 Max value: 2
Result
Swirl
An effect that swirls the input in a spiral.
Parameters
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Strength - The amount of twist to the spiral.
Default value: 10 Min value: -70 Max value: 70
AspectRatio - The aspect ratio (width / height) of the input.
Default value: 1.5 Min value: 0.5 Max value: 2
Result
Magnify
An effect that magnifies a circular region.
Parameters
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Radius - The radius of the magnified region.
Default value: 0.25 Min value: 0 Max value: 1
Magnification - The magnification factor.
Default value: 2 Min value: 1 Max value: 5
AspectRatio - The aspect ratio (width / height) of the input.
Default value: 1.5 Min value: 0.5 Max value: 2
Result
SmoothMagnify
An effect that magnifies a circular region.
Parameters
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
InnerRadius - The inner radius of the magnified region.
Default value: 0.2 Min value: 0 Max value: 1
OuterRadius - The outer radius of the magnified region.
Default value: 0.4 Min value: 0 Max value: 1
Magnification - The magnification factor.
Default value: 2 Min value: 1 Max value: 5
AspectRatio - The aspect ratio (width / height) of the input.
Default value: 1.5 Min value: 0.5 Max value: 2
Result
Bands
An effect that creates bands of bright regions.
Parameters
BandDensity - The number of verical bands to add to the output. The higher the value the more bands.
Default value: 65 Min value: 0 Max value: 150
BandIntensity - Intensity of each band.
Default value: 0.2 Min value: 0 Max value: 1
Result
Wave
An effect that applies a wave pattern to the input.
Parameters
Time - The moment in time. Animate this value over a long period of time. The speed depends on the size. The larger the size, the larger the increase in time on every frame, thus from 0 to 2048 in a smaller amount of time.
Default value: 0 Min value: 0 Max value: 2048
WaveSize - The distance between waves. (the higher the value the closer the waves are to their neighbor).
Default value: 64 Min value: 32 Max value: 256
Result
Wrap
Wrap image by two Bezier curves.
Parameters
LeftStart - Left wrap curve start point
Default value: 0 Min value: 0 Max value: 1
LeftControl1 - Left wrap curve control point 1
Default value: 0.25 Min value: 0 Max value: 1
LeftControl2 - Left wrap curve control point 2
Default value: 0.25 Min value: 0 Max value: 1
LeftEnd - Left wrap curve end point
Default value: 0 Min value: 0 Max value: 1
RightStart - Right wrap curve start point
Default value: 1 Min value: 0 Max value: 1
RightControl1 - Right wrap curve control point 1
Default value: 0.75 Min value: 0 Max value: 1
RightControl2 - Right wrap curve control point 2
Default value: 0.75 Min value: 0 Max value: 1
RightEnd - Right wrap curve end point
Default value: 1 Min value: 0 Max value: 1
Result
BandedSwirl
An effect that swirls the input in alternating clockwise and counterclockwise bands.
Parameters
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Bands - The number of bands in the swirl.
Default value: 10 Min value: 0 Max value: 20
Strength - The amount of twist to the spiral.
Default value: 30 Min value: -70 Max value: 70
AspectRatio - The aspect ratio (width / height) of the input.
Default value: 1.5 Min value: 0.5 Max value: 2
Result
Pinch
An effect that pinches a circular region.
Parameters
Center - The center point of the pinched region.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Radius - The radius of the pinched region.
Default value: 0.25 Min value: 0 Max value: 1
Strength - The amount of twist to the spiral.
Default value: 10 Min value: 0 Max value: 20
AspectRatio - The aspect ratio (width / height) of the input.
Default value: 1.5 Min value: 0.5 Max value: 2
Result
Color Category
Monochrome
Remaps colors so they fall within shades of a single color.
ColorKeyAlpha
An effect that makes pixels of a particular color transparent.
Parameters
ColorKey - The color that becomes transparent.
Default value: 0 Min value: -1 Max value: 1
Tolerance - The tolerance in color differences.
Default value: 0.3 Min value: 0 Max value: 1
Result
Invert
An effect that inverts all colors.
MaskToAlpha
Converts a grayscale image to a white image that is masked by alpha.
Color Adjust Category
HueAdjust
Changes the overall hue, or tint, of the source pixels.
Parameters
Hue - The hue offset.
Default value: 0 Min value: -1 Max value: 1
Result
Contrast
An effect that controls brightness and contrast.
Parameters
Brightness - The brightness offset.
Default value: 0 Min value: -1 Max value: 1
Contrast - The contrast multiplier.
Default value: 1.5 Min value: 0 Max value: 2
Result
Bloom
An effect that intensifies bright regions.
Parameters
BloomIntensity - Intensity of the bloom image.
Default value: 1 Min value: 0 Max value: 1
BaseIntensity - Intensity of the base image.
Default value: 0.5 Min value: 0 Max value: 1
BloomSaturation - Saturation of the bloom image.
Default value: 1 Min value: 0 Max value: 1
BaseSaturation - Saturation of the base image.
Default value: 0.5 Min value: 0 Max value: 1
Result
Gloom
An effect that intensifies dark regions.
Parameters
GloomIntensity - Intensity of the gloom image.
Default value: 1 Min value: 0 Max value: 1
BaseIntensity - Intensity of the base image.
Default value: 0.5 Min value: 0 Max value: 1
GloomSaturation - Saturation of the gloom image.
Default value: 1 Min value: 0 Max value: 1
BaseSaturation - Saturation of the base image.
Default value: 0.5 Min value: 0 Max value: 1
Result
Composite Category
NormalBlend
Normal blending of two images.
Parameters
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
Generator Category
Fill
Generates a solid color.
Parameters
Color - The fill color.
Color value as $AARRGGBB where XX - Hex value of alpha, red, green, blue component. For example red value is $FFFF0000.
Result
FillRGB
Fill all pixels with not empty alpha.
Parameters
Color - The fill color.
Color value as $AARRGGBB where XX - Hex value of alpha, red, green, blue component. For example red value is $FFFF0000.
Result
Style Category
Pixellate
Parameters
BlockCount - The number of pixel blocks.
Default value: 25 Min value: 1 Max value: 1000
Result
Emboss
An effect that embosses the input.
Parameters
Amount - The amplitude of the embossing.
Default value: 0.5 Min value: 0 Max value: 1
Width - The separation between samples (as a fraction of input size).
Default value: 3 Min value: 0 Max value: 10
Result
Sharpen
An effect that sharpens the input.
Parameters
Amount - The amount of sharpening.
Default value: 1 Min value: 0 Max value: 2
Result
Toon
An effect that applies cartoon-like shading (posterization).
Parameters
Levels - The number of color levels to use.
Default value: 5 Min value: 3 Max value: 15
Result
Sepia
Sepia effect.
Parameters
Amount - The amount of sharpening.
Default value: 0.5 Min value: 0 Max value: 1
Result
PaperSketch
An paper sketch effect.
Parameters
BrushSize - The brush size of the sketch effect.
Default value: 3 Min value: 0.6 Max value: 10
Result
PencilStroke
An pencil stroke effect.
Parameters
BrushSize - The brush size of the sketch effect.
Default value: 5 Min value: 1 Max value: 19
Result
Tiles Category
Tiler
Pixel shader tiles the image across multiple rows and columns
Parameters
VerticalTileCount - The number of verical tiles to add to the output. The higher the value the more tiles.
Default value: 4 Min value: 0 Max value: 20
HorizontalTileCount - The number of horizontal tiles to add to the output. The higher the value the more tiles.
Default value: 3 Min value: 0 Max value: 20
HorizontalOffset - Change the horizontal offset of each tile.
Default value: 0 Min value: 0 Max value: 1
VerticalOffset - Change the vertical offset of each tile.
Default value: 0 Min value: 0 Max value: 1
Result
Transition Category
BandedSwirlTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Strength - The amount of twist to the spiral.
Default value: 1 Min value: 0 Max value: 10
Frequency - The frequency of the spiral.
Default value: 20 Min value: 0 Max value: 100
Center - The center point of the ripples.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
BlindTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
NumberOfBlinds - The number of Blinds strips
Default value: 5 Min value: 2 Max value: 15
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
BloodTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
RandomSeed - The seed value that determines dripiness.
Default value: 0.3 Min value: 0 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
CircleTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
FuzzyAmount - The fuzziness factor.
Default value: 0.1 Min value: 0 Max value: 1
Size - The size of the circle.
Default value: 1 Min value: 0 Max value: 2
Center - The center point of effect.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
MagnifyTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Center - The center point of effect.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
CrumbleTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
RandomSeed - The seed value that determines dripiness.
Default value: 0 Min value: -1 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
DisolveTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
RandomSeed - The seed value that determines dripiness.
Default value: 0 Min value: -1 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
DropTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
RandomSeed - The seed value that determines dripiness.
Default value: 0 Min value: -1 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
FadeTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
BrightTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
PixellateTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
BlurTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
WiggleTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
ShapeTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
RippleTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
RotateCrumbleTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
RandomSeed - The seed value that determines dripiness.
Default value: 0 Min value: -1 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
SaturateTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
SlideTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
SlideAmount - The center point of the ripples.
Default value: (150,150) Min value: (-65535,-65535) Max value: (65535,65535)
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
SwirlTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Strength - The amount of twist to the spiral.
Default value: 30 Min value: -70 Max value: 70
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
WaterTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
RandomSeed - The seed value that determines dripiness.
Default value: 0.3 Min value: 0 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
WaveTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
LineTransition
A transition effect.
Parameters
Progress - The amount(%) of the transition from first texture to the second texture.
Default value: 30 Min value: 0 Max value: 100
Origin - The line origin.
Default value: (0,0) Min value: (0,0) Max value: (65535,65535)
Normal - The line normal.
Default value: (150,150) Min value: (0,0) Max value: (65535,65535)
Offset - The line offset.
Default value: (400,400) Min value: (0,0) Max value: (65535,65535)
FuzzyAmount - The fuzziness factor.
Default value: 0.1 Min value: 0 Max value: 1
Target - The target bitmap.
Bitmap object can be set using Filters.ValueAsBitmap[Target] property.
Result
