a lot of small corrections to bring down the number of undocumented functions, reported by the script; added em.cpp sample

This commit is contained in:
Vadim Pisarevsky
2011-06-09 01:16:45 +00:00
parent 3b9e752be7
commit 20aca7440f
30 changed files with 474 additions and 746 deletions

View File

@@ -490,7 +490,7 @@ gpu::reprojectImageTo3D
:param stream: Stream for the asynchronous version.
See Also: :c:cpp:func:`reprojectImageTo3D` .
See Also: :cpp:func:`reprojectImageTo3D` .
.. index:: gpu::solvePnPRansac
@@ -507,7 +507,7 @@ gpu::solvePnPRansac
:param camera_mat: 3x3 matrix of intrinsic camera parameters.
:param dist_coef: Distortion coefficients. See :c:cpp:func:`undistortPoints` for details.
:param dist_coef: Distortion coefficients. See :cpp:func:`undistortPoints` for details.
:param rvec: Output 3D rotation vector.
@@ -523,5 +523,5 @@ gpu::solvePnPRansac
:param inliers: Output vector of inlier indices.
See Also :c:cpp:func:`solvePnPRansac`.
See Also :cpp:func:`solvePnPRansac`.

View File

@@ -195,7 +195,7 @@ gpu::BruteForceMatcher_GPU::match
Finds the best match for each descriptor from a query set with train descriptors.
See Also:
:c:cpp:func:`DescriptorMatcher::match`
:cpp:func:`DescriptorMatcher::match`
.. index:: gpu::BruteForceMatcher_GPU::matchSingle

View File

@@ -224,7 +224,7 @@ gpu::createBoxFilter_GPU
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`boxFilter`
See Also: :cpp:func:`boxFilter`
.. index:: gpu::boxFilter
@@ -248,7 +248,7 @@ gpu::boxFilter
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`boxFilter`
See Also: :cpp:func:`boxFilter`
.. index:: gpu::blur
@@ -270,7 +270,7 @@ gpu::blur
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`blur`, :cpp:func:`gpu::boxFilter`
See Also: :cpp:func:`blur`, :cpp:func:`gpu::boxFilter`
.. index:: gpu::createMorphologyFilter_GPU
@@ -296,7 +296,7 @@ gpu::createMorphologyFilter_GPU
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`createMorphologyFilter`
See Also: :cpp:func:`createMorphologyFilter`
.. index:: gpu::erode
@@ -320,7 +320,7 @@ gpu::erode
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`erode`
See Also: :cpp:func:`erode`
.. index:: gpu::dilate
@@ -344,7 +344,7 @@ gpu::dilate
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`dilate`
See Also: :cpp:func:`dilate`
.. index:: gpu::morphologyEx
@@ -381,7 +381,7 @@ gpu::morphologyEx
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`morphologyEx`
See Also: :cpp:func:`morphologyEx`
.. index:: gpu::createLinearFilter_GPU
@@ -407,7 +407,7 @@ gpu::createLinearFilter_GPU
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`createLinearFilter`
See Also: :cpp:func:`createLinearFilter`
.. index:: gpu::filter2D
@@ -431,7 +431,7 @@ gpu::filter2D
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`filter2D`
See Also: :cpp:func:`filter2D`
.. index:: gpu::Laplacian
@@ -447,15 +447,15 @@ gpu::Laplacian
:param ddepth: Desired depth of the destination image. It supports only the same depth as the source image depth.
:param ksize: Aperture size used to compute the second-derivative filters (see :c:cpp:func:`getDerivKernels`). It must be positive and odd. Only ``ksize`` = 1 and ``ksize`` = 3 are supported.
:param ksize: Aperture size used to compute the second-derivative filters (see :cpp:func:`getDerivKernels`). It must be positive and odd. Only ``ksize`` = 1 and ``ksize`` = 3 are supported.
:param scale: Optional scale factor for the computed Laplacian values. By default, no scaling is applied (see :c:cpp:func:`getDerivKernels` ).
:param scale: Optional scale factor for the computed Laplacian values. By default, no scaling is applied (see :cpp:func:`getDerivKernels` ).
**Note:**
This filter does not check out-of-border accesses, so only a proper sub-matrix of a bigger matrix has to be passed to it.
See Also: :c:cpp:func:`Laplacian`,:cpp:func:`gpu::filter2D` .
See Also: :cpp:func:`Laplacian`,:cpp:func:`gpu::filter2D` .
.. index:: gpu::getLinearRowFilter_GPU
@@ -473,7 +473,7 @@ gpu::getLinearRowFilter_GPU
:param anchor: Anchor position within the kernel. Negative values mean that the anchor is positioned at the aperture center.
:param borderType: Pixel extrapolation method. For details, see :c:cpp:func:`borderInterpolate`. For details on limitations, see below.
:param borderType: Pixel extrapolation method. For details, see :cpp:func:`borderInterpolate`. For details on limitations, see below.
There are two versions of the algorithm: NPP and OpenCV.
* NPP version is called when ``srcType == CV_8UC1`` or ``srcType == CV_8UC4`` and ``bufType == srcType`` . Otherwise, the OpenCV version is called. NPP supports only ``BORDER_CONSTANT`` border type and does not check indices outside the image.
@@ -497,13 +497,13 @@ gpu::getLinearColumnFilter_GPU
:param anchor: Anchor position within the kernel. Negative values mean that the anchor is positioned at the aperture center.
:param borderType: Pixel extrapolation method. For details, see :c:cpp:func:`borderInterpolate` . For details on limitations, see below.
:param borderType: Pixel extrapolation method. For details, see :cpp:func:`borderInterpolate` . For details on limitations, see below.
There are two versions of the algorithm: NPP and OpenCV.
* NPP version is called when ``dstType == CV_8UC1`` or ``dstType == CV_8UC4`` and ``bufType == dstType`` . Otherwise, the OpenCV version is called. NPP supports only ``BORDER_CONSTANT`` border type and does not check indices outside the image.
* OpenCV version supports only ``CV_32F`` buffer depth and ``BORDER_REFLECT101``, ``BORDER_REPLICATE``, and ``BORDER_CONSTANT`` border types. It checks indices outside image.
See Also: :cpp:func:`gpu::getLinearRowFilter_GPU`, :c:cpp:func:`createSeparableLinearFilter`
See Also: :cpp:func:`gpu::getLinearRowFilter_GPU`, :cpp:func:`createSeparableLinearFilter`
.. index:: gpu::createSeparableLinearFilter_GPU
@@ -521,10 +521,10 @@ gpu::createSeparableLinearFilter_GPU
:param anchor: Anchor position within the kernel. Negative values mean that anchor is positioned at the aperture center.
:param rowBorderType, columnBorderType: Pixel extrapolation method in the horizontal and vertical directions For details, see :c:cpp:func:`borderInterpolate`. For details on limitations, see :cpp:func:`gpu::getLinearRowFilter_GPU`, cpp:cpp:func:`gpu::getLinearColumnFilter_GPU`.
:param rowBorderType, columnBorderType: Pixel extrapolation method in the horizontal and vertical directions For details, see :cpp:func:`borderInterpolate`. For details on limitations, see :cpp:func:`gpu::getLinearRowFilter_GPU`, cpp:cpp:func:`gpu::getLinearColumnFilter_GPU`.
See Also: :cpp:func:`gpu::getLinearRowFilter_GPU`, :cpp:func:`gpu::getLinearColumnFilter_GPU`, :c:cpp:func:`createSeparableLinearFilter`
See Also: :cpp:func:`gpu::getLinearRowFilter_GPU`, :cpp:func:`gpu::getLinearColumnFilter_GPU`, :cpp:func:`createSeparableLinearFilter`
.. index:: gpu::sepFilter2D
@@ -544,9 +544,9 @@ gpu::sepFilter2D
:param anchor: Anchor position within the kernel. The default value ``(-1, 1)`` means that the anchor is at the kernel center.
:param rowBorderType, columnBorderType: Pixel extrapolation method. For details, see :c:cpp:func:`borderInterpolate`.
:param rowBorderType, columnBorderType: Pixel extrapolation method. For details, see :cpp:func:`borderInterpolate`.
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :c:cpp:func:`sepFilter2D`
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :cpp:func:`sepFilter2D`
.. index:: gpu::createDerivFilter_GPU
@@ -564,11 +564,11 @@ gpu::createDerivFilter_GPU
:param dy: Derivative order in respect of y.
:param ksize: Aperture size. See :c:cpp:func:`getDerivKernels` for details.
:param ksize: Aperture size. See :cpp:func:`getDerivKernels` for details.
:param rowBorderType, columnBorderType: Pixel extrapolation method. See :c:cpp:func:`borderInterpolate` for details.
:param rowBorderType, columnBorderType: Pixel extrapolation method. See :cpp:func:`borderInterpolate` for details.
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :c:cpp:func:`createDerivFilter`
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :cpp:func:`createDerivFilter`
.. index:: gpu::Sobel
@@ -590,11 +590,11 @@ gpu::Sobel
:param ksize: Size of the extended Sobel kernel. Possible valies are 1, 3, 5 or 7.
:param scale: Optional scale factor for the computed derivative values. By default, no scaling is applied. For details, see :c:cpp:func:`getDerivKernels` .
:param scale: Optional scale factor for the computed derivative values. By default, no scaling is applied. For details, see :cpp:func:`getDerivKernels` .
:param rowBorderType, columnBorderType: Pixel extrapolation method. See :c:cpp:func:`borderInterpolate` for details.
:param rowBorderType, columnBorderType: Pixel extrapolation method. See :cpp:func:`borderInterpolate` for details.
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :c:cpp:func:`Sobel`
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :cpp:func:`Sobel`
.. index:: gpu::Scharr
@@ -614,11 +614,11 @@ gpu::Scharr
:param yorder: Order of the derivative y.
:param scale: Optional scale factor for the computed derivative values. By default, no scaling is applied. See :c:cpp:func:`getDerivKernels` for details.
:param scale: Optional scale factor for the computed derivative values. By default, no scaling is applied. See :cpp:func:`getDerivKernels` for details.
:param rowBorderType, columnBorderType: Pixel extrapolation method. For details, see :c:cpp:func:`borderInterpolate` and :c:cpp:func:`Scharr` .
:param rowBorderType, columnBorderType: Pixel extrapolation method. For details, see :cpp:func:`borderInterpolate` and :cpp:func:`Scharr` .
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :c:cpp:func:`Scharr`
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :cpp:func:`Scharr`
.. index:: gpu::createGaussianFilter_GPU
@@ -630,15 +630,15 @@ gpu::createGaussianFilter_GPU
:param type: Source and destination image type. ``CV_8UC1``, ``CV_8UC4``, ``CV_16SC1``, ``CV_16SC2``, ``CV_32SC1``, ``CV_32FC1`` are supported.
:param ksize: Aperture size. See :c:cpp:func:`getGaussianKernel` for details.
:param ksize: Aperture size. See :cpp:func:`getGaussianKernel` for details.
:param sigmaX: Gaussian sigma in the horizontal direction. See :c:cpp:func:`getGaussianKernel` for details.
:param sigmaX: Gaussian sigma in the horizontal direction. See :cpp:func:`getGaussianKernel` for details.
:param sigmaY: Gaussian sigma in the vertical direction. If 0, then :math:`\texttt{sigmaY}\leftarrow\texttt{sigmaX}` .
:param rowBorderType, columnBorderType: Border type to use. See :c:cpp:func:`borderInterpolate` for details.
:param rowBorderType, columnBorderType: Border type to use. See :cpp:func:`borderInterpolate` for details.
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :c:cpp:func:`createGaussianFilter`
See Also: :cpp:func:`gpu::createSeparableLinearFilter_GPU`, :cpp:func:`createGaussianFilter`
.. index:: gpu::GaussianBlur
@@ -654,11 +654,11 @@ gpu::GaussianBlur
:param ksize: Gaussian kernel size. ``ksize.width`` and ``ksize.height`` can differ but they both must be positive and odd. If they are zeros, they are computed from ``sigmaX`` and ``sigmaY`` .
:param sigmaX, sigmaY: Gaussian kernel standard deviations in X and Y direction. If ``sigmaY`` is zero, it is set to be equal to ``sigmaX`` . If they are both zeros, they are computed from ``ksize.width`` and ``ksize.height``, respectively. See :c:cpp:func:`getGaussianKernel` for details. To fully control the result regardless of possible future modification of all this semantics, you are recommended to specify all of ``ksize``, ``sigmaX``, and ``sigmaY`` .
:param sigmaX, sigmaY: Gaussian kernel standard deviations in X and Y direction. If ``sigmaY`` is zero, it is set to be equal to ``sigmaX`` . If they are both zeros, they are computed from ``ksize.width`` and ``ksize.height``, respectively. See :cpp:func:`getGaussianKernel` for details. To fully control the result regardless of possible future modification of all this semantics, you are recommended to specify all of ``ksize``, ``sigmaX``, and ``sigmaY`` .
:param rowBorderType, columnBorderType: Pixel extrapolation method. See :c:cpp:func:`borderInterpolate` for details.
:param rowBorderType, columnBorderType: Pixel extrapolation method. See :cpp:func:`borderInterpolate` for details.
See Also: :cpp:func:`gpu::createGaussianFilter_GPU`, :c:cpp:func:`GaussianBlur`
See Also: :cpp:func:`gpu::createGaussianFilter_GPU`, :cpp:func:`GaussianBlur`
.. index:: gpu::getMaxFilter_GPU

View File

@@ -42,7 +42,7 @@ gpu::meanShiftProc
:param criteria: Termination criteria. See :cpp:class:`TermCriteria`.
See Also:
:c:cpp:func:`gpu::meanShiftFiltering`
:cpp:func:`gpu::meanShiftFiltering`
.. index:: gpu::meanShiftSegmentation
@@ -81,7 +81,7 @@ gpu::integral
:param sqsum: Squared integral image of the ``CV_32FC1`` type.
See Also:
:c:cpp:func:`integral`
:cpp:func:`integral`
.. index:: gpu::sqrIntegral
@@ -128,7 +128,7 @@ gpu::cornerHarris
:param borderType: Pixel extrapolation method. Only ``BORDER_REFLECT101`` and ``BORDER_REPLICATE`` are supported for now.
See Also:
:c:cpp:func:`cornerHarris`
:cpp:func:`cornerHarris`
.. index:: gpu::cornerMinEigenVal
@@ -150,7 +150,7 @@ gpu::cornerMinEigenVal
:param borderType: Pixel extrapolation method. Only ``BORDER_REFLECT101`` and ``BORDER_REPLICATE`` are supported for now.
See also: :c:cpp:func:`cornerMinEigenVal`
See also: :cpp:func:`cornerMinEigenVal`
.. index:: gpu::mulSpectrums
@@ -173,7 +173,7 @@ gpu::mulSpectrums
Only full (not packed) ``CV_32FC2`` complex spectrums in the interleaved format are supported for now.
See Also:
:c:cpp:func:`mulSpectrums`
:cpp:func:`mulSpectrums`
.. index:: gpu::mulAndScaleSpectrums
@@ -198,7 +198,7 @@ gpu::mulAndScaleSpectrums
Only full (not packed) ``CV_32FC2`` complex spectrums in the interleaved format are supported for now.
See Also:
:c:cpp:func:`mulSpectrums`
:cpp:func:`mulSpectrums`
.. index:: gpu::dft
@@ -237,7 +237,7 @@ gpu::dft
If the source matrix is real (its type is ``CV_32FC1`` ), forward DFT is performed. The result of the DFT is packed into complex ( ``CV_32FC2`` ) matrix. So, the width of the destination matrix is ``dft_size.width / 2 + 1`` . But if the source is a single column, the height is reduced instead of the width.
See Also:
:c:cpp:func:`dft`
:cpp:func:`dft`
.. index:: gpu::convolve
@@ -268,7 +268,7 @@ gpu::ConvolveBuf
.. cpp:class:: gpu::ConvolveBuf
This class provides a memory buffer for the
:c:cpp:func:`gpu::convolve` function.
:cpp:func:`gpu::convolve` function.
::
struct CV_EXPORTS ConvolveBuf
@@ -290,12 +290,12 @@ gpu::ConvolveBuf::ConvolveBuf
.. cpp:function:: ConvolveBuf::ConvolveBuf()
Constructs an empty buffer that is properly resized after the first call of the
:c:cpp:func:`convolve` function.
:cpp:func:`convolve` function.
.. cpp:function:: ConvolveBuf::ConvolveBuf(Size image_size, Size templ_size)
Constructs a buffer for the
:c:cpp:func:`convolve` function with respective arguments.
:cpp:func:`convolve` function with respective arguments.
.. index:: gpu::matchTemplate
@@ -328,7 +328,7 @@ gpu::matchTemplate
* ``CV_TM_CCORR``
See Also:
:c:cpp:func:`matchTemplate`
:cpp:func:`matchTemplate`
.. index:: gpu::remap
@@ -354,7 +354,7 @@ gpu::remap
Values of pixels with non-integer coordinates are computed using bilinear the interpolation.
See Also: :c:cpp:func:`remap`
See Also: :cpp:func:`remap`
.. index:: gpu::cvtColor

View File

@@ -17,7 +17,7 @@ gpu::meanStdDev
:param stddev: Standard deviation value.
See Also: :c:cpp:func:`meanStdDev`
See Also: :cpp:func:`meanStdDev`
.. index:: gpu::norm
@@ -37,7 +37,7 @@ gpu::norm
:param buf: Optional buffer to avoid extra memory allocations. It is resized automatically.
See Also: :c:cpp:func:`norm`
See Also: :cpp:func:`norm`
.. index:: gpu::sum
@@ -53,7 +53,7 @@ gpu::sum
:param buf: Optional buffer to avoid extra memory allocations. It is resized automatically.
See Also: :c:cpp:func:`sum`
See Also: :cpp:func:`sum`
.. index:: gpu::absSum
@@ -105,7 +105,7 @@ gpu::minMax
The function does not work with ``CV_64F`` images on GPUs with the compute capability < 1.3.
See Also: :c:cpp:func:`minMaxLoc`
See Also: :cpp:func:`minMaxLoc`
.. index:: gpu::minMaxLoc
@@ -135,7 +135,7 @@ gpu::minMaxLoc
The function does not work with ``CV_64F`` images on GPU with the compute capability < 1.3.
See Also: :c:cpp:func:`minMaxLoc`
See Also: :cpp:func:`minMaxLoc`
.. index:: gpu::countNonZero
@@ -153,4 +153,4 @@ gpu::countNonZero
The function does not work with ``CV_64F`` images on GPUs with the compute capability < 1.3.
See Also: :c:cpp:func:`countNonZero`
See Also: :cpp:func:`countNonZero`

View File

@@ -324,5 +324,5 @@ gpu::CascadeClassifier_GPU::detectMultiScale
imshow("Faces", image_cpu);
See Also: :c:cpp:func:`CascadeClassifier::detectMultiScale`
See Also: :cpp:func:`CascadeClassifier::detectMultiScale`

View File

@@ -16,7 +16,7 @@ gpu::transpose
:param dst: Destination matrix.
See Also:
:c:cpp:func:`transpose`
:cpp:func:`transpose`
.. index:: gpu::flip
@@ -40,7 +40,7 @@ gpu::flip
See Also:
:c:cpp:func:`flip`
:cpp:func:`flip`
.. index:: gpu::LUT
@@ -57,7 +57,7 @@ gpu::LUT
:param dst: Destination matrix with the same depth as ``lut`` and the same number of channels as ``src``.
See Also: :c:cpp:func:`LUT`
See Also: :cpp:func:`LUT`
.. index:: gpu::merge
@@ -81,7 +81,7 @@ gpu::merge
:param stream: Stream for the asynchronous version.
See Also: :c:cpp:func:`merge`
See Also: :cpp:func:`merge`
.. index:: gpu::split
@@ -103,7 +103,7 @@ gpu::split
:param stream: Stream for the asynchronous version.
See Also: :c:cpp:func:`split`
See Also: :cpp:func:`split`
.. index:: gpu::magnitude
@@ -128,7 +128,7 @@ gpu::magnitude
:param stream: Stream for the asynchronous version.
See Also:
:c:cpp:func:`magnitude`
:cpp:func:`magnitude`
.. index:: gpu::magnitudeSqr
@@ -173,7 +173,7 @@ gpu::phase
:param stream: Stream for the asynchronous version.
See Also:
:c:cpp:func:`phase`
:cpp:func:`phase`
.. index:: gpu::cartToPolar
@@ -198,7 +198,7 @@ gpu::cartToPolar
:param stream: Stream for the asynchronous version.
See Also:
:c:cpp:func:`cartToPolar`
:cpp:func:`cartToPolar`
.. index:: gpu::polarToCart
@@ -223,4 +223,4 @@ gpu::polarToCart
:param stream: Stream for the asynchronous version.
See Also:
:c:cpp:func:`polarToCart`
:cpp:func:`polarToCart`

View File

@@ -21,7 +21,7 @@ gpu::add
:param dst: Destination matrix with the same size and type as ``src1``.
See Also: :c:cpp:func:`add`
See Also: :cpp:func:`add`
.. index:: gpu::subtract
@@ -39,7 +39,7 @@ gpu::subtract
:param dst: Destination matrix with the same size and type as ``src1``.
See Also: :c:cpp:func:`subtract`
See Also: :cpp:func:`subtract`
@@ -59,7 +59,7 @@ gpu::multiply
:param dst: Destination matrix with the same size and type as ``src1``.
See Also: :c:cpp:func:`multiply`
See Also: :cpp:func:`multiply`
.. index:: gpu::divide
@@ -78,9 +78,9 @@ gpu::divide
:param dst: Destination matrix with the same size and type as ``src1``.
This function, in contrast to :c:cpp:func:`divide`, uses a round-down rounding mode.
This function, in contrast to :cpp:func:`divide`, uses a round-down rounding mode.
See Also: :c:cpp:func:`divide`
See Also: :cpp:func:`divide`
@@ -96,7 +96,7 @@ gpu::exp
:param dst: Destination matrix with the same size and type as ``src``.
See Also: :c:cpp:func:`exp`
See Also: :cpp:func:`exp`
@@ -112,7 +112,7 @@ gpu::log
:param dst: Destination matrix with the same size and type as ``src``.
See Also: :c:cpp:func:`log`
See Also: :cpp:func:`log`
@@ -132,7 +132,7 @@ gpu::absdiff
:param dst: Destination matrix with the same size and type as ``src1``.
See Also: :c:cpp:func:`absdiff`
See Also: :cpp:func:`absdiff`
.. index:: gpu::compare
@@ -157,7 +157,7 @@ gpu::compare
* **CMP_LE:** ``src1(.) <= src2(.)``
* **CMP_NE:** ``src1(.) != src2(.)``
See Also: :c:cpp:func:`compare`
See Also: :cpp:func:`compare`
.. index:: gpu::bitwise_not
@@ -268,7 +268,7 @@ gpu::min
:param stream: Stream for the asynchronous version.
See Also: :c:cpp:func:`min`
See Also: :cpp:func:`min`
@@ -294,4 +294,4 @@ gpu::max
:param stream: Stream for the asynchronous version.
See Also: :c:cpp:func:`max`
See Also: :cpp:func:`max`