Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
RasterPaintEngine Enumeration
See Also  
Leadtools Namespace : RasterPaintEngine Enumeration



Indicates the painting engine to use when rendering images.

Syntax

Visual Basic (Declaration) 
Public Enum RasterPaintEngine 
   Inherits Enum
Visual Basic (Usage)Copy Code
Dim instance As RasterPaintEngine
C# 
public enum RasterPaintEngine : Enum 
C++/CLI 
public enum class RasterPaintEngine : public Enum 

Members

MemberDescription
Gdi Use Windows GDI when painting RasterImage objects
GdiPlus Use Windows GDI+ when painting RasterImage objects
GdiPlus2 Obselete. Do not use, instead, use GdiPlus

Example

For an example, refer to RasterPaintProperties.

Remarks

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

When the RasterPaintEngine.GdiPlus engine is used, the RasterImage.Paint method internally will call GDI+ Graphics.DrawImage methods to paint the image. Note that if the RasterImage object is not fully compatible with GDI+, the framework will internally makes 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.

RasterPaintEngine.GdiPlus2 engine is deprecated as of LEADTOOLS v16.5. The functionality of this paint engine is merged with RasterPaintEngine.GdiPlus and you should convert your code to use RasterPaintEngine.GdiPlus whenever RasterPaintEngine.GdiPlus2 was used.

Using a particular paint engine depends on the 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 RasterImage has a transparent color or is a 32-bit image with an alpha channel), then use RasterPaintEngine.GdiPlus. RasterPaintEngine.GdiPlus does not support transparency nor painting the alpha channel values of an image.

For more information, refer to The RasterPaintEngine Property and 16bpp Grayscale Images.

Inheritance Hierarchy

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

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also