Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
PaintEngine Property
See Also 
Leadtools Namespace > RasterPaintProperties Structure : PaintEngine Property



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

Syntax

Visual Basic (Declaration)  
Public Property PaintEngine As RasterPaintEngine
Visual Basic (Usage) Copy Code
Dim instance As RasterPaintProperties
Dim value As RasterPaintEngine
 
instance.PaintEngine = value
 
value = instance.PaintEngine
C#  
public RasterPaintEngine PaintEngine {get; set;}
C++/CLI  
public:
property RasterPaintEngine PaintEngine {
   RasterPaintEngine get();
   void set (RasterPaintEngine value);
}

Return Value

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

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:

When the RasterPaintEngine.GdiPlus engine is used, the following properties are ignored when painting images:
Property Notes
RasterOperation Raster operations (ROP) are not supported in GDI+
UsePaintPalette Palette is automatically used.

Requirements

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

See Also