updated docs according to the last changes
authorIlya Lavrenov <ilya.lavrenov@itseez.com>
Thu, 9 Jan 2014 13:00:08 +0000 (17:00 +0400)
committerIlya Lavrenov <ilya.lavrenov@itseez.com>
Fri, 10 Jan 2014 14:19:26 +0000 (18:19 +0400)
cmake/OpenCVCompilerOptions.cmake~ [deleted file]
modules/stitching/doc/warpers.rst
modules/stitching/doc/warpers.rst~ [deleted file]

diff --git a/cmake/OpenCVCompilerOptions.cmake~ b/cmake/OpenCVCompilerOptions.cmake~
deleted file mode 100644 (file)
index 59b19b6..0000000
+++ /dev/null
@@ -1,308 +0,0 @@
-if(MINGW OR (X86 AND UNIX AND NOT APPLE))
-  # mingw compiler is known to produce unstable SSE code with -O3 hence we are trying to use -O2 instead
-  if(CMAKE_COMPILER_IS_GNUCXX)
-    foreach(flags CMAKE_CXX_FLAGS CMAKE_CXX_FLAGS_RELEASE CMAKE_CXX_FLAGS_DEBUG)
-      string(REPLACE "-O3" "-O2" ${flags} "${${flags}}")
-    endforeach()
-  endif()
-
-  if(CMAKE_COMPILER_IS_GNUCC)
-    foreach(flags CMAKE_C_FLAGS CMAKE_C_FLAGS_RELEASE CMAKE_C_FLAGS_DEBUG)
-      string(REPLACE "-O3" "-O2" ${flags} "${${flags}}")
-    endforeach()
-  endif()
-endif()
-
-if(MSVC)
-  string(REGEX REPLACE "^  *| * $" "" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
-  string(REGEX REPLACE "^  *| * $" "" CMAKE_CXX_FLAGS_INIT "${CMAKE_CXX_FLAGS_INIT}")
-  if(CMAKE_CXX_FLAGS STREQUAL CMAKE_CXX_FLAGS_INIT)
-    # override cmake default exception handling option
-    string(REPLACE "/EHsc" "/EHa" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}")
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}"  CACHE STRING "Flags used by the compiler during all build types." FORCE)
-  endif()
-endif()
-
-set(OPENCV_EXTRA_FLAGS "")
-set(OPENCV_EXTRA_C_FLAGS "")
-set(OPENCV_EXTRA_CXX_FLAGS "")
-set(OPENCV_EXTRA_FLAGS_RELEASE "")
-set(OPENCV_EXTRA_FLAGS_DEBUG "")
-set(OPENCV_EXTRA_EXE_LINKER_FLAGS "")
-set(OPENCV_EXTRA_EXE_LINKER_FLAGS_RELEASE "")
-set(OPENCV_EXTRA_EXE_LINKER_FLAGS_DEBUG "")
-
-macro(add_extra_compiler_option option)
-  if(CMAKE_BUILD_TYPE)
-    set(CMAKE_TRY_COMPILE_CONFIGURATION ${CMAKE_BUILD_TYPE})
-  endif()
-  ocv_check_flag_support(CXX "${option}" _varname "${OPENCV_EXTRA_CXX_FLAGS} ${ARGN}")
-  if(${_varname})
-    set(OPENCV_EXTRA_CXX_FLAGS "${OPENCV_EXTRA_CXX_FLAGS} ${option}")
-  endif()
-
-  ocv_check_flag_support(C "${option}" _varname "${OPENCV_EXTRA_C_FLAGS} ${ARGN}")
-  if(${_varname})
-    set(OPENCV_EXTRA_C_FLAGS "${OPENCV_EXTRA_C_FLAGS} ${option}")
-  endif()
-endmacro()
-
-# OpenCV fails some tests when 'char' is 'unsigned' by default
-add_extra_compiler_option(-fsigned-char)
-
-if(MINGW)
-  # http://gcc.gnu.org/bugzilla/show_bug.cgi?id=40838
-  # here we are trying to workaround the problem
-  add_extra_compiler_option(-mstackrealign)
-  if(NOT HAVE_CXX_MSTACKREALIGN)
-    add_extra_compiler_option(-mpreferred-stack-boundary=2)
-  endif()
-endif()
-
-if(CMAKE_COMPILER_IS_GNUCXX)
-  # High level of warnings.
-  add_extra_compiler_option(-W)
-  add_extra_compiler_option(-Wall)
-  add_extra_compiler_option(-Werror=return-type)
-  add_extra_compiler_option(-Werror=non-virtual-dtor)
-  add_extra_compiler_option(-Werror=address)
-  add_extra_compiler_option(-Werror=sequence-point)
-  add_extra_compiler_option(-Wformat)
-  add_extra_compiler_option(-Werror=format-security -Wformat)
-  add_extra_compiler_option(-Wmissing-declarations)
-  add_extra_compiler_option(-Wmissing-prototypes)
-  add_extra_compiler_option(-Wstrict-prototypes)
-  add_extra_compiler_option(-Wundef)
-  add_extra_compiler_option(-Winit-self)
-  add_extra_compiler_option(-Wpointer-arith)
-  add_extra_compiler_option(-Wshadow)
-  add_extra_compiler_option(-Wsign-promo)
-
-  if(ENABLE_NOISY_WARNINGS)
-    add_extra_compiler_option(-Wcast-align)
-    add_extra_compiler_option(-Wstrict-aliasing=2)
-  else()
-    add_extra_compiler_option(-Wno-narrowing)
-    add_extra_compiler_option(-Wno-delete-non-virtual-dtor)
-    add_extra_compiler_option(-Wno-unnamed-type-template-args)
-  endif()
-  add_extra_compiler_option(-fdiagnostics-show-option)
-
-  # The -Wno-long-long is required in 64bit systems when including sytem headers.
-  if(X86_64)
-    add_extra_compiler_option(-Wno-long-long)
-  endif()
-
-  # We need pthread's
-  if(UNIX AND NOT ANDROID AND NOT (APPLE AND CMAKE_COMPILER_IS_CLANGCXX))
-    add_extra_compiler_option(-pthread)
-  endif()
-
-  if(OPENCV_WARNINGS_ARE_ERRORS)
-    add_extra_compiler_option(-Werror)
-  endif()
-
-  if(X86 AND NOT MINGW64 AND NOT X86_64 AND NOT APPLE)
-    add_extra_compiler_option(-march=i686)
-  endif()
-
-  # Other optimizations
-  if(ENABLE_OMIT_FRAME_POINTER)
-    add_extra_compiler_option(-fomit-frame-pointer)
-  else()
-    add_extra_compiler_option(-fno-omit-frame-pointer)
-  endif()
-  if(ENABLE_FAST_MATH)
-    add_extra_compiler_option(-ffast-math)
-  endif()
-  if(ENABLE_POWERPC)
-    add_extra_compiler_option("-mcpu=G3 -mtune=G5")
-  endif()
-  if(ENABLE_SSE)
-    add_extra_compiler_option(-msse)
-  endif()
-  if(ENABLE_SSE2)
-    add_extra_compiler_option(-msse2)
-  endif()
-  if (ENABLE_NEON)
-    add_extra_compiler_option("-mfpu=neon")
-  endif()
-  if (ENABLE_VFPV3 AND NOT ENABLE_NEON)
-    add_extra_compiler_option("-mfpu=vfpv3")
-  endif()
-
-  # SSE3 and further should be disabled under MingW because it generates compiler errors
-  if(NOT MINGW)
-    if(ENABLE_AVX)
-      add_extra_compiler_option(-mavx)
-    endif()
-
-    # GCC depresses SSEx instructions when -mavx is used. Instead, it generates new AVX instructions or AVX equivalence for all SSEx instructions when needed.
-    if(NOT OPENCV_EXTRA_CXX_FLAGS MATCHES "-mavx")
-      if(ENABLE_SSE3)
-        add_extra_compiler_option(-msse3)
-      endif()
-
-      if(ENABLE_SSSE3)
-        add_extra_compiler_option(-mssse3)
-      endif()
-
-      if(ENABLE_SSE41)
-        add_extra_compiler_option(-msse4.1)
-      endif()
-
-      if(ENABLE_SSE42)
-        add_extra_compiler_option(-msse4.2)
-      endif()
-    endif()
-  endif(NOT MINGW)
-
-  if(X86 OR X86_64)
-    if(NOT APPLE AND CMAKE_SIZEOF_VOID_P EQUAL 4)
-      if(OPENCV_EXTRA_CXX_FLAGS MATCHES "-m(sse2|avx)")
-        add_extra_compiler_option(-mfpmath=sse)# !! important - be on the same wave with x64 compilers
-      else()
-        add_extra_compiler_option(-mfpmath=387)
-      endif()
-    endif()
-  endif()
-
-  if(ENABLE_NEON)
-    add_extra_compiler_option(-mfpu=neon)
-  endif()
-
-  # Profiling?
-  if(ENABLE_PROFILING)
-    add_extra_compiler_option("-pg -g")
-    # turn off incompatible options
-    foreach(flags CMAKE_CXX_FLAGS CMAKE_C_FLAGS CMAKE_CXX_FLAGS_RELEASE CMAKE_C_FLAGS_RELEASE CMAKE_CXX_FLAGS_DEBUG CMAKE_C_FLAGS_DEBUG
-                  OPENCV_EXTRA_FLAGS_RELEASE OPENCV_EXTRA_FLAGS_DEBUG OPENCV_EXTRA_C_FLAGS OPENCV_EXTRA_CXX_FLAGS)
-      string(REPLACE "-fomit-frame-pointer" "" ${flags} "${${flags}}")
-      string(REPLACE "-ffunction-sections" "" ${flags} "${${flags}}")
-    endforeach()
-  elseif(NOT APPLE AND NOT ANDROID)
-    # Remove unreferenced functions: function level linking
-    add_extra_compiler_option(-ffunction-sections)
-  endif()
-
-  set(OPENCV_EXTRA_FLAGS_RELEASE "${OPENCV_EXTRA_FLAGS_RELEASE} -DNDEBUG")
-  set(OPENCV_EXTRA_FLAGS_DEBUG "${OPENCV_EXTRA_FLAGS_DEBUG} -O0 -DDEBUG -D_DEBUG")
-endif()
-
-if(MSVC)
-  set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /D _CRT_SECURE_NO_DEPRECATE /D _CRT_NONSTDC_NO_DEPRECATE /D _SCL_SECURE_NO_WARNINGS")
-  # 64-bit portability warnings, in MSVC80
-  if(MSVC80)
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /Wp64")
-  endif()
-
-  if(BUILD_WITH_DEBUG_INFO)
-    set(OPENCV_EXTRA_EXE_LINKER_FLAGS_RELEASE "${OPENCV_EXTRA_EXE_LINKER_FLAGS_RELEASE} /debug")
-  endif()
-
-  # Remove unreferenced functions: function level linking
-  set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /Gy")
-  if(NOT MSVC_VERSION LESS 1400)
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /bigobj")
-  endif()
-  if(BUILD_WITH_DEBUG_INFO)
-    set(OPENCV_EXTRA_FLAGS_RELEASE "${OPENCV_EXTRA_FLAGS_RELEASE} /Zi")
-  endif()
-
-  if(ENABLE_AVX AND NOT MSVC_VERSION LESS 1600)
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /arch:AVX")
-  endif()
-
-  if(ENABLE_SSE4_1 AND CV_ICC AND NOT OPENCV_EXTRA_FLAGS MATCHES "/arch:")
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /arch:SSE4.1")
-  endif()
-
-  if(ENABLE_SSE3 AND CV_ICC AND NOT OPENCV_EXTRA_FLAGS MATCHES "/arch:")
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /arch:SSE3")
-  endif()
-
-  if(NOT MSVC64)
-    # 64-bit MSVC compiler uses SSE/SSE2 by default
-    if(ENABLE_SSE2 AND NOT OPENCV_EXTRA_FLAGS MATCHES "/arch:")
-      set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /arch:SSE2")
-    endif()
-    if(ENABLE_SSE AND NOT OPENCV_EXTRA_FLAGS MATCHES "/arch:")
-      set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /arch:SSE")
-    endif()
-  endif()
-
-  if(ENABLE_SSE OR ENABLE_SSE2 OR ENABLE_SSE3 OR ENABLE_SSE4_1 OR ENABLE_AVX)
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /Oi")
-  endif()
-
-  if(X86 OR X86_64)
-    if(CMAKE_SIZEOF_VOID_P EQUAL 4 AND ENABLE_SSE2)
-      set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /fp:fast") # !! important - be on the same wave with x64 compilers
-    endif()
-  endif()
-
-  if(OPENCV_WARNINGS_ARE_ERRORS)
-    set(OPENCV_EXTRA_FLAGS "${OPENCV_EXTRA_FLAGS} /WX")
-  endif()
-endif()
-
-# Extra link libs if the user selects building static libs:
-if(NOT BUILD_SHARED_LIBS AND CMAKE_COMPILER_IS_GNUCXX AND NOT ANDROID)
-  # Android does not need these settings because they are already set by toolchain file
-  set(OPENCV_LINKER_LIBS ${OPENCV_LINKER_LIBS} stdc++)
-  set(OPENCV_EXTRA_FLAGS "-fPIC ${OPENCV_EXTRA_FLAGS}")
-endif()
-
-# Add user supplied extra options (optimization, etc...)
-# ==========================================================
-set(OPENCV_EXTRA_FLAGS         "${OPENCV_EXTRA_FLAGS}"         CACHE INTERNAL "Extra compiler options")
-set(OPENCV_EXTRA_C_FLAGS       "${OPENCV_EXTRA_C_FLAGS}"       CACHE INTERNAL "Extra compiler options for C sources")
-set(OPENCV_EXTRA_CXX_FLAGS     "${OPENCV_EXTRA_CXX_FLAGS}"     CACHE INTERNAL "Extra compiler options for C++ sources")
-set(OPENCV_EXTRA_FLAGS_RELEASE "${OPENCV_EXTRA_FLAGS_RELEASE}" CACHE INTERNAL "Extra compiler options for Release build")
-set(OPENCV_EXTRA_FLAGS_DEBUG   "${OPENCV_EXTRA_FLAGS_DEBUG}"   CACHE INTERNAL "Extra compiler options for Debug build")
-set(OPENCV_EXTRA_EXE_LINKER_FLAGS         "${OPENCV_EXTRA_EXE_LINKER_FLAGS}"         CACHE INTERNAL "Extra linker flags")
-set(OPENCV_EXTRA_EXE_LINKER_FLAGS_RELEASE "${OPENCV_EXTRA_EXE_LINKER_FLAGS_RELEASE}" CACHE INTERNAL "Extra linker flags for Release build")
-set(OPENCV_EXTRA_EXE_LINKER_FLAGS_DEBUG   "${OPENCV_EXTRA_EXE_LINKER_FLAGS_DEBUG}"   CACHE INTERNAL "Extra linker flags for Debug build")
-
-# set default visibility to hidden
-if(CMAKE_COMPILER_IS_GNUCXX AND CMAKE_OPENCV_GCC_VERSION_NUM GREATER 399)
-  add_extra_compiler_option(-fvisibility=hidden)
-  add_extra_compiler_option(-fvisibility-inlines-hidden)
-endif()
-
-#combine all "extra" options
-set(CMAKE_C_FLAGS           "${CMAKE_C_FLAGS} ${OPENCV_EXTRA_FLAGS} ${OPENCV_EXTRA_C_FLAGS}")
-set(CMAKE_CXX_FLAGS         "${CMAKE_CXX_FLAGS} ${OPENCV_EXTRA_FLAGS} ${OPENCV_EXTRA_CXX_FLAGS}")
-set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} ${OPENCV_EXTRA_FLAGS_RELEASE}")
-set(CMAKE_C_FLAGS_RELEASE   "${CMAKE_C_FLAGS_RELEASE} ${OPENCV_EXTRA_FLAGS_RELEASE}")
-set(CMAKE_CXX_FLAGS_DEBUG   "${CMAKE_CXX_FLAGS_DEBUG} ${OPENCV_EXTRA_FLAGS_DEBUG}")
-set(CMAKE_C_FLAGS_DEBUG     "${CMAKE_C_FLAGS_DEBUG} ${OPENCV_EXTRA_FLAGS_DEBUG}")
-set(CMAKE_EXE_LINKER_FLAGS         "${CMAKE_EXE_LINKER_FLAGS} ${OPENCV_EXTRA_EXE_LINKER_FLAGS}")
-set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} ${OPENCV_EXTRA_EXE_LINKER_FLAGS_RELEASE}")
-set(CMAKE_EXE_LINKER_FLAGS_DEBUG   "${CMAKE_EXE_LINKER_FLAGS_DEBUG} ${OPENCV_EXTRA_EXE_LINKER_FLAGS_DEBUG}")
-
-if(MSVC)
-  # avoid warnings from MSVC about overriding the /W* option
-  # we replace /W3 with /W4 only for C++ files,
-  # since all the 3rd-party libraries OpenCV uses are in C,
-  # and we do not care about their warnings.
-  string(REPLACE "/W3" "/W4" CMAKE_CXX_FLAGS         "${CMAKE_CXX_FLAGS}")
-  string(REPLACE "/W3" "/W4" CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE}")
-  string(REPLACE "/W3" "/W4" CMAKE_CXX_FLAGS_DEBUG   "${CMAKE_CXX_FLAGS_DEBUG}")
-
-  if(NOT ENABLE_NOISY_WARNINGS AND MSVC_VERSION EQUAL 1400)
-    ocv_warnings_disable(CMAKE_CXX_FLAGS /wd4510 /wd4610 /wd4312 /wd4201 /wd4244 /wd4328 /wd4267)
-  endif()
-
-  # allow extern "C" functions throw exceptions
-  foreach(flags CMAKE_C_FLAGS CMAKE_C_FLAGS_RELEASE CMAKE_C_FLAGS_RELEASE CMAKE_CXX_FLAGS CMAKE_CXX_FLAGS_RELEASE CMAKE_CXX_FLAGS_DEBUG)
-    string(REPLACE "/EHsc-" "/EHs" ${flags} "${${flags}}")
-    string(REPLACE "/EHsc"  "/EHs" ${flags} "${${flags}}")
-
-    string(REPLACE "/Zm1000" "" ${flags} "${${flags}}")
-  endforeach()
-
-  if(NOT ENABLE_NOISY_WARNINGS)
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /wd4251") #class 'std::XXX' needs to have dll-interface to be used by clients of YYY
-  endif()
-endif()
index 1025ffa..278020f 100644 (file)
@@ -14,17 +14,17 @@ Rotation-only model image warper interface. ::
     public:
         virtual ~RotationWarper() {}
 
-        virtual Point2f warpPoint(const Point2f &pt, const Mat &K, const Mat &R) = 0;
+        virtual Point2f warpPoint(const Point2f &pt, InputArray K, InputArray R) = 0;
 
-        virtual Rect buildMaps(Size src_size, const Mat &K, const Mat &R, Mat &xmap, Mat &ymap) = 0;
+        virtual Rect buildMaps(Size src_size, InputArray K, InputArray R, OutputArray xmap, OutputArray ymap) = 0;
 
-        virtual Point warp(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                           Mat &dst) = 0;
+        virtual Point warp(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
+                           OutputArray dst) = 0;
 
-        virtual void warpBackward(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                                  Size dst_size, Mat &dst) = 0;
+        virtual void warpBackward(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
+                                  Size dst_size, OutputArray dst) = 0;
 
-        virtual Rect warpRoi(Size src_size, const Mat &K, const Mat &R) = 0;
+        virtual Rect warpRoi(Size src_size, InputArray K, InputArray R) = 0;
     };
 
 detail::RotationWarper::warpPoint
@@ -32,7 +32,7 @@ detail::RotationWarper::warpPoint
 
 Projects the image point.
 
-.. ocv:function:: Point2f detail::RotationWarper::warpPoint(const Point2f &pt, const Mat &K, const Mat &R)
+.. ocv:function:: Point2f detail::RotationWarper::warpPoint(const Point2f &pt, InputArray K, InputArray R)
 
     :param pt: Source point
 
@@ -47,7 +47,7 @@ detail::RotationWarper::buildMaps
 
 Builds the projection maps according to the given camera data.
 
-.. ocv:function:: Rect detail::RotationWarper::buildMaps(Size src_size, const Mat &K, const Mat &R, Mat &xmap, Mat &ymap)
+.. ocv:function:: Rect detail::RotationWarper::buildMaps(Size src_size, InputArray K, InputArray R, OutputArray xmap, OutputArray ymap)
 
     :param src_size: Source image size
 
@@ -66,7 +66,7 @@ detail::RotationWarper::warp
 
 Projects the image.
 
-.. ocv:function:: Point detail::RotationWarper::warp(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode, Mat &dst)
+.. ocv:function:: Point detail::RotationWarper::warp(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode, OutputArray dst)
 
     :param src: Source image
 
@@ -87,7 +87,7 @@ detail::RotationWarper::warpBackward
 
 Projects the image backward.
 
-.. ocv:function:: void detail::RotationWarper::warpBackward(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode, Size dst_size, Mat &dst)
+.. ocv:function:: void detail::RotationWarper::warpBackward(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode, Size dst_size, OutputArray dst)
 
     :param src: Projected image
 
@@ -106,7 +106,7 @@ Projects the image backward.
 detail::RotationWarper::warpRoi
 -------------------------------
 
-.. ocv:function:: Rect detail::RotationWarper::warpRoi(Size src_size, const Mat &K, const Mat &R)
+.. ocv:function:: Rect detail::RotationWarper::warpRoi(Size src_size, InputArray K, InputArray R)
 
     :param src_size: Source image bounding box
 
@@ -124,9 +124,9 @@ Base class for warping logic implementation. ::
 
     struct CV_EXPORTS ProjectorBase
     {
-        void setCameraParams(const Mat &K = Mat::eye(3, 3, CV_32F),
-                            const Mat &R = Mat::eye(3, 3, CV_32F),
-                            const Mat &T = Mat::zeros(3, 1, CV_32F));
+        void setCameraParams(InputArray K = Mat::eye(3, 3, CV_32F),
+                            InputArray R = Mat::eye(3, 3, CV_32F),
+                            InputArray T = Mat::zeros(3, 1, CV_32F));
 
         float scale;
         float k[9];
@@ -146,17 +146,17 @@ Base class for rotation-based warper using a `detail::ProjectorBase`_ derived cl
     class CV_EXPORTS RotationWarperBase : public RotationWarper
     {
     public:
-        Point2f warpPoint(const Point2f &pt, const Mat &K, const Mat &R);
+        Point2f warpPoint(const Point2f &pt, InputArray K, InputArray R);
 
-        Rect buildMaps(Size src_size, const Mat &K, const Mat &R, Mat &xmap, Mat &ymap);
+        Rect buildMaps(Size src_size, InputArray K, InputArray R, OutputArray xmap, OutputArray ymap);
 
-        Point warp(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                Mat &dst);
+        Point warp(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
+                OutputArray dst);
 
-        void warpBackward(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                        Size dst_size, Mat &dst);
+        void warpBackward(InputArray src, InputArray K, InputArray R, int interp_mode, int border_mode,
+                        Size dst_size, OutputArray dst);
 
-        Rect warpRoi(Size src_size, const Mat &K, const Mat &R);
+        Rect warpRoi(Size src_size, InputArray K, InputArray R);
 
     protected:
 
@@ -183,14 +183,14 @@ Warper that maps an image onto the z = 1 plane. ::
 
         void setScale(float scale) { projector_.scale = scale; }
 
-        Point2f warpPoint(const Point2f &pt, const Mat &K, const Mat &R, const Mat &T);
+        Point2f warpPoint(const Point2f &pt, InputArray K, InputArray R, InputArray T);
 
-        Rect buildMaps(Size src_size, const Mat &K, const Mat &R, const Mat &T, Mat &xmap, Mat &ymap);
+        Rect buildMaps(Size src_size, InputArray K, InputArray R, InputArray T, OutputArray xmap, OutputArray ymap);
 
-        Point warp(const Mat &src, const Mat &K, const Mat &R, const Mat &T, int interp_mode, int border_mode,
-                   Mat &dst);
+        Point warp(InputArray src, InputArray K, InputArray R, InputArray T, int interp_mode, int border_mode,
+                   OutputArray dst);
 
-        Rect warpRoi(Size src_size, const Mat &K, const Mat &R, const Mat &T);
+        Rect warpRoi(Size src_size, InputArray K, InputArray R, InputArray T);
 
     protected:
         void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
diff --git a/modules/stitching/doc/warpers.rst~ b/modules/stitching/doc/warpers.rst~
deleted file mode 100644 (file)
index 1025ffa..0000000
+++ /dev/null
@@ -1,263 +0,0 @@
-Images Warping
-==============
-
-.. highlight:: cpp
-
-detail::RotationWarper
-----------------------
-.. ocv:class:: detail::RotationWarper
-
-Rotation-only model image warper interface. ::
-
-    class CV_EXPORTS RotationWarper
-    {
-    public:
-        virtual ~RotationWarper() {}
-
-        virtual Point2f warpPoint(const Point2f &pt, const Mat &K, const Mat &R) = 0;
-
-        virtual Rect buildMaps(Size src_size, const Mat &K, const Mat &R, Mat &xmap, Mat &ymap) = 0;
-
-        virtual Point warp(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                           Mat &dst) = 0;
-
-        virtual void warpBackward(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                                  Size dst_size, Mat &dst) = 0;
-
-        virtual Rect warpRoi(Size src_size, const Mat &K, const Mat &R) = 0;
-    };
-
-detail::RotationWarper::warpPoint
----------------------------------
-
-Projects the image point.
-
-.. ocv:function:: Point2f detail::RotationWarper::warpPoint(const Point2f &pt, const Mat &K, const Mat &R)
-
-    :param pt: Source point
-
-    :param K: Camera intrinsic parameters
-
-    :param R: Camera rotation matrix
-
-    :return: Projected point
-
-detail::RotationWarper::buildMaps
----------------------------------
-
-Builds the projection maps according to the given camera data.
-
-.. ocv:function:: Rect detail::RotationWarper::buildMaps(Size src_size, const Mat &K, const Mat &R, Mat &xmap, Mat &ymap)
-
-    :param src_size: Source image size
-
-    :param K: Camera intrinsic parameters
-
-    :param R: Camera rotation matrix
-
-    :param xmap: Projection map for the x axis
-
-    :param ymap: Projection map for the y axis
-
-    :return: Projected image minimum bounding box
-
-detail::RotationWarper::warp
-----------------------------
-
-Projects the image.
-
-.. ocv:function:: Point detail::RotationWarper::warp(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode, Mat &dst)
-
-    :param src: Source image
-
-    :param K: Camera intrinsic parameters
-
-    :param R: Camera rotation matrix
-
-    :param interp_mode: Interpolation mode
-
-    :param border_mode: Border extrapolation mode
-
-    :param dst: Projected image
-
-    :return: Project image top-left corner
-
-detail::RotationWarper::warpBackward
-------------------------------------
-
-Projects the image backward.
-
-.. ocv:function:: void detail::RotationWarper::warpBackward(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode, Size dst_size, Mat &dst)
-
-    :param src: Projected image
-
-    :param K: Camera intrinsic parameters
-
-    :param R: Camera rotation matrix
-
-    :param interp_mode: Interpolation mode
-
-    :param border_mode: Border extrapolation mode
-
-    :param dst_size: Backward-projected image size
-
-    :param dst: Backward-projected image
-
-detail::RotationWarper::warpRoi
--------------------------------
-
-.. ocv:function:: Rect detail::RotationWarper::warpRoi(Size src_size, const Mat &K, const Mat &R)
-
-    :param src_size: Source image bounding box
-
-    :param K: Camera intrinsic parameters
-
-    :param R: Camera rotation matrix
-
-    :return: Projected image minimum bounding box
-
-detail::ProjectorBase
----------------------
-.. ocv:struct:: detail::ProjectorBase
-
-Base class for warping logic implementation. ::
-
-    struct CV_EXPORTS ProjectorBase
-    {
-        void setCameraParams(const Mat &K = Mat::eye(3, 3, CV_32F),
-                            const Mat &R = Mat::eye(3, 3, CV_32F),
-                            const Mat &T = Mat::zeros(3, 1, CV_32F));
-
-        float scale;
-        float k[9];
-        float rinv[9];
-        float r_kinv[9];
-        float k_rinv[9];
-        float t[3];
-    };
-
-detail::RotationWarperBase
---------------------------
-.. ocv:class:: detail::RotationWarperBase
-
-Base class for rotation-based warper using a `detail::ProjectorBase`_ derived class. ::
-
-    template <class P>
-    class CV_EXPORTS RotationWarperBase : public RotationWarper
-    {
-    public:
-        Point2f warpPoint(const Point2f &pt, const Mat &K, const Mat &R);
-
-        Rect buildMaps(Size src_size, const Mat &K, const Mat &R, Mat &xmap, Mat &ymap);
-
-        Point warp(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                Mat &dst);
-
-        void warpBackward(const Mat &src, const Mat &K, const Mat &R, int interp_mode, int border_mode,
-                        Size dst_size, Mat &dst);
-
-        Rect warpRoi(Size src_size, const Mat &K, const Mat &R);
-
-    protected:
-
-        // Detects ROI of the destination image. It's correct for any projection.
-        virtual void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
-
-        // Detects ROI of the destination image by walking over image border.
-        // Correctness for any projection isn't guaranteed.
-        void detectResultRoiByBorder(Size src_size, Point &dst_tl, Point &dst_br);
-
-        P projector_;
-    };
-
-detail::PlaneWarper
--------------------
-.. ocv:class:: detail::PlaneWarper : public detail::RotationWarperBase<PlaneProjector>
-
-Warper that maps an image onto the z = 1 plane. ::
-
-    class CV_EXPORTS PlaneWarper : public RotationWarperBase<PlaneProjector>
-    {
-    public:
-        PlaneWarper(float scale = 1.f) { projector_.scale = scale; }
-
-        void setScale(float scale) { projector_.scale = scale; }
-
-        Point2f warpPoint(const Point2f &pt, const Mat &K, const Mat &R, const Mat &T);
-
-        Rect buildMaps(Size src_size, const Mat &K, const Mat &R, const Mat &T, Mat &xmap, Mat &ymap);
-
-        Point warp(const Mat &src, const Mat &K, const Mat &R, const Mat &T, int interp_mode, int border_mode,
-                   Mat &dst);
-
-        Rect warpRoi(Size src_size, const Mat &K, const Mat &R, const Mat &T);
-
-    protected:
-        void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
-    };
-
-.. seealso:: :ocv:class:`detail::RotationWarper`
-
-detail::PlaneWarper::PlaneWarper
---------------------------------
-
-Construct an instance of the plane warper class.
-
-.. ocv:function:: void detail::PlaneWarper::PlaneWarper(float scale = 1.f)
-
-    :param scale: Projected image scale multiplier
-
-detail::SphericalWarper
------------------------
-.. ocv:class:: detail::SphericalWarper : public detail::RotationWarperBase<SphericalProjector>
-
-Warper that maps an image onto the unit sphere located at the origin. ::
-
-    class CV_EXPORTS SphericalWarper : public RotationWarperBase<SphericalProjector>
-    {
-    public:
-        SphericalWarper(float scale) { projector_.scale = scale; }
-
-    protected:
-        void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br);
-    };
-
-.. seealso:: :ocv:class:`detail::RotationWarper`
-
-detail::SphericalWarper::SphericalWarper
-----------------------------------------
-
-Construct an instance of the spherical warper class.
-
-.. ocv:function:: void detail::SphericalWarper::SphericalWarper(float scale)
-
-    :param scale: Projected image scale multiplier
-
-detail::CylindricalWarper
--------------------------
-.. ocv:class:: detail::CylindricalWarper : public detail::RotationWarperBase<CylindricalProjector>
-
-Warper that maps an image onto the x*x + z*z = 1 cylinder. ::
-
-    class CV_EXPORTS CylindricalWarper : public RotationWarperBase<CylindricalProjector>
-    {
-    public:
-        CylindricalWarper(float scale) { projector_.scale = scale; }
-
-    protected:
-        void detectResultRoi(Size src_size, Point &dst_tl, Point &dst_br)
-        {
-            RotationWarperBase<CylindricalProjector>::detectResultRoiByBorder(src_size, dst_tl, dst_br);
-        }
-    };
-
-.. seealso:: :ocv:class:`detail::RotationWarper`
-
-detail::CylindricalWarper::CylindricalWarper
---------------------------------------------
-
-Construct an instance of the cylindrical warper class.
-
-.. ocv:function:: void detail::CylindricalWarper::CylindricalWarper(float scale)
-
-    :param scale: Projected image scale multiplier