From 1a0dc73d98fdbe0d45523ca3ac914928b0ae775a Mon Sep 17 00:00:00 2001
From: Théo de la Hogue
Date: Wed, 27 Sep 2023 09:58:43 +0200
Subject: Adding new chapter to explain how to configure ArUco marker
 detection.

---
 .../aruco_detector_configuration.md                | 39 ++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md

(limited to 'docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md')

diff --git a/docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md b/docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md
new file mode 100644
index 0000000..98b0841
--- /dev/null
+++ b/docs/user_guide/aruco_markers_pipeline/advanced_topics/aruco_detector_configuration.md
@@ -0,0 +1,39 @@
+Improve ArUco markers detection
+===============================
+
+As explain in [OpenCV ArUco documentation](https://docs.opencv.org/4.x/d1/dcd/structcv_1_1aruco_1_1DetectorParameters.html), ArUco markers detection is highly configurable.
+
+## Load ArUcoDetector parameters
+
+[ArUcoCamera.detector.parameters](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoDetector.Parameters) can be loaded thanks to a dedicated JSON entry.
+
+Here is an extract from the JSON [ArUcoCamera](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoCamera) configuration file with ArUco detector parameters:
+
+```json
+{
+    "name": "My FullHD camera",
+    "size": [1920, 1080],
+    "aruco_detector": {
+        "dictionary": "DICT_APRILTAG_16h5",
+        "marker_size": 5,
+        "parameters": {
+		    "cornerRefinementMethod": 3,
+		    "aprilTagQuadSigma": 2,
+		    "aprilTagDeglitch": 1
+		}
+    },
+    ...
+```
+
+## Print ArUcoDetector parameters
+
+```python
+# Assuming ArUcoCamera is loaded
+...
+
+# Print all ArUcoDetector parameters
+print(aruco_camera.aruco_detector.parameters)
+
+# Print only modified ArUcoDetector parameters
+print(f'{aruco_camera.aruco_detector.parameters:modified}')
+```
-- 
cgit v1.1