> 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/ai-blocks/depth-estimation-depthany-v2.md).

# Depth Estimation (DepthAny. V2)

Ce bloc de fonction estime la profondeur par pixel (distance) à partir d'une seule image RGB/BGR. Il génère une visualisation colorée de la profondeur et une carte de profondeur en niveaux de gris que vous pouvez afficher, enregistrer ou transmettre à d'autres blocs de traitement.

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

`Image` Image RGB/BGR utilisée comme entrée pour l'estimation de profondeur.

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

`Depth Vis` Visualisation colorée de la profondeur estimée (facile à inspecter).

`Depth Map` Carte de profondeur en niveaux de gris normalisée sur 0–255 (utile pour l'analyse et pour alimenter d'autres blocs en aval).

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

`Model Size` Choisissez le compromis précision / vitesse du modèle. Les options incluent typiquement Small, Base et Large.\
`Max Size` Curseur limitant la plus grande dimension d'image utilisée lors du traitement. Des valeurs plus grandes donnent plus de détails mais nécessitent plus de temps de calcul.

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

* Produit à la fois une carte de profondeur visuelle et une image de profondeur brute en niveaux de gris pour une utilisation flexible.
* Le choix du modèle permet d'ajuster la vitesse d'inférence en fonction de la précision désirée.
* `Max Size` empêche que des images très grandes ralentissent le traitement ; le bloc redimensionne automatiquement les entrées pour une inférence efficace.
* Utilise automatiquement les ressources de traitement disponibles pour offrir le meilleur débit possible (comportement au niveau de l'UI).

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

Lorsque le bloc s'exécute, il prend l'image d'entrée actuelle, la redimensionne éventuellement pour respecter le réglage `Max Size`, la traite avec le modèle sélectionné, puis renvoie les deux sorties : une visualisation colorée et une carte de profondeur normalisée en niveaux de gris. Des modèles plus grands et des valeurs `Max Size` plus élevées augmentent le temps de traitement.

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

1. Connectez un bloc producteur d'image à l'entrée `Image`.
2. Sélectionnez un `Model Size` en fonction du compromis précision / vitesse dont vous avez besoin.
3. Ajustez `Max Size` pour limiter le temps de traitement tout en conservant suffisamment de détails.
4. Utilisez `Depth Vis` pour une inspection rapide des résultats ; utilisez `Depth Map` comme entrée numérique pour d'autres blocs de traitement.

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

* Pour des images très grandes, utilisez `Image Resizer` avant ce bloc pour réduire le temps de traitement tout en conservant la zone importante.
* Si l'image d'entrée est de faible résolution, essayez d'exécuter `Super Resolution` en amont pour améliorer les détails avant l'estimation de profondeur.
* Pour inspecter visuellement les sorties dans votre flux, connectez `Depth Vis` au bloc `Show Image`.
* Enregistrez automatiquement les résultats en envoyant `Depth Vis` ou `Depth Map` vers `Image Logger` ou `Image Write`.
* Lors des expérimentations, commencez avec `Model Size` sur Small pour obtenir un retour rapide, puis passez à Base ou Large une fois les réglages stabilisés.

(indice : blocs complémentaires recommandés — `Image Resizer`, `Super Resolution`, `Show Image`, `Image Logger`, `Image Write`)

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si le traitement est trop lent : réduisez le `Model Size` ou diminuez `Max Size`.
* Si les résultats semblent trop grossiers : augmentez `Max Size` ou essayez un `Model Size` plus grand (si les ressources de calcul le permettent).
* Si aucune sortie n'apparaît ou si le bloc se bloque : assurez-vous que le bloc d'image en amont fournit des images valides.
* Si vous devez conserver les résultats récents pour vérification, orientez les sorties vers `Image Logger` ou `Show Image` pour confirmer les attentes.