Processing math: 13%
ImageDev

LogicalOperationWithValue

Performs a pointwise logical operation between an image and a value.

Access to parameter description

The logical operators to apply between the input images I and the constant value C can be selected from: More information about logical operations are available in the Logical Operations group presentation.

See also

Function Syntax

This function returns outputImage. 
// Function prototype
std::shared_ptr< iolink::ImageView >
logicalOperationWithValue( std::shared_ptr< iolink::ImageView > inputImage,
                           uint32_t value,
                           LogicalOperationWithValue::LogicalOperator logicalOperator,
                           std::shared_ptr< iolink::ImageView > outputImage = nullptr );

Class Syntax

Parameters

Parameter Name Description Type Supported Values Default Value
input
inputImage
The input image, must be integer, including grayscale, binary, label, and color. Image Binary, Label, Grayscale or Multispectral nullptr
input
value
The value to apply, cast to the type of the input image. UInt32 Any value 0
input
logicalOperator
The logical operator to apply. Default is AND.
AND The logical AND operator performs a bitwise conjunction between an image and a constant value. On a binary image, it is equivalent to a Minimum operation, as it appears in the following truth table. ICI∧C111100010000
OR The logical OR operator performs a bitwise disjunction between an image and a constant value. On a binary image I, it is equivalent to a Maximum operation as it appears in the following truth table. ICI∨C111101011000
XOR The logical XOR operator performs a bitwise exclusive disjunction between an image and a constant value. On a binary image I and a constant value C, the logical XOR operator is described by the following truth table. ICI⊻
NAND The logical NAND operator performs a bitwise alternative denial between an image and a constant value. On a binary image I and a constant value C, the logical NAND operator is described by the following truth table. \begin{array}{|c|c|c|} \hline I & C & I \uparrow C\\ \hline 1 & 1 & 0\\ 1 & 0 & 1\\ 0 & 1 & 1\\ 0 & 0 & 1\\ \hline \end{array}
NOR The logical NOR operator performs a bitwise joint denial between an image and a constant value. On a binary image I and a constant value C, the logical NOR operator is described by the following truth table. \begin{array}{|c|c|c|} \hline I & C & I \downarrow C\\ \hline 1 & 1 & 0\\ 1 & 0 & 0\\ 0 & 1 & 0\\ 0 & 0 & 1\\ \hline \end{array}
NXOR The logical NXOR operator performs a bitwise equivalence (or logical biconditional) between an image and a constant value. It is the negation of the exclusive OR between an image I and a constant value C as described by the truth table and the following figure. \begin{array}{|c|c|c|} \hline I & C & I \equiv C\\ \hline 1 & 1 & 1\\ 1 & 0 & 0\\ 0 & 1 & 0\\ 0 & 0 & 1\\ \hline \end{array}
SUBTRACT The logical SUBTRACT operator performs a bitwise logical difference between an image and a constant value. On a binary image I and a constant value C, the logical SUBTRACT operator is described by the following truth table. \begin{array}{|c|c|c|} \hline I & C & I - C\\ \hline 1 & 1 & 0\\ 1 & 0 & 1\\ 0 & 1 & 0\\ 0 & 0 & 0\\ \hline \end{array} Remark: the logical difference is the only non commutative logical operation; for instance, I-C\neq C-I.
Enumeration AND
output
outputImage
The output image, size and type are forced to the same values as the input. Image nullptr

Object Examples

auto polystyrene = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "polystyrene.tif" );

LogicalOperationWithValue logicalOperationWithValueAlgo;
logicalOperationWithValueAlgo.setInputImage( polystyrene );
logicalOperationWithValueAlgo.setValue( 10 );
logicalOperationWithValueAlgo.setLogicalOperator( LogicalOperationWithValue::LogicalOperator::AND );
logicalOperationWithValueAlgo.execute();

std::cout << "outputImage:" << logicalOperationWithValueAlgo.outputImage()->toString();

Function Examples

auto polystyrene = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "polystyrene.tif" );

auto result = logicalOperationWithValue( polystyrene, 10, LogicalOperationWithValue::LogicalOperator::AND );

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