FadedMaskCommand Class

Summary

Creates a fade mask image in which the color of each pixel is changed with respect to its position in the image. This change depends on the fade rate.

Syntax

C++/CLI

Python

public class FadedMaskCommand : RasterCommand

public ref class FadedMaskCommand : public RasterCommand

class FadedMaskCommand(RasterCommand):

Remarks

This command is concerned with the size and shape of the region, not the image itself. Therefore, any image with a region can be used to create a fade mask image. The fade mask image can be used by the FeatherAlphaBlendCommand to combine two images with feathering.
If the FadedMaskCommandFlags.FadeOutsideRegion flag is not set, then the size of the fade mask image is equal to the size of a region and the fade progresses toward the center of the region. If the FadedMaskCommandFlags.FadeOutsideRegion flag is set, the size is equal to the size of region plus the Inflate value and the fade starts at the edge of the region and progresses toward the edge of the fade mask image. (The Inflate value is used only with FadedMaskCommandFlags.FadeOutsideRegion flag).
In order to use the fade mask image in the FeatherAlphaBlendCommand the fade mask image must contain three portions:
- A portion in which the output (from the blending method) will be the same as the destination image. This is called the Transparency portion of the mask and it is filled with black.
- A portion in which the output is a combination of the destination and source image.
- A portion in which the output comes from the source image. This is called the Dump portion of the mask and it is filled with white.
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 supports 32-bit grayscale images.

For more information, refer to Introduction to Image Processing With LEADTOOLS. For more information, refer to Using the FadedMask Method.

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Effects; 
 
 
public void FeatherAlphaBlendCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   RasterImage backgroundImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")); 
   RasterImage sourceImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "LittleGFlyingAlpha.png"), 32, CodecsLoadByteOrder.Bgr, 1, 1); 
   FeatherAlphaBlendCommand command = new FeatherAlphaBlendCommand(); 
   command.DestinationRectangle = new LeadRect(0, 0, sourceImage.Width, sourceImage.Height); 
   command.MaskImage = sourceImage.CreateAlphaImage(); 
   command.SourceImage = sourceImage; 
   command.SourcePoint = new LeadPoint(0, 0); 
   command.Run(backgroundImage); 
   codecs.Save(backgroundImage, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.assertTrue; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.effects.*; 
 
 
public void featherAlphaBlendCommandExample() { 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   RasterImage backgroundImage = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Image1.cmp")); 
   RasterImage sourceImage = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "LittleGFlyingAlpha.png"), 32, 
         CodecsLoadByteOrder.BGR, 1, 1); 
   FeatherAlphaBlendCommand command = new FeatherAlphaBlendCommand(); 
   command.setDestinationRectangle(new LeadRect(0, 0, sourceImage.getWidth(), sourceImage.getHeight())); 
   command.setMaskImage(sourceImage.createAlphaImage()); 
   command.setSourceImage(sourceImage); 
   command.setSourcePoint(new LeadPoint(0, 0)); 
   int change = command.run(backgroundImage); 
   assertTrue(change != RasterImageChangedFlags.NONE); 
   codecs.save(backgroundImage, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 24); 
}