LEADTOOLS Image Processing (Leadtools.ImageProcessing.Effects assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
TextureAlphaBlendCommand Class
See Also  Members  
Leadtools.ImageProcessing.Effects Namespace : TextureAlphaBlendCommand Class



Combines image data from two images with feathering and constant opacity; by combining the two images with a variable opacity that depends on a fade mask then combine the result with the destination image with a constant opacity.

Object Model

TextureAlphaBlendCommand Class

Syntax

Visual Basic (Declaration) 
Public Class TextureAlphaBlendCommand 
   Inherits Leadtools.ImageProcessing.RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage)Copy Code
Dim instance As TextureAlphaBlendCommand
C# 
public class TextureAlphaBlendCommand : Leadtools.ImageProcessing.RasterCommand, IRasterCommand  
C++/CLI 
public ref class TextureAlphaBlendCommand : public Leadtools.ImageProcessing.RasterCommand, IRasterCommand  

Example

Run the Leadtools.ImageProcessing.Effects.TextureAlphaBlendCommand on an image.

Visual BasicCopy Code
Public Sub TextureAlphaBlendCommandExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"))

   ' Prepare the command
   Try
      Dim SrcImage As RasterImage
      Dim MaskImage As RasterImage
      Dim underlayImage As RasterImage
      SrcImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "image2.cmp"), 24, CodecsLoadByteOrder.Bgr, 1, 1)
      'Load the fade mask image.
      MaskImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "ImageProcessingDemo\image3.cmp"), 24, CodecsLoadByteOrder.Bgr, 1, 1)
      underlayImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "cannon.jpg"), 4, CodecsLoadByteOrder.Bgr, 1, 1)
      Dim command As TextureAlphaBlendCommand = New TextureAlphaBlendCommand
      command.DestinationRectangle = New LeadRect(0, 0, leadImage.Width, leadImage.Height)
      command.MaskImage = MaskImage
      command.Opacity = 100
      command.SourceImage = SrcImage
      command.UnderlayImage = underlayImage
      command.SourcePoint = New LeadPoint(0, 0)
      ' Combine ImageSource with the affected image, with MaskImage and a 100 opacity.
      command.Run(leadImage)
      codecs.Save(leadImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24)

   Catch ex As Exception
      MessageBox.Show(ex.Message, "TextureAlphaBlendTest", MessageBoxButtons.OK, MessageBoxIcon.Exclamation)
   End Try

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
public void TextureAlphaBlendCommandExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Master.jpg"));

      // Prepare the command
      RasterImage SrcImage;
      RasterImage MaskImage;
      RasterImage underlayImage;

      SrcImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\Image3.cmp"), 4, CodecsLoadByteOrder.Bgr, 1, 1);
      //Load the fade mask image.
      MaskImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\FadeMask.bmp"), 4, CodecsLoadByteOrder.Bgr, 1, 1);

      underlayImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "cannon.jpg"), 4, CodecsLoadByteOrder.Bgr, 1, 1);

      TextureAlphaBlendCommand command = new TextureAlphaBlendCommand();
      command.DestinationRectangle = new LeadRect(image.Width / 2 - MaskImage.Width / 2, image.Height / 2  - MaskImage.Height / 2, MaskImage.Width, MaskImage.Height);
      command.MaskImage = MaskImage;
      command.Opacity = 100;
      command.SourceImage = SrcImage;
      command.SourcePoint = new LeadPoint(0, 0);
      command.UnderlayImage = underlayImage;
      // Combine ImageSource with the affected image, with MaskImage and a 100 opacity.
      command.Run(image);
      codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24);

   }

static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
SilverlightCSharpCopy Code
SilverlightVBCopy Code

Remarks

  • To combine two images with a fixed opacity, use the AlphaBlendCommand.
  • To combine two images with a feather, use the Leadtools.ImageProcessing.Effects.FeatherAlphaBlendCommand.
  • The TextureAlphaBlendCommand does the two operations; first it combines the two images with feathering using the fade mask image, then combines the result with the destination image with a fixed opacity.
  • To create an image that contains a fade mask, use FadedMaskCommand.
  • This command can also underlay the fade mask image with the underlay image before using it in the feather combine operation.
  • This command also combines the fade mask image with the underlay image so that it appears to be an underlying texture for the fade mask image.
  • The following is an example for the resulted image using this commands with the following characteristics:
    • The source image is a red image.
    • The destination image is a white image.
    • The opacity is set to 255.
    • The right image is the result of applying the method without texture image.
    • The left image is the result of applying the method with texture image.
  • This command supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.
  • This command does not support signed data images.
  • This command does not support 32-bit grayscale images.
For more information, refer to Introduction to Image Processing With LEADTOOLS.
For more information, refer to Applying Artistic Effects.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.Effects.TextureAlphaBlendCommand

Requirements

Target Platforms: Silverlight 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also