add first stub

Author: robgee86

src/arduino/app_bricks/hand_gesture_detection/README.md

@@ -0,0 +1 @@
+# TODO

src/arduino/app_bricks/hand_gesture_detection/__init__.py

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: Copyright (C) ARDUINO SRL (http://www.arduino.cc)
+#
+# SPDX-License-Identifier: MPL-2.0
+
+from typing import Literal
+
+from arduino.app_peripherals.camera import BaseCamera, Camera
+
+
+class HandGestureTracking:
+    def __init__(self, camera: BaseCamera | None = None):
+        if camera is None:
+            camera = Camera(fps=30)
+        self.camera = camera
+
+    def on_gesture(self, gesture, callback, hand: Literal["left", "right", "both"] = "both"):
+        pass
+
+    def on_enter(self, callback, hand: Literal["left", "right", "both"] = "both"):
+        pass
+
+    def on_exit(self, callback, hand: Literal["left", "right", "both"] = "both"):
+        pass
+
+    def on_frame(self, callback):
+        pass

src/arduino/app_bricks/hand_gesture_detection/brick_compose.yaml

@@ -0,0 +1,12 @@
+services:
+  hand-gesture-tracker:
+    image: hand-gesture-tracker
+    privileged: true
+    ports:
+      - ${BIND_ADDRESS:-0.0.0.0}:5002:5002
+    user: 0:0
+    healthcheck:
+      test: [ "CMD-SHELL", "nc -zv hand-gesture-tracker 5002 || exit 1" ]
+      interval: 1s
+      timeout: 2s
+      retries: 30

src/arduino/app_bricks/hand_gesture_detection/brick_config.yaml

@@ -0,0 +1,10 @@
+id: arduino:hand_gesture_tracking
+name: Hand gesture tracking
+description: |
+  This hand gesture tracking brick utilizes a pre-trained model to analyze video streams from a camera.
+  The output is a video stream featuring hand gesture tracking as overlay, with the added capability to
+  trigger actions based on these detections.
+category: video
+requires_container: true
+required_devices:
+  - camera

src/arduino/app_bricks/hand_gesture_detection/examples/01_gesture.py

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: Copyright (C) ARDUINO SRL (http://www.arduino.cc)
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Hand gesture detection"
+# EXAMPLE_REQUIRES = "Requires a connected camera"
+
+from arduino.app_bricks.hand_gesture_detection import HandGestureTracking
+from arduino.app_utils.app import App
+
+pd = HandGestureTracking()
+pd.on_gesture("Victory", lambda: print("All your bases are belong to us"))
+pd.on_gesture("Open_Palm", lambda: print("Moving left!"), hand="left")
+pd.on_gesture("Open_Palm", lambda: print("Moving right!"), hand="right")
+
+App.run()

src/arduino/app_bricks/hand_gesture_detection/examples/02_enter_exit.py

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: Copyright (C) ARDUINO SRL (http://www.arduino.cc)
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Hand enter/exit detection"
+# EXAMPLE_REQUIRES = "Requires a connected camera"
+
+from arduino.app_bricks.hand_gesture_detection import HandGestureTracking
+from arduino.app_utils.app import App
+
+pd = HandGestureTracking()
+pd.on_enter(lambda: print("Hi there!"))
+pd.on_exit(lambda: print("Goodbye!"))
+
+App.run()

src/arduino/app_bricks/hand_gesture_detection/examples/03_confirm.py

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: Copyright (C) ARDUINO SRL (http://www.arduino.cc)
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Get user confirmation with hand gestures"
+# EXAMPLE_REQUIRES = "Requires a connected camera"
+
+from arduino.app_bricks.hand_gesture_detection import HandGestureTracking
+from arduino.app_utils.app import App
+
+pd = HandGestureTracking()
+pd.on_gesture("Thumb_Up", lambda: print("Operation confirmed!"))
+
+App.run()