Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.3.5
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 
Managed Extensions for C++ 
__value public enum RasterPaintEngine : public Enum 
C++/CLI 
public enum class RasterPaintEngine : public Enum 

Members

MemberDescription
Gdi Use GDI
GdiPlus Use GDI+
GdiPlus2 Use GDI+

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 convert the object into a suitable format. This may result in some of the internal image data to be altered.

When the RasterPaintEngine.GdiPlus2 engine is used, the RasterImage.Paint method internally will call GDI+ Graphics.DrawImage methods to paint the image. Note that when using this engine, the RasterImage object data is guaranteed not to be altered or changed in any way.

Using a particular paint engine depends on the RasterImage object and your specific needs:

  • RasterPaintEngine.Gdi is generally faster than RasterPaintEngine.GdiPlus or RasterPaintEngine.GdiPlus2
  • If the RasterImage object is not GDI+ compatible, and you want to preserve the image state and data when painting, use either RasterPaintEngine.Gdi or RasterPaintEngine.GdiPlus2 (refer to RasterImage.TestGdiPlusCompatible for more information).
  • If you need to use GDI+ specific features (for example, if the RasterImage has a transparent color), then use either RasterPaintEngine.GdiPlus or RasterPaintEngine.GdiPlus2.

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 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also