> 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/basler-camera.md).

# Basler Camera

Ce bloc de fonction se connecte à une caméra Basler et fournit des images en direct pour votre scénario. Il est conçu pour les caméras industrielles et propose des options de configuration réseau et des contrôles de temporisation adaptés à une acquisition d'images fiable.

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

Ce bloc ne nécessite aucune entrée.

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

`Image`\
Dernière image capturée par la caméra. Si la caméra n'est pas disponible, la sortie restera vide (None) jusqu'à ce qu'une image puisse être récupérée.

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

`IP Address`\
Saisissez l'adresse IP de la caméra. Laisser vide pour essayer la première caméra Basler détectée sur le réseau.

`NAT Address`\
Facultatif. À utiliser si la caméra est accessible via une adresse NAT différente de l'IP de la caméra.

`Destination Address`\
Facultatif. À utiliser si la caméra doit envoyer en multicast ou est routée vers une adresse machine spécifique.

`Trigger Ready Timeout (ms)`\
Temps d'attente maximum (en millisecondes) avant d'envoyer un trigger logiciel à la caméra.

`Retrieve Result Timeout (ms)`\
Temps d'attente maximum (en millisecondes) pour recevoir l'image après l'envoi du trigger.

Remarque : le bloc tentera de (re)se connecter automatiquement lorsque les paramètres changent. Utilisez les contrôles ci‑dessus pour configurer la connectivité et les temporisations.

## 🎨 Fonctionnalités <a href="#features" id="features"></a>

* Connexion fiable aux caméras Basler avec prise en charge des adresses IP et NAT.
* Contrôles de temporisation pour ajuster la réactivité face aux délais réseau ou caméra.
* Reconnexion automatique lors de changements de paramètres ou d'échecs temporaires.
* Fournit en temps réel la dernière image pour le traitement en aval.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Remplissez `IP Address` si vous connaissez l'adresse de la caméra. Sinon, laissez vide pour utiliser la première caméra Basler disponible.
2. Configurez éventuellement `NAT Address` ou `Destination Address` si votre réseau l'exige.
3. Ajustez `Trigger Ready Timeout (ms)` et/ou `Retrieve Result Timeout (ms)` en cas de délais ou d'échecs.
4. Ajoutez des blocs en aval qui consomment la sortie `Image` pour construire votre pipeline.

## 📊 Évaluation <a href="#evaluation" id="evaluation"></a>

Lors de l'exécution, ce bloc fournira la trame la plus récente de la caméra Basler configurée sur la sortie `Image`. Si la caméra est injoignable ou si aucune image ne peut être récupérée, la sortie restera vide jusqu'à la restauration de la connexion.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Prévisualisez rapidement les images en connectant la sortie `Image` à `Show Image`.
* Sauvegardez des images ou des séquences capturées avec `Image Logger` ou `Record Video` pour une revue hors ligne.
* Si vos blocs IA peinent avec des images très grandes, insérez `Image Resizer` avant le traitement lourd pour réduire la taille et améliorer le débit.
* Pour des tâches d'inspection ou de détection, associez avec `Object Detection`, `Object Detection - Custom` ou `Mask Detection` pour analyser les images en direct.
* Utilisez `Super Resolution` après la capture si vous avez besoin d'un meilleur niveau de détail pour l'analyse en aval.
* Rognez ou focalisez les zones d'intérêt avec `Image ROI Select` ou `Image ROI` avant d'appliquer des détecteurs pour réduire les faux positifs et accélérer le traitement.

## 🛠️ Résolution de problèmes <a href="#troubleshooting" id="troubleshooting"></a>

* Si aucune image n'apparaît, vérifiez la connectivité réseau et que la caméra est alimentée et joignable à l'adresse configurée.
* Si les images sont retardées ou expirent, augmentez `Trigger Ready Timeout (ms)` et/ou `Retrieve Result Timeout (ms)`.
* Si la connexion échoue continuellement après des changements de paramètres, vérifiez les adresses et essayez de redémarrer la caméra ou l'équipement réseau.