Skip to content

Interactive 2D wave optics simulator. Turn any image into a refractive scene, add sources, watch waves refract, diffract and interfere. Probes, intensity maps, video export.

C#

Simulation > Warn when a run does not fit in RAM: the memory warning before a run that would spill

Alexander Graef81cfdbac17c8
diff --git a/Assets/Legend.md b/Assets/Legend.md
index 7cf9bcc..e2bb4ea 100644
--- a/Assets/Legend.md
+++ b/Assets/Legend.md
@@ -187,7 +187,8 @@ The Simulation menu.
3. **Stop**
4. **Use the GPU (OpenCL)**
5. **Re-run automatically after edits**
-6. **RAM cache size**
+6. **Warn when a run does not fit in RAM**
+7. **RAM cache size**
## The Help menu
diff --git a/Assets/menu-simulation.svg b/Assets/menu-simulation.svg
index 75038db..072e49f 100644
--- a/Assets/menu-simulation.svg
+++ b/Assets/menu-simulation.svg
@@ -1,11 +1,12 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="412" height="194.4" viewBox="0 0 515 243">
- <image x="0" y="0" width="515" height="243" xlink:href="data:image/png;base64,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"/>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="442.4" height="218.4" viewBox="0 0 553 273">
+ <image x="0" y="0" width="553" height="273" xlink:href="data:image/png;base64,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"/>
<g font-family="Segoe UI, Helvetica, Arial, sans-serif" font-size="13.75" font-weight="bold" text-anchor="middle">
<g><title>Run</title><circle cx="124" cy="51" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="51" dy=".36em" fill="#000">1</text></g>
<g><title>Pause</title><circle cx="124" cy="81" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="81" dy=".36em" fill="#000">2</text></g>
<g><title>Stop</title><circle cx="124" cy="111" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="111" dy=".36em" fill="#000">3</text></g>
<g><title>Use the GPU (OpenCL)</title><circle cx="124" cy="150" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="150" dy=".36em" fill="#000">4</text></g>
<g><title>Re-run automatically after edits</title><circle cx="124" cy="180" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="180" dy=".36em" fill="#000">5</text></g>
- <g><title>RAM cache size</title><circle cx="124" cy="210" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="210" dy=".36em" fill="#000">6</text></g>
+ <g><title>Warn when a run does not fit in RAM</title><circle cx="124" cy="210" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="210" dy=".36em" fill="#000">6</text></g>
+ <g><title>RAM cache size</title><circle cx="124" cy="240" r="11.25" fill="#FFC107" stroke="#202020" stroke-width="1.25"/><text x="124" y="240" dy=".36em" fill="#000">7</text></g>
</g>
</svg>
diff --git a/CLAUDE.md b/CLAUDE.md
index 3652ae1..3bd7e92 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -409,6 +409,21 @@ FrameStore: native memory up to the budget, the rest in a temp file (%LOCALAPPDA
validates a one-of-every-kind project and every example as saved against it with .NET's DTD validator and proves a
misspelt attribute, a wrong value and a misplaced element are reported. The examples and the harnesses' test projects are
not re-saved with it yet.
+- **Memory warning** (2026-11-03, the user's design): Simulation > Warn when a run does not fit in RAM
+ (`Settings.WarnWhenRamInsufficient`, default on). A preview run whose frames exceed the budget asks first, F5, Play and
+ the automatic re-run alike (the user's choice, so no spill is silent; an export's run is full quality by rule and never
+ asks): `MemoryWarningWindow`, in the message window's look, names the need and the budget, offers four checkboxes: the
+ RAM cache size to Auto (the user's request the same day; greyed when Auto gains less than a frame) and three that each
+ lower the preview quality a notch (half the resolution, half the frames, 8-bit samples; a lever at the View menu's
+ lowest is greyed), pre-ticked with the fewest ticks that fit and the mildest among as many (the largest need that
+ fits, so the cache comes before any loss of quality), a live line with the ticks' result, and "Do not warn me again",
+ which clears the setting. Run puts the choice into the Simulation and View menu settings
+ (persisted, so the scratch frames match the run and later runs fit without asking; the settings' change schedules a
+ scratch frame and a re-run as the View menu's does, and the run started right after leaves nothing stale for it);
+ Cancel keeps the stale run and says so at Info. Asked every time, no memory of an answer. Play asks before the pane's
+ clock starts and a cancelled warning turns playback off again (2026-11-03, the user's report: the modal window's message
+ loop had ticked the playhead through the stale frames). The arithmetic is
+ `RunSpec.StoreBytesAt`, proven by `library_check`.
- File types `.wdproj` / `.wdscheme` are registered per user at start-up; unsaved edits ask on close.
- **Examples** (2026-10-29, the user's request): File > Examples lists the project files of the repository's `Examples`
folder, embedded in the app (`EmbeddedResource` in the WPF project, `Examples.cs`), in file order with the two-digit
@@ -489,7 +504,7 @@ numbers: no GPU JPEG, no OpenCL colouring at presentation, no `Vector256`, no Di
## Harnesses
-`library_check` (100+ checks: engines, store, renderer, half tables, screen path, schemes, probes, scratch, reduced preview, importer, export, parts, group move, open edges, work groups on a prime grid, ranges, XOR gate, zone plate, gate port follower, history, clipboard, the project file's DTD, the first start's tiers, the engine's page-locked snapshots, scene replacement).
+`library_check` (100+ checks: engines, store, renderer, half tables, screen path, schemes, probes, scratch, reduced preview, importer, export, parts, group move, open edges, work groups on a prime grid, ranges, XOR gate, zone plate, gate port follower, history, clipboard, the project file's DTD, the first start's tiers, the engine's page-locked snapshots, scene replacement, the memory warning's store bytes).
UI, all on `Common.ps1`, with their check counts: `PreviewCheck` 43, `RunCheck` 71, `LanguageCheck` 11,
`ProbeGraphCheck` 39, `ImportCheck` 10, `ExportCheck` 44, `PreviewQualityCheck` 35, `SceneImageCheck` 8,
`ColorPickerCheck` 13, `KeyboardCheck` 13, `AboutCheck` 18, `SelectionCheck` 10. Test projects `tiny*.wdproj` sit beside them. The
@@ -498,7 +513,9 @@ Wave Dude 2D projects the import checks read (`library_check`, `ImportCheck`, `S
examples is gone from the repository, in history up to 02d0e2d; `library_check` finds the repository root by the
fixtures folder). A harness
sets the persisted settings it expects (split orientation, preview quality). Known flake: a second app start in one
-script sometimes comes up active; only the foreground guard fails then.
+script sometimes comes up active; only the foreground guard fails then. UI Automation files an owned dialog (the message
+window, the memory warning) under its owner, not among the root's children: find its content below the main window and
+walk up to the Window element for its handle (2026-11-03, half an hour lost to a root search).
**Manual figures** (2026-10-27): `Screenshots.ps1` on `Common.ps1` writes `Assets/*.svg` (the PNG inlined, numbered
badges at UI Automation rectangles), `Assets/Legend.md` (what each number marks) and `Assets/main-window.png` (the
window without badges, the README's picture, 2026-10-30): the window, the menus, the tree,
@@ -533,7 +550,7 @@ never reworded per file.
README and a documentation file (he writes them); an integer
upscale in exports; HEVC;
-automatic quality lowering when a run would spill (undecided); dropping the 9-point Laplacian (undecided);
+dropping the 9-point Laplacian (undecided);
**optical parts**: the open points at the end of `OpticalParts.md` (a `PartCheck.ps1` harness, example projects,
Bragg thicknesses in pixels) wait for the user.
diff --git a/MANUAL.md b/MANUAL.md
index 427b978..88525da 100644
--- a/MANUAL.md
+++ b/MANUAL.md
@@ -230,7 +230,8 @@ The Simulation menu.
3. **Stop**: Stops the run (Shift+F5); the frames computed so far stay.
4. **Use the GPU (OpenCL)**: Computes on the graphics card, many times faster than the processor; the results are the same. Off, or without OpenCL, the processor is used. On by default.
5. **Re-run automatically after edits**: Starts a new run by itself a moment after you change the scene, a source or a part; off, you run by hand with F5 or Play. On by default.
-6. **RAM cache size**: How much of the memory a run's frames may take: Auto decides from the free memory, or a share from 10 to 100 percent caps it; the frames beyond it go to a cache file on disk.
+6. **Warn when a run does not fit in RAM**: Asks before a run whose frames would not all fit in the memory the RAM cache may take. Tick the RAM cache size to Auto, half the resolution, half the frames or 8-bit samples, each with its effect shown, and Run applies them in the Simulation and View menus for this and later runs; Cancel leaves everything as it is. "Do not warn me again" switches this off. On by default.
+7. **RAM cache size**: How much of the memory a run's frames may take: Auto decides from the free memory, or a share from 10 to 100 percent caps it; the frames beyond it go to a cache file on disk.
### The Help menu
diff --git a/WaveDudeNext.WPF/Dialogs/MemoryWarningWindow.xaml b/WaveDudeNext.WPF/Dialogs/MemoryWarningWindow.xaml
new file mode 100644
index 0000000..5334065
--- /dev/null
+++ b/WaveDudeNext.WPF/Dialogs/MemoryWarningWindow.xaml
@@ -0,0 +1,77 @@
+<!--
+SPDX-License-Identifier: GPL-3.0-or-later
+Copyright (C) 2026 Alexander Graef <[email protected]>
+
+This file is part of WaveDude Next, a 2D wave simulator.
+
+Based on the work of
+ Jeroen Vleggaar (Huygens Optics), author of Wave Dude 2D, Copyright (C) 2026
+ <https://www.youtube.com/@HuygensOptics>, <https://www.huygensoptics.com>
+ 0x23 (Diffraction Limited), author of WaveSimulator2D
+ <https://www.youtube.com/@DiffractionLimited>, <https://github.com/0x23/WaveSimulator2D>
+
+WaveDude Next is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, either version 3 of the License, or (at your option) any later
+version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
+<https://www.gnu.org/licenses/>.
+-->
+
+<Window x:Class="WaveDudeNext.WPF.Dialogs.MemoryWarningWindow"
+ xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+ xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+ Title="{DynamicResource Title}" Icon="/App.ico"
+ Width="500" SizeToContent="Height" ResizeMode="NoResize" ShowInTaskbar="False"
+ WindowStartupLocation="CenterOwner"
+ Style="{StaticResource {x:Type Window}}"
+ AutomationProperties.AutomationId="MemoryWarningWindow">
+ <!-- the memory warning (2026-11-03, the user's design), in the message window's look: the question disc and the facts
+ (the run's need, the RAM cache's budget), a checkbox that sets the RAM cache size to Auto and three that each lower
+ the preview quality a notch, pre-ticked with the mildest set that makes the run fit, a line under them with the
+ ticks' result, "Do not warn me again", then Run (Enter) and Cancel (Esc); every control in the Tab cycle, the
+ buttons' underlined letters work without Alt -->
+ <Grid Margin="20,18,20,16">
+ <Grid.RowDefinitions>
+ <RowDefinition Height="Auto" />
+ <RowDefinition Height="Auto" />
+ <RowDefinition Height="Auto" />
+ <RowDefinition Height="Auto" />
+ <RowDefinition Height="Auto" />
+ <RowDefinition Height="Auto" />
+ </Grid.RowDefinitions>
+
+ <DockPanel Grid.Row="0">
+ <Grid Width="32" Height="32" Margin="0,0,16,0" VerticalAlignment="Top" DockPanel.Dock="Left">
+ <Ellipse Fill="{DynamicResource Accent}" />
+ <TextBlock Text="?" FontSize="20" FontWeight="Bold" Foreground="{DynamicResource StatusBarForeground}"
+ HorizontalAlignment="Center" VerticalAlignment="Center" />
+ </Grid>
+ <TextBlock x:Name="messageText" TextWrapping="Wrap" VerticalAlignment="Center" MinHeight="32"
+ AutomationProperties.AutomationId="MemoryWarningText" />
+ </DockPanel>
+
+ <TextBlock Grid.Row="1" Text="{DynamicResource MemoryWarningChoices}" TextWrapping="Wrap" Margin="48,14,0,6" />
+ <StackPanel Grid.Row="2" Margin="48,0,0,0">
+ <!-- the RAM cache size to Auto (2026-11-03, the user's request): the budget rises instead of the need falling; its
+ caption carries the automatic budget, so the code sets it -->
+ <CheckBox x:Name="cacheBox" Margin="0,2" AutomationProperties.AutomationId="MemoryWarningCache" />
+ <CheckBox x:Name="resolutionBox" Content="{DynamicResource MemoryWarningResolution}" Margin="0,2"
+ AutomationProperties.AutomationId="MemoryWarningResolution" />
+ <CheckBox x:Name="framesBox" Content="{DynamicResource MemoryWarningFrames}" Margin="0,2"
+ AutomationProperties.AutomationId="MemoryWarningFrames" />
+ <CheckBox x:Name="samplesBox" Content="{DynamicResource MemoryWarningSamples}" Margin="0,2"
+ AutomationProperties.AutomationId="MemoryWarningSamples" />
+ </StackPanel>
+ <TextBlock x:Name="resultText" Grid.Row="3" TextWrapping="Wrap" Margin="48,8,0,0"
+ AutomationProperties.AutomationId="MemoryWarningResult" />
+ <CheckBox x:Name="muteBox" Grid.Row="4" Content="{DynamicResource MemoryWarningMute}" Margin="48,14,0,0"
+ AutomationProperties.AutomationId="MemoryWarningMute" />
+
+ <StackPanel Grid.Row="5" Orientation="Horizontal" HorizontalAlignment="Right" Margin="0,18,0,0">
+ <Button x:Name="runButton" Content="{DynamicResource DialogRun}" MinWidth="90" Margin="8,0,0,0" IsDefault="True"
+ Click="OnRun" AutomationProperties.AutomationId="MemoryWarningRun" />
+ <Button Content="{DynamicResource DialogCancel}" MinWidth="90" Margin="8,0,0,0" IsCancel="True"
+ AutomationProperties.AutomationId="MemoryWarningCancel" />
+ </StackPanel>
+ </Grid>
+</Window>
diff --git a/WaveDudeNext.WPF/Dialogs/MemoryWarningWindow.xaml.cs b/WaveDudeNext.WPF/Dialogs/MemoryWarningWindow.xaml.cs
new file mode 100644
index 0000000..31558d0
--- /dev/null
+++ b/WaveDudeNext.WPF/Dialogs/MemoryWarningWindow.xaml.cs
@@ -0,0 +1,177 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Alexander Graef <[email protected]>
+//
+// This file is part of WaveDude Next, a 2D wave simulator.
+//
+// Based on the work of
+// Jeroen Vleggaar (Huygens Optics), author of Wave Dude 2D, Copyright (C) 2026
+// <https://www.youtube.com/@HuygensOptics>, <https://www.huygensoptics.com>
+// 0x23 (Diffraction Limited), author of WaveSimulator2D
+// <https://www.youtube.com/@DiffractionLimited>, <https://github.com/0x23/WaveSimulator2D>
+//
+// WaveDude Next is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation, either version 3 of the License, or (at your option) any later
+// version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
+// <https://www.gnu.org/licenses/>.
+
+
+using System.Media;
+using System.Windows;
+using System.Windows.Controls;
+using System.Windows.Input;
+using NLog;
+using WaveDudeNext.Engine;
+using WaveDudeNext.Runs;
+using WaveDudeNext.WPF.Theming;
+
+namespace WaveDudeNext.WPF.Dialogs;
+
+/// <summary>What the memory warning was answered with.</summary>
+/// <param name="Quality">The preview quality to run at: the current one with each ticked lever a notch lower, the current one itself when nothing was ticked.</param>
+/// <param name="CacheAuto">"RAM cache size to Auto" was ticked: the caller sets the share to automatic.</param>
+/// <param name="Mute">"Do not warn me again" was ticked: the caller clears the setting.</param>
+public sealed record MemoryWarningChoice(PreviewQuality Quality, bool CacheAuto, bool Mute);
+
+/// <summary>
+/// The memory warning (2026-11-03, the user's design): shown before a preview run whose frames would not all fit in the
+/// RAM cache (Simulation > Warn when a run does not fit in RAM). Names the run's need and the cache's budget, offers
+/// a lever that sets the RAM cache size to Auto (the budget rises; greyed when that gains less than a frame) and three
+/// that each lower the preview quality a notch (half the resolution, half the frames, 8-bit samples), pre-ticked with
+/// the fewest that make the run fit and the mildest among as many, a line under them with the ticks' result, and "Do
+/// not warn me again". Run returns the choice, Cancel or Esc null; the caller applies it. The arithmetic is
+/// <see cref="RunSpec.StoreBytesAt"/>. UI thread only.
+/// </summary>
+public partial class MemoryWarningWindow : Window
+{
+ /// <summary>The largest divisor the View menu offers: a lever there has no notch left.</summary>
+ private const int MaxDivisor = 4;
+
+ private static readonly ILogger Logger = LogManager.GetCurrentClassLogger();
+ private readonly RunSpec _spec;
+ private readonly long _budget;
+ private readonly long _autoBudget;
+ private readonly PreviewQuality _current;
+ private MemoryWarningChoice? _choice;
+
+ private MemoryWarningWindow(RunSpec spec, long budget, long autoBudget, PreviewQuality current)
+ {
+ InitializeComponent();
+ SourceInitialized += (_, _) => ThemeController.Instance.ApplyTitleBar(this);
+ _spec = spec;
+ _budget = budget;
+ _autoBudget = autoBudget;
+ _current = current;
+ messageText.Text = string.Format((string)FindResource("MemoryWarningTextFormat"), FrameMemory.Gigabytes(spec.StoreBytes), FrameMemory.Gigabytes(budget));
+ cacheBox.Content = string.Format((string)FindResource("MemoryWarningCacheFormat"), FrameMemory.Gigabytes(autoBudget));
+ // a lever with nothing to offer is greyed: the cache when Auto gains less than a frame (the share is Auto already, or
+ // the free memory binds it, which two readings of the memory status can differ about by a few kilobytes), a quality
+ // lever at its lowest notch
+ cacheBox.IsEnabled = autoBudget - budget >= FrameStore.MemoryOf(spec.Shape, spec.Layers, 1);
+ resolutionBox.IsEnabled = current.ResolutionDivisor < MaxDivisor;
+ framesBox.IsEnabled = current.FrameDivisor < MaxDivisor;
+ samplesBox.IsEnabled = current.Format == FrameFormat.Half;
+ (bool cache, bool resolution, bool frames, bool samples) = Proposal();
+ cacheBox.IsChecked = cache;
+ resolutionBox.IsChecked = resolution;
+ framesBox.IsChecked = frames;
+ samplesBox.IsChecked = samples;
+ foreach (CheckBox box in Levers)
+ {
+ box.Checked += (_, _) => ShowResult();
+ box.Unchecked += (_, _) => ShowResult();
+ }
+ ShowResult();
+ FocusManager.SetFocusedElement(this, Levers.FirstOrDefault(box => box.IsEnabled) ?? (UIElement)runButton);
+ }
+
+ /// <summary>The lever boxes in their order on screen.</summary>
+ private CheckBox[] Levers => [cacheBox, resolutionBox, framesBox, samplesBox];
+
+ /// <summary>
+ /// Shows the warning modally over <paramref name="owner"/> for a run of <paramref name="spec"/> whose frames exceed
+ /// <paramref name="budget"/> bytes of memory, <paramref name="autoBudget"/> being the budget with the RAM cache size at
+ /// Auto; <paramref name="current"/> is the preview quality the spec was made with.
+ /// </summary>
+ /// <returns>The choice Run was pressed with, or null for Cancel, Esc or the close box.</returns>
+ public static MemoryWarningChoice? Show(Window owner, RunSpec spec, long budget, long autoBudget, PreviewQuality current)
+ {
+ Logger.Debug("Memory warning: the run's frames need {Need:0.0} GB, the RAM cache has {Budget:0.0} GB ({Auto:0.0} GB at Auto)", FrameMemory.ToGigabytes(spec.StoreBytes), FrameMemory.ToGigabytes(budget), FrameMemory.ToGigabytes(autoBudget));
+ SystemSounds.Question.Play();
+ var window = new MemoryWarningWindow(spec, budget, autoBudget, current) { Owner = owner };
+ window.ShowDialog();
+ if (window._choice == null)
+ {
+ Logger.Debug("Memory warning answered: cancelled");
+ }
+ else
+ {
+ Logger.Debug("Memory warning answered: run at {Quality} ({Need:0.0} GB), RAM cache to Auto: {Cache}, warn again: {Again}", window._choice.Quality, FrameMemory.ToGigabytes(spec.StoreBytesAt(window._choice.Quality)), window._choice.CacheAuto, !window._choice.Mute);
+ }
+ return window._choice;
+ }
+
+ /// <summary>The budget the cache box stands for: the automatic one when ticked, else the current.</summary>
+ private long BudgetOf(bool cache) => cache ? _autoBudget : _budget;
+
+ /// <summary>The quality the ticks stand for: the current one with each ticked divisor doubled (to the View menu's largest) and the samples to palette indices.</summary>
+ private PreviewQuality QualityOf(bool resolution, bool frames, bool samples) => _current with
+ {
+ ResolutionDivisor = resolution ? Math.Min(_current.ResolutionDivisor * 2, MaxDivisor) : _current.ResolutionDivisor,
+ FrameDivisor = frames ? Math.Min(_current.FrameDivisor * 2, MaxDivisor) : _current.FrameDivisor,
+ Format = samples ? FrameFormat.Index : _current.Format,
+ };
+
+ /// <summary>The quality the boxes are ticked for right now.</summary>
+ private PreviewQuality Chosen => QualityOf(resolutionBox.IsChecked == true, framesBox.IsChecked == true, samplesBox.IsChecked == true);
+
+ /// <summary>
+ /// The ticks to propose: among the combinations of the levers that have something to offer, the fewest ticks that
+ /// make the run fit, and the mildest among as many (the largest need that still fits, so the cache, which leaves the
+ /// need as it is, comes before any loss of quality); a tie goes to the first-start ladder's order, 8-bit samples
+ /// before half the frames before half the resolution (the mask's bits, the sort being stable); every lever that can
+ /// when none does.
+ /// </summary>
+ private (bool Cache, bool Resolution, bool Frames, bool Samples) Proposal()
+ {
+ var fitting = new List<(bool Cache, bool Resolution, bool Frames, bool Samples, int Ticks, long Bytes)>();
+ for (int mask = 1; mask < 16; mask++)
+ {
+ bool samples = (mask & 1) != 0;
+ bool frames = (mask & 2) != 0;
+ bool resolution = (mask & 4) != 0;
+ bool cache = (mask & 8) != 0;
+ if ((cache && !cacheBox.IsEnabled) || (resolution && !resolutionBox.IsEnabled) || (frames && !framesBox.IsEnabled) || (samples && !samplesBox.IsEnabled))
+ {
+ continue;
+ }
+ long bytes = _spec.StoreBytesAt(QualityOf(resolution, frames, samples));
+ if (bytes <= BudgetOf(cache))
+ {
+ fitting.Add((cache, resolution, frames, samples, (cache ? 1 : 0) + (resolution ? 1 : 0) + (frames ? 1 : 0) + (samples ? 1 : 0), bytes));
+ }
+ }
+ if (fitting.Count == 0)
+ {
+ return (cacheBox.IsEnabled, resolutionBox.IsEnabled, framesBox.IsEnabled, samplesBox.IsEnabled);
+ }
+ var best = fitting.OrderBy(c => c.Ticks).ThenByDescending(c => c.Bytes).First();
+ return (best.Cache, best.Resolution, best.Frames, best.Samples);
+ }
+
+ /// <summary>The line under the levers: what the ticked choice needs, and whether it fits the ticked budget or how much of it still goes to disk.</summary>
+ private void ShowResult()
+ {
+ long bytes = _spec.StoreBytesAt(Chosen);
+ long budget = BudgetOf(cacheBox.IsChecked == true);
+ resultText.Text = bytes <= budget
+ ? string.Format((string)FindResource("MemoryWarningFitsFormat"), FrameMemory.Gigabytes(bytes))
+ : string.Format((string)FindResource("MemoryWarningSpillsFormat"), FrameMemory.Gigabytes(bytes), FrameMemory.Gigabytes(bytes - budget));
+ }
+
+ private void OnRun(object sender, RoutedEventArgs e)
+ {
+ _choice = new MemoryWarningChoice(Chosen, cacheBox.IsChecked == true, muteBox.IsChecked == true);
+ DialogResult = true;
+ }
+}
diff --git a/WaveDudeNext.WPF/MainWindow.Simulation.cs b/WaveDudeNext.WPF/MainWindow.Simulation.cs
index 7a8fe79..0ab9b69 100644
--- a/WaveDudeNext.WPF/MainWindow.Simulation.cs
+++ b/WaveDudeNext.WPF/MainWindow.Simulation.cs
@@ -22,6 +22,7 @@ using System.Windows.Threading;
using WaveDudeNext.Engine;
using WaveDudeNext.Model;
using WaveDudeNext.Runs;
+using WaveDudeNext.WPF.Dialogs;
using WaveDudeNext.WPF.Rendering;
namespace WaveDudeNext.WPF;
@@ -82,7 +83,8 @@ public partial class MainWindow
/// <param name="trackIntensity">Store the intensity plane whatever the project needs (an export of the intensity asks for it).</param>
/// <param name="fullQuality">Capture every cell of every frame as a half whatever the View menu says (an export needs that).</param>
/// <param name="intensityRoot">With <paramref name="fullQuality"/>: store the intensity as its square root, the preview's, or as I (an OpenEXR export of I).</param>
- private void StartRun(bool automatic = false, bool trackIntensity = false, bool fullQuality = false, bool intensityRoot = true)
+ /// <returns>Whether a run was started: false when the memory warning was cancelled.</returns>
+ private bool StartRun(bool automatic = false, bool trackIntensity = false, bool fullQuality = false, bool intensityRoot = true)
{
if (!Settings.Default.UseGpu)
{
@@ -95,6 +97,39 @@ public partial class MainWindow
// below gives them back, and the new store allocates its memory tier only once they are gone (2026-10-16)
long budget = FrameMemory.Budget(Settings.Default.FrameMemoryPercent, Run?.Store.RamBytes ?? 0);
int ramFrames = Math.Min(spec.StoredFrameCount, FrameStore.FramesInBudget(spec.Shape, spec.Layers, budget));
+ // a preview run that does not fit asks first (the memory warning, 2026-11-03, the user's design: F5, Play and the
+ // automatic re-run alike, so no spill is silent; an export's run must be full quality and never asks). The choice
+ // lands in the View menu settings, so the scratch frames match the run and later runs fit without asking; the
+ // settings' change marks the old run stale and schedules a scratch frame and a re-run, as the View menu's does, and
+ // the run started below makes that re-run find nothing stale
+ if (ramFrames < spec.StoredFrameCount && !fullQuality && Settings.Default.WarnWhenRamInsufficient)
+ {
+ // the budget with the RAM cache size at Auto, the warning's fourth lever: the budget itself when it is Auto already
+ long autoBudget = Settings.Default.FrameMemoryPercent > FrameMemory.Automatic ? FrameMemory.Budget(FrameMemory.Automatic, Run?.Store.RamBytes ?? 0) : budget;
+ MemoryWarningChoice? choice = MemoryWarningWindow.Show(this, spec, budget, autoBudget, quality);
+ if (choice == null)
+ {
+ Logger.Info("{Kind} not started: the memory warning was cancelled", automatic ? "Re-run" : "Run");
+ return false;
+ }
+ if (choice.Mute)
+ {
+ Settings.Default.WarnWhenRamInsufficient = false;
+ }
+ if (choice.CacheAuto)
+ {
+ Settings.Default.FrameMemoryPercent = FrameMemory.Automatic;
+ }
+ if (choice.Quality != quality)
+ {
+ Settings.Default.SetPreviewQuality(choice.Quality);
+ quality = PreviewQualitySetting;
+ spec = RunSpec.Create(Project, LoadSceneImage(), Settings.Default.UseGpu, trackIntensity, quality);
+ }
+ budget = FrameMemory.Budget(Settings.Default.FrameMemoryPercent, Run?.Store.RamBytes ?? 0);
+ ramFrames = Math.Min(spec.StoredFrameCount, FrameStore.FramesInBudget(spec.Shape, spec.Layers, budget));
+ SaveSettings();
+ }
if (ramFrames < spec.StoredFrameCount)
{
FrameCache.CheckSpace(FrameStore.SizeOf(spec.Shape, spec.Layers, spec.StoredFrameCount - ramFrames));
@@ -120,6 +155,7 @@ public partial class MainWindow
IsProbesStale = false;
Run = run;
run.Start();
+ return true;
}
/// <summary>The scene image's full path: as given when rooted, otherwise relative to the project file.</summary>
@@ -148,7 +184,11 @@ public partial class MainWindow
/// <summary>Stop applies to a run in progress, or to an export in progress (Esc cancels it).</summary>
private void CanStop(object sender, CanExecuteRoutedEventArgs e) => e.CanExecute = Run?.IsActive == true || Export?.IsActive == true;
- /// <summary>Play pressed: a missing or stale run is started like an automatic one (position kept, not followed); errors go to the log and status bar. Not while an export reads the store.</summary>
+ /// <summary>
+ /// Play pressed: a missing or stale run is started like an automatic one (position kept, not followed); errors go to
+ /// the log and status bar. Not while an export reads the store. A run refused in the memory warning turns playback
+ /// off again, before the pane's clock starts (2026-11-03): there is no simulation to show then.
+ /// </summary>
private void OnEnsureRun(object sender, ExecutedRoutedEventArgs e)
{
if (IsExporting || Run?.IsActive == true || (Run != null && !IsRunStale && !IsProbesStale))
@@ -157,7 +197,10 @@ public partial class MainWindow
}
try
{
- StartRun(automatic: true);
+ if (!StartRun(automatic: true))
+ {
+ previewPane.IsPlaying = false;
+ }
}
catch (Exception ex) when (ex is RunSpecException or IOException or UnauthorizedAccessException or NotSupportedException)
{
diff --git a/WaveDudeNext.WPF/MainWindow.xaml b/WaveDudeNext.WPF/MainWindow.xaml
index 7aa9614..b4545fa 100644
--- a/WaveDudeNext.WPF/MainWindow.xaml
+++ b/WaveDudeNext.WPF/MainWindow.xaml
@@ -399,6 +399,11 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<MenuItem Header="{DynamicResource MenuSimulationAutoRerun}" IsCheckable="True"
IsChecked="{Binding Source={x:Static p:Settings.Default}, Path=AutoRerun, Mode=TwoWay}"
AutomationProperties.AutomationId="MenuAutoRerun" />
+ <!-- a run whose frames do not fit in the RAM cache asks first (the memory warning, 2026-11-03, the user's design),
+ offering a lower preview quality; its "Do not warn me again" clears this -->
+ <MenuItem Header="{DynamicResource MenuSimulationWarnMemory}" IsCheckable="True"
+ IsChecked="{Binding Source={x:Static p:Settings.Default}, Path=WarnWhenRamInsufficient, Mode=TwoWay}"
+ AutomationProperties.AutomationId="MenuWarnMemory" />
<!-- the memory a run's frames may take before the rest goes to disk: the application decides from what is free
("Auto", 2026-10-15), a percentage of the RAM is only an upper bound on that -->
<MenuItem Header="{DynamicResource MenuSimulationFrameMemory}" controls:MenuIcon.Drawing="FrameMemory" AutomationProperties.AutomationId="MenuFrameMemory"
diff --git a/WaveDudeNext.WPF/MainWindow.xaml.cs b/WaveDudeNext.WPF/MainWindow.xaml.cs
index 0e8c358..1e70cf5 100644
--- a/WaveDudeNext.WPF/MainWindow.xaml.cs
+++ b/WaveDudeNext.WPF/MainWindow.xaml.cs
@@ -97,13 +97,17 @@ public partial class MainWindow : Window
{
Logger.Info(Settings.Default.UseGpu ? "Use the GPU switched on (Simulation menu)" : "Use the GPU switched off (Simulation menu): runs use the CPU from now on");
}
+ else if (args.PropertyName == nameof(Settings.WarnWhenRamInsufficient))
+ {
+ Logger.Info(Settings.Default.WarnWhenRamInsufficient ? "Memory warning switched on (Simulation menu)" : "Memory warning switched off: a run whose frames do not fit in the RAM cache goes to the cache file without asking");
+ }
else if (args.PropertyName == nameof(Settings.FrameMemoryPercent))
{
int percent = Settings.Default.FrameMemoryPercent;
double budget = FrameMemory.ToGigabytes(FrameMemory.Budget(percent));
if (percent <= FrameMemory.Automatic)
{
- Logger.Info("RAM cache size: automatic (what is free minus {Margin:0.0} GB), {Budget:0.0} GB right now (Simulation menu)", FrameMemory.ToGigabytes(FrameMemory.Margin), budget);
+ Logger.Info("RAM cache size: automatic (what is free minus {Margin:0.0} GB), {Budget:0.0} GB right now (Simulation menu or the memory warning)", FrameMemory.ToGigabytes(FrameMemory.Margin), budget);
}
else
{
@@ -112,7 +116,7 @@ public partial class MainWindow : Window
}
else if (args.PropertyName is nameof(Settings.PreviewResolution) or nameof(Settings.PreviewFrames) or nameof(Settings.PreviewSampleBytes))
{
- Logger.Info("Preview quality: {Quality} (View menu)", PreviewQualitySetting);
+ Logger.Info("Preview quality: {Quality} (View menu or the memory warning)", PreviewQualitySetting);
OnPreviewQualityChanged();
}
else if (args.PropertyName == nameof(Settings.PreviewDitherBits))
diff --git a/WaveDudeNext.WPF/Panes/PreviewPane.xaml.cs b/WaveDudeNext.WPF/Panes/PreviewPane.xaml.cs
index 6cfa54c..7ae2c27 100644
--- a/WaveDudeNext.WPF/Panes/PreviewPane.xaml.cs
+++ b/WaveDudeNext.WPF/Panes/PreviewPane.xaml.cs
@@ -1004,11 +1004,18 @@ public partial class PreviewPane : UserControl
{
pane.Position = pane.InPoint; // play the range again from its start
}
+ // playing means showing the simulation: the window starts a run when there is none or it is stale. Asked before
+ // the clock starts (2026-11-03, the user's report): a run that does not fit asks in a modal window, whose message
+ // loop had ticked the clock through the stale frames; a refused run turns playback off again, which lands here
+ // with false before the command returns, so the clock stays off then
+ SimulationCommands.EnsureRun.Execute(null, pane);
+ if (!pane.IsPlaying)
+ {
+ return;
+ }
pane._carry = 0.0;
pane._clock.Restart();
pane._timer.Start();
- // playing means showing the simulation: the window starts a run when there is none or it is stale
- SimulationCommands.EnsureRun.Execute(null, pane);
}
else
{
diff --git a/WaveDudeNext.WPF/Settings.cs b/WaveDudeNext.WPF/Settings.cs
index ac2ce3c..936aac7 100644
--- a/WaveDudeNext.WPF/Settings.cs
+++ b/WaveDudeNext.WPF/Settings.cs
@@ -170,6 +170,20 @@ public sealed class Settings : INotifyPropertyChanged
set => Set(ref _autoRerun, value);
}
+ private bool _warnWhenRamInsufficient = true;
+
+ /// <summary>
+ /// Whether a run whose frames would not all fit in the RAM cache asks first (Simulation > Warn when a run does not fit
+ /// in RAM, 2026-11-03, the user's design): the memory warning offers a lower preview quality for it; off, the frames
+ /// beyond the budget go to the cache file with only the log saying so. The warning's "Do not warn me again" clears it.
+ /// </summary>
+ [XmlAttribute, DefaultValue(true)]
+ public bool WarnWhenRamInsufficient
+ {
+ get => _warnWhenRamInsufficient;
+ set => Set(ref _warnWhenRamInsufficient, value);
+ }
+
private bool _useGpu = true;
/// <summary>Whether runs use the OpenCL engine, falling back to the CPU.</summary>
@@ -287,12 +301,18 @@ public sealed class Settings : INotifyPropertyChanged
set => Set(ref _exportHints, value);
}
- /// <summary>Sets the three preview quality settings and the dithering as one: a first start's choice for the machine (<see cref="PreviewDefaults"/>).</summary>
- public void SetPreviewQuality(PreviewQuality quality, int ditherBits)
+ /// <summary>Sets the three preview quality settings as one (the memory warning's choice, 2026-11-03); each raises its change.</summary>
+ public void SetPreviewQuality(PreviewQuality quality)
{
PreviewResolution = quality.ResolutionDivisor;
PreviewFrames = quality.FrameDivisor;
PreviewSampleBytes = quality.Format == FrameFormat.Half ? 2 : 1;
+ }
+
+ /// <summary>Sets the three preview quality settings and the dithering as one: a first start's choice for the machine (<see cref="PreviewDefaults"/>).</summary>
+ public void SetPreviewQuality(PreviewQuality quality, int ditherBits)
+ {
+ SetPreviewQuality(quality);
PreviewDitherBits = ditherBits;
}
diff --git a/WaveDudeNext.WPF/Strings/Strings.DE.xaml b/WaveDudeNext.WPF/Strings/Strings.DE.xaml
index dfb0d4b..ee97be2 100644
--- a/WaveDudeNext.WPF/Strings/Strings.DE.xaml
+++ b/WaveDudeNext.WPF/Strings/Strings.DE.xaml
@@ -101,6 +101,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="MenuSimulationStop">S_topp</s:String>
<s:String x:Key="MenuSimulationUseGpu">_GPU verwenden (OpenCL)</s:String>
<s:String x:Key="MenuSimulationAutoRerun">Nach Änderungen _automatisch neu starten</s:String>
+ <s:String x:Key="MenuSimulationWarnMemory">_Warnen, wenn ein Lauf nicht in den RAM passt</s:String>
<s:String x:Key="MenuSimulationFrameMemory">Größe des RAM-_Caches</s:String>
<s:String x:Key="MenuSimulationFrameMemoryAuto">_Auto</s:String>
<s:String x:Key="MenuHelp">_Hilfe</s:String>
@@ -270,6 +271,17 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="DialogSave">_Speichern</s:String>
<s:String x:Key="DialogDiscard">_Nicht speichern</s:String>
<s:String x:Key="DialogCancel">_Abbrechen</s:String>
+ <s:String x:Key="DialogRun">_Starten</s:String>
+ <!-- die Speicherwarnung (Simulation > Warnen, wenn ein Lauf nicht in den RAM passt) -->
+ <s:String x:Key="MemoryWarningTextFormat">Die Bilder des Laufs brauchen {0} Speicher, der RAM-Cache hat {1}. Die Bilder darüber hinaus gehen in die Cache-Datei auf der Festplatte, was langsamer ist.</s:String>
+ <s:String x:Key="MemoryWarningChoices">Einstellungen, die für diesen und spätere Läufe geändert werden:</s:String>
+ <s:String x:Key="MemoryWarningCacheFormat">RAM-Cache auf Auto: {0} für die Bilder (Menü Simulation)</s:String>
+ <s:String x:Key="MemoryWarningResolution">Auflösung halbieren: ein Viertel des Speichers (Menü Ansicht)</s:String>
+ <s:String x:Key="MemoryWarningFrames">Halb so viele Bilder speichern: die Hälfte des Speichers (Menü Ansicht)</s:String>
+ <s:String x:Key="MemoryWarningSamples">8-Bit-Samples: die Hälfte des Speichers (Menü Ansicht)</s:String>
+ <s:String x:Key="MemoryWarningFitsFormat">Die Bilder brauchen dann {0} und passen in den RAM-Cache.</s:String>
+ <s:String x:Key="MemoryWarningSpillsFormat">Die Bilder brauchen dann {0}; {1} davon gehen weiterhin auf die Festplatte.</s:String>
+ <s:String x:Key="MemoryWarningMute">Nicht mehr warnen</s:String>
<s:String x:Key="NoSelection">Keine Auswahl</s:String>
<s:String x:Key="TreeProject">Projekt</s:String>
diff --git a/WaveDudeNext.WPF/Strings/Strings.EN.xaml b/WaveDudeNext.WPF/Strings/Strings.EN.xaml
index 4fbb81b..5a64417 100644
--- a/WaveDudeNext.WPF/Strings/Strings.EN.xaml
+++ b/WaveDudeNext.WPF/Strings/Strings.EN.xaml
@@ -103,6 +103,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="MenuSimulationStop">S_top</s:String>
<s:String x:Key="MenuSimulationUseGpu">Use the _GPU (OpenCL)</s:String>
<s:String x:Key="MenuSimulationAutoRerun">Re-run _automatically after edits</s:String>
+ <s:String x:Key="MenuSimulationWarnMemory">_Warn when a run does not fit in RAM</s:String>
<s:String x:Key="MenuSimulationFrameMemory">RAM _cache size</s:String>
<s:String x:Key="MenuSimulationFrameMemoryAuto">_Auto</s:String>
<s:String x:Key="MenuHelp">_Help</s:String>
@@ -272,6 +273,17 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="DialogSave">_Save</s:String>
<s:String x:Key="DialogDiscard">_Don't save</s:String>
<s:String x:Key="DialogCancel">_Cancel</s:String>
+ <s:String x:Key="DialogRun">_Run</s:String>
+ <!-- the memory warning (Simulation > Warn when a run does not fit in RAM): {0} the run's need, {1} the RAM cache's budget; in the result lines {0} the ticked choice's need, {1} what still goes to disk -->
+ <s:String x:Key="MemoryWarningTextFormat">The run's frames need {0} of memory, and the RAM cache has {1}. The frames beyond that go to the cache file on disk, which is slower.</s:String>
+ <s:String x:Key="MemoryWarningChoices">Settings to change for this and later runs:</s:String>
+ <s:String x:Key="MemoryWarningCacheFormat">RAM cache size to Auto: {0} for the frames (Simulation menu)</s:String>
+ <s:String x:Key="MemoryWarningResolution">Halve the resolution: a quarter of the memory (View menu)</s:String>
+ <s:String x:Key="MemoryWarningFrames">Store half the frames: half the memory (View menu)</s:String>
+ <s:String x:Key="MemoryWarningSamples">8-bit samples: half the memory (View menu)</s:String>
+ <s:String x:Key="MemoryWarningFitsFormat">The frames then need {0} and fit in the RAM cache.</s:String>
+ <s:String x:Key="MemoryWarningSpillsFormat">The frames then need {0}; {1} of them still go to disk.</s:String>
+ <s:String x:Key="MemoryWarningMute">Do not warn me again</s:String>
<s:String x:Key="NoSelection">No selection</s:String>
<s:String x:Key="TreeProject">Project</s:String>
diff --git a/WaveDudeNext.WPF/Strings/Strings.FR.xaml b/WaveDudeNext.WPF/Strings/Strings.FR.xaml
index df06357..448077f 100644
--- a/WaveDudeNext.WPF/Strings/Strings.FR.xaml
+++ b/WaveDudeNext.WPF/Strings/Strings.FR.xaml
@@ -101,6 +101,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="MenuSimulationStop">_Arrêter</s:String>
<s:String x:Key="MenuSimulationUseGpu">Utiliser le _GPU (OpenCL)</s:String>
<s:String x:Key="MenuSimulationAutoRerun">Relancer a_utomatiquement après une modification</s:String>
+ <s:String x:Key="MenuSimulationWarnMemory">A_vertir quand une simulation ne tient pas dans la RAM</s:String>
<s:String x:Key="MenuSimulationFrameMemory">Taille du _cache RAM</s:String>
<s:String x:Key="MenuSimulationFrameMemoryAuto">_Auto</s:String>
<s:String x:Key="MenuHelp">_Aide</s:String>
@@ -270,6 +271,17 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="DialogSave">_Enregistrer</s:String>
<s:String x:Key="DialogDiscard">_Ne pas enregistrer</s:String>
<s:String x:Key="DialogCancel">_Annuler</s:String>
+ <s:String x:Key="DialogRun">_Lancer</s:String>
+ <!-- l'avertissement mémoire (Simulation > Avertir quand une simulation ne tient pas dans la RAM) -->
+ <s:String x:Key="MemoryWarningTextFormat">Les images de la simulation ont besoin de {0} de mémoire ; le cache RAM en offre {1}. Les images au-delà vont dans le fichier cache sur le disque, ce qui est plus lent.</s:String>
+ <s:String x:Key="MemoryWarningChoices">Réglages à changer pour cette simulation et les suivantes :</s:String>
+ <s:String x:Key="MemoryWarningCacheFormat">Cache RAM sur Auto : {0} pour les images (menu Simulation)</s:String>
+ <s:String x:Key="MemoryWarningResolution">Résolution divisée par deux : un quart de la mémoire (menu Affichage)</s:String>
+ <s:String x:Key="MemoryWarningFrames">Moitié moins d'images conservées : la moitié de la mémoire (menu Affichage)</s:String>
+ <s:String x:Key="MemoryWarningSamples">Échantillons 8 bits : la moitié de la mémoire (menu Affichage)</s:String>
+ <s:String x:Key="MemoryWarningFitsFormat">Les images ont alors besoin de {0} et tiennent dans le cache RAM.</s:String>
+ <s:String x:Key="MemoryWarningSpillsFormat">Les images ont alors besoin de {0} ; {1} vont encore sur le disque.</s:String>
+ <s:String x:Key="MemoryWarningMute">Ne plus m'avertir</s:String>
<s:String x:Key="NoSelection">Aucune sélection</s:String>
<s:String x:Key="TreeProject">Projet</s:String>
diff --git a/WaveDudeNext.WPF/Strings/Strings.NL.xaml b/WaveDudeNext.WPF/Strings/Strings.NL.xaml
index 0a7648c..eac6212 100644
--- a/WaveDudeNext.WPF/Strings/Strings.NL.xaml
+++ b/WaveDudeNext.WPF/Strings/Strings.NL.xaml
@@ -101,6 +101,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="MenuSimulationStop">S_toppen</s:String>
<s:String x:Key="MenuSimulationUseGpu">_GPU gebruiken (OpenCL)</s:String>
<s:String x:Key="MenuSimulationAutoRerun">Na bewerkingen _automatisch opnieuw starten</s:String>
+ <s:String x:Key="MenuSimulationWarnMemory">_Waarschuwen als een simulatie niet in het RAM past</s:String>
<s:String x:Key="MenuSimulationFrameMemory">Grootte van de RAM-_cache</s:String>
<s:String x:Key="MenuSimulationFrameMemoryAuto">_Auto</s:String>
<s:String x:Key="MenuHelp">_Help</s:String>
@@ -270,6 +271,17 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or
<s:String x:Key="DialogSave">_Opslaan</s:String>
<s:String x:Key="DialogDiscard">_Niet opslaan</s:String>
<s:String x:Key="DialogCancel">_Annuleren</s:String>
+ <s:String x:Key="DialogRun">_Starten</s:String>
+ <!-- de geheugenwaarschuwing (Simulatie > Waarschuwen als een simulatie niet in het RAM past) -->
+ <s:String x:Key="MemoryWarningTextFormat">De beelden van de simulatie hebben {0} geheugen nodig, en de RAM-cache heeft {1}. De beelden daarboven gaan naar het cachebestand op de schijf, wat trager is.</s:String>
+ <s:String x:Key="MemoryWarningChoices">Instellingen die voor deze en latere simulaties veranderen:</s:String>
+ <s:String x:Key="MemoryWarningCacheFormat">RAM-cache op Auto: {0} voor de beelden (menu Simulatie)</s:String>
+ <s:String x:Key="MemoryWarningResolution">Resolutie halveren: een kwart van het geheugen (menu Beeld)</s:String>
+ <s:String x:Key="MemoryWarningFrames">Half zoveel beelden opslaan: de helft van het geheugen (menu Beeld)</s:String>
+ <s:String x:Key="MemoryWarningSamples">8-bits samples: de helft van het geheugen (menu Beeld)</s:String>
+ <s:String x:Key="MemoryWarningFitsFormat">De beelden hebben dan {0} nodig en passen in de RAM-cache.</s:String>
+ <s:String x:Key="MemoryWarningSpillsFormat">De beelden hebben dan {0} nodig; {1} daarvan gaan nog naar de schijf.</s:String>
+ <s:String x:Key="MemoryWarningMute">Niet meer waarschuwen</s:String>
<s:String x:Key="NoSelection">Geen selectie</s:String>
<s:String x:Key="TreeProject">Project</s:String>
diff --git a/WaveDudeNext/Runs/FrameStore.cs b/WaveDudeNext/Runs/FrameStore.cs
index c4aad0f..2829ca5 100644
--- a/WaveDudeNext/Runs/FrameStore.cs
+++ b/WaveDudeNext/Runs/FrameStore.cs
@@ -206,6 +206,9 @@ public sealed unsafe class FrameStore : IFrameSource, IDisposable
/// <summary>Bytes a file holding <paramref name="capacity"/> frames of this shape takes, for <see cref="FrameCache.CheckSpace"/> (the spilled part of a run).</summary>
public static long SizeOf(FrameShape shape, FrameLayers layers, int capacity) => HeaderSize + capacity * FrameBytesOf(shape, layers);
+ /// <summary>Bytes <paramref name="frames"/> frames of this shape take in memory, no file header: a run's need against <see cref="FrameMemory.Budget(int, long)"/>.</summary>
+ public static long MemoryOf(FrameShape shape, FrameLayers layers, int frames) => frames * FrameBytesOf(shape, layers);
+
/// <summary>How many frames of this shape fit into <paramref name="budget"/> bytes of memory.</summary>
public static int FramesInBudget(FrameShape shape, FrameLayers layers, long budget) =>
(int)Math.Clamp(Math.Max(0, budget) / FrameBytesOf(shape, layers), 0, int.MaxValue);
diff --git a/WaveDudeNext/Runs/RunSpec.cs b/WaveDudeNext/Runs/RunSpec.cs
index 590d8f4..2f93ace 100644
--- a/WaveDudeNext/Runs/RunSpec.cs
+++ b/WaveDudeNext/Runs/RunSpec.cs
@@ -89,6 +89,17 @@ public sealed class RunSpec
/// <summary>Number of frames actually stored: ⌈<see cref="FrameCount"/> / <see cref="FrameStride"/>⌉ (the store's capacity).</summary>
public int StoredFrameCount => (FrameCount + FrameStride - 1) / FrameStride;
+ /// <summary>Bytes the stored frames take in memory at the spec's own quality: <see cref="StoredFrameCount"/> frames of <see cref="Shape"/> with <see cref="Layers"/>.</summary>
+ public long StoreBytes => StoreBytesAt(Quality);
+
+ /// <summary>
+ /// Bytes the stored frames would take in memory at another <paramref name="quality"/> on this canvas with these
+ /// layers (the memory warning's arithmetic for each of its choices, 2026-11-03): ⌈<see cref="FrameCount"/> / its frame
+ /// divisor⌉ frames, each of <see cref="Shape"/> at its resolution divisor and sample format.
+ /// </summary>
+ public long StoreBytesAt(PreviewQuality quality) =>
+ FrameStore.MemoryOf(Shape with { Divisor = quality.ResolutionDivisor, Format = quality.Format }, Layers, (FrameCount + quality.FrameDivisor - 1) / quality.FrameDivisor);
+
/// <summary>Index in the store of the frame that shows timeline frame <paramref name="frame"/>: the last stored one at or before it.</summary>
public int StoredIndexOf(int frame) => frame / FrameStride;
diff --git a/_tools/library_check/Program.cs b/_tools/library_check/Program.cs
index 17dcdc7..67f2d4d 100644
--- a/_tools/library_check/Program.cs
+++ b/_tools/library_check/Program.cs
@@ -277,6 +277,7 @@ internal static class Program
CheckFrameStore(scene);
CheckFirstStart();
CheckPreviewQuality(scene, W, H);
+ CheckStoreBytes();
CheckRenderer();
CheckColorSchemes();
CheckProbeGraph();
@@ -1762,6 +1763,35 @@ internal static class Program
/// the CPU captures of every shape equal to it and the GPU's within the card's arithmetic, a store of index
/// bytes, the export's refusal of it, a spec with a quality, and a headless run plus a scratch frame in that shape.
/// </summary>
+ /// <summary>
+ /// A run's store bytes at another preview quality (the memory warning's arithmetic, 2026-11-03): ⌈frames / frame
+ /// divisor⌉ frames of the canvas at the resolution divisor in the sample format, against the sizes written out, and a
+ /// spec made at that quality needing the same.
+ /// </summary>
+ private static void CheckStoreBytes()
+ {
+ Console.WriteLine("--- store bytes at a preview quality (the memory warning)");
+ var project = new Project();
+ project.Scene.Width = 64;
+ project.Scene.Height = 48;
+ project.Simulation.Steps = 18;
+ project.Simulation.VisualizeEvery = 2;
+ RunSpec full = RunSpec.Create(project, null, preferGpu: false);
+ int planes = full.TrackIntensity ? 2 : 1;
+ long plane = 64L * 48;
+ long halfPlane = 32L * 24;
+ Check(full.FrameCount == 9 && full.StoreBytes == 9 * 2 * plane * planes
+ && full.StoreBytesAt(new PreviewQuality(2, 1, FrameFormat.Half)) == 9 * 2 * halfPlane * planes
+ && full.StoreBytesAt(new PreviewQuality(1, 2, FrameFormat.Half)) == 5 * 2 * plane * planes
+ && full.StoreBytesAt(new PreviewQuality(1, 4, FrameFormat.Half)) == 3 * 2 * plane * planes
+ && full.StoreBytesAt(new PreviewQuality(1, 1, FrameFormat.Index)) == 9 * plane * planes
+ && full.StoreBytesAt(new PreviewQuality(2, 2, FrameFormat.Index)) == 5 * halfPlane * planes,
+ "store bytes: 9 frames of 64x48 as halves; half resolution a quarter, every second frame 5 frames, every fourth 3, 8-bit half, all three together");
+ RunSpec reduced = RunSpec.Create(project, null, preferGpu: false, quality: new PreviewQuality(2, 2, FrameFormat.Index));
+ Check(reduced.StoreBytes == full.StoreBytesAt(reduced.Quality) && reduced.StoreBytes == FrameStore.MemoryOf(reduced.Shape, reduced.Layers, reduced.StoredFrameCount),
+ "a spec made at a quality needs what the full spec computes for it: the store's frame bytes times its capacity");
+ }
+
private static void CheckPreviewQuality(SceneData scene, int W, int H)
{
Console.WriteLine("--- preview quality (shrunk and 8-bit frames)");