refactor: migrate camera_code_detection

Author: robgee86

src/arduino/app_bricks/camera_code_detection/README.md

@@ -6,8 +6,8 @@ This Brick enables real-time barcode and QR code scanning from a camera video st
 
 The Camera Code Detection Brick allows you to:
 
-- Capture frames from a USB camera.
-- Configure camera settings (resolution and frame rate).
+- Capture frames from a Camera (see Camera peripheral for supported cameras).
+- Configure Camera settings (resolution and frame rate).
 - Define the type of code to detect: barcodes and/or QR codes.
 - Process detections with customizable callbacks.
 
@@ -22,7 +22,7 @@ The Camera Code Detection Brick allows you to:
 
 ## Prerequisites
 
-To use this Brick you should have a USB camera connected to your board.
+To use this Brick you can choose to plug a camera to your board or use a network-connected camera.
 
 **Tip**: Use a USB-C® Hub with USB-A connectors to support commercial web cameras.
 
@@ -37,9 +37,25 @@ def render_frame(frame):
 def handle_detected_code(frame, detection):
     ...
 
-# Select the camera you want to use, its resolution and the max fps
-detection = CameraCodeDetection(camera=0, resolution=(640, 360), fps=10)
+detection = CameraCodeDetection()
 detection.on_frame(render_frame)
 detection.on_detection(handle_detected_code)
-detection.start()
+
+App.run()
 ```
+
+You can also select a specific camera to use:
+
+```python
+from arduino.app_bricks.camera_code_detection import CameraCodeDetection
+
+def handle_detected_code(frame, detection):
+    ...
+
+# Select the camera you want to use, its resolution and the max fps
+camera = Camera(camera="rtsp://...", resolution=(640, 360), fps=10)
+detection = CameraCodeDetection(camera)
+detection.on_detection(handle_detected_code)
+
+App.run()
+```

src/arduino/app_bricks/camera_code_detection/detection.py

@@ -6,12 +6,12 @@
 import threading
 from typing import Callable
 
-import cv2
 from pyzbar.pyzbar import decode, ZBarSymbol, PyZbarError
 import numpy as np
-from PIL.Image import Image
+from PIL.Image import Image, fromarray
 
 from arduino.app_peripherals.camera import Camera
+from arduino.app_utils.image import greyscale
 from arduino.app_utils import brick, Logger
 
 logger = Logger("CameraCodeDetection")
@@ -44,7 +44,7 @@ class CameraCodeDetection:
     """Scans a camera video feed for QR codes and/or barcodes.
 
     Args:
-        camera (USBCamera): The USB camera instance. If None, a default camera will be initialized.
+        camera (Camera): The camera instance to use for capturing video. If None, a default camera will be initialized.
         detect_qr (bool): Whether to detect QR codes. Defaults to True.
         detect_barcode (bool): Whether to detect barcodes. Defaults to True.
 
@@ -154,13 +154,13 @@ def loop(self):
             self._on_error(e)
             return
 
-        # Use grayscale for barcode/QR code detection
-        gs_frame = cv2.cvtColor(frame, cv2.COLOR_RGB2GRAY)
-
-        self._on_frame(frame)
+        pil_frame = fromarray(frame)
+        self._on_frame(pil_frame)
 
+        # Use grayscale for barcode/QR code detection
+        gs_frame = greyscale(frame)
         detections = self._scan_frame(gs_frame)
-        self._on_detect(frame, detections)
+        self._on_detect(pil_frame, detections)
 
     def _on_frame(self, frame: Image):
         if self._on_frame_cb:
@@ -170,7 +170,7 @@ def _on_frame(self, frame: Image):
                 logger.error(f"Failed to run on_frame callback: {e}")
                 self._on_error(e)
 
-    def _scan_frame(self, frame: cv2.typing.MatLike) -> list[Detection]:
+    def _scan_frame(self, frame: np.ndarray) -> list[Detection]:
         """Scan the frame for a single barcode or QR code."""
         detections = []
 

src/arduino/app_bricks/camera_code_detection/examples/2_detection_list.py

@@ -19,4 +19,4 @@ def on_codes_detected(frame: Image, detections: list[Detection]):
 detector = CameraCodeDetection()
 detector.on_detect(on_codes_detected)
 
-App.run()  # This will block until the app is stopped
+App.run()

src/arduino/app_bricks/camera_code_detection/examples/3_detection_with_overrides.py

@@ -6,7 +6,7 @@
 # EXAMPLE_REQUIRES = "Requires an USB webcam connected to the Arduino board."
 from PIL.Image import Image
 from arduino.app_utils.app import App
-from arduino.app_peripherals.usb_camera import USBCamera
+from arduino.app_peripherals.usb_camera import Camera
 from arduino.app_bricks.camera_code_detection import CameraCodeDetection, Detection
 
 
@@ -17,7 +17,7 @@ def on_code_detected(frame: Image, detection: Detection):
     # e.g., draw a bounding box, save it to a database or log it.
 
 
-camera = USBCamera(camera=0, resolution=(640, 360), fps=10)
+camera = Camera(camera=2, resolution=(640, 360), fps=10)
 detector = CameraCodeDetection(camera)
 detector.on_detect(on_code_detected)