Camera USB External

Ce bloc de fonction se connecte à une caméra USB externe via son index de périphérique et offre des contrôles flexibles pour la résolution, l'exposition et le streaming d'images en direct. Il convient aux configurations d'automatisation et de production où l'index caméra, la résolution et l'exposition sont pilotés par d'autres blocs ou signaux externes.

📥 Inputs

Activate Signal Utilisez ce booléen pour commencer à récupérer les images depuis la caméra sélectionnée.

Release Signal Utilisez ce booléen pour arrêter la caméra et libérer ses ressources.

Camera Index Fournissez un entier pour sélectionner le périphérique caméra (index de périphérique ou mappage d'index scannés).

Resolution Width Fournissez un entier pour la largeur de capture souhaitée.

Resolution Height Fournissez un entier pour la hauteur de capture souhaitée.

Scan Cameras Mettez à true pour rescanner les caméras USB connectées et actualiser la liste des périphériques disponibles.

Set Exposure Valeur numérique optionnelle pour définir l'exposition manuelle sur la caméra si elle le supporte.

Set Auto Exposure Valeur numérique optionnelle pour définir le mode d'auto-exposition si la caméra le supporte.

📤 Outputs

Camera Frame La dernière image capturée depuis la caméra USB sélectionnée.

🕹️ Controls

Source / Resolution Info Une étiquette d'état qui affiche la source caméra courante et la résolution active.

Remarque : De nombreux réglages sont exposés comme entrées afin que le bloc puisse être piloté par d'autres blocs ou contrôles UI.

🎯 Features

• Sélection de la caméra par index de périphérique ou par la liste scannée, adapté aux systèmes multi-caméras.

• Changement de résolution à l'exécution via des entrées séparées pour largeur et hauteur.

• Contrôle d'exposition manuel et auto-exposition lorsque la caméra et la plateforme le permettent.

• Comportement de redémarrage "soft" : le bloc tente de récupérer des images vides ou erronées en redémarrant automatiquement la caméra.

• Téléverseur d'images en arrière-plan optionnel (si configuré) pour streamer des images à des fins de journalisation ou d'analyse distante.

• Conçu pour les flux de travail headless ou automatisés car la plupart des paramètres sont disponibles via des entrées.

⚙️ Mécanisme d'exécution

• Lorsque Activate Signal est true, le bloc essaie de délivrer des images via Camera Frame.

• Lorsque Release Signal est true, le bloc arrête la capture et libère les ressources de la caméra.

• Changer Camera Index déclenche l'ouverture du périphérique choisi.

• Fournir Resolution Width et Resolution Height pendant l'activation tentera de modifier la résolution de capture.

• Fournir Set Exposure ou Set Auto Exposure tentera d'ajuster les réglages d'exposition si le périphérique le supporte.

• Si le bloc rencontre des images vides ou échouées de façon répétée, il effectuera un cycle de redémarrage pour récupérer la caméra automatiquement.

• Si Scan Cameras est activé, le bloc actualise la liste des caméras disponibles (utile lors du branchement de nouveaux dispositifs).

📝 Usage instructions

1. Utilisez Scan Cameras ou la découverte de caméras de votre système pour lister les périphériques disponibles.

2. Donnez l'index de périphérique désiré à Camera Index pour choisir une caméra.

3. Facultatif : définissez Resolution Width et Resolution Height pour la taille de capture souhaitée.

4. Envoyez Activate Signal pour démarrer la capture d'images. Surveillez Source / Resolution Info pour l'état courant.

5. Ajustez Set Exposure ou Set Auto Exposure uniquement si votre caméra prend en charge ces contrôles.

6. Envoyez Release Signal lorsque vous avez terminé pour libérer le périphérique.

💡 Tips and Tricks

• Pour prévisualiser les images en direct, connectez la sortie Camera Frame à un bloc Show Image pour un visualiseur interactif.

• Pour sauvegarder des images ou créer un jeu de données, connectez Camera Frame à Image Logger ou Record Video.

• Si la caméra produit des images bruyantes, faites passer les images par Blur ou Denoising avant de les envoyer aux détecteurs.

• Redimensionnez les captures haute résolution avant un traitement lourd pour améliorer la vitesse : connectez Camera Frame à Image Resize puis aux blocs d'analyse en aval.

• Pour une analyse basée sur une région, recadrez l'image avec Image ROI Select avant d'exécuter des détecteurs comme Find Object ou Object Detection.

• Combinez avec des blocs IA tels que Object Detection - Custom ou Skeleton Estimation pour des pipelines d'inférence en direct.

• Utilisez Scan Cameras lors du branchement à chaud des caméras pour que le bloc découvre les nouveaux périphériques sans redémarrer tout le système.

🛠️ Troubleshooting

• Pas d'images ou images noires/vides :

  • Vérifiez que l'entier fourni à Camera Index est correct. Si vous n'êtes pas sûr, lancez un scan avec Scan Cameras.

  • Assurez-vous qu'aucune autre application n'utilise la caméra. Libérez-la ou fermez les autres applications puis réessayez.

  • Essayez des résolutions plus faibles via Resolution Width et Resolution Height — certaines caméras ne peuvent pas streamer des résolutions élevées de manière fiable.

• Les contrôles d'exposition n'ont aucun effet :

  • Toutes les caméras ou plateformes ne gèrent pas l'exposition par programme. Si les réglages ne s'appliquent pas, essayez l'utilitaire du fabricant de la caméra ou utilisez l'étiquette Info du bloc pour confirmer les valeurs actuelles.

• Perte d'images intermittente ou échecs :

  • Essayez un autre port USB ou un hub USB alimenté. Utilisez une résolution plus faible pour réduire la bande passante.

  • Si la récupération automatique ne suffit pas, basculez Release Signal puis Activate Signal pour forcer un redémarrage complet.

• Caméra non détectée lors du scan :

  • Vérifiez que l'appareil est alimenté et connecté. Rebranchez la caméra et activez Scan Cameras à nouveau.

  • Sur certains systèmes, les index de périphériques peuvent changer après un redémarrage ou un rebranchement — utilisez la liste scannée pour sélectionner de manière fiable.

Si les problèmes persistent, prévisualisez les images avec Show Image et capturez un court enregistrement avec Record Video pour inspecter le comportement et le partager avec le support.