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#
A scene pixel with red 0 is a mirror; red below 100 is an index of 1
Alexander Graef5dbefa6ec239
diff --git a/CLAUDE.md b/CLAUDE.mdindex 23498d3..8314d0e 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -88,7 +88,8 @@ FrameStore: native memory up to the budget, the rest in a temp file (%LOCALAPPDA- **Engine contract**: padded grid (`Stride = Width + 2`), one driver thread at a time, no locking; capturesdeliver planes in the spec's `FrameShape` (halves or palette index bytes, the GPU converting on the card);`Reset`, `SetEmitters`, `SetProbes`. Numerics are Jeroen's (dx = dt = 1, leapfrog, 9-point or 4th-order- Laplacian, soft sources, EMA intensity), verified CPU = GPU by the harness; seeds from `Pcg32` make CPU = GPU+ Laplacian, soft sources, EMA intensity; a scene pixel with red 0 is a mirror, n = 1000, his V0.30 rule,+ 2026-10-18), verified CPU = GPU by the harness; seeds from `Pcg32` make CPU = GPUbit for bit on random gaps. The importer's fallbacks differ from the model's defaults on purpose.- **Frames vs steps**: frame k is the state after step `k × VisualizeEvery`.- **The engine choice is a user setting** (Simulation > Use the GPU, default on, CPU fallback logged).diff --git a/WaveDudeNext.WPF/Strings/Strings.DE.xaml b/WaveDudeNext.WPF/Strings/Strings.DE.xamlindex 3688858..76a755e 100644--- a/WaveDudeNext.WPF/Strings/Strings.DE.xaml+++ b/WaveDudeNext.WPF/Strings/Strings.DE.xaml@@ -359,7 +359,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or<s:String x:Key="Label.Scene.Mode">Modus</s:String><s:String x:Key="Hint.Scene.Mode">Leere Leinwand der angegebenen Größe oder eine aus dem Szenenbild gebaute Leinwand.</s:String><s:String x:Key="Label.Scene.Image">Szenenbild</s:String>- <s:String x:Key="Hint.Scene.Image">Bild, aus dem die Leinwand gebaut wird: Rot = Brechungsindex, Grün = Quellen, Blau = Dämpfung. Der Name des eingebetteten Bilds oder ein Pfad relativ zum Projektordner.</s:String>+ <s:String x:Key="Hint.Scene.Image">Bild, aus dem die Leinwand gebaut wird: Rot = Brechungsindex (Rot 0 = ein Spiegel), Grün = Quellen, Blau = Dämpfung. Der Name des eingebetteten Bilds oder ein Pfad relativ zum Projektordner.</s:String><s:String x:Key="Label.Scene.ImagePath">Bilddatei</s:String><s:String x:Key="Hint.Scene.ImagePath">Herkunft des eingebetteten Bilds. Die Datei wird beobachtet, solange das Projekt offen ist, und bei Änderung neu eingebettet; beim Öffnen des Projekts ersetzt eine geänderte Datei das eingebettete Bild ebenfalls.</s:String><s:String x:Key="Label.Scene.Width">Breite</s:String>diff --git a/WaveDudeNext.WPF/Strings/Strings.EN.xaml b/WaveDudeNext.WPF/Strings/Strings.EN.xamlindex e71bbb0..df6a29c 100644--- a/WaveDudeNext.WPF/Strings/Strings.EN.xaml+++ b/WaveDudeNext.WPF/Strings/Strings.EN.xaml@@ -361,7 +361,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or<s:String x:Key="Label.Scene.Mode">Mode</s:String><s:String x:Key="Hint.Scene.Mode">Blank canvas of the given size, or a canvas built from the scene image.</s:String><s:String x:Key="Label.Scene.Image">Scene image</s:String>- <s:String x:Key="Hint.Scene.Image">Image the canvas is built from: red = refractive index, green = sources, blue = damping. The name of the embedded image, or a path relative to the project folder.</s:String>+ <s:String x:Key="Hint.Scene.Image">Image the canvas is built from: red = refractive index (red 0 = a mirror), green = sources, blue = damping. The name of the embedded image, or a path relative to the project folder.</s:String><s:String x:Key="Label.Scene.ImagePath">Image file</s:String><s:String x:Key="Hint.Scene.ImagePath">Where the embedded image came from. It is watched while the project is open and re-embedded when it changes; on opening the project a changed file replaces the embedded image too.</s:String><s:String x:Key="Label.Scene.Width">Width</s:String>diff --git a/WaveDudeNext.WPF/Strings/Strings.FR.xaml b/WaveDudeNext.WPF/Strings/Strings.FR.xamlindex 706d009..f309b21 100644--- a/WaveDudeNext.WPF/Strings/Strings.FR.xaml+++ b/WaveDudeNext.WPF/Strings/Strings.FR.xaml@@ -359,7 +359,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or<s:String x:Key="Label.Scene.Mode">Mode</s:String><s:String x:Key="Hint.Scene.Mode">Toile vierge de la taille donnée, ou toile construite à partir de l'image de scène.</s:String><s:String x:Key="Label.Scene.Image">Image de scène</s:String>- <s:String x:Key="Hint.Scene.Image">Image dont la toile est construite : rouge = indice de réfraction, vert = sources, bleu = amortissement. Le nom de l'image intégrée, ou un chemin relatif au dossier du projet.</s:String>+ <s:String x:Key="Hint.Scene.Image">Image dont la toile est construite : rouge = indice de réfraction (rouge 0 = un miroir), vert = sources, bleu = amortissement. Le nom de l'image intégrée, ou un chemin relatif au dossier du projet.</s:String><s:String x:Key="Label.Scene.ImagePath">Fichier image</s:String><s:String x:Key="Hint.Scene.ImagePath">Origine de l'image intégrée. Le fichier est surveillé tant que le projet est ouvert et réintégré quand il change ; à l'ouverture du projet, un fichier modifié remplace aussi l'image intégrée.</s:String><s:String x:Key="Label.Scene.Width">Largeur</s:String>diff --git a/WaveDudeNext.WPF/Strings/Strings.NL.xaml b/WaveDudeNext.WPF/Strings/Strings.NL.xamlindex 125c5fb..3d00b83 100644--- a/WaveDudeNext.WPF/Strings/Strings.NL.xaml+++ b/WaveDudeNext.WPF/Strings/Strings.NL.xaml@@ -359,7 +359,7 @@ version. It is distributed WITHOUT ANY WARRANTY. See the LICENSE.md file or<s:String x:Key="Label.Scene.Mode">Modus</s:String><s:String x:Key="Hint.Scene.Mode">Leeg canvas van de opgegeven grootte, of een canvas opgebouwd uit de scèneafbeelding.</s:String><s:String x:Key="Label.Scene.Image">Scèneafbeelding</s:String>- <s:String x:Key="Hint.Scene.Image">Afbeelding waaruit het canvas wordt opgebouwd: rood = brekingsindex, groen = bronnen, blauw = demping. De naam van de ingebedde afbeelding, of een pad relatief aan de projectmap.</s:String>+ <s:String x:Key="Hint.Scene.Image">Afbeelding waaruit het canvas wordt opgebouwd: rood = brekingsindex (rood 0 = een spiegel), groen = bronnen, blauw = demping. De naam van de ingebedde afbeelding, of een pad relatief aan de projectmap.</s:String><s:String x:Key="Label.Scene.ImagePath">Afbeeldingsbestand</s:String><s:String x:Key="Hint.Scene.ImagePath">Herkomst van de ingebedde afbeelding. Het bestand wordt bewaakt zolang het project open is en opnieuw ingebed als het verandert; bij het openen van het project vervangt een gewijzigd bestand de ingebedde afbeelding ook.</s:String><s:String x:Key="Label.Scene.Width">Breedte</s:String>diff --git a/WaveDudeNext/Engine/SceneData.cs b/WaveDudeNext/Engine/SceneData.csindex 418c784..628ff2c 100644--- a/WaveDudeNext/Engine/SceneData.cs+++ b/WaveDudeNext/Engine/SceneData.cs@@ -23,7 +23,9 @@ namespace WaveDudeNext.Engine;/// velocity: 1 = no damping, 0 = the wave is stopped) and the positions / levels of image-defined sources/// (the value of the green channel sets the frequency)./// The rules are those of the Python classes <c>StaticImageScene</c>, <c>StaticRefractiveIndex</c> and-/// <c>StaticDampening</c>: red channel = refractive index * 100 (clamped to 0.9..10), green = every pixel+/// <c>StaticDampening</c>: red channel = refractive index * 100 (clamped to 1..10 as in Wave Dude 2D, whose help says+/// values below 100 are set to 100; the Python clamped at 0.9, 2026-10-18; red 0 is a mirror, see+/// <see cref="MirrorRefractiveIndex"/>), green = every pixel/// above 0 is a sinusoidal source whose level is the green value, blue = damping strength (0 = none,/// 255 = full; stored as <c>D = 1 - blue / 255</c>), damping edge = a border of the given thickness with/// damping factor <c>sqrt(i / thickness)</c> at i pixels from the edge.@@ -34,6 +36,13 @@ namespace WaveDudeNext.Engine;/// </summary>public sealed class SceneData{+ /// <summary>+ /// The refractive index of a scene pixel with a red value of 0: Jeroen's rule from Wave Dude 2D V0.30 (2026-10-18). Such a+ /// pixel is a mirror, a wall no wave gets through (a source placed inside one crawls); a closed outline of them is a+ /// cavity that keeps a wave for ever. Red values below 90 were never usable, so nothing else changes.+ /// </summary>+ public const double MirrorRefractiveIndex = 1000.0;+private SceneData(int w, int h, float[] c2, float[] d, int[] srcX, int[] srcY, byte[] srcLevel){Width = w;@@ -76,7 +85,7 @@ public sealed class SceneDataint blue = row[offset];int green = row[offset + 1];int red = row[offset + 2];- double refractiveIndex = Math.Clamp(red / 100.0, 0.9, 10.0);+ double refractiveIndex = red == 0 ? MirrorRefractiveIndex : Math.Clamp(red / 100.0, 1.0, 10.0);double speed = 1.0 / refractiveIndex;int index = y * width + x;c2[index] = (float)(speed * speed);@@ -95,7 +104,7 @@ public sealed class SceneData/// <summary>/// Creates a uniform, user defined <paramref name="w"/> x <paramref name="h"/> scene without sources: the- /// speed is derived from <paramref name="refractiveIndex"/> (clamped to 0.9..10) and the damping+ /// speed is derived from <paramref name="refractiveIndex"/> (clamped to 1..10) and the damping/// factor is 1 (none) everywhere except in the <paramref name="dampingEdge"/> border./// </summary>/// <param name="w">Canvas width in pixels.</param>@@ -104,7 +113,7 @@ public sealed class SceneData/// <param name="refractiveIndex">Background refractive index (1.0 by default, the same rule as a scene image's red channel: index = red / 100).</param>public static SceneData Empty(int w, int h, int dampingEdge, double refractiveIndex = 1.0){- float speed = (float)(1.0 / Math.Clamp(refractiveIndex, 0.9, 10.0));+ float speed = (float)(1.0 / Math.Clamp(refractiveIndex, 1.0, 10.0));float[] c2 = new float[w * h];float[] d = new float[w * h];Array.Fill(c2, speed * speed);diff --git a/WaveDudeNext/Model/Scene.cs b/WaveDudeNext/Model/Scene.csindex b88cb78..8cc09b4 100644--- a/WaveDudeNext/Model/Scene.cs+++ b/WaveDudeNext/Model/Scene.cs@@ -91,7 +91,7 @@ public sealed class Scene : ObservableObject[DefaultValue("")][Category("Canvas")][DisplayName("Scene image")]- [Description("Image the canvas is built from: red = refractive index, green = sources, blue = damping. The name of the embedded image, or a path relative to the project folder.")]+ [Description("Image the canvas is built from: red = refractive index (red 0 = a mirror), green = sources, blue = damping. The name of the embedded image, or a path relative to the project folder.")]public string Image{get => _image;diff --git a/_tools/library_check/Program.cs b/_tools/library_check/Program.csindex e8b9e21..fdd0a85 100644--- a/_tools/library_check/Program.cs+++ b/_tools/library_check/Program.cs@@ -212,6 +212,7 @@ internal static class ProgramCheckCaptureResetEmitters(scene, W, H);CheckDeterminism(scene);CheckEmitterMapping();+ CheckMirror(W, H);CheckFrameStore(scene);CheckPreviewQuality(scene, W, H);CheckRenderer();@@ -545,6 +546,57 @@ internal static class Program}}+ /// <summary>Jeroen's V0.30 rule: a red value of 0 is a refractive index of 1000, a wall no wave gets through.</summary>+ private static void CheckMirror(int W, int H)+ {+ Console.WriteLine("--- mirror pixels (red 0)");+ (byte[] bgra, int stride) = ScenePixels(W, H);+ for (int y = 0; y < H; y++)+ {+ bgra[y * stride + 32 * 4 + 2] = 0; // a one-pixel wall at x = 32+ }+ SceneData wall = SceneData.FromBgra(bgra, W, H, stride, false, 0);+ SceneData open = SceneData.FromBgra(ScenePixels(W, H).Bgra, W, H, stride, false, 0);+ Check(Math.Abs(wall.C2[32] - 1e-6f) < 1e-9f && Math.Abs(wall.C2[31] - 1f) < 1e-6f, "red 0 is a refractive index of 1000 (c\u00b2 = 1e-6), red 100 stays 1");+ bgra[33 * 4 + 2] = 50; // red 50 at (33, 0): below 100 and not 0+ Check(Math.Abs(SceneData.FromBgra(bgra, W, H, stride, false, 0).C2[33] - 1f) < 1e-6f, "red 1..99 is a refractive index of 1, as in Wave Dude 2D (the Python allowed 0.9)");+ var emitters = new List<Emitter> { Make(16, 24, 120, 1.0) };+ const int steps = 150;+ float[] withWall = RunCpu(wall, emitters, steps);+ float[] without = RunCpu(open, emitters, steps);+ float leftWall = MaxAbsColumns(withWall, W, H, 0, 30);+ float rightWall = MaxAbsColumns(withWall, W, H, 34, W - 1);+ float rightOpen = MaxAbsColumns(without, W, H, 34, W - 1);+ Check(rightOpen > 0.01f && leftWall > 0.01f && rightWall < rightOpen * 1e-2f, $"a wall of red 0 blocks the wave: max |u| right of it {rightWall} against {rightOpen} without the wall, left of it {leftWall}");+ GpuWaveSimulator? gpu = GpuWaveSimulator.TryCreate(wall, new EngineOptions(1.0, 1.0, false, false, 10.0, 1.0), emitters, out string problems);+ if (gpu == null)+ {+ Console.WriteLine(" skip GPU: " + problems);+ return;+ }+ using (gpu)+ {+ Run(gpu, steps);+ float diff = MaxDiff(withWall, gpu.FieldData);+ Check(diff < 1e-3f * Math.Max(1f, MaxAbs(withWall)), "GPU agrees on the wall scene (max diff " + diff + ")");+ }+ }++ /// <summary>Max |u| over the canvas columns <paramref name="x0"/>..<paramref name="x1"/> of a padded field.</summary>+ private static float MaxAbsColumns(float[] padded, int W, int H, int x0, int x1)+ {+ int stride = W + 2;+ float max = 0f;+ for (int y = 0; y < H; y++)+ {+ for (int x = x0; x <= x1; x++)+ {+ max = Math.Max(max, Math.Abs(padded[(y + 1) * stride + x + 1]));+ }+ }+ return max;+ }+private static float[] RunCpu(SceneData scene, List<Emitter> emitters, int steps){var cpu = new WaveSimulator(scene, new EngineOptions(1.0, 1.0, false, false, 10.0, 1.0), emitters);