Merge pull request #2250 from dogod621:master

* Add pattern generator tool

* Fix help error

* Update readme

modules/aruco/misc/pattern_generator/README.md

+# OpenCVMarkerPrinter
+
+## Description
+This small app can save some commonly used opencv markers such as ArUco, ArUcoGrid, Chessboard and ChArUco to vector graphics file. **Supported vector graphics file format: .svg, .pdf and .ps.**
+
+<img src="./doc/images/MarkerPrinterGUI.jpg" height="160" />
+
+### Dependencies
+#### MarkerPrinter
+  * numpy
+  * PIL(Pillow, for image processing)
+  * cairo(for drawing vector graphic)
+  * cairosvg(for svg to png)
+
+#### MarkerPrinterGUI
+  * tkinter(for GUI)
+
+## Tutorial
+#### GUI
+```
+python MarkerPrinterGUI.py
+```
+
+You can switch ArUco, ArUcoGrid, Chessboard and ChArUco mode at the GUI tab, then you can select dictionary from the GUI menu and modify board shape, marker size, border width... etc. at the GUI entry, finally click the preview or save button to show the marker image on the GUI window or save it to file.
+
+#### Command-Line
+##### Print help
+```
+python MarkerPrinter.py
+```
+
+##### Print predefined dictionary list
+```
+python MarkerPrinter.py --list_dictionary
+```
+
+##### Save chessboard
+```
+python MarkerPrinter.py --chess --file "./chess.pdf" --size_x 16 --size_y 9 --square_length 0.09
+```
+
+##### Save ArUco
+```
+python MarkerPrinter.py --aruco --file "./aruco.pdf" --dictionary DICT_ARUCO_ORIGINAL --marker_length 0.07 --marker_id 0 --border_bits 1
+```
+
+##### Save ArUco Grid
+```
+python MarkerPrinter.py --aruco_grid --file "./aruco_grid.pdf" --dictionary DICT_ARUCO_ORIGINAL --size_x 16 --size_y 9 --marker_length 0.07 --marker_separation 0.02 --first_marker 0 --border_bits 1
+```
+
+##### Save ChArUco
+```
+python MarkerPrinter.py --charuco --file "./charuco.pdf" --dictionary DICT_ARUCO_ORIGINAL --size_x 16 --size_y 9 --square_length 0.09 --marker_length 0.07 --border_bits 1
+```
+
+## Useful Options:
+### Divde output to chunks
+If you are using consumer level printer, you will suffer from not able printing too large marker, so just set chunks shape at the GUI subSize entry before saving the marker to files, it will divide output marker to chunks. If you are using command-line interface, just add --sub_size_x x --sub_size_y y as parameters.
+
+### Page border
+If you are printing the image directly, you will need add page border to protect the marker, so just set page border at the GUI pageBorder entry before saving the marker to files. If you are using command-line interface, just add --page_border_x x --page_border_y y as parameters.
+
+### Generate aruco data:
+Although there is a built-in aruco dictionary data, but if you want to update the dictionary(If aruco update predefined dictionary list), just install opencv-python and opencv-contrib-python, and than run
+```
+python MarkerPrinter.py --generate arucoDictBytesList.npz
+```

modules/aruco/tutorials/table_of_content_aruco.markdown

@@ -11,6 +11,11 @@ Also, the ChArUco functionalities combine ArUco markers with traditional chessbo
 an easy and versatile corner detection. The module also includes the functions to detect
 ChArUco corners and use them for pose estimation and camera calibration.
 
+If you are going to print out the markers, an useful script/GUI tool is place at
+opencv_contrib/modules/aruco/misc/pattern_generator/ that can generate vector graphics
+of ArUco, ArUcoGrid and ChArUco boards. It can help you to print out the pattern with real size
+and without artifacts.
+
 -   @subpage tutorial_aruco_detection
 
     *Compatibility:* \> OpenCV 3.0