From 8fc18a434da400f0fe82707e23838d6cc40a787d Mon Sep 17 00:00:00 2001
From: Théo de la Hogue
Date: Wed, 3 Jul 2024 17:14:43 +0200
Subject: Rewriting eye tracking context and gaze analysis sections.

---
 .../utils/estimate_aruco_markers_pose.md           | 60 ++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 docs/user_guide/utils/estimate_aruco_markers_pose.md

(limited to 'docs/user_guide/utils/estimate_aruco_markers_pose.md')

diff --git a/docs/user_guide/utils/estimate_aruco_markers_pose.md b/docs/user_guide/utils/estimate_aruco_markers_pose.md
new file mode 100644
index 0000000..3d34972
--- /dev/null
+++ b/docs/user_guide/utils/estimate_aruco_markers_pose.md
@@ -0,0 +1,60 @@
+Estimate ArUco markers pose
+===========================
+
+This **ArGaze** application detects ArUco markers inside a movie frame then, export pose estimation as .obj file into a folder.
+
+Firstly, edit **utils/estimate_markers_pose/context.json** file as to select a movie *path*.
+
+```json
+{
+    "argaze.utils.contexts.OpenCV.Movie" : {
+        "name": "ArUco markers pose estimator",
+        "path": "./src/argaze/utils/demo/tobii_record/segments/1/fullstream.mp4",
+        "pipeline": "pipeline.json"
+    }
+}
+```
+
+Sencondly, edit **utils/estimate_markers_pose/pipeline.json** file to setup ArUco camera *size*, ArUco detector *dictionary*, *pose_size* and *pose_ids* attributes.
+
+```json
+{
+    "argaze.ArUcoMarker.ArUcoCamera.ArUcoCamera": {
+        "name": "Full HD Camera",
+        "size": [1920, 1080],
+        "aruco_detector": {
+            "dictionary": "DICT_APRILTAG_16h5",
+            "pose_size": 4,
+            "pose_ids": [],
+            "parameters": {
+                "useAruco3Detection": 1
+            },
+            "observers":{
+                "observers.ArUcoMarkersPoseRecorder": {
+                    "output_folder": "_export/records/aruco_markers_group"
+                }
+            }
+        },
+        "sides_mask": 420,
+        "image_parameters": {
+            "background_weight": 1,
+            "draw_gaze_positions": {
+                "color": [0, 255, 255],
+                "size": 4
+            },
+            "draw_detected_markers": {
+                "color": [255, 255, 255],
+                "draw_axes": {
+                    "thickness": 4
+                }
+            }
+        }
+    }
+}
+```
+
+Then, launch the application.
+
+```shell
+python -m argaze load ./src/argaze/utils/estimate_markers_pose/context.json
+```
\ No newline at end of file
-- 
cgit v1.1