Fix the documentation for Mat::diag(int). (#8199)

* Fix the documentation for Mat::diag(int).

Fix issue #8181

* Fix the documentation for Mat::diag(int).

Fix issue #8181.

* Add support for printing out cv::Complex.

* Remove extra spaces.

* cv::Complex is submitted as a new pull request.

Merge pull request #8203 from alalek:ocl_kernelarg_validate

Merge pull request #8214 from jinay1991:patch-1

Update ocl.cpp function Device::OpenCLVersion()

Instead of CL_DEVICE_EXTENSIONS in Querying OpenCLVersion, it should be CL_DEVICE_VERSION flag which needs to be passed to the function.

Merge pull request #8211 from csukuangfj:csukuangfj-patch-3

Merge pull request #8210 from alalek:fix_mkl_link

Merge pull request #8131 from atinfinity:170205-add_dense_flow_sample

Merge pull request #8153 from Sejsel:patch-1

Merge pull request #8208 from csukuangfj:complex_support

Add support for printing out cv::Complex. (#8208)

* Add support for printing out cv::Complex.

* Conform to the format of std::complex.

* Remove extra spaces.

* Remove extra spaces.

Merge pull request #8209 from csukuangfj:csukuangfj-patch-2

Change the argument type to cl_platform_info.

Although both `cl_platform_info` and `cl_device_info` are defined as macro `cl_uint`, it needs to use `cl_platform_info` to get
the platform information.

Merge pull request #8206 from paroj:cast

cmake: fix order of MKL libraries, don't pass additional libraries as modules

Fix typos.

add missing casts to _Tp as determinant() always returns double

ocl: validate arguments in KernelArgs constructor

- don't use undefined flag=0. It should be CONSTANT instead.
- don't allow 'UMat* m=NULL' argument (except LOCAL/CONSTANT flags).
  This case is not handled well to provide NULL __global pointers.
  It is better to use '-D' macro defines instead (at least for performance)

Merge pull request #8160 from ilijapuaca:master

Merge pull request #8186 from Kronopath:patch-1

Merge pull request #8176 from alalek:cmake_cleanup_msvc_checks

Merge pull request #8175 from alalek:cmake_cleanup_defines

Merge pull request #8197 from csukuangfj/csukuangfj-patch-1

Fix typos in the documentation for AutoBuffer. (#8197)

* Allocate 1000 floats to match the documentation

Fix the documentation of `AutoBuffer`. By default, the following code
```.cpp
cv::AutoBuffer<float> m;
````
allocates only 264 floats. But the comment in the demonstration code says it allocates 1000 floats, which is
not correct.

* fix typo in the comment.

refactoring

refactoring

fixed indent

added option to specify flow type

Work around CMake bug that mangles install dir

CMake has a long-standing bug/feature (see [here](https://cmake.org/pipermail/cmake/2015-March/060204.html) and reply [here](https://cmake.org/pipermail/cmake/2015-March/060209.html)) which can mangle certain path variables by attempting to make them into relative paths if you try to set them with CACHE PATH.

Say you have your OpenCV download at `/path/on/my/computer/to/opencv/`. What actually happens is that if you try to set this variable by invoking CMAKE with `-DCMAKE_INSTALL_PREFIX=/my/desired/install/path`, what you end up is *not* `/usr/local/` and *not* `my/desired/install/path`, but instead, this monstrosity: `/path/on/my/computer/to/opencv/src/OpenCV-build//my/desired/install/path`.

That is, CMake attempts, for some reason, to turn the path that you passed into a path relative to `${CMAKE_BINARY_DIR}`. See the links I posted above: this is a known (and apparently unfixable) issue with CMake.

In OpenCV's case, among other potential issues, this leads to broken paths in `opencv_tests_config.hpp`, which can break the build or cause bizarre behaviour.

The fix for this issue, as stated in my links above, is to test that the variable hasn't been set yet with an `if(NOT DEFINED ...)` before attempting to set it. This is what I've implemented here. I admit I don't know enough about OpenCV's internals to know whether you *really* need to force the install to be in `/usr/local`, but as it stands right now you get *neither* a clean `/usr/local` path *nor* a customized `/my/desired/install/path`, but a broken mess. This change at least allows the user to customize their install directory.

In the meantime, there's a workaround for this, by explicitly defining the variable as a path with `-DCMAKE_INSTALL_PREFIX:PATH=my/desired/install/path`. But if this change can save anyone else the hours of headaches that I had today, I'll be happy.

Merge pull request #8165 from AdeelH:master

cmake: cleanup MSVC checks

cmake: cleanup unused defines

Merge pull request #8150 from cclauss/patch-1

cv2.findContours() no longer modifies source image (#8150)

* cv2.findContours() no longer modifies source image

Since OpenCV 3.2, cv2.findContours() no longer modifies the source image but returns a modified image as the first of three return parameters.  ??? Do I have that correct ???

Also fixed up the code blocks to be valid markdown.

* ```python --> @code{.py}

Enables syntax highlighting in docs.

Updated version of libwebp to 0.6.0. Removed iOS from build exceptions for libwebp

Merge pull request #8159 from alalek:fix_8158

update fix for #8105 (compiling with mingw32)

taken from https://github.com/google/googletest/pull/856

core: fix String::end() implementation

Fixed two typos in the Filter2D tutorial

Merge pull request #8134 from chrizandr:doc_typo

Merge pull request #7904 from paroj:initmapfc2

Merge pull request #7910 from StevenPuttemans:add_visapp2017_contribution

Merge pull request #8140 from StevenPuttemans:fix_gdal_driver_4channel_16bit

enable processing of 16, 32 and 64 bit 4 channel data using GDAL1.2

Merge pull request #8125 from terfendail:ovxhal_integral_fix

Merge pull request #8137 from LaurentBerger:thresholdDoc

Solve issue 8136 opencv doc of threshold

Add note about OTSU and TRIANGLE (comment sovrasov)

Solve issue 8136 opencv doc of threshold

Merge pull request #8133 from StevenPuttemans:add_detectMultiScale_notice

Corrected typo in py_histogram_begins tutorial

Merge pull request #8132 from tonytheodore:highgui-gl

Merge pull request #8128 from LaurentBerger:MatrixExpressions

Add a link to MatExpr in Detailed Description of Mat

Merge pull request #8123 from msk-repo01:master

Merge pull request #8107 from reunanen:fix8093

add explanation to detectMultiScale overload functionality

highgui: use forward slash for gl.h include

The backslash causes build failure when cross-compiling with mingw-w64

added dense flow sample

Add a link to MatExpr in Detailed Description of Mat

Fixed addressing structure population for integral image output

Merge pull request #8084 from mshabunin:libstdcplusplus-debug

Fix for opencv/opencv#8105 (compiling with mingw32)

fix for opencv/opencv#8105, compilation issue with mingw32 (in
google/googletest#721 a similar issue was solved and the reason was
described as MinGW defines _CRITICAL_SECTION and _RTL_CRITICAL_SECTION
as two separate (equivalent) structs, instead of using typedef)

Merge pull request #8112 from PkLab:Fix_7898

CoInitialize/CoUninitialize in VFW classes (#8112)

Merge pull request #8114 from lupustr3:pvlasov/ipp_python_export

Adds IPP control functions to bindings export

Merge pull request #8078 from tomoaki0705:universalIntrinsicLapack

Merge pull request #8109 from lupustr3:pvlasov/ipp_build_fix

Fixes IPP build on linux;

Fix #8093: CV_DbgAssert that the result of area() fits in the return value

Merge pull request #8081 from mshabunin:fix-kmeans-compactness

Enable GNU STL debug mode for debug builds

Merge pull request #8077 from sovrasov:mog2_docs_update

Merge pull request #8103 from sovrasov:em_docs_update

KMeans improvement

- fixed returned compactness value
- added centers drawing to the example app
- added compactness test

use universal intrinsic in VBLAS
 - brush up v_reduce_sum of SSE version

ml::EM: add documentation for predict() method

Merge pull request #8098 from chrizandr:Tree_load_Wrapper

Add wrappers for load functions for DTrees and Boost classifiers

Merge pull request #8082 from PkLab:fix_videoio_doc

Merge pull request #8089 from hrnr:estimate_convert_fix

fix wrong conversion in estimateAffine2D* functions

Merge pull request #8099 from chrizandr:ML_Wrappers

Wrappers for load methods of EM, LR, SVMSGD and Normal Bayes Classifier

Merge pull request #8088 from paroj:vtkfix

Wrappers for load methods of EM, LR, SVMSGD and Normal Bayes Classifier

Add wrappers for load functions for DTrees and Boost classifiers

Merge pull request #8085 from tomoaki0705:checkSse2

add test for convertions in estimateAffine2D* functions

test with integer points to cover conversion bugs.

fix conversion bug in estimateAffine2D* functions

functions support points to have other datatypes than floats.

* fix bug in coversion that overwrites src points with dst points

viz: fix compilation - we need the VTK includes before ocv_define_module

check correct flag

Merge pull request #8080 from alalek:fix_8079

Fix misplaced description CAP_PROP_SETTINGS and others minor changes in videoio doc

build: workaround for missing _mm256_setr_m128 in GCC

Merge pull request #8076 from tomoaki0705:brushupAvxPopcount

Clarify docs for MOG2::apply

brush up AVX optimization in popcount
 - make sure SIMD optimization works even when AVX is not available

Merge pull request #8074 from alalek:fix_java_tests

java: force 64F in solvePnP test

Merge pull request #8072 from tomoaki0705:AVXcorner

Merge pull request #8071 from tomoaki0705:imgprocRemoveRedundantCheck

Merge pull request #8061 from tomoaki0705:universalIntrinsicStereoCalib3d

Merge pull request #8062 from mshabunin:add-cv_deprecated

optimize corner detection series using AVX instructions
 - make sure SSE version will be still available for backward compatibility

remove pure SSE part

Merge pull request #8068 from catree:thrust_tutorial

Merge pull request #8044 from alalek:opencv_world_with_contrib

Merge pull request #8060 from Legoless:master