PaintEngine Property

Gets and sets the paint engine to use when displaying images.

public RasterPaintEngine PaintEngine { get; set; } 

Public Property PaintEngine As RasterPaintEngine 

public: 
property RasterPaintEngine PaintEngine { 
   RasterPaintEngine get(); 
   void set (    RasterPaintEngine ); 
} 

Property Value

A RasterPaintEngine enumeration value that specifies the paint engine to use when displaying images.

When the RasterPaintEngine.Gdi engine is used, the RasterImagePainter.Paint method calls the Win32 API functions internally to paint the image.

When the RasterPaintEngine.GdiPlus engine is used, the RasterImagePainter.Paint method calls GDI+ Graphics.DrawImage methods internally to paint the image. Note that if the Leadtools.RasterImage object is not fully compatible with GDI+, the framework makes a copy of parts of the image data (bands) internally and paints them to the destination device. The original data is not converted and no changes will be made to the original image.

Choosing a paint engine depends on the Leadtools.RasterImage object and your specific needs:

• RasterPaintEngine.Gdi is generally faster than RasterPaintEngine.GdiPlus since painting in Windows is faster using the Windows GDI is faster than using GDI+.
• If you need to use GDI+ specific features (for example, if the Leadtools.RasterImage has a transparent color or is a 32-bit image with an alpha channel), then use RasterPaintEngine.GdiPlus. RasterPaintEngine.Gdi does not support transparency nor painting the alpha channel values of an image.

When the RasterPaintEngine.GdiPlus engine is used, the following properties are ignored when painting images:

For an example, refer to RasterPaintProperties.

Target Platforms

Reference

RasterPaintProperties Structure

RasterPaintProperties Members