ColorThresholding

Transforms a color image into a binary image.

Access to parameter description

For an introduction:

section Image Segmentation
section Binarization

This algorithm thresholds a color image from three thresholding ranges. The threshold parameters allow selecting the range for the RGB or HSL levels, depending on the type of image. The retained pixel are the intersection of the three selected ranges in each channel. In other words, this algorithm acts as thresholding each channel separately and applying a logical AND operator between the three results.

See also

See related example

GlobalAnalysis

Function Syntax

This function returns outputBinaryImage.

// Function prototype
std::shared_ptr< iolink::ImageView >
colorThresholding( std::shared_ptr< iolink::ImageView > inputColorImage,
                   iolink::Vector2d thresholdRangeRed,
                   iolink::Vector2d thresholdRangeGreen,
                   iolink::Vector2d thresholdRangeBlue,
                   std::shared_ptr< iolink::ImageView > outputBinaryImage = NULL );

This function returns outputBinaryImage.

// Function prototype.
color_thresholding( input_color_image,
                    threshold_range_red = [128, 255],
                    threshold_range_green = [128, 255],
                    threshold_range_blue = [128, 255],
                    output_binary_image = None )

This function returns outputBinaryImage.

// Function prototype.
public static IOLink.ImageView
ColorThresholding( IOLink.ImageView inputColorImage,
                   double[] thresholdRangeRed = null,
                   double[] thresholdRangeGreen = null,
                   double[] thresholdRangeBlue = null,
                   IOLink.ImageView outputBinaryImage = null );

Class Syntax

// Command constructor.
ColorThresholding();

/// Gets the inputColorImage parameter.
/// The input color image.
std::shared_ptr< iolink::ImageView > inputColorImage() const;
/// Sets the inputColorImage parameter.
/// The input color image.
void setInputColorImage( std::shared_ptr< iolink::ImageView > inputColorImage );

/// Gets the thresholdRangeRed parameter.
/// The low and high thresholds for the first channel (red for an RGB image).
iolink::Vector2d thresholdRangeRed() const;
/// Sets the thresholdRangeRed parameter.
/// The low and high thresholds for the first channel (red for an RGB image).
void setThresholdRangeRed( const iolink::Vector2d& thresholdRangeRed );

/// Gets the thresholdRangeGreen parameter.
/// The low and high thresholds for the second channel (green for an RGB image).
iolink::Vector2d thresholdRangeGreen() const;
/// Sets the thresholdRangeGreen parameter.
/// The low and high thresholds for the second channel (green for an RGB image).
void setThresholdRangeGreen( const iolink::Vector2d& thresholdRangeGreen );

/// Gets the thresholdRangeBlue parameter.
/// The low and high thresholds for the third channel (blue for an RGB image).
iolink::Vector2d thresholdRangeBlue() const;
/// Sets the thresholdRangeBlue parameter.
/// The low and high thresholds for the third channel (blue for an RGB image).
void setThresholdRangeBlue( const iolink::Vector2d& thresholdRangeBlue );

/// Gets the outputBinaryImage parameter.
/// The output binary image. Its dimensions are forced to the same values as the input.
std::shared_ptr< iolink::ImageView > outputBinaryImage() const;
/// Sets the outputBinaryImage parameter.
/// The output binary image. Its dimensions are forced to the same values as the input.
void setOutputBinaryImage( std::shared_ptr< iolink::ImageView > outputBinaryImage );


// Method to launch the command.
void execute();

# Property of the inputColorImage parameter.
ColorThresholding.input_color_image
# Property of the thresholdRangeRed parameter.
ColorThresholding.threshold_range_red
# Property of the thresholdRangeGreen parameter.
ColorThresholding.threshold_range_green
# Property of the thresholdRangeBlue parameter.
ColorThresholding.threshold_range_blue
# Property of the outputBinaryImage parameter.
ColorThresholding.output_binary_image

// Method to launch the command.
execute()

// Command constructor.
ColorThresholding()

// Property of the inputColorImage parameter.
ColorThresholding.inputColorImage
// Property of the thresholdRangeRed parameter.
ColorThresholding.thresholdRangeRed
// Property of the thresholdRangeGreen parameter.
ColorThresholding.thresholdRangeGreen
// Property of the thresholdRangeBlue parameter.
ColorThresholding.thresholdRangeBlue
// Property of the outputBinaryImage parameter.
ColorThresholding.outputBinaryImage

// Method to launch the command.
Execute()

Parameters

	Description	Type	Supported Values	Default Value
inputColorImage	The input color image.	Image	Multispectral	nullptr
thresholdRangeRed	The low and high thresholds for the first channel (red for an RGB image).	Vector2d	Any value	{128.f, 255.f}
thresholdRangeGreen	The low and high thresholds for the second channel (green for an RGB image).	Vector2d	Any value	{128.f, 255.f}
thresholdRangeBlue	The low and high thresholds for the third channel (blue for an RGB image).	Vector2d	Any value	{128.f, 255.f}
outputBinaryImage	The output binary image. Its dimensions are forced to the same values as the input.	Image		nullptr

Description	Type	Supported Values	Default Value
input_color_image	The input color image.	image	Multispectral	None
threshold_range_red	The low and high thresholds for the first channel (red for an RGB image).	vector2d	Any value	[128, 255]
threshold_range_green	The low and high thresholds for the second channel (green for an RGB image).	vector2d	Any value	[128, 255]
threshold_range_blue	The low and high thresholds for the third channel (blue for an RGB image).	vector2d	Any value	[128, 255]
output_binary_image	The output binary image. Its dimensions are forced to the same values as the input.	image		None

Description	Type	Supported Values	Default Value
inputColorImage	The input color image.	Image	Multispectral	null
thresholdRangeRed	The low and high thresholds for the first channel (red for an RGB image).	Vector2d	Any value	{128f, 255f}
thresholdRangeGreen	The low and high thresholds for the second channel (green for an RGB image).	Vector2d	Any value	{128f, 255f}
thresholdRangeBlue	The low and high thresholds for the third channel (blue for an RGB image).	Vector2d	Any value	{128f, 255f}
outputBinaryImage	The output binary image. Its dimensions are forced to the same values as the input.	Image		null

Object Examples

std::shared_ptr< iolink::ImageView > ateneub = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "ateneub.jpg" );

ColorThresholding colorThresholdingAlgo;
colorThresholdingAlgo.setInputColorImage( ateneub );
colorThresholdingAlgo.setThresholdRangeRed( {128.0, 255.0} );
colorThresholdingAlgo.setThresholdRangeGreen( {128.0, 255.0} );
colorThresholdingAlgo.setThresholdRangeBlue( {128.0, 255.0} );
colorThresholdingAlgo.execute();

std::cout << "outputBinaryImage:" << colorThresholdingAlgo.outputBinaryImage()->toString();

ateneub = ioformat.read_image(imagedev_data.get_image_path("ateneub.jpg"))

color_thresholding_algo = imagedev.ColorThresholding()
color_thresholding_algo.input_color_image = ateneub
color_thresholding_algo.threshold_range_red = [128.0, 255.0]
color_thresholding_algo.threshold_range_green = [128.0, 255.0]
color_thresholding_algo.threshold_range_blue = [128.0, 255.0]
color_thresholding_algo.execute()

print( "output_binary_image:", str( color_thresholding_algo.output_binary_image ) )

ImageView ateneub = ViewIO.ReadImage( @"Data/images/ateneub.jpg" );

ColorThresholding colorThresholdingAlgo = new ColorThresholding
{
    inputColorImage = ateneub,
    thresholdRangeRed = new double[]{128.0, 255.0},
    thresholdRangeGreen = new double[]{128.0, 255.0},
    thresholdRangeBlue = new double[]{128.0, 255.0}
};
colorThresholdingAlgo.Execute();

Console.WriteLine( "outputBinaryImage:" + colorThresholdingAlgo.outputBinaryImage.ToString() );

Function Examples

std::shared_ptr< iolink::ImageView > ateneub = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "ateneub.jpg" );

auto result = colorThresholding( ateneub, {128.0, 255.0}, {128.0, 255.0}, {128.0, 255.0} );

std::cout << "outputBinaryImage:" << result->toString();

ateneub = ioformat.read_image(imagedev_data.get_image_path("ateneub.jpg"))

result = imagedev.color_thresholding( ateneub, [128.0, 255.0], [128.0, 255.0], [128.0, 255.0] )

print( "output_binary_image:", str( result ) )

ImageView ateneub = ViewIO.ReadImage( @"Data/images/ateneub.jpg" );

IOLink.ImageView result = Processing.ColorThresholding( ateneub, new double[]{128.0, 255.0}, new double[]{128.0, 255.0}, new double[]{128.0, 255.0} );

Console.WriteLine( "outputBinaryImage:" + result.ToString() );

ColorThresholding

- Function Syntax

+ Class Syntax

Parameters

Object Examples

Function Examples

Function Syntax

Class Syntax