Overloads Public Sub PaintImageEffect( _
   ByVal hdc As IntPtr, _
   ByVal image As RasterImage, _
   ByVal src As Rectangle, _
   ByVal srcClip As Rectangle, _
   ByVal dest As Rectangle, _
   ByVal destClip As Rectangle, _
   ByVal paintProperties As RasterPaintProperties, _
   ByVal effectType As SpecialEffectsType, _
   ByVal progressCallback As SpecialEffectsProgress _
) 

Visual Basic (Usage)

Copy Code

Dim instance As SpecialEffectsProcessor Dim hdc As IntPtr Dim image As RasterImage Dim src As Rectangle Dim srcClip As Rectangle Dim dest As Rectangle Dim destClip As Rectangle Dim paintProperties As RasterPaintProperties Dim effectType As SpecialEffectsType Dim progressCallback As SpecialEffectsProgress   instance.PaintImageEffect(hdc, image, src, srcClip, dest, destClip, paintProperties, effectType, progressCallback)

public void PaintImageEffect( 
   IntPtr hdc,
   RasterImage image,
   Rectangle src,
   Rectangle srcClip,
   Rectangle dest,
   Rectangle destClip,
   RasterPaintProperties paintProperties,
   SpecialEffectsType effectType,
   SpecialEffectsProgress progressCallback
)

public: void PaintImageEffect( 
   IntPtr hdc,
   RasterImage image,
   Rectangle src,
   Rectangle srcClip,
   Rectangle dest,
   Rectangle destClip,
   RasterPaintProperties paintProperties,
   SpecialEffectsType effectType,
   SpecialEffectsProgress* progressCallback
) 

public:
void PaintImageEffect( 
   IntPtr hdc,
   RasterImage image,
   Rectangle src,
   Rectangle srcClip,
   Rectangle dest,
   Rectangle destClip,
   RasterPaintProperties paintProperties,
   SpecialEffectsType effectType,
   SpecialEffectsProgress^ progressCallback
) 

Parameters

hdc

Handle to the target device context.

image

Pointer to an object that references the image to paint.

src

Rectangle that specifies the part of the image to use as the display source.

srcClip

Rectangle that specifies the portion of the display source to paint. Generally, this is used for updating the display when part of the source image has changed.

dest

Rectangle that determines how the source rectangle is scaled and how the image is positioned in the device context. The coordinates for the Rectangle object are relative to the device context. There is no default for this parameter. You must specify the Rectangle object.

destClip

Rectangle to be used as the display destination clipping rectangle that specifies the portion of the display rectangle to paint. Generally, this is used for updating changes in the display surface, such as when a user moves another window, uncovering a part of the image that had been covered up. The coordinates in the Rectangle object are relative to the device context. You can pass null to use the default, which matches the device context.

paintProperties

Options for the display.

effectType

Effect to apply when painting. For valid values, refer to SpecialEffectsType.

progressCallback

Callback method that will be called when the paint image effect is started to determine the status for the paint of the image effect.

This example shows the minimum requirements for using PaintImageEffect method to paint an image .

Visual Basic

Copy Code

Public Sub PaintImageEffect(ByVal g As Graphics, ByVal destRect As Rectangle)    Dim processor As SpecialEffectsProcessor = New SpecialEffectsProcessor()    Dim properties As RasterPaintProperties = New RasterPaintProperties()    properties.RasterOperation = RasterPaintProperties.SourceCopy    RasterCodecs.Startup()    Dim codecs As RasterCodecs = New RasterCodecs()    Dim rasterImage As RasterImage = codecs.Load("C:\Program Files\LEAD Technologies, Inc\LEADTOOLS 15\Images\Image1.cmp")    processor.PaintImageEffect(g, rasterImage, Rectangle.Empty, Rectangle.Empty, destRect, Rectangle.Empty, properties, SpecialEffectsType.SpiralIn, Nothing)    rasterImage.Dispose()    RasterCodecs.Shutdown() End Sub

C#

Copy Code

public void PaintImageEffect(Graphics g, Rectangle destRect)  {     SpecialEffectsProcessor processor = new SpecialEffectsProcessor();     RasterPaintProperties properties = new RasterPaintProperties();     properties.RasterOperation = RasterPaintProperties.SourceCopy;       RasterCodecs.Startup();     RasterCodecs codecs = new RasterCodecs();     RasterImage rasterImage = codecs.Load(@"C:\Program Files\LEAD Technologies, Inc\LEADTOOLS 15\Images\Image1.cmp");       processor.PaintImageEffect(g, rasterImage,                                Rectangle.Empty, /* Default source rectangle */                                Rectangle.Empty, /* Default source clip area */                                destRect, /* Destination rectangle */                                Rectangle.Empty, /* Default destination clipping rectangle */                                properties,                                SpecialEffectsType.SpiralIn, /* Spiral effect */                                null);       rasterImage.Dispose();     RasterCodecs.Shutdown();  }

If the screen has fewer colors than the image, this method dithers the output to that display surface without affecting the actual image data.

PaintImageEffect paints an image faster if its view perspective is bottom left. LEAD CMP images have a bottom-left view perspective, but some other formats have a top-left perspective. To get uniformly fast paints on all images, you can set the perspective after you load them. (You do not have to change them back before saving them in the original format, because the save methods set the orientation for the specified format.)

Multipass painting for the PushClass is disabled.

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

Reference