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

Recommended Defaults

For compatibility, some of the default options of TImageEnView are not the recommended ones. Here are some suggested changes:

• 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;
• If you are updating an older project, ensure that LegacyBitmap is false for better performance and memory usage:
    ImageEnView1.LegacyBitmap := False;

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

---