RasterPaintEngine Enumeration

Indicates the painting engine to use when rendering images using the Windows GDI or GDI+ engines..

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public enum RasterPaintEngine : System.Enum, System.IComparable, System.IConvertible, System.IFormattable

'Declaration
 
Public Enum RasterPaintEngine 
   Inherits System.Enum
   Implements System.IComparable, System.IConvertible, System.IFormattable

'Usage
 
Dim instance As RasterPaintEngine

public enum RasterPaintEngine : System.IComparable, System.IConvertible, System.IFormattable

Leadtools.Drawing.RasterPaintEngine = function() { };
Leadtools.Drawing.RasterPaintEngine.prototype = {

  LeadtoolsMemberMarker(replace me)
 };

public enum class RasterPaintEngine : public System.Enum, System.IComparable, System.IConvertible, System.IFormattable

Members

Member	Description
Gdi	Use Windows GDI when painting Leadtools.RasterImage objects
GdiPlus	Use Windows GDI+ when painting Leadtools.RasterImage objects

Remarks

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

When the RasterPaintEngine.GdiPlus engine is used, the RasterImagePainter.Paint method internally will call GDI+ Graphics.DrawImage methods to paint the image. Note that if the Leadtools.RasterImage object is not fully compatible with GDI+, the framework will internally make a copy of parts of the image data (bands) 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.

Example

For an example, refer to RasterPaintProperties.

Inheritance Hierarchy

System.Object
   System.ValueType
      System.Enum
         Leadtools.Drawing.RasterPaintEngine

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Leadtools.Drawing Namespace