TIEImageEffectsList.Insert

Declaration

procedure Insert(Index: integer; v: TIEImageEffect); overload;
procedure Insert(Index: integer; Operation: TPreviewEffect); overload;
function Insert(Index: integer; (pe: TPreviewEffects = [peAll]): integer; overload;

Description

Insert a new effect into the active effects list of the image.
If a single effect is specified (e.g peRotate), it is added directly. If a set is specified (e.g [peRotate] or ppeColorAdjustments), then the Previews dialog is displayed.



Generally it will be used in one of the two following ways:

1. Prompt the user to specify an effect from the Proc Previews dialog

// Prompt the user to specify a color adjustment (do not need to call ImageEnView1.Update)
ImageEnView1.IEBitmap.EffectsChain.Insert( 0, ppeColorAdjustments );


2. Inserting a custom effect using code (in combination with CurrentItem)

// Insert a rotation effect to the image chain
ImageEnView1.IEBitmap.EffectsChain.Insert( 0, peRotate );
ImageEnView1.IEBitmap.EffectsChain.CurrentItem.Rotate_Angle := 90;
ImageEnView1.IEBitmap.EffectsChain.CurrentItem.Rotate_Antialias := ierBicubic;
ImageEnView1.Update();  // Must call update after manually setting properties


Note: If a TImageEnView is being used, you MUST call ImageEnView1.Update() after inserting an item (except for the TPreviewEffects overload)

Examples

// Prompt the user to specify a color adjustment, e.g. hue, contrast, automatic-enhancement, etc.
ImageEnView1.IEBitmap.EffectsChain.Insert( 0, ppeColorAdjustments );



// Prompt the user to specify an editing effect, e.g. rotation, resizing or cropping
ImageEnView1.IEBitmap.EffectsChain.Insert( 0, ppeEditingFunctions );



// Prompt the user to specify an image effect, e.g. Lens or Wave effect
ImageEnView1.IEBitmap.EffectsChain.Insert( 0, ppeSpecialEffects );



// Prompt the user to specify image rotation
ImageEnView1.IEBitmap.EffectsChain.Insert( 0, [peRotate] );


// Insert a horizontal flip
ImageEnView1.IEBitmap.EffectsChain.Insert( peRotate ); // Rotation and flipping type
ImageEnView1.IEBitmap.EffectsChain.CurrentItem.Flip_Horz := True;
ImageEnView1.Update();  // Must call update after manually setting properties

---