* doc: fix return parameter for void method

* docs: add missing parameter description

* added detection of inverted Markers, tests included

* corrections added, default preserved, identation, var, comment

Update code to take into account solvePnP and solvePnPRansac use InputOutputArray for rvec and tvec parameters.

* Fix spelling of perpectiveRemovePixelPerCell in struct docstring

* Fix spelling of perpectiveRemovePixelPerCell in detection tutorial

Add AprilTag dictionaries to be able to detect AprilTag markers. Add ArUco and AprilTag 2 citations.

Apriltag (#1570)

* doCornerRefinement to CornerRefinementMethod :: detected contours points are used to detect the corners

* some little corrections

* samples edited

* documented :)

* tabs corrected

* Docu corrections

* refinement for all candidates

* refinement for all candidates :: copy paste error corrected

* comment

* apriltag

* whitespace corrected

* corr ini

* correction :: warnings, c4244, preprocDirect, ...

* try to ignore 4244, fix 2131, add test, and ...

* try to ignore 4244

* test duplicate deleted

* corrected test, warnings

* test :: correction

* warnings

* warnings and test

* warnings

* perspective test, warning corrections

* warning a_q_t

* warning

* warning

* 3 clause BSD license

* stacksz and typo

* eliminate build warnings

- cv::fastAtan2()
- cvFloor()

* small code refactoring

* fix isfinite()

* get rid of manual calloc/free calls

* update file headers

* support custom dictionaries via python bindngs

* make markerSize and maxCorrectionBits writeable

new corner refinement method :: using the contour-lines (#973)

* doCornerRefinement to CornerRefinementMethod :: detected contours points are used to detect the corners

* some little corrections

* samples edited

* documented :)

* tabs corrected

* Docu corrections

* refinement for all candidates

* refinement for all candidates :: copy paste error corrected

* comment

aruco: make public the getBoardObjectAndImagePoints function (#1108)

* Made the private static getBoardObjectAndImagePoints function public to be used for calibration.

* Switched the arguments detectedIds and detectedCorners, and objPoints and imgPoints on getBoardObjectandImagePoints function for consistency with calibrateCamera and calibrateCameraAruco functions.

* Added the flag CV_EXPORTS_W to the getBoardObjectAndImagePoints function.

allows trading corner precision for corner quantity

also add shortcut if markers are aligned with image axes

type should be OutputArray instead of OutputArrayOfArrays.
at<Vec3d> is one dimensional. (fixes debug assert)
fixes #574

allows using Mat and vector<Vec3d> as argument for rvecs, tvecs that are
allocated at once.

also avoids manual memcpy: the predefined dictionary data is not
duplicated any more.