Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.3.5
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;}
Managed Extensions for C++ 
public: __property RasterPaintEngine get_PaintEngine();
public: __property void set_PaintEngine( 
   RasterPaintEngine value
);
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 the 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 the 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:

When RasterPaintEngine.GdiPlus or RasterPaintEngine.GdiPlus2 engine is used, the following properties are ignored when painting images:
PropertyNotes
RasterOperationRaster operations (ROP) are not supported in GDI+
UsePaintPalettePalette is automatically used.
PaintDisplayModeResample/Bicubic scaling and other speed/quality algorithm is controlled by the Graphics object itself. (Only with RasterPaintEngine.GdiPlus).

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