TImageEnProc.DoPreviews
Declaration
function DoPreviews(pe: TPreviewEffects = [peAll]; IsResizeable: Boolean = true; FormWidth : Integer = -1; FormHeight : Integer = -1; FormLeft : Integer = -1; FormTop: Integer = -1): Boolean;Description
Executes the Image Processing dialog to allow the user to perform various color and image manipulation functions upon the image.| Parameter | Description |
|---|---|
| pe | The set of effects to show in the dialog. You may wish to use [peAll], or one of the constants for editing, color adjustment and effect sets: ppeColorAdjustments, ppeEditingFunctions or ppeSpecialEffects |
| IsResizeable | If true, the user can enlarge the dialog |
| FormWidth/FormHeight | The initial size of the form. -1 = default value. Dialog size is controlled also by TIPDialogParams.DialogWidth and TIPDialogParams.DialogHeight |
| FormLeft/FormTop | The initial form position. -1 = default value (centered) |
Notes:
- To assign default values, read user specified values or persist values between sessions, use TIPDialogParams
- For peRotate DefaultRotateAntiAlias specifies whether anti-alias is used
- For peResize DefaultResampleFilter specifies the resampling filter that it used to improve the quality
- peSoftShadow is not available if you have not enabled the alpha channel
- The language used in the dialog is controlled by MsgLanguage. The styling can also be adjusted using UseButtonGlyphsInDialogs
- Most color effects (those in ppeColorAdjustments) have no effect with 1bit images (even though changes may be shown in the preview if a quality sample is in use)
Demos
 | Demos\ImageEditing\CompleteEditor\PhotoEn.dpr |
| | Demos\Other\ImageEn_Dialogs\ImageEn_Dialogs.dpr |
Examples
// Prompt to allow all editing and color adjustment on the current imageImageEnView1.Proc.DoPreviews( [ peAll ] );
// Prompt to perform color adjustment on the current image
ImageEnView1.Proc.DoPreviews( ppeColorAdjustments );
// Prompt to perform image effects on the current image
ImageEnView1.Proc.DoPreviews( ppeSpecialEffects );
// Prompt to edit the current image
ImageEnView1.Proc.DoPreviews( ppeEditingFunctions );
ImageEnView1.Proc.PreviewsParams := ImageEnView1.Proc.PreviewsParams + [ prppDefaultLockPreview ]; // Default to preview
ImageEnView1.Proc.DoPreviews( [ peContrast, peUserFilt ] ); // Show contrast and user filters
// Prompt for image editing functions with best quality output
IEGlobalSettings().DefaultRotateAntiAlias := ierBicubic;
IEGlobalSettings().DefaultResampleFilter := rfLanczos3;
ImageEnView1.Proc.DoPreviews( ppeEditingFunctions );
// Display Effects Dialog with state saved between sessions
if FileExists( 'D:\State.dat' ) then
ImageEnView1.Proc.IPDialogParams.LoadFromFile( 'D:\State.dat' );
ImageEnView1.Proc.DoPreviews( ppeSpecialEffects );
ImageEnView1.Proc.IPDialogParams.SaveToFile( 'D:\State.dat' );
