SelectDataCommand Class

Selects a specific number of bits of an 8, 12 or 16-bit grayscale image and puts them into a mask, then colors the image depending on the mask. This can show image variances depending on user-defined conditions. This command is available in the Medical toolkits.

Object Model

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public class SelectDataCommand : Leadtools.ImageProcessing.RasterCommand, Leadtools.ImageProcessing.IRasterCommand

'Declaration
 
Public Class SelectDataCommand 
   Inherits Leadtools.ImageProcessing.RasterCommand
   Implements Leadtools.ImageProcessing.IRasterCommand

'Usage
 
Dim instance As SelectDataCommand

public sealed class SelectDataCommand : Leadtools.ImageProcessing.IRasterCommand

function Leadtools.ImageProcessing.Core.SelectDataCommand()

public ref class SelectDataCommand : public Leadtools.ImageProcessing.RasterCommand, Leadtools.ImageProcessing.IRasterCommand

Remarks

This command is used as a visualization aid. You can select certain bits of the supported type image and show the variances of that image under conditions that you define.
For 8, 12 and 16-bit grayscale image, the source low bit can range from 0 to 7, 11, and 15 respectively. However if this value exceeded the range then the method will not return an error, and the DestinationImage will be a pure black image.
For 8, 12 and 16-bit grayscale image, the source high bit can range from source low bit to 7, 11, and 15 respectively. No error will be returned if source high bit is greater than 7, 11 or 15. The command will return an invalid parameter error if source high bit < source low bit.
The command will first construct a mask from bits source low bit through source high bit. For each pixel, the pixel value will be combined with the mask using a bitwise 'and' operation. The result will be shifted to the right by source low bit. This result will be compared with the threshold: if the value is greater than or equal to the threshold, the output pixel's color is changed using the Color property or the color parameter if you ar using the appropriate Constructor. If the result is less than the threshold, the output is set to 0.
The following example shows you how to treat a 16-bit grayscale image:
- In a 16-bit grayscale image, the bits are ordered as b15 b14 b13 ... b2 b1 b0.
- For SourceLowBit = 3, SourceHighBit = 8, Threshold = 16 and Color = new Leadtools.RasterColor(0, 255, 0)
- In Source image (SourceImage)
- -------------------
- b15 b14 b13 b12 b11 b10 b9 |b8 b7 b6 b5 b4 b3| b2 b1 b0
- -------------------
- 0 1 1 0 1 1 1 0 1 0 0 1 1 1 0 1
In our case, the mask is 010011 in base 2 (19 in decimal). Since 19 >= 16, the destination pixel will be colored using the Color property (or the color parameter of the Constructor). The output pixel will be:
- if Combine = false: Color = new Leadtools.RasterColor(0,255,0)
- if Combine = true: we take the high byte of the source pixel, which is 01101110 in base 2 (0x6E), and then the value is AND-ed with each component of the color. So the output pixel will be RGB(0x00 & 0x6E, 0xFF & 0x6E, 0x00 & 0x6E) which is RGB(0x00, 0x6E, 0x00).
Let us consider another case: the source pixel is 0110111000011101 the mask value is 000011 in base 2(3 in decimal). Since 3 > 16, the destination pixel will be:
- if the combine value = false: Color = new Leadtools.RasterColor(0,0,0)
- if the combine value = true: The high byte of the source pixel will bet set for the RGB, that is RGB(0x6E, 0x6E, 0x6E).
This command supports 8, 12 and 16-bit grayscale bitmaps only. Support for 12 and 16-bit grayscale images are available only in the Document/Medical toolkits. It also can process the whole image or a region of the image. If an image has a region, the effect is applied only to the region.
This command does not support 32-bit grayscale images.

For more information, refer to Correcting Colors.
For more information, refer to Grayscale Images.

Example

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Public Sub SelectDataCommandExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

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

   ' Prepare the command
   Dim command As SelectDataCommand = New SelectDataCommand
   command.Color = New RasterColor(233, 10, 77)
   command.Combine = True
   command.SourceLowBit = 2
   command.SourceHighBit = 6
   command.Threshold = 25

   command.Run(leadImage)
   codecs.Save(command.DestinationImage, Path.Combine(LEAD_VARS.ImagesDir, "SelectDataResult.bmp"), RasterImageFormat.Bmp, 24)

End Sub

Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

public void SelectDataCommandExample()
   {
      // Load an image
      RasterCodecs codecs = new RasterCodecs();
      codecs.ThrowExceptionsOnInvalidImages = true;

      RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\Beauty16.jpg"));

      // Prepare the command
      SelectDataCommand command = new SelectDataCommand();
      command.Color = new RasterColor(233, 10, 77);
      command.Combine = true;
      command.SourceLowBit = 2;
      command.SourceHighBit = 6;
      command.Threshold = 25;

      command.Run(image);
      codecs.Save(command.DestinationImage, Path.Combine(LEAD_VARS.ImagesDir, "SelectDataResult.Bmp"), RasterImageFormat.Bmp, 24);

   }

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

function SelectDataCommandExample()
{
   var codecs = new Leadtools.Codecs.RasterCodecs();
   codecs.throwExceptionsOnInvalidImages = true;

   // Load the image
   var srcFileName = "Assets\\Beauty16.jpg";
   var processedImage;
   return Tools.AppInstallFolder().getFileAsync(srcFileName).then(function (loadFile) {
      return codecs.loadAsync(Leadtools.LeadStreamFactory.create(loadFile));
   }).then(function (image) {
      // Prepare the command
      with (Leadtools.ImageProcessing.Core) {
         var command = new SelectDataCommand();
         command.color = Leadtools.RasterColorHelper.create(233, 10, 77);
         command.combine = true;
         command.sourceLowBit = 2;
         command.sourceHighBit = 6;
         command.threshold = 25;
         
         command.run(image);
         processedImage = command.destinationImage;
      }
      var destFileName = "SelectDataResult.bmp";
      return Tools.AppLocalFolder().createFileAsync(destFileName);
   }).then(function (saveFile) {
      return codecs.saveAsync(processedImage, Leadtools.LeadStreamFactory.create(saveFile), Leadtools.RasterImageFormat.bmp, 24);
   });
}

[TestMethod]
public async Task SelectDataCommandExample()
{
   // Load an image
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   // Load the image
   string srcFileName = @"Assets\Beauty16.jpg";
   StorageFile loadFile = await Tools.AppInstallFolder.GetFileAsync(srcFileName);
   RasterImage image = await codecs.LoadAsync(LeadStreamFactory.Create(loadFile));

   // Prepare the command
   SelectDataCommand command = new SelectDataCommand();
   command.Color = RasterColorHelper.Create(233, 10, 77);
   command.Combine = true;
   command.SourceLowBit = 2;
   command.SourceHighBit = 6;
   command.Threshold = 25;

   command.Run(image);

   string destFileName = @"SelectDataResult.bmp";
   StorageFile saveFile = await Tools.AppLocalFolder.CreateFileAsync(destFileName);
   await codecs.SaveAsync(command.DestinationImage, LeadStreamFactory.Create(saveFile), RasterImageFormat.Bmp, 24);
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SelectDataCommand Members
Leadtools.ImageProcessing.Core Namespace
Correcting Colors
Grayscale Images
WindowLevelCommand Class
Leadtools.ImageProcessing.Color.GrayScaleToDuotoneCommand
Leadtools.ImageProcessing.Color.GrayScaleToMultitoneCommand
ShiftDataCommand Class
ColorizeGrayCommand Class
Leadtools.ImageProcessing.Color.SelectiveColorCommand
Leadtools.ImageProcessing.Color.AdjustTintCommand
Leadtools.ImageProcessing.Effects.ColorHalftoneCommand