add examples

Author: robgee86

src/arduino/app_peripherals/camera/examples/1_initialize.py

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Initialize camera input"
+# EXAMPLE_REQUIRES = "Requires a connected camera"
+from arduino.app_peripherals.camera import Camera, V4LCamera
+
+
+default = Camera() # Uses default camera (V4L)
+
+# The following two are equivalent
+camera = Camera(2, resolution=(640, 480), fps=15)  # Infers camera type
+v4l = V4LCamera(2, (640, 480), 15)  # Explicitly requests V4L camera
+
+# Note: constructor arguments (except source) must be provided in keyword
+# format to forward them correctly to the specific camera implementations.

src/arduino/app_peripherals/camera/examples/2_capture_image.py

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Capture an image"
+# EXAMPLE_REQUIRES = "Requires a connected camera"
+import numpy as np
+from arduino.app_peripherals.camera import Camera
+
+
+camera = Camera()
+camera.start()
+image: np.ndarray = camera.capture()
+camera.stop()

src/arduino/app_peripherals/camera/examples/3_capture_video.py

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Capture a video"
+# EXAMPLE_REQUIRES = "Requires a connected camera"
+import time
+import numpy as np
+from arduino.app_peripherals.camera import Camera
+
+
+# Capture a video for 5 seconds at 15 FPS
+camera = Camera(fps=15)
+camera.start()
+
+start_time = time.time()
+while time.time() - start_time < 5:
+    image: np.ndarray = camera.capture()
+    # You can process the image here if needed, e.g save it
+
+camera.stop()

src/arduino/app_peripherals/camera/examples/4_capture_hls.py

@@ -0,0 +1,23 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Capture an HLS (HTTP Live Stream) video"
+import time
+import numpy as np
+from arduino.app_peripherals.camera import Camera
+
+
+# Capture a freely available HLS playlist for testing
+# Note: Public streams can be unreliable and may go offline without notice.
+url = 'https://demo.unified-streaming.com/k8s/features/stable/video/tears-of-steel/tears-of-steel.ism/.m3u8'
+
+camera = Camera(url)
+camera.start()
+
+start_time = time.time()
+while time.time() - start_time < 5:
+    image: np.ndarray = camera.capture()
+    # You can process the image here if needed, e.g save it
+
+camera.stop()

src/arduino/app_peripherals/camera/examples/5_capture_rtsp.py

@@ -0,0 +1,23 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Capture an RTSP (Real-Time Streaming Protocol) video"
+import time
+import numpy as np
+from arduino.app_peripherals.camera import Camera
+
+
+# Capture a freely available RTSP stream for testing
+# Note: Public streams can be unreliable and may go offline without notice.
+url = "rtsp://170.93.143.139/rtplive/470011e600ef003a004ee33696235daa"
+
+camera = Camera(url)
+camera.start()
+
+start_time = time.time()
+while time.time() - start_time < 5:
+    image: np.ndarray = camera.capture()
+    # You can process the image here if needed, e.g save it
+
+camera.stop()

src/arduino/app_peripherals/camera/examples/6_capture_websocket.py

@@ -0,0 +1,20 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 ARDUINO SA <http://www.arduino.cc>
+#
+# SPDX-License-Identifier: MPL-2.0
+
+# EXAMPLE_NAME = "Capture an input WebSocket video"
+import time
+import numpy as np
+from arduino.app_peripherals.camera import Camera
+
+
+# Expose a WebSocket camera stream for clients to connect to and consume it
+camera = Camera("ws://0.0.0.0:8080", timeout=5)
+camera.start()
+
+start_time = time.time()
+while time.time() - start_time < 5:
+    image: np.ndarray = camera.capture()
+    # You can process the image here if needed, e.g save it
+
+camera.stop()