Snapshot Tool
The Snapshot Tool allows you to capture the state of any inspected member at a specific moment in time.
Snapshots can be reviewed later or compared against other snapshots to see exactly how values have changed.
This is ideal for debugging runtime state changes, verifying object modifications, or preserving important reference states for future checks.
Snapshot Modes
When creating a snapshot, you choose one of three Compare Modes:
-
Reference Only
Captures only the object reference, ignoring all member values. -
Shallow
Captures the first‑level members (fields/properties) without diving into nested objects. -
Deep
Recursively captures all nested members for the most detailed snapshot.
Creating a Snapshot
You can create a snapshot in multiple ways:
-
Drag & Drop
Drag a member from the Tree View into the Snapshot Tool area. A menu will appear to choose the snapshot type (Reference Only, Shallow, Deep). -
Contextual Menu
Right‑click a member in the Tree View and choose:Snapshot → Reference Only
Snapshot → Shallow
Snapshot → Deep
-
Toolbar Button
Use the snapshot button in the Tree View toolbar to pick the snapshot type.
Naming and Persistence
When you choose a snapshot type, a name prompt will appear:
- Name — Assign a descriptive label for easy identification.
- Persistent Toggle — If enabled, the snapshot will be stored locally so it can be reviewed at any time.
Tip: You can skip this prompt entirely by disabling it in:
Preferences → Snapshots → Prompt Snapshot Name
.
Managing Persistence
Snapshots can be made persistent or non‑persistent at any time:
Right‑click a snapshot in the list and toggle Persistent.
Viewing Snapshots
The Snapshot Tool offers two viewing modes:
-
Grouped View
Displays snapshots in a Tree View structure where each parent node is a captured member and child nodes are snapshots for that member. -
Flat View
Displays all snapshots in a flat list, sorted by creation time.
Reviewing a Snapshot
-
Double‑click on a snapshot to open it in a custom tree view in place of the default inspector.
-
To return to the default inspector view, click the close button in the snapshot view or press Escape.
Comparing Snapshots
You can compare two snapshots of the same type and compare mode:
-
Assign snapshots to Slot A and Slot B:
- Drag from the list (Grouped or Flat) into the slot.
-
Click Compare to open the Compare Result Tree View.
-
Differences are highlighted for quick inspection.
History
All compared snapshot sessions are saved in the History Tab:
-
Re‑open a past comparison by double‑clicking it.
-
The saved comparison will reopen directly in the Compare Result Tree View.