Declaration
property OnBeforeDrawLayer: TIEDrawLayerEvent;
Description
Occurs immediately before a layer is painted to the back buffer.
Parameter | Description |
Dest | The layer as a bitmap (you may draw to it) |
LayerIndex | The layer index that we are drawing |
Note: With
TImageEnView.OnBeforeDrawLayer,
Dest is only the layer as an image. Whereas, with
OnDrawLayer,
Dest is the entire image the layer has been painted to.
ImageEnView Paint Events
The main paint events of TImageEnView are
OnDrawBackBuffer which occurs when the back buffer is painted and
OnDrawCanvas which occurs every time the canvas is painted. Generally
OnDrawBackBuffer is used for better performance, because the back buffer painting only occurs after the content is
updated. If you need constant custom drawing (e.g. to draw a marker at the current cursor position) then use
OnDrawCanvas.
In layer applications,
OnBeforeDrawLayer and
OnDrawLayer will occur while painting each individual layer. Use these methods if you need easy custom drawing upon each individual layer (e.g. a layer title). Generally
OnBeforeDrawLayer is best, unless you need to paint to the whole image (i.e. outside the area of the layer).
Other drawing events:
◼OnDrawBackground occurs when the background (area behind the image is painted) is painted to allow custom background styling
◼OnDrawLayerBox occurs when the
box around a
layer is painted to allow custom styling of the box
◼OnDrawLayerGrip occurs when the
grips of the selected
layer are drawn to allow custom grip styling
◼OnTransitionPaint occurs while
transitioning from one image to the next
◼OnPaint notifies whenever there is a paint event. It is not used for custom drawing
◼OnDrawPolygon notifies whenever a point of a polygonal selection is drawn
// Show all layers as gray-scale
procedure Tfmain.ImageEnView1BeforeDrawLayer(Sender: TObject; dest: TIEBitmap; LayerIndex: Integer);
var
aProc: TImageEnProc;
begin
aProc := TImageEnProc.CreateFromBitmap( Dest );
aProc.ConvertToGray();
aProc.Free();
end;