Declaration

TImageEnView = class(TIEView);

Description

TImageEnView is an image container, viewer and editor. It supports zooming, scrolling, selections and layers.
TImageEnView encapsulates a TImageEnIO (IO property) for loading/saving/acquisition and a TImageEnProc (Proc property) component for image editing/processing (you do not need to add extra TImageEnIO and TImageEnProc components to your form).




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;

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 - 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

---