Image Memory

This function block keeps an image in memory so you can "freeze" a frame and reuse it until you choose to update it. It is useful when you want to hold a reference image for inspection, logging or downstream processing without continuously relying on a live source.

📥 Inputs

• Image Any Connect the image you want to store or update.

• Save Image When True the block will keep (freeze) the currently stored image and will not update it from the input.

📤 Outputs

• Image Any The image currently held in memory (either the last stored image or the live input when not frozen).

🕹️ Controls

• Save Image Use this boolean control to freeze or unfreeze the stored image.

  • When set to True the stored image is preserved and the block will keep outputting that image even if the input changes.

  • When set to False the block updates its stored image from the Image Any input.

⚙️ Running mechanism

• By default the block outputs the latest image connected to its Image Any input.

• If Save Image is set to True, the block will hold the current image and continue to output that same image until Save Image becomes False.

• When you save and reload your project, the block can restore the stored image so the memory state persists across sessions (if an image was stored).

🎯 Features

• Freeze-frame capability for consistent downstream processing.

• Simple boolean control to lock/unlock the stored image.

• Persistence across project save/load so a captured reference image can be kept between sessions.

📝 Usage instructions

1. Connect a live image source (camera, stream, load image, etc.) to the Image Any input.

2. To capture and hold a frame, set Save Image to True. The block will keep outputting that frame.

3. To resume live updates, set Save Image to False. The block will then copy the latest input and continue updating its stored image.

💡 Tips and Tricks

• To preview the stored image, connect this block's output to Show Image.

• Use Image ROI Select before this block to capture and freeze only a region of interest instead of the whole frame.

• If you want a smaller image for faster storage or downstream processing, add Image Resize before the block.

• For more robust reference images, apply Blur or Image Threshold before capturing to reduce noise or binarize the scene.

• Combine with Image Logger or Image Write to save frozen images to disk when Save Image is activated.

• Use Is None or Replace None downstream to guard against missing images in your flow.

🛠️ Troubleshooting

• If the output appears empty after loading a project, ensure an image was previously captured with Save Image enabled or provide a fresh input image and set Save Image to False to update.

• If you expect live updates but the image is not changing, check that Save Image is set to False so the block is allowed to refresh from the input.