> 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/image-transformations/analysis/image-memory.md).

# Image Memory

Ce bloc fonction conserve une image en mémoire afin que vous puissiez "geler" une trame et la réutiliser jusqu'à ce que vous choisissiez de la mettre à jour. Il est utile lorsque vous souhaitez conserver une image de référence pour l'inspection, la journalisation ou le traitement en aval sans dépendre en permanence d'une source en direct.

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

* `Image Any` Connectez l'image que vous souhaitez stocker ou mettre à jour.
* `Save Image` Lorsque True, le bloc conservera (gèlera) l'image actuellement stockée et ne la mettra pas à jour depuis l'entrée.

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

* `Image Any` L'image actuellement conservée en mémoire (soit la dernière image stockée, soit l'entrée en direct lorsque le bloc n'est pas gelé).

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

* `Save Image` Utilisez ce contrôle booléen pour geler ou dégeler l'image stockée.
  * Lorsque défini sur True, l'image stockée est préservée et le bloc continuera à fournir cette image en sortie même si l'entrée change.
  * Lorsque défini sur False, le bloc met à jour son image stockée depuis l'entrée `Image Any`.

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

* Par défaut, le bloc fournit la dernière image connectée à son entrée `Image Any`.
* Si `Save Image` est réglé sur True, le bloc maintiendra l'image courante et continuera à fournir cette même image jusqu'à ce que `Save Image` devienne False.
* Lorsque vous enregistrez et rechargez votre projet, le bloc peut restaurer l'image stockée afin que l'état de la mémoire persiste entre les sessions (si une image a été stockée).

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

* Capacité de gel d'image pour un traitement en aval cohérent.
* Contrôle booléen simple pour verrouiller/déverrouiller l'image stockée.
* Persistance lors de l'enregistrement/chargement du projet pour conserver une image de référence capturée entre les sessions.

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

1. Connectez une source d'image en direct (caméra, flux, chargement d'image, etc.) à l'entrée `Image Any`.
2. Pour capturer et conserver une trame, définissez `Save Image` sur True. Le bloc continuera à fournir cette trame en sortie.
3. Pour reprendre les mises à jour en direct, définissez `Save Image` sur False. Le bloc copiera alors la dernière image d'entrée et mettra à jour son image stockée.

## 💡 Conseils et astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour prévisualiser l'image stockée, connectez la sortie de ce bloc à `Show Image`.
* Utilisez `Image ROI Select` avant ce bloc pour capturer et geler uniquement une région d'intérêt au lieu de la trame complète.
* Si vous voulez une image plus petite pour un stockage plus rapide ou un traitement en aval accéléré, ajoutez `Image Resize` avant le bloc.
* Pour une image de référence plus robuste, appliquez `Blur` ou `Image Threshold` avant la capture afin de réduire le bruit ou binariser la scène.
* Combinez avec `Image Logger` ou `Image Write` pour enregistrer les images gelées sur le disque lorsque `Save Image` est activé.
* Utilisez `Is None` ou `Replace None` en aval pour vous protéger contre les images manquantes dans le flux.

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

* Si la sortie apparaît vide après le chargement d'un projet, assurez-vous qu'une image a été précédemment capturée avec `Save Image` activé ou fournissez une nouvelle image d'entrée et réglez `Save Image` sur False pour mettre à jour.
* Si vous attendez des mises à jour en direct mais que l'image ne change pas, vérifiez que `Save Image` est défini sur False afin que le bloc puisse se rafraîchir depuis l'entrée.