aboutsummaryrefslogtreecommitdiff
path: root/docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md
diff options
context:
space:
mode:
authorThéo de la Hogue2024-04-10 15:13:12 +0200
committerThéo de la Hogue2024-04-10 15:13:12 +0200
commit03013286100d4a3cc49439afc6f432f7be0c494b (patch)
tree3615506f50381208bd4d327d61a49440143d6ffe /docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md
parentbcfb82055c1736262ce974dc5dd10b365dda8d5c (diff)
downloadargaze-03013286100d4a3cc49439afc6f432f7be0c494b.zip
argaze-03013286100d4a3cc49439afc6f432f7be0c494b.tar.gz
argaze-03013286100d4a3cc49439afc6f432f7be0c494b.tar.bz2
argaze-03013286100d4a3cc49439afc6f432f7be0c494b.tar.xz
orthographic corrections
Diffstat (limited to 'docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md')
-rw-r--r--docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md132
1 files changed, 0 insertions, 132 deletions
diff --git a/docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md b/docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md
deleted file mode 100644
index 04d6a2f..0000000
--- a/docs/user_guide/aruco_markers_pipeline/advanced_topics/scripting.md
+++ /dev/null
@@ -1,132 +0,0 @@
-Script the pipeline
-===================
-
-All aruco markers pipeline objects are accessible from Python script.
-This could be particularly useful for realtime AR interaction applications.
-
-## Load ArUcoCamera configuration from dictionary
-
-First of all, [ArUcoCamera](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoCamera) configuration can be loaded from a python dictionary.
-
-```python
-from argaze.ArUcoMarkers import ArUcoCamera
-
-# Edit a dict with ArUcoCamera configuration
-configuration = {
- "name": "My FullHD camera",
- "size": (1920, 1080),
- ...
- "aruco_detector": {
- ...
- },
- "scenes": {
- "MyScene" : {
- "aruco_markers_group": {
- ...
- },
- "layers": {
- "MyLayer": {
- "aoi_scene": {
- ...
- }
- },
- ...
- }
- },
- ...
- }
- "layers": {
- "MyLayer": {
- ...
- },
- ...
- },
- "image_parameters": {
- ...
- }
-}
-
-# Load ArUcoCamera
-aruco_camera = ArUcoCamera.ArUcoCamera.from_dict(configuration)
-
-# Do something with ArUcoCamera
-...
-```
-
-## Access to ArUcoCamera and ArScenes attributes
-
-Then, once the configuration is loaded, it is possible to access to its attributes: [read ArUcoCamera code reference](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoCamera) to get a complete list of what is available.
-
-Thus, the [ArUcoCamera.scenes](../../../argaze.md/#argaze.ArFeatures.ArCamera) attribute allows to access each loaded aruco scene and so, access to their attributes: [read ArUcoScene code reference](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoScene) to get a complete list of what is available.
-
-```python
-from argaze import ArFeatures
-
-# Assuming the ArUcoCamera is loaded
-...
-
-# Iterate over each ArUcoCamera scene
-for name, aruco_scene in aruco_camera.scenes.items():
- ...
-```
-
-## Pipeline execution outputs
-
-[ArUcoCamera.watch](../../../argaze.md/#argaze.ArFeatures.ArCamera.watch) method returns data about pipeline execution.
-
-```python
-# Assuming that timestamped images are available
-...:
-
- try:
-
- # Watch image with ArUco camera
- aruco_camera.watch(image, timestamp=timestamp)
-
- # Do something with pipeline exception
- except Exception as e:
-
- ...
-
- # Do something with detected_markers
- ... aruco_camera.aruco_detector.detected_markers()
-
-```
-
-Let's understand the meaning of each returned data.
-
-### *aruco_camera.aruco_detector.detected_markers()*
-
-A dictionary containing all detected markers provided by [ArUcoDetector](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoDetector) class.
-
-## Setup ArUcoCamera image parameters
-
-Specific [ArUcoCamera.image](../../../argaze.md/#argaze.ArFeatures.ArFrame.image) method parameters can be configured thanks to a python dictionary.
-
-```python
-# Assuming ArUcoCamera is loaded
-...
-
-# Edit a dict with ArUcoCamera image parameters
-image_parameters = {
- "draw_detected_markers": {
- ...
- },
- "draw_scenes": {
- ...
- },
- "draw_optic_parameters_grid": {
- ...
- },
- ...
-}
-
-# Pass image parameters to ArUcoCamera
-aruco_camera_image = aruco_camera.image(**image_parameters)
-
-# Do something with ArUcoCamera image
-...
-```
-
-!!! note
- [ArUcoCamera](../../../argaze.md/#argaze.ArUcoMarkers.ArUcoCamera) inherits from [ArFrame](../../../argaze.md/#argaze.ArFeatures.ArFrame) and so, benefits from all image parameters described in [gaze analysis pipeline visualisation section](../../gaze_analysis_pipeline/visualisation.md). \ No newline at end of file