From: Andrey Kamaev Date: Wed, 10 Apr 2013 12:17:28 +0000 (+0400) Subject: Move borderInterpolate and copyMakeBorder documentation X-Git-Tag: accepted/tizen/6.0/unified/20201030.111113~3921^2 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=4846dcdfeb3172fdffb3c76ef8930ae1bb02a636;p=platform%2Fupstream%2Fopencv.git Move borderInterpolate and copyMakeBorder documentation --- diff --git a/modules/core/doc/operations_on_arrays.rst b/modules/core/doc/operations_on_arrays.rst index e31677d..61594dc 100644 --- a/modules/core/doc/operations_on_arrays.rst +++ b/modules/core/doc/operations_on_arrays.rst @@ -3498,3 +3498,101 @@ The function :ocv:func:`transpose` transposes the matrix ``src`` : \texttt{dst} (i,j) = \texttt{src} (j,i) .. note:: No complex conjugation is done in case of a complex matrix. It it should be done separately if needed. + + +borderInterpolate +----------------- +Computes the source location of an extrapolated pixel. + +.. ocv:function:: int borderInterpolate( int p, int len, int borderType ) + +.. ocv:pyfunction:: cv2.borderInterpolate(p, len, borderType) -> retval + + :param p: 0-based coordinate of the extrapolated pixel along one of the axes, + likely <0 or >= ``len`` . + + :param len: Length of the array along the corresponding axis. + + :param borderType: Border type, one of the ``BORDER_*`` , except for ``BORDER_TRANSPARENT`` + and ``BORDER_ISOLATED`` . When ``borderType==BORDER_CONSTANT`` , the + function always returns -1, regardless of ``p`` and ``len`` . + +The function computes and returns the coordinate of a donor pixel corresponding to the specified +extrapolated pixel when using the specified extrapolation border mode. For example, if you use +``BORDER_WRAP`` mode in the horizontal direction, ``BORDER_REFLECT_101`` in the vertical direction +and want to compute value of the "virtual" pixel ``Point(-5, 100)`` in a floating-point image +``img`` , it looks like: :: + + float val = img.at(borderInterpolate(100, img.rows, BORDER_REFLECT_101), + borderInterpolate(-5, img.cols, BORDER_WRAP)); + + +Normally, the function is not called directly. It is used inside :ocv:class:`FilterEngine` +and :ocv:func:`copyMakeBorder` to compute tables for quick extrapolation. + +.. seealso:: + + :ocv:class:`FilterEngine`, + :ocv:func:`copyMakeBorder` + + +copyMakeBorder +-------------- +Forms a border around an image. + +.. ocv:function:: void copyMakeBorder( InputArray src, OutputArray dst, int top, int bottom, int left, int right, int borderType, const Scalar& value=Scalar() ) + +.. ocv:pyfunction:: cv2.copyMakeBorder(src, top, bottom, left, right, borderType[, dst[, value]]) -> dst + + :param src: Source image. + + :param dst: Destination image of the same type as ``src`` and the + size ``Size(src.cols+left+right, src.rows+top+bottom)`` . + + :param top: + + :param bottom: + + :param left: + + :param right: Parameter specifying how many pixels in each direction from the source image + rectangle to extrapolate. For example, ``top=1, bottom=1, left=1, right=1`` + mean that 1 pixel-wide border needs to be built. + + :param borderType: Border type. See :ocv:func:`borderInterpolate` for details. + + :param value: Border value if ``borderType==BORDER_CONSTANT`` . + +The function copies the source image into the middle of the destination image. The areas to the +left, to the right, above and below the copied source image will be filled with extrapolated pixels. +This is not what :ocv:class:`FilterEngine` or filtering functions based on it do (they extrapolate +pixels on-fly), but what other more complex functions, including your own, may do to simplify image +boundary handling. + +The function supports the mode when ``src`` is already in the middle of ``dst`` . In this case, the +function does not copy ``src`` itself but simply constructs the border, for example: :: + + // let border be the same in all directions + int border=2; + // constructs a larger image to fit both the image and the border + Mat gray_buf(rgb.rows + border*2, rgb.cols + border*2, rgb.depth()); + // select the middle part of it w/o copying data + Mat gray(gray_canvas, Rect(border, border, rgb.cols, rgb.rows)); + // convert image from RGB to grayscale + cvtColor(rgb, gray, CV_RGB2GRAY); + // form a border in-place + copyMakeBorder(gray, gray_buf, border, border, + border, border, BORDER_REPLICATE); + // now do some custom filtering ... + ... + + +.. note:: + + When the source image is a part (ROI) of a bigger image, the function will try to use the pixels + outside of the ROI to form a border. To disable this feature and always do extrapolation, as if + ``src`` was not a ROI, use ``borderType | BORDER_ISOLATED``. + +.. seealso:: + + :ocv:func:`borderInterpolate` diff --git a/modules/imgproc/doc/filtering.rst b/modules/imgproc/doc/filtering.rst index 81a64bd..3e0bbb3 100755 --- a/modules/imgproc/doc/filtering.rst +++ b/modules/imgproc/doc/filtering.rst @@ -444,37 +444,6 @@ The call ``blur(src, dst, ksize, anchor, borderType)`` is equivalent to ``boxFil :ocv:func:`medianBlur` -borderInterpolate ------------------ -Computes the source location of an extrapolated pixel. - -.. ocv:function:: int borderInterpolate( int p, int len, int borderType ) - -.. ocv:pyfunction:: cv2.borderInterpolate(p, len, borderType) -> retval - - :param p: 0-based coordinate of the extrapolated pixel along one of the axes, likely <0 or >= ``len`` . - - :param len: Length of the array along the corresponding axis. - - :param borderType: Border type, one of the ``BORDER_*`` , except for ``BORDER_TRANSPARENT`` and ``BORDER_ISOLATED`` . When ``borderType==BORDER_CONSTANT`` , the function always returns -1, regardless of ``p`` and ``len`` . - -The function computes and returns the coordinate of a donor pixel corresponding to the specified extrapolated pixel when using the specified extrapolation border mode. For example, if you use ``BORDER_WRAP`` mode in the horizontal direction, ``BORDER_REFLECT_101`` in the vertical direction and want to compute value of the "virtual" pixel ``Point(-5, 100)`` in a floating-point image ``img`` , it looks like: :: - - float val = img.at(borderInterpolate(100, img.rows, BORDER_REFLECT_101), - borderInterpolate(-5, img.cols, BORDER_WRAP)); - - -Normally, the function is not called directly. It is used inside -:ocv:class:`FilterEngine` and -:ocv:func:`copyMakeBorder` to compute tables for quick extrapolation. - -.. seealso:: - - :ocv:class:`FilterEngine`, - :ocv:func:`copyMakeBorder` - - - boxFilter --------- Blurs an image using the box filter. @@ -537,63 +506,6 @@ The function constructs a vector of images and builds the Gaussian pyramid by re :ocv:func:`pyrDown` to the previously built pyramid layers, starting from ``dst[0]==src`` . - -copyMakeBorder --------------- -Forms a border around an image. - -.. ocv:function:: void copyMakeBorder( InputArray src, OutputArray dst, int top, int bottom, int left, int right, int borderType, const Scalar& value=Scalar() ) - -.. ocv:pyfunction:: cv2.copyMakeBorder(src, top, bottom, left, right, borderType[, dst[, value]]) -> dst - -.. ocv:cfunction:: void cvCopyMakeBorder( const CvArr* src, CvArr* dst, CvPoint offset, int bordertype, CvScalar value=cvScalarAll(0) ) -.. ocv:pyoldfunction:: cv.CopyMakeBorder(src, dst, offset, bordertype, value=(0, 0, 0, 0))-> None - - :param src: Source image. - - :param dst: Destination image of the same type as ``src`` and the size ``Size(src.cols+left+right, src.rows+top+bottom)`` . - - :param top: - - :param bottom: - - :param left: - - :param right: Parameter specifying how many pixels in each direction from the source image rectangle to extrapolate. For example, ``top=1, bottom=1, left=1, right=1`` mean that 1 pixel-wide border needs to be built. - - :param borderType: Border type. See :ocv:func:`borderInterpolate` for details. - - :param value: Border value if ``borderType==BORDER_CONSTANT`` . - -The function copies the source image into the middle of the destination image. The areas to the left, to the right, above and below the copied source image will be filled with extrapolated pixels. This is not what -:ocv:class:`FilterEngine` or filtering functions based on it do (they extrapolate pixels on-fly), but what other more complex functions, including your own, may do to simplify image boundary handling. - -The function supports the mode when ``src`` is already in the middle of ``dst`` . In this case, the function does not copy ``src`` itself but simply constructs the border, for example: :: - - // let border be the same in all directions - int border=2; - // constructs a larger image to fit both the image and the border - Mat gray_buf(rgb.rows + border*2, rgb.cols + border*2, rgb.depth()); - // select the middle part of it w/o copying data - Mat gray(gray_canvas, Rect(border, border, rgb.cols, rgb.rows)); - // convert image from RGB to grayscale - cvtColor(rgb, gray, CV_RGB2GRAY); - // form a border in-place - copyMakeBorder(gray, gray_buf, border, border, - border, border, BORDER_REPLICATE); - // now do some custom filtering ... - ... - - -.. note:: - - When the source image is a part (ROI) of a bigger image, the function will try to use the pixels outside of the ROI to form a border. To disable this feature and always do extrapolation, as if ``src`` was not a ROI, use ``borderType | BORDER_ISOLATED``. - -.. seealso:: - - :ocv:func:`borderInterpolate` - - createBoxFilter ------------------- Returns a box filter engine.