> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/input-output/image-inputs/camera-usb.md).

# Camera USB

Ce bloc fonctionnel se connecte aux caméras USB branchées sur votre ordinateur et fournit des images en direct pour le traitement ou la visualisation. Utilisez-le pour sélectionner une caméra, changer la résolution et contrôler quand la caméra est activée ou libérée.

## 📥 Entrées (sockets) <a href="#inputs" id="inputs"></a>

* `Activate Signal` — Entrée booléenne pour activer la récupération des images. Lorsqu'elle n'est pas active, le bloc conserve et renvoie la dernière image capturée.
* `Release Signal` — Entrée booléenne pour arrêter et libérer la ressource de la caméra.

## 📤 Sorties (sockets) <a href="#outputs" id="outputs"></a>

* `Camera Frame` — Image du flux en direct provenant de la caméra USB sélectionnée.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

* `Scan Connected USB Cameras` — Bouton pour détecter et lister les caméras USB connectées au système.
* `Select USB Camera` — Menu déroulant pour choisir la caméra à utiliser parmi celles détectées.
* `Camera Resolution` — Menu déroulant pour choisir une résolution de capture prise en charge par la caméra.
* `Current Resolution` — Étiquette en lecture seule montrant la résolution actuellement utilisée par la caméra.
* `Open Advanced Setting` — Bouton qui ouvre la fenêtre des paramètres du fabricant (si disponible sur la plateforme).

## 🎯 Key features <a href="#features" id="features"></a>

* Découverte et sélection faciles de plusieurs caméras USB.
* Choix de résolution à la volée avec affichage de la résolution active.
* Contrôle d'activation/libération pour libérer la caméra pour d'autres applications.
* Protection contre les images corrompues ou vides grâce à des tentatives automatiques de récupération.
* Idéal comme source d'image en direct pour le traitement en aval ou les flux d'enregistrement.

## 📝 How to use <a href="#usage" id="usage"></a>

1. Cliquez sur le bouton `Scan Connected USB Cameras` pour remplir la liste des caméras.
2. Choisissez la caméra souhaitée dans `Select USB Camera`.
3. Facultatif : changez la valeur de `Camera Resolution` et vérifiez l'étiquette `Current Resolution`.
4. Envoyez `Activate Signal` (true) pour commencer à recevoir des images sur `Camera Frame`.
5. Lorsque vous avez terminé, envoyez `Release Signal` (true) pour libérer la ressource caméra.

## ⚙️ What happens when it runs <a href="#evaluation" id="evaluation"></a>

Quand il est activé, le bloc capture la dernière image disponible de la caméra USB sélectionnée et la publie via `Camera Frame`. Si la caméra échoue ou si les images sont vides, le bloc tentera de récupérer la connexion et vous informera via la zone de messages et les indicateurs d'état.

## 💡 Tips and Tricks

* Prévisualisez la sortie en direct en connectant `Camera Frame` au bloc `Show Image` pour inspecter les images et ouvrir le visualiseur d'image.
* Réduisez la charge avant des blocs IA lourds en ajoutant un bloc `Image Resizer` ou `Image Resize` pour diminuer la résolution des images.
* Améliorez la qualité visuelle pour les tâches de détection en insérant `Adjust Colors`, `Auto Contrast` ou `Denoising` avant les détecteurs IA.
* Combinez avec `Image ROI Select` pour recadrer une zone spécifique et accélérer les détecteurs en aval (par ex. `Object Detection`, `Mask Detection`).
* Sauvegardez des images importantes avec `Image Logger` ou enregistrez une séquence continue avec `Record Video`.
* Pour l'extraction de texte, envoyez les images vers `OCR` ou `OCR (EasyOCR)` après avoir vérifié la netteté et le contraste.
* Utilisez `Blur` ou `Image Threshold` pour prétraiter des scènes bruyantes avant `Find Object` ou d'autres détecteurs basés sur des modèles.
* Pour la journalisation distante ou cloud, associez la source caméra à `Image Logger` ou `CSV Export` pour stocker les métadonnées avec les images.

## 🛠️ Troubleshooting

* Pas de caméra listée : Vérifiez que la caméra est connectée et alimentée. Rebranchez le câble USB ou essayez un autre port, puis appuyez de nouveau sur `Scan Connected USB Cameras`.
* Caméra occupée ou ne démarre pas : Fermez d'autres applications qui pourraient utiliser la caméra, puis essayez de la libérer et de relancer la détection.
* Images vides ou corrompues : Essayez une autre résolution via `Camera Resolution` ou appuyez sur le bouton de scan pour redémarrer la caméra. Si le problème persiste, débranchez et rebranchez la caméra.
* Paramètres avancés indisponibles : Certaines plateformes n'autorisent pas l'affichage des paramètres fabricant ; consultez les notes spécifiques à la plateforme ou utilisez l'utilitaire externe du fabricant.

Si les problèmes persistent, combinez la caméra avec une prévisualisation simple via `Show Image` pour isoler si le problème vient du matériel ou d'un bloc de traitement en aval.