ImageEn, unit imageenproc

TImageEnProc.DoPreviews

TImageEnProc.DoPreviews


Declaration

function DoPreviews(pe: TPreviewEffects = [peAll]; IsResizeable: Boolean = true; FormWidth : Integer = -1; FormHeight : Integer = -1; FormLeft : Integer = -1; FormTop: Integer = -1): Boolean; overload;
function DoPreviews(pe: TPreviewEffects; var Dest: TIEImageEffect): Boolean; overload;


Description

Executes the Image Processing dialog to allow the user to perform various color and image manipulation functions upon the image (most of the methods of TImageEnProc).
To apply values specified in the dialog to other images use ApplyPreviews.
If you use the second overload, the previews are not applied to the current images, but only stored in the destination TIEImageEffect object.

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. The default size is controlled by TIEImageEffect.DialogWidth and TIEImageEffect.DialogHeight
FormLeft/FormTop The initial form position. -1 = default value. The default position is centered and controlled by TIEImageEffect.DialogLeft and TIEImageEffect.DialogTop

Note:
 To assign default values, read user specified values or persist values between sessions, use TIEImageEffect
 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)
 To embed the editing UI in your forms, use the TIEEditControls component


Demos

Demo  Demos\ImageEditing\CompleteEditor\PhotoEn.dpr
Demo  Demos\Other\ImageEn_Dialogs\ImageEn_Dialogs.dpr
Demo  Demos\ImageEditing\EffectsChain\EffectsChain.dpr
Demo  Demos\InputOutput\BatchConvert\BatchConvert.dpr


Examples

// Prompt user to perform editing and color adjustment on the current image
ImageEnView1.Proc.DoPreviews( [ peAll ] );

// Prompt user to perform color adjustment on the current image
ImageEnView1.Proc.DoPreviews( ppeColorAdjustments );



// Prompt user to perform image effects on the current image
ImageEnView1.Proc.DoPreviews( ppeSpecialEffects );



// Prompt user to perform editing operations 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' );

// Default to the Rotate page
ImageEnView1.Proc.IPDialogParams.Operation := peRotate;
ImageEnView1.Proc.IPDialogParams.Rotate_Angle := 45;
ImageEnView1.Proc.DoPreviews( ppeEditingFunctions );

// Prompt the user for an image editing effect and add it to our Effects Chain (TIEImageEffectsList)
op := TIEImageEffect.Create();
try
  if ImageEnView1.Proc.DoPreviews( ppeEditingFunctions, op ) then
  begin
    EffectsChain.Add( op );
    ListBox1.Items.Add( op.Description() );
  end;
finally
  op.Free;
end;


See Also

Public Property  ApplyPreviews
Public Property  IPDialogParams
Published Property  PreviewFont
Published Property  PreviewFontEnabled
Public Property  PreviewsLog
Published Property  PreviewsParams