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

Display

Background

Scrollbars

Bitmap

Interactive Image Editing

User Interaction

Selections

Alpha Channel (Transparency)

Layers - General

Layers - Display

Layers - Editing
Also: Layer Loading and Layer Saving


Animations and Transitions

Rulers and Measurement

Navigator

Other

Events

Display Events

Paint Events

User Interaction Events

Layer Events

Media Events

Ruler Events

Transition Effects

Other Events

---