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

# Image Memory

Dieser Funktionsblock hält ein Bild im Speicher, sodass Sie einen Frame "einfrieren" und wiederverwenden können, bis Sie ihn aktualisieren möchten. Nützlich, wenn Sie ein Referenzbild für Inspektion, Protokollierung oder nachgelagerte Verarbeitung behalten wollen, ohne ständig auf eine Live-Quelle angewiesen zu sein.

## 📥 Eingänge

* `Image Any` — Verbinden Sie hier das Bild, das Sie speichern oder aktualisieren möchten.
* `Save Image` — Wenn True, behält der Block das aktuell gespeicherte Bild bei (friert es ein) und aktualisiert es nicht mehr vom Eingang.

## 📤 Ausgänge

* `Image Any` — Das aktuell im Speicher gehaltene Bild (entweder das zuletzt gespeicherte Bild oder der Live-Eingang, wenn nicht eingefroren).

## 🕹️ Steuerungen

* `Save Image` — Dieser boolesche Schalter friert das gespeicherte Bild ein oder hebt das Einfrieren auf.
  * Bei True wird das gespeicherte Bild beibehalten und der Block gibt weiterhin dieses Bild aus, auch wenn sich der Eingang ändert.
  * Bei False aktualisiert der Block sein gespeichertes Bild aus dem `Image Any`-Eingang.

## ⚙️ Funktionsweise

* Standardmäßig gibt der Block das zuletzt an seinen `Image Any`-Eingang angeschlossene Bild aus.
* Ist `Save Image` auf True gesetzt, hält der Block das aktuelle Bild und gibt dieses bis zur Rückkehr von `Save Image` auf False weiter aus.
* Beim Speichern und erneuten Laden des Projekts kann der Block das gespeicherte Bild wiederherstellen, sodass der Speicherzustand zwischen Sitzungen bestehen bleibt (sofern ein Bild gespeichert war).

## 🎯 Funktionen

* Einfrieren eines Frames für konsistente nachgelagerte Verarbeitung.
* Einfache boolesche Steuerung zum Sperren/Entsperren des gespeicherten Bildes.
* Persistenz beim Speichern/Laden des Projekts, damit ein erfasstes Referenzbild zwischen Sitzungen erhalten bleibt.

## 📝 Nutzungshinweise

1. Verbinden Sie eine Live-Bildquelle (Kamera, Stream, Load Image usw.) mit dem `Image Any`-Eingang.
2. Um einen Frame zu erfassen und zu halten, setzen Sie `Save Image` auf True. Der Block gibt dann diesen Frame aus.
3. Um die Live-Aktualisierung wieder aufzunehmen, setzen Sie `Save Image` auf False. Der Block übernimmt dann wieder das neueste Eingangssignal und aktualisiert sein gespeichertes Bild.

## 💡 Tipps und Tricks

* Um das gespeicherte Bild anzusehen, verbinden Sie den Ausgang dieses Blocks mit `Show Image`.
* Verwenden Sie `Image ROI Select` vor diesem Block, um nur eine Region of Interest (ROI) einzufrieren, statt des gesamten Frames.
* Für kleinere Bildgrößen (schnellere Speicherung/Verarbeitung) fügen Sie vor dem Block `Image Resize` hinzu.
* Für robustere Referenzbilder wenden Sie vor dem Erfassen `Blur` oder `Image Threshold` an, um Rauschen zu reduzieren oder die Szene zu binarisieren.
* Kombinieren Sie mit `Image Logger` oder `Image Write`, um eingefrorene Bilder beim Aktivieren von `Save Image` auf der Festplatte zu speichern.
* Verwenden Sie `Is None` oder `Replace None` nachgelagert, um mit fehlenden Bildern im Ablauf umzugehen.

## 🛠️ Fehlersuche

* Wenn die Ausgabe nach dem Laden eines Projekts leer erscheint, vergewissern Sie sich, dass zuvor ein Bild mit `Save Image` erfasst wurde, oder liefern Sie ein neues Eingangssignal und setzen Sie `Save Image` auf False, um zu aktualisieren.
* Wenn Sie Live-Updates erwarten, sich das Bild aber nicht ändert, prüfen Sie, ob `Save Image` auf False gesetzt ist, damit der Block vom Eingang aktualisieren darf.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/image-transformations/analysis/image-memory.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
