Per-element Operations — OpenCV 2.4.6.1 documentation

### Navigation

- index
- next |
- previous |
- OpenCV 2.4.6.1 documentation »
- OpenCV API Reference »
- gpu. GPU-accelerated Computer Vision »

# Per-element Operations

## gpu::add

Computes a matrix-matrix or matrix-scalar sum.

C++:`` void `gpu::``add`(const GpuMat& a, const GpuMat& b, GpuMat& c, const GpuMat& mask=GpuMat(), int dtype=-1, Stream& stream=Stream::Null() )

C++:`` void `gpu::``add`(const GpuMat& a, const Scalar& sc, GpuMat& c, const GpuMat& mask=GpuMat(), int dtype=-1, Stream& stream=Stream::Null() )

  Parameters: | a – First source matrix. b – Second source matrix to be added to `a` . Matrix should have the same size and type as `a` . sc – A scalar to be added to `a` . c – Destination matrix that has the same size and number of channels as the input array(s). The depth is defined by `dtype` or `a` depth. mask – Optional operation mask, 8-bit single channel array, that specifies elements of the destination array to be changed. dtype – Optional depth of the output array. stream – Stream for the asynchronous version.

See also

`add()`

## gpu::subtract

Computes a matrix-matrix or matrix-scalar difference.

C++:`` void `gpu::``subtract`(const GpuMat& a, const GpuMat& b, GpuMat& c, const GpuMat& mask=GpuMat(), int dtype=-1, Stream& stream=Stream::Null() )

C++:`` void `gpu::``subtract`(const GpuMat& a, const Scalar& sc, GpuMat& c, const GpuMat& mask=GpuMat(), int dtype=-1, Stream& stream=Stream::Null() )

  Parameters: | a – First source matrix. b – Second source matrix to be added to `a` . Matrix should have the same size and type as `a` . sc – A scalar to be added to `a` . c – Destination matrix that has the same size and number of channels as the input array(s). The depth is defined by `dtype` or `a` depth. mask – Optional operation mask, 8-bit single channel array, that specifies elements of the destination array to be changed. dtype – Optional depth of the output array. stream – Stream for the asynchronous version.

See also

`subtract()`

## gpu::multiply

Computes a matrix-matrix or matrix-scalar per-element product.

C++:`` void `gpu::``multiply`(const GpuMat& a, const GpuMat& b, GpuMat& c, double scale=1, int dtype=-1, Stream& stream=Stream::Null() )

C++:`` void `gpu::``multiply`(const GpuMat& a, const Scalar& sc, GpuMat& c, double scale=1, int dtype=-1, Stream& stream=Stream::Null() )

  Parameters: | a – First source matrix. b – Second source matrix to be multiplied by `a` elements. sc – A scalar to be multiplied by `a` elements. c – Destination matrix that has the same size and number of channels as the input array(s). The depth is defined by `dtype` or `a` depth. scale – Optional scale factor. dtype – Optional depth of the output array. stream – Stream for the asynchronous version.

See also

`multiply()`

## gpu::divide

Computes a matrix-matrix or matrix-scalar division.

C++:`` void `gpu::``divide`(const GpuMat& a, const GpuMat& b, GpuMat& c, double scale=1, int dtype=-1, Stream& stream=Stream::Null() )

C++:`` void `gpu::``divide`(const GpuMat& a, const Scalar& sc, GpuMat& c, double scale=1, int dtype=-1, Stream& stream=Stream::Null())

C++:`` void `gpu::``divide`(double scale, const GpuMat& b, GpuMat& c, int dtype=-1, Stream& stream=Stream::Null() )

  Parameters: | a – First source matrix or a scalar. b – Second source matrix. The `a` elements are divided by it. sc – A scalar to be divided by the elements of `a` matrix. c – Destination matrix that has the same size and number of channels as the input array(s). The depth is defined by `dtype` or `a` depth. scale – Optional scale factor. dtype – Optional depth of the output array. stream – Stream for the asynchronous version.

This function, in contrast to `divide()`, uses a round-down rounding mode.

See also

`divide()`

## gpu::addWeighted

Computes the weighted sum of two arrays.

C++:`` void `gpu::``addWeighted`(const GpuMat& src1, double alpha, const GpuMat& src2, double beta, double gamma, GpuMat& dst, int dtype=-1, Stream& stream=Stream::Null())

  Parameters: | src1 – First source array. alpha – Weight for the first array elements. src2 – Second source array of the same size and channel number as `src1` . beta – Weight for the second array elements. dst – Destination array that has the same size and number of channels as the input arrays. gamma – Scalar added to each sum. dtype – Optional depth of the destination array. When both input arrays have the same depth, `dtype` can be set to `-1`, which will be equivalent to `src1.depth()`. stream – Stream for the asynchronous version.

The function `addWeighted` calculates the weighted sum of two arrays as follows:

\texttt{dst} (I)= \texttt{saturate} ( \texttt{src1} (I)* \texttt{alpha} + \texttt{src2} (I)* \texttt{beta} + \texttt{gamma} )

where `I` is a multi-dimensional index of array elements. In case of multi-channel arrays, each channel is processed independently.

See also

`addWeighted()`

## gpu::abs

Computes an absolute value of each matrix element.

C++:`` void `gpu::``abs`(const GpuMat& src, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src – Source matrix. Supports `CV_16S` and `CV_32F` depth. dst – Destination matrix with the same size and type as `src` . stream – Stream for the asynchronous version.

See also

`abs()`

## gpu::sqr

Computes a square value of each matrix element.

C++:`` void `gpu::``sqr`(const GpuMat& src, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src – Source matrix. Supports `CV_8U` , `CV_16U` , `CV_16S` and `CV_32F` depth. dst – Destination matrix with the same size and type as `src` . stream – Stream for the asynchronous version.

## gpu::sqrt

Computes a square root of each matrix element.

C++:`` void `gpu::``sqrt`(const GpuMat& src, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src – Source matrix. Supports `CV_8U` , `CV_16U` , `CV_16S` and `CV_32F` depth. dst – Destination matrix with the same size and type as `src` . stream – Stream for the asynchronous version.

See also

`sqrt()`

## gpu::exp

Computes an exponent of each matrix element.

C++:`` void `gpu::``exp`(const GpuMat& a, GpuMat& b, Stream& stream=Stream::Null() )

  Parameters: | a – Source matrix. Supports `CV_8U` , `CV_16U` , `CV_16S` and `CV_32F` depth. b – Destination matrix with the same size and type as `a` . stream – Stream for the asynchronous version.

See also

`exp()`

## gpu::log

Computes a natural logarithm of absolute value of each matrix element.

C++:`` void `gpu::``log`(const GpuMat& a, GpuMat& b, Stream& stream=Stream::Null() )

  Parameters: | a – Source matrix. Supports `CV_8U` , `CV_16U` , `CV_16S` and `CV_32F` depth. b – Destination matrix with the same size and type as `a` . stream – Stream for the asynchronous version.

See also

`log()`

## gpu::pow

Raises every matrix element to a power.

C++:`` void `gpu::``pow`(const GpuMat& src, double power, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src – Source matrix. Supports all type, except `CV_64F` depth. power – Exponent of power. dst – Destination matrix with the same size and type as `src` . stream – Stream for the asynchronous version.

The function `pow` raises every element of the input matrix to `p` :

\texttt{dst} (I) = \fork{\texttt{src}(I)^p}{if \texttt{p} is integer}{|\texttt{src}(I)|^p}{otherwise}

See also

`pow()`

## gpu::absdiff

Computes per-element absolute difference of two matrices (or of a matrix and scalar).

C++:`` void `gpu::``absdiff`(const GpuMat& a, const GpuMat& b, GpuMat& c, Stream& stream=Stream::Null() )

C++:`` void `gpu::``absdiff`(const GpuMat& a, const Scalar& s, GpuMat& c, Stream& stream=Stream::Null() )

  Parameters: | a – First source matrix. b – Second source matrix to be added to `a` . s – A scalar to be added to `a` . c – Destination matrix with the same size and type as `a` . stream – Stream for the asynchronous version.

See also

`absdiff()`

## gpu::compare

Compares elements of two matrices.

C++:`` void `gpu::``compare`(const GpuMat& a, const GpuMat& b, GpuMat& c, int cmpop, Stream& stream=Stream::Null() )

C++:`` void `gpu::``compare`(const GpuMat& a, Scalar sc, GpuMat& c, int cmpop, Stream& stream=Stream::Null())

  Parameters: | a – First source matrix. b – Second source matrix with the same size and type as `a` . sc – A scalar to be compared with `a` . c – Destination matrix with the same size as `a` and the `CV_8UC1` type. cmpop – Flag specifying the relation between the elements to be checked: CMP_EQ: `a(.) == b(.)` CMP_GT: `a(.) < b(.)` CMP_GE: `a(.) <= b(.)` CMP_LT: `a(.) < b(.)` CMP_LE: `a(.) <= b(.)` CMP_NE: `a(.) != b(.)` stream – Stream for the asynchronous version.

See also

`compare()`

## gpu::bitwise_not

Performs a per-element bitwise inversion.

C++:`` void `gpu::``bitwise_not`(const GpuMat& src, GpuMat& dst, const GpuMat& mask=GpuMat(), Stream& stream=Stream::Null())

  Parameters: | src – Source matrix. dst – Destination matrix with the same size and type as `src` . mask – Optional operation mask. 8-bit single channel image. stream – Stream for the asynchronous version.

## gpu::bitwise_or

Performs a per-element bitwise disjunction of two matrices or of matrix and scalar.

C++:`` void `gpu::``bitwise_or`(const GpuMat& src1, const GpuMat& src2, GpuMat& dst, const GpuMat& mask=GpuMat(), Stream& stream=Stream::Null())

C++:`` void `gpu::``bitwise_or`(const GpuMat& src1, const Scalar& sc, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src1 – First source matrix. src2 – Second source matrix with the same size and type as `src1` . dst – Destination matrix with the same size and type as `src1` . mask – Optional operation mask. 8-bit single channel image. stream – Stream for the asynchronous version.

## gpu::bitwise_and

Performs a per-element bitwise conjunction of two matrices or of matrix and scalar.

C++:`` void `gpu::``bitwise_and`(const GpuMat& src1, const GpuMat& src2, GpuMat& dst, const GpuMat& mask=GpuMat(), Stream& stream=Stream::Null())

C++:`` void `gpu::``bitwise_and`(const GpuMat& src1, const Scalar& sc, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src1 – First source matrix. src2 – Second source matrix with the same size and type as `src1` . dst – Destination matrix with the same size and type as `src1` . mask – Optional operation mask. 8-bit single channel image. stream – Stream for the asynchronous version.

## gpu::bitwise_xor

Performs a per-element bitwise `exclusive or` operation of two matrices of matrix and scalar.

C++:`` void `gpu::``bitwise_xor`(const GpuMat& src1, const GpuMat& src2, GpuMat& dst, const GpuMat& mask=GpuMat(), Stream& stream=Stream::Null())

C++:`` void `gpu::``bitwise_xor`(const GpuMat& src1, const Scalar& sc, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src1 – First source matrix. src2 – Second source matrix with the same size and type as `src1` . dst – Destination matrix with the same size and type as `src1` . mask – Optional operation mask. 8-bit single channel image. stream – Stream for the asynchronous version.

## gpu::rshift

Performs pixel by pixel right shift of an image by a constant value.

C++:`` void `gpu::``rshift`(const GpuMat& src, Scalar_<int> sc, GpuMat& dst, Stream& stream=Stream::Null() )

  Parameters: | src – Source matrix. Supports 1, 3 and 4 channels images with integers elements. sc – Constant values, one per channel. dst – Destination matrix with the same size and type as `src` . stream – Stream for the asynchronous version.

## gpu::lshift

Performs pixel by pixel right left of an image by a constant value.

C++:`` void `gpu::``lshift`(const GpuMat& src, Scalar_<int> sc, GpuMat& dst, Stream& stream=Stream::Null() )

  Parameters: | src – Source matrix. Supports 1, 3 and 4 channels images with `CV_8U` , `CV_16U` or `CV_32S` depth. sc – Constant values, one per channel. dst – Destination matrix with the same size and type as `src` . stream – Stream for the asynchronous version.

## gpu::min

Computes the per-element minimum of two matrices (or a matrix and a scalar).

C++:`` void `gpu::``min`(const GpuMat& src1, const GpuMat& src2, GpuMat& dst, Stream& stream=Stream::Null())

C++:`` void `gpu::``min`(const GpuMat& src1, double src2, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src1 – First source matrix. src2 – Second source matrix or a scalar to compare `src1` elements with. dst – Destination matrix with the same size and type as `src1` . stream – Stream for the asynchronous version.

See also

`min()`

## gpu::max

Computes the per-element maximum of two matrices (or a matrix and a scalar).

C++:`` void `gpu::``max`(const GpuMat& src1, const GpuMat& src2, GpuMat& dst, Stream& stream=Stream::Null())

C++:`` void `gpu::``max`(const GpuMat& src1, double src2, GpuMat& dst, Stream& stream=Stream::Null())

  Parameters: | src1 – First source matrix. src2 – Second source matrix or a scalar to compare `src1` elements with. dst – Destination matrix with the same size and type as `src1` . stream – Stream for the asynchronous version.

See also

`max()`

## Help and Feedback

You did not find what you were looking for?

- Ask a question on the Q&A forum.
- If you think something is missing or wrong in the documentation, please file a bug report.

### Navigation

- index
- next |
- previous |
- OpenCV 2.4.6.1 documentation »
- OpenCV API Reference »
- gpu. GPU-accelerated Computer Vision »