VintaSoft Imaging .NET SDK v8.6
Vintasoft.Imaging.ImageProcessing.Color Namespace / BinarizeCommand Class
Members Example



In This Topic
    BinarizeCommand Class
    In This Topic
    Converts an image to black-and-white image.
    Object Model
    BinarizeCommand ClassProcessingCommandResults ClassProcessingCommandResult Class
    Syntax
    'Declaration
     
    Public Class BinarizeCommand 
       Inherits Vintasoft.Imaging.ImageProcessing.ProcessingCommandBase
    public __gc class BinarizeCommand : public Vintasoft.Imaging.ImageProcessing.ProcessingCommandBase 
    public ref class BinarizeCommand : public Vintasoft.Imaging.ImageProcessing.ProcessingCommandBase 
    Remarks
    This command keeps the pixel format of the image. Use the Vintasoft.Imaging.ImageProcessing.ChangePixelFormatToBlackWhiteCommand class if pixel format of image must be changed to PixelFormat.BlackWhite.
    Example
    This example shows how to load an image from disk, binarize the image and save the result to a new image file.
    Class BlackAndWhiteCommandExample
        Public Sub ProcessImage()
            ' [ do not forget to set your image file path here! ]
            ' open an existing image
            Dim image As New Vintasoft.Imaging.VintasoftImage("Flower.jpg")
                
            ' create the command with default parameters
            Dim command As New Vintasoft.Imaging.ImageProcessing.Color.BinarizeCommand()
            ' subscribe to progress event
            AddHandler command.Progress, New System.EventHandler(Of Vintasoft.Imaging.ImageProcessing.ImageProcessingProgressEventArgs)(AddressOf command_Progress)
                
            Try
                ' execute the command
                command.ExecuteInPlace(image)
            Catch ex As Vintasoft.Imaging.ImageProcessing.ImageProcessingException
                ' show error message if problem occured
                System.Windows.Forms.MessageBox.Show(ex.Message)
                Return
            End Try
                
            ' save the processed image to the new file
            image.Save("processed-image.tif")
        End Sub
                
        Private Sub command_Progress(sender As Object, e As Vintasoft.Imaging.ImageProcessing.ImageProcessingProgressEventArgs)
            ' update progress info using e.Progress property
            ' ...
                
            ' cancel execution of command using e.Cancel property if necessary
            ' ...
        End Sub
    End Class
    class BlackAndWhiteCommandExample
    {
        public void ProcessImage()
        {
            // [ do not forget to set your image file path here! ]
            // open an existing image
            Vintasoft.Imaging.VintasoftImage image = new Vintasoft.Imaging.VintasoftImage("Flower.jpg");
                
            // create the command with default parameters
            Vintasoft.Imaging.ImageProcessing.Color.BinarizeCommand command =
                new Vintasoft.Imaging.ImageProcessing.Color.BinarizeCommand();
            // subscribe to progress event
            command.Progress +=
                new System.EventHandler<Vintasoft.Imaging.ImageProcessing.ImageProcessingProgressEventArgs>(command_Progress);
                
            try
            {
                // execute the command
                command.ExecuteInPlace(image);
            }
            catch (Vintasoft.Imaging.ImageProcessing.ImageProcessingException ex)
            {
                // show error message if problem occured
                System.Windows.Forms.MessageBox.Show(ex.Message);
                return;
            }
                
            // save the processed image to the new file
            image.Save("processed-image.tif");
        }
                
        void command_Progress(object sender, Vintasoft.Imaging.ImageProcessing.ImageProcessingProgressEventArgs e)
        {
            // update progress info using e.Progress property
            // ...
                
            // cancel execution of command using e.Cancel property if necessary
            // ...
        }
    }
    Inheritance Hierarchy

    System.Object
       Vintasoft.Imaging.ImageProcessing.ProcessingCommandBase
          Vintasoft.Imaging.ImageProcessing.Color.BinarizeCommand

    Requirements

    Target Platforms: Windows 10, Windows 8, Windows 7, Windows Vista, Windows XP, Windows Server 2012, Windows Server 2008, Windows Server 2003

    See Also