| OpenCV 4.3.0 Open Source Computer Vision

Functions
Graph API: Pixelwise operations
G-API Core functionality

## Functions
GMat | cv::gapi::bitwise_and (const GMat &src1, const GMat &src2)
| computes bitwise conjunction of the two matrixes (src1 & src2) Calculates the per-element bit-wise logical conjunction of two matrices of the same size. More...
GMat | cv::gapi::bitwise_and (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::bitwise_not (const GMat &src)
| Inverts every bit of an array. The function bitwise_not calculates per-element bit-wise inversion of the input matrix: \[\texttt{dst} (I) = \neg \texttt{src} (I)\] . More...
GMat | cv::gapi::bitwise_or (const GMat &src1, const GMat &src2)
| computes bitwise disjunction of the two matrixes (src1 | src2) Calculates the per-element bit-wise logical disjunction of two matrices of the same size. More...
GMat | cv::gapi::bitwise_or (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::bitwise_xor (const GMat &src1, const GMat &src2)
| computes bitwise logical "exclusive or" of the two matrixes (src1 ^ src2) Calculates the per-element bit-wise logical "exclusive or" of two matrices of the same size. More...
GMat | cv::gapi::bitwise_xor (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::cmpEQ (const GMat &src1, const GMat &src2)
| Performs the per-element comparison of two matrices checking if elements from first matrix are equal to elements in second. More...
GMat | cv::gapi::cmpEQ (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::cmpGE (const GMat &src1, const GMat &src2)
| Performs the per-element comparison of two matrices checking if elements from first matrix are greater or equal compare to elements in second. More...
GMat | cv::gapi::cmpGE (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::cmpGT (const GMat &src1, const GMat &src2)
| Performs the per-element comparison of two matrices checking if elements from first matrix are greater compare to elements in second. More...
GMat | cv::gapi::cmpGT (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::cmpLE (const GMat &src1, const GMat &src2)
| Performs the per-element comparison of two matrices checking if elements from first matrix are less or equal compare to elements in second. More...
GMat | cv::gapi::cmpLE (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::cmpLT (const GMat &src1, const GMat &src2)
| Performs the per-element comparison of two matrices checking if elements from first matrix are less than elements in second. More...
GMat | cv::gapi::cmpLT (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::cmpNE (const GMat &src1, const GMat &src2)
| Performs the per-element comparison of two matrices checking if elements from first matrix are not equal to elements in second. More...
GMat | cv::gapi::cmpNE (const GMat &src1, const GScalar &src2)
GMat | cv::gapi::select (const GMat &src1, const GMat &src2, const GMat &mask)
| Select values from either first or second of input matrices by given mask. The function set to the output matrix either the value from the first input matrix if corresponding value of mask matrix is 255, or value from the second input matrix (if value of mask matrix set to 0). More...

## Detailed Description

gapi_math

## Function Documentation

## ◆ bitwise_and() [1/2]

GMat cv::gapi::bitwise_and | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

computes bitwise conjunction of the two matrixes (src1 & src2) Calculates the per-element bit-wise logical conjunction of two matrices of the same size.

In case of floating-point matrices, their machine-specific bit representations (usually IEEE754-compliant) are used for the operation. In case of multi-channel matrices, each channel is processed independently. Output matrix must have the same size and depth as the input matrices.

Supported matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.bitwise_and"

Parameters

  src1 | first input matrix.
  src2 | second input matrix.

## ◆ bitwise_and() [2/2]

GMat cv::gapi::bitwise_and | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.bitwise_andS"

Parameters

  src1 | first input matrix.
  src2 | scalar, which will be per-lemenetly conjuncted with elements of src1.

## ◆ bitwise_not()

GMat cv::gapi::bitwise_not | ( | const GMat & | src | ) |

`#include <opencv2/gapi/core.hpp>`

Inverts every bit of an array. The function bitwise_not calculates per-element bit-wise inversion of the input matrix:

\[\texttt{dst} (I) = \neg \texttt{src} (I)\]

.

In case of floating-point matrices, their machine-specific bit representations (usually IEEE754-compliant) are used for the operation. In case of multi-channel matrices, each channel is processed independently. Output matrix must have the same size and depth as the input matrix.

Supported matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.bitwise_not"

Parameters

  src | input matrix.

## ◆ bitwise_or() [1/2]

GMat cv::gapi::bitwise_or | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

computes bitwise disjunction of the two matrixes (src1 | src2) Calculates the per-element bit-wise logical disjunction of two matrices of the same size.

In case of floating-point matrices, their machine-specific bit representations (usually IEEE754-compliant) are used for the operation. In case of multi-channel matrices, each channel is processed independently. Output matrix must have the same size and depth as the input matrices.

Supported matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.bitwise_or"

Parameters

  src1 | first input matrix.
  src2 | second input matrix.

## ◆ bitwise_or() [2/2]

GMat cv::gapi::bitwise_or | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.bitwise_orS"

Parameters

  src1 | first input matrix.
  src2 | scalar, which will be per-lemenetly disjuncted with elements of src1.

## ◆ bitwise_xor() [1/2]

GMat cv::gapi::bitwise_xor | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

computes bitwise logical "exclusive or" of the two matrixes (src1 ^ src2) Calculates the per-element bit-wise logical "exclusive or" of two matrices of the same size.

In case of floating-point matrices, their machine-specific bit representations (usually IEEE754-compliant) are used for the operation. In case of multi-channel matrices, each channel is processed independently. Output matrix must have the same size and depth as the input matrices.

Supported matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.bitwise_xor"

Parameters

  src1 | first input matrix.
  src2 | second input matrix.

## ◆ bitwise_xor() [2/2]

GMat cv::gapi::bitwise_xor | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.bitwise_xorS"

Parameters

  src1 | first input matrix.
  src2 | scalar, for which per-lemenet "logical or" operation on elements of src1 will be performed.

## ◆ cmpEQ() [1/2]

GMat cv::gapi::cmpEQ | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Performs the per-element comparison of two matrices checking if elements from first matrix are equal to elements in second.

The function compares elements of two matrices src1 and src2 of the same size:

\[\texttt{dst} (I) = \texttt{src1} (I) == \texttt{src2} (I)\]

When the comparison result is true, the corresponding element of output array is set to 255. The comparison operations can be replaced with the equivalent matrix expressions:

\[\texttt{dst} = \texttt{src1} == \texttt{src2}\]

Output matrix of depth CV_8U must have the same size and the same number of channels as the input matrices.

Supported input matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpEQ"

Parameters

  src1 | first input matrix.
  src2 | second input matrix/scalar of the same depth as first input matrix.

See also
  min, max, threshold, cmpNE

## ◆ cmpEQ() [2/2]

GMat cv::gapi::cmpEQ | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpEQScalar"

## ◆ cmpGE() [1/2]

GMat cv::gapi::cmpGE | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Performs the per-element comparison of two matrices checking if elements from first matrix are greater or equal compare to elements in second.

The function compares elements of two matrices src1 and src2 of the same size:

\[\texttt{dst} (I) = \texttt{src1} (I) >= \texttt{src2} (I)\]

When the comparison result is true, the corresponding element of output array is set to 255. The comparison operations can be replaced with the equivalent matrix expressions:

\[\texttt{dst} = \texttt{src1} >= \texttt{src2}\]

Output matrix of depth CV_8U must have the same size and the same number of channels as the input matrices.

Supported input matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpGE"

Parameters

  src1 | first input matrix.
  src2 | second input matrix/scalar of the same depth as first input matrix.

See also
  min, max, threshold, cmpLE, cmpGT, cmpLS

## ◆ cmpGE() [2/2]

GMat cv::gapi::cmpGE | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpLGEcalar"

## ◆ cmpGT() [1/2]

GMat cv::gapi::cmpGT | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Performs the per-element comparison of two matrices checking if elements from first matrix are greater compare to elements in second.

The function compares elements of two matrices src1 and src2 of the same size:

\[\texttt{dst} (I) = \texttt{src1} (I) > \texttt{src2} (I)\]

When the comparison result is true, the corresponding element of output array is set to 255. The comparison operations can be replaced with the equivalent matrix expressions:

\[\texttt{dst} = \texttt{src1} > \texttt{src2}\]

Output matrix of depth CV_8U must have the same size and the same number of channels as the input matrices/matrix.

Supported input matrix data types are CV_8UC1, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpGT"

Parameters

  src1 | first input matrix.
  src2 | second input matrix/scalar of the same depth as first input matrix.

See also
  min, max, threshold, cmpLE, cmpGE, cmpLS

## ◆ cmpGT() [2/2]

GMat cv::gapi::cmpGT | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpGTScalar"

## ◆ cmpLE() [1/2]

GMat cv::gapi::cmpLE | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Performs the per-element comparison of two matrices checking if elements from first matrix are less or equal compare to elements in second.

The function compares elements of two matrices src1 and src2 of the same size:

\[\texttt{dst} (I) = \texttt{src1} (I) <= \texttt{src2} (I)\]

When the comparison result is true, the corresponding element of output array is set to 255. The comparison operations can be replaced with the equivalent matrix expressions:

\[\texttt{dst} = \texttt{src1} <= \texttt{src2}\]

Output matrix of depth CV_8U must have the same size and the same number of channels as the input matrices.

Supported input matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpLE"

Parameters

  src1 | first input matrix.
  src2 | second input matrix/scalar of the same depth as first input matrix.

See also
  min, max, threshold, cmpGT, cmpGE, cmpLS

## ◆ cmpLE() [2/2]

GMat cv::gapi::cmpLE | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpLEScalar"

## ◆ cmpLT() [1/2]

GMat cv::gapi::cmpLT | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Performs the per-element comparison of two matrices checking if elements from first matrix are less than elements in second.

The function compares elements of two matrices src1 and src2 of the same size:

\[\texttt{dst} (I) = \texttt{src1} (I) < \texttt{src2} (I)\]

When the comparison result is true, the corresponding element of output array is set to 255. The comparison operations can be replaced with the equivalent matrix expressions:

\[\texttt{dst} = \texttt{src1} < \texttt{src2}\]

Output matrix of depth CV_8U must have the same size and the same number of channels as the input matrices/matrix.

Supported input matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpLT"

Parameters

  src1 | first input matrix.
  src2 | second input matrix/scalar of the same depth as first input matrix.

See also
  min, max, threshold, cmpLE, cmpGE, cmpGT

## ◆ cmpLT() [2/2]

GMat cv::gapi::cmpLT | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpLTScalar"

## ◆ cmpNE() [1/2]

GMat cv::gapi::cmpNE | ( | const GMat & | src1,
|  | const GMat & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Performs the per-element comparison of two matrices checking if elements from first matrix are not equal to elements in second.

The function compares elements of two matrices src1 and src2 of the same size:

\[\texttt{dst} (I) = \texttt{src1} (I) != \texttt{src2} (I)\]

When the comparison result is true, the corresponding element of output array is set to 255. The comparison operations can be replaced with the equivalent matrix expressions:

\[\texttt{dst} = \texttt{src1} != \texttt{src2}\]

Output matrix of depth CV_8U must have the same size and the same number of channels as the input matrices.

Supported input matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpNE"

Parameters

  src1 | first input matrix.
  src2 | second input matrix/scalar of the same depth as first input matrix.

See also
  min, max, threshold, cmpEQ

## ◆ cmpNE() [2/2]

GMat cv::gapi::cmpNE | ( | const GMat & | src1,
|  | const GScalar & | src2
| ) |  |

`#include <opencv2/gapi/core.hpp>`

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Note
  Function textual ID is "org.opencv.core.pixelwise.compare.cmpNEScalar"

## ◆ select()

GMat cv::gapi::select | ( | const GMat & | src1,
|  | const GMat & | src2,
|  | const GMat & | mask
| ) |  |

`#include <opencv2/gapi/core.hpp>`

Select values from either first or second of input matrices by given mask. The function set to the output matrix either the value from the first input matrix if corresponding value of mask matrix is 255, or value from the second input matrix (if value of mask matrix set to 0).

Input mask matrix must be of CV_8UC1 type, two other inout matrices and output matrix should be of the same type. The size should be the same for all input and output matrices. Supported input matrix data types are CV_8UC1, CV_8UC3, CV_16UC1, CV_16SC1, CV_32FC1.

Note
  Function textual ID is "org.opencv.core.pixelwise.select"

Parameters

  src1 | first input matrix.
  src2 | second input matrix.
  mask | mask input matrix.