TImageEnView.RetouchTool

Declaration

property RetouchTool: TIERetouchToolInteraction;

Description

Provides access to the methods and properties of the TIERetouchToolInteraction class, which is used when MouseInteractGeneral is miRetouchTool.
The retouch tool allows the user to apply fix effects to the image, e.g. smudging, blurring, inpainting, etc. When used with a tablet/pen, then pressure may affect the brush size (except for the smudge and motion blur effects).

Demo

Demos\ImageEditing\RetouchTool\RetouchTool.dpr

Examples

// Enable retouch mode
ImageEnView1.MouseInteractGeneral := [miRetouchTool];

// Smudge the image
ImageEnView1.RetouchTool.RetouchMode    := iermSmudge;
ImageEnView1.RetouchTool.SmudgePressure := 15;
ImageEnView1.RetouchTool.Feathering     := 3;
ImageEnView1.MouseInteractGeneral       := [ miRetouchTool ];

// Apply motion blur to image
ImageEnView1.RetouchTool.RetouchMode := iermMotionBlur ;
ImageEnView1.RetouchTool.MotionBlurSigma := 8;
ImageEnView1.RetouchTool.MotionBlurAngle := 180;
ImageEnView1.RetouchTool.MotionBlurRadius := 10;
ImageEnView1.MouseInteractGeneral := [ miRetouchTool ];

// Use IEVision's Inpainting to remove blemishes in the image
ImageEnView1.RetouchTool.RetouchMode := iermIEVisionInpaint;
ImageEnView1.RetouchTool.InpaintRangeSize := 6;
ImageEnView1.MouseInteractGeneral := [ miRetouchTool ];

// Pixelate the brushed area (e.g. to hide sensitive detail)
ImageEnView1.RetouchTool.RetouchMode := iermPixelize;
ImageEnView1.RetouchTool.PixelizeBlockSize := 5;
ImageEnView1.MouseInteractGeneral := [ miRetouchTool ];

// Warp the image
ImageEnView1.RetouchTool.RetouchMode    := iermWarp;
ImageEnView1.RetouchTool.BrushSize      := 60;
ImageEnView1.MouseInteractGeneral       := [ miRetouchTool ];

// Blur the image
ImageEnView1.RetouchTool.RetouchMode := iermBlur;
ImageEnView1.RetouchTool.BlurRadius := 7;
ImageEnView1.MouseInteractGeneral    := [ miRetouchTool ];

// Sharpen the image
ImageEnView1.RetouchTool.RetouchMode     := iermAutoSharpen;
ImageEnView1.RetouchTool.AutoSharpenRate := 0.025;
ImageEnView1.RetouchTool.AutoSharpenIntensity := 30;
ImageEnView1.MouseInteractGeneral        := [ miRetouchTool ];

// Remove noise from the image
ImageEnView1.RetouchTool.RetouchMode := iermSmooth;
ImageEnView1.RetouchTool.SmoothRadius := 12;
ImageEnView1.MouseInteractGeneral     := [ miRetouchTool ];

// Lighten the brushed region
ImageEnView1.RetouchTool.RetouchMode          := iermBrightness;
ImageEnView1.RetouchTool.BrightnessAdjustment := -10;
ImageEnView1.MouseInteractGeneral             := [ miRetouchTool ];

// Reduce color saturation in the brushed image
ImageEnView1.RetouchTool.RetouchMode      := iermSaturation;
ImageEnView1.RetouchTool.SaturationAmount := -30;
ImageEnView1.MouseInteractGeneral         := [ miRetouchTool ];

// Apply a wave effect to the brushed region
ImageEnView1.RetouchTool.RetouchMode := iermWave;
ImageEnView1.RetouchTool.WaveAmplitude := 5;
ImageEnView1.RetouchTool.WavePhase   := 90;
ImageEnView1.RetouchTool.WaveLength := 20;
ImageEnView1.MouseInteractGeneral    := [ miRetouchTool ];

// Apply a gray-scale pencil sketch effect to brushed areas
ImageEnView1.RetouchTool.RetouchMode         := iermPencilSketch;
ImageEnView1.RetouchTool.PencilSketchGray    := True;
ImageEnView1.RetouchTool.PencilSketchLevels := 3;
ImageEnView1.RetouchTool.PencilSketchThickness := 1.4;
ImageEnView1.RetouchTool.PencilSketchAlpha   := 0.2;
ImageEnView1.RetouchTool.PencilSketchDensity := 0.8;
ImageEnView1.MouseInteractGeneral            := [ miRetouchTool ];

// Show retouch brush properties dialog
ImageEnView1.MouseInteractGeneral := [miRetouchTool];
ImageEnView1.BrushShowPropertiesDialog();

TImageEnView.RetouchTool