PaintImageRegionEffect(IntPtr,RasterImage,Rectangle,Rectangle,Rectangle,Rectangle,RasterPaintProperties,SpecialEffectsType,SpecialEffectsProgress) Method


Applies an effect when painting a bitmap region to a device context. This method works the same as PaintImageEffect, except that only the bitmap region is painted.

Public Overloads Sub PaintImageRegionEffect( _ 
   ByVal hdc As IntPtr, _ 
   ByVal image As Leadtools.RasterImage, _ 
   ByVal src As Rectangle, _ 
   ByVal srcClip As Rectangle, _ 
   ByVal dest As Rectangle, _ 
   ByVal destClip As Rectangle, _ 
   ByVal paintProperties As Leadtools.Drawing.RasterPaintProperties, _ 
   ByVal effectType As SpecialEffectsType, _ 
   ByVal progressCallback As SpecialEffectsProgress _ 
public void PaintImageRegionEffect( 
   IntPtr hdc, 
   RasterImage image, 
   Rectangle src, 
   Rectangle srcClip, 
   Rectangle dest, 
   Rectangle destClip, 
   RasterPaintProperties paintProperties, 
   SpecialEffectsType effectType, 
   SpecialEffectsProgress progressCallback 
void PaintImageRegionEffect(  
   IntPtr hdc, 
   Leadtools.RasterImage^ image, 
   Rectangle src, 
   Rectangle srcClip, 
   Rectangle dest, 
   Rectangle destClip, 
   Leadtools.Drawing.RasterPaintProperties paintProperties, 
   SpecialEffectsType effectType, 
   SpecialEffectsProgress^ progressCallback 


Handle to a device context

Pointer to an object hat reference the bitmap that has the region to paint.

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

Rectangle to be used as the display source clipping 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.

Rectangle to be used as the display destination 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.

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 for the Rectangle object are relative to the device context. You can pass null to use the default, which matches the device context.

Options for the display.

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

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


Multipass painting for the PushClass is disabled.


This example shows the minimum requirements for using PaintImageRegionEffect(Graphics,RasterImage,Rectangle,Rectangle,Rectangle,Rectangle,RasterPaintProperties,SpecialEffectsType,SpecialEffectsProgress) method to paint an image .

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.SpecialEffects; 
using Leadtools.Drawing; 
public void PaintImageRegionEffect(Graphics g, Rectangle destRect) 
   SpecialEffectsProcessor processor = new SpecialEffectsProcessor(); 
   RasterPaintProperties properties = new RasterPaintProperties(); 
   properties.RasterOperation = RasterPaintProperties.SourceCopy; 
   RasterCodecs codecs = new RasterCodecs(); 
   RasterImage rasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")); 
   processor.PaintImageRegionEffect(g, rasterImage, 
                                    Rectangle.Empty, /* Default source rectangle */ 
                                    Rectangle.Empty, /* Default source clip area */ 
                                    destRect, /* Destination rectangle */ 
                                    Rectangle.Empty, /* Default destination clipping rectangle */ 
                                    SpecialEffectsType.SpiralIn, /* Spiral effect */ 
static bool SpecialEffectsProgress(int percent) 
   Console.WriteLine("{0}%", percent); 
   return true; 
static class LEAD_VARS 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.SpecialEffects 
Imports Leadtools.Drawing 
Public Sub PaintImageRegionEffect(ByVal g As Graphics, ByVal destRect As Rectangle) 
   Dim processor As SpecialEffectsProcessor = New SpecialEffectsProcessor() 
   Dim properties As RasterPaintProperties = New RasterPaintProperties() 
   properties.RasterOperation = RasterPaintProperties.SourceCopy 
   Dim codecs As RasterCodecs = New RasterCodecs() 
   Dim rasterImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")) 
   processor.PaintImageRegionEffect(g, rasterImage, Rectangle.Empty, Rectangle.Empty, destRect, Rectangle.Empty, properties, SpecialEffectsType.SpiralIn, 
                                    AddressOf SpecialEffectsProgress) 
End Sub 
Private Shared Function SpecialEffectsProgress(ByVal percent As Integer) As Boolean 
   Console.WriteLine("{0}%", percent) 
   Return True 
End Function 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 


Target Platforms

Help Version 20.0.2019.3.11
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2019 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.SpecialEffects Assembly