🏷️ upicvision

📸 Overview

The TagDetector class is a powerful 🚀 real-time AprilTag detection system that transforms your camera into a smart tag recognition device!

🎯 Key Features:

• 📷 Real-time Detection: Lightning-fast AprilTag identification using OpenCV and AprilTag libraries
• 🎮 Easy Control: Simple start, stop, pause, and resume operations
• ⚙️ Flexible Configuration: Customizable camera settings and resolution scaling
• 🔧 Resource Management: Smart camera initialization and cleanup
• 🎪 Thread-Safe: Built-in threading support for smooth performance

Perfect for robotics 🤖, augmented reality 🥽, and computer vision applications!

🚀 Quick Start Guide

🔧 Initialization

from upic import TagDetector

# 🎬 Create your detector with custom settings
detector = TagDetector(cam_id=0, resolution_multiplier=0.75)

📹 Camera Operations

# 🟢 Start the magic - open camera and begin detection
detector.open_camera().apriltag_detect_start()

# ⏸️ Pause detection temporarily (camera stays active)
detector.halt_detection()

# ▶️ Resume detection when ready
detector.resume_detection()

# 🔴 Clean shutdown - release camera resources
detector.release_camera()

🏷️ Getting the Detected Tag

# 🔍 Check what tag is currently detected
current_tag_id = detector.tag_id
print(f"🎯 Current Tag ID: {current_tag_id}")

💡 Complete Working Example

from upic import TagDetector

# 🚀 Initialize the detector
detector = TagDetector(cam_id=0, resolution_multiplier=0.75)

# 🎬 Start detection
detector.open_camera().apriltag_detect_start()

# 🎮 Control detection as needed
detector.halt_detection()  # ⏸️ Pause
detector.resume_detection()  # ▶️ Resume

# 🔍 Get the detected tag
current_tag_id = detector.tag_id
print(f"🎯 Detected Tag ID: {current_tag_id}")

# 🧹 Clean up when finished
detector.release_camera()