Properties · Methods · Events · Demos · Examples

Declaration

TImageEnView = class(TIEView);

Description

TImageEnView is a visual component for image display and editing. It supports zooming, scrolling, selections and layers.
It encapsulates a TIEBitmap as an image container (IEBitmap property) , a TImageEnIO (IO property) for loading, saving, acquisition and printing, and a TImageEnProc (Proc property) for image editing and analysis.
TImageEnView can also be used for display and editing of PDF documents.


Layer editing is also supported, including: images, built-in vector shapes, rich text, polygons and lines.


For rapid UI development a full set of actions is also available.

Overview

Recommendations

• To provide native support for JPEG, PNG and JPEG2000, add the following units to the uses clause of one of your project files:
    ieNativeJPEG, ieNativePNG, ieNativeJ2K
• Use TImageEnView Actions to speed up your development
• If you are displaying images with alpha (transparency), consider displaying a chessboard background, that is separated from the non-image area:
    ImageEnView1.BackgroundStyle := iebsChessboard;
    ImageEnView1.SetChessboardStyle( 16, bsSolid, clWhite, $00E9E9E9 );
    ImageEnView1.BackgroundOuter := clBtnFace;
• If you are creating a layer editor, enable LayerEditingMode:
    IEGlobalSettings().LayerEditingMode := True;
• Enable AutoShrink and AutoStretch if you want to display images without scrolling
• By default, TImageEnView is initially filled with a white image the size of the control, to start it completely empty call Blank:
    ImageEnView1.Blank();
• Specify a ZoomFilter to improve the quality when the zoom is not 100%
    ZoomFilter := rfFastLinear;
• Specify UndoLimit to enable multiple levels of Undo/Redo:
    ImageEnView1.Proc.UndoLimit := 30;
• Enable AutoSetBitDepth so that setting TImageEnView.IEBitmap.PixelFormat automatically updates SamplesPerPixel and BitsPerSample
    IEGlobalSettings().AutoSetBitDepth := True;
• Use MouseInteractGeneral and MouseInteractLayers to specify the effect of the mouse, and KeyInteract for the keyboard
• If you are updating an older project, ensure that LegacyBitmap is false for better performance and memory usage:
    ImageEnView1.LegacyBitmap := False;

Keyboard Shortcuts

The following keyboard shortcuts are supported:
Note: Configure or disable individual keyboard shortcuts using KeyboardShortcuts

Debugging Visualizer

You can view the content of a TImageEnView while debugging by hovering over the object and clicking the Inspect button:

Demos

Examples

procedure TForm1.FormCreate(Sender: TObject);
begin
  // Setup TImageEnView
  ImageEnView1.AutoShrink            := True;           // Make the image fit within the window
  ImageEnView1.BorderStyle           := bsNone;         // Normally don't require a 3D border
  ImageEnView1.ZoomFilter            := rfFastLinear;   // Use better quality drawing when the image is not 100%, Use rfFastLinear for best speed or rfLanczos3 for best quality
  ImageEnView1.MouseInteractGeneral  := [miSelect];     // What action should the mouse do?
  ImageEnView1.Proc.UndoLimit        := 30;             // Allow 30 levels of undo/redo
  IEGlobalSettings().AutoSetBitDepth := True;           // Enabling makes any changes to the TImageEnView.IEBitmap.PixelFormat automatically update the SamplesPerPixel/BitsPerSample properties

  ImageEnView1.Blank();                                 // Initialize state of TImageEnView as empty (instead of defaulting to blank image the size of the control)
end;

// Display an image
ImageEnView1.IO.LoadFromFile('C:\MyImage.jpg');

// Rotate the image           
ImageEnView1.Proc.Rotate(270, True);

Methods and Properties

Embedded Components

Image Display

General Display

Background

Scrollbars

Bitmap

Interactive Image Editing

User Interaction

Selections - General

Selections - Editing

Selections - Styling

Alpha Channel (Transparency)

Layers - General

Layers - Display

Layers - Editing
Also: Layer Loading and Layer Saving


Animations and Transitions

Rulers and Measurement

Other

Events

Display Events

Paint Events

User Interaction Events

Layer Events

Media Events

Ruler Events

Transition Effects

Other Events

---