This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
EveUnity/packages/org.gamecult.eve.unity-scene/Tests/Editor/EveFieldsUnitySceneProjectionTests.cs
2026-07-15 23:38:00 +01:00

374 lines
17 KiB
C#

using System;
using System.IO;
using System.Linq;
using System.Collections.Generic;
using GameCult.Eve.PluginFields;
using GameCult.Eve.UnityScene.Fields;
using NUnit.Framework;
using UnityEngine;
namespace GameCult.Eve.UnityScene.Tests
{
public sealed class EveFieldsUnitySceneProjectionTests
{
[Test]
public void RasterizerConsumesPluginOwnedDocumentContract()
{
var render = typeof(EveFieldsSplatRasterizer).GetMethod(
"Render",
new[] { typeof(IEveFieldsSplatsDocument), typeof(int), typeof(int) });
Assert.That(render, Is.Not.Null);
Assert.That(typeof(EveFieldsSplatRasterizer).Assembly.GetReferencedAssemblies().Any(assembly =>
assembly.Name?.Contains("Aetheria", StringComparison.OrdinalIgnoreCase) == true), Is.False);
}
[Test]
public void CanonicalFieldsPackageOwnsTheCultMeshWireDocument()
{
Assert.That(typeof(EveFieldsSplatsDocument).GetCustomAttributes(false)
.Any(attribute => attribute.GetType().Name == "CultDocumentAttribute"), Is.True);
Assert.That(new EveFieldsSplatsDocument().Schema, Is.EqualTo(EveFieldsSchemas.Splats));
Assert.That(typeof(EveFieldsSplatsDocument).Assembly.GetReferencedAssemblies()
.Any(assembly => assembly.Name?.Contains("Aetheria", StringComparison.OrdinalIgnoreCase) == true), Is.False);
}
[Test]
public void VolumeRendererConsumesCanonicalFieldsWithoutProviderCode()
{
Assert.That(typeof(EveUnityFieldsVolumeRenderer).Assembly.GetReferencedAssemblies()
.Any(assembly => assembly.Name?.Contains("Aetheria", StringComparison.OrdinalIgnoreCase) == true), Is.False);
Assert.That(typeof(IEveUnityFieldsSplatsDocumentSource).GetEvent("FieldsSplatsAvailable"), Is.Not.Null);
}
[Test]
public void VolumeProgramAcceptsPortableTwoPassLifecycle()
{
var metadata = RequiredVolumeProgramMetadata();
Assert.That(EveUnityFieldsVolumeRenderer.TryValidateProgramMetadata(metadata, out var error), Is.True, error);
}
[Test]
public void VolumeProgramAcceptsCompleteTemporalLifecycle()
{
var metadata = RequiredVolumeProgramMetadata();
metadata["unity.volume.pass.temporal"] = "1";
metadata["unity.volume.texturePort.currentSample"] = "_CurrentVolume";
metadata["unity.volume.texturePort.history"] = "_HistoryVolume";
metadata["unity.volume.matrixPort.previousViewProjection"] = "_PreviousViewProjection";
metadata["unity.volume.floatPort.resetHistory"] = "_ResetHistory";
Assert.That(EveUnityFieldsVolumeRenderer.TryValidateProgramMetadata(metadata, out var error), Is.True, error);
}
[Test]
public void VolumeProgramRejectsPartialTemporalLifecycle()
{
var metadata = RequiredVolumeProgramMetadata();
metadata["unity.volume.pass.temporal"] = "1";
metadata["unity.volume.texturePort.currentSample"] = "_CurrentVolume";
Assert.That(EveUnityFieldsVolumeRenderer.TryValidateProgramMetadata(metadata, out var error), Is.False);
Assert.That(error, Does.Contain("history port"));
}
[Test]
public void VolumeRendererDerivesViewportTextureScaleFromNativeDimensions()
{
var texture = new Texture2D(128, 64, TextureFormat.RGBA32, false);
try
{
Assert.That(EveUnityFieldsVolumeRenderer.TryComputeViewportTextureScale(
640,
360,
texture,
out var scale), Is.True);
Assert.That(scale, Is.EqualTo(new Vector4(5f, 5.625f, 0f, 0f)));
}
finally
{
UnityEngine.Object.DestroyImmediate(texture);
}
}
[Test]
public void PackageContainsGenericFieldsShader()
{
Assert.That(Shader.Find("Eve/Fields/Splats"), Is.Not.Null);
Assert.That(File.Exists("Packages/org.gamecult.eve.unity-scene/Runtime/Fields/EveFieldsSplatsCore.hlsl"), Is.True);
}
[Test]
public void LayerRendererConsumesPluginContractsWithoutProviderBindings()
{
var render = typeof(EveFieldsSplatLayerRenderer).GetMethod("Render");
Assert.That(render, Is.Not.Null);
Assert.That(render.GetParameters()[0].ParameterType, Is.EqualTo(typeof(IEveFieldsSplatsDocument)));
Assert.That(typeof(EveFieldsSplatLayerRenderer).GetField("GlobalTextureName"), Is.Null);
}
[Test]
public void RasterizerProducesProviderIndependentFieldsCapture()
{
var host = new GameObject("eve-fields-capture");
var rasterizer = host.AddComponent<EveFieldsSplatRasterizer>();
var output = rasterizer.Render(new CaptureDocument(), 64, 64);
Assert.That(output, Is.Not.Null);
var previous = RenderTexture.active;
RenderTexture.active = output;
var readback = new Texture2D(64, 64, TextureFormat.RGBA32, false, true);
readback.ReadPixels(new Rect(0, 0, 64, 64), 0, 0);
readback.Apply();
RenderTexture.active = previous;
Assert.That(readback.GetPixels().Any(pixel => pixel.r > 0.01f), Is.True);
var outputPath = Path.GetFullPath(Path.Combine(Application.dataPath, "../../artifacts/fields-surface/latest/unity-fields.png"));
Directory.CreateDirectory(Path.GetDirectoryName(outputPath));
File.WriteAllBytes(outputPath, readback.EncodeToPNG());
UnityEngine.Object.DestroyImmediate(readback);
UnityEngine.Object.DestroyImmediate(host);
}
[Test]
public void RasterizerLowersPortablePowerPulseParameters()
{
var document = new EveFieldsSplatsDocument
{
Viewport = new EveFieldsViewport { MinX = -1, MinY = -1, MaxX = 1, MaxY = 1 },
Splats = new EveFieldsSplatSoa
{
Count = 1,
CenterX = new[] { 0d },
CenterY = new[] { 0d },
HalfExtentX = new[] { 1d },
HalfExtentY = new[] { 1d },
RotationCos = new[] { 1d },
RotationSin = new[] { 0d },
Channel = new[] { 0 },
Falloff = new[] { EveFieldsSplatFalloffs.PowerPulse },
FalloffScale = new[] { 2d },
FalloffExponent = new[] { 1d },
ValueR = new[] { 1d },
ValueA = new[] { 1d },
LayerIndex = new[] { 0 },
SourceKind = new[] { EveFieldsSplatSourceKinds.Constant }
}
};
var host = new GameObject("eve-fields-power-pulse");
var rasterizer = host.AddComponent<EveFieldsSplatRasterizer>();
var output = rasterizer.Render(document, 128, 128);
var previous = RenderTexture.active;
RenderTexture.active = output;
var readback = new Texture2D(128, 128, TextureFormat.RGBAFloat, false, true);
readback.ReadPixels(new Rect(0, 0, 128, 128), 0, 0);
readback.Apply();
RenderTexture.active = previous;
Assert.That(readback.GetPixel(64, 64).r, Is.GreaterThan(0.95f));
Assert.That(readback.GetPixel(80, 64).r, Is.InRange(0.65f, 0.85f));
Assert.That(readback.GetPixel(96, 64).r, Is.LessThan(0.02f));
UnityEngine.Object.DestroyImmediate(readback);
UnityEngine.Object.DestroyImmediate(host);
}
[Test]
public void RasterizerAnchorsAnimatedSimplexToFieldWorldAndPublishedSimulationTime()
{
var first = ProceduralDocument(
0, 100, 50, EveFieldsSplatSourceKinds.AnimatedSimplexNoise, 2);
var shifted = ProceduralDocument(
25, 125, 75, EveFieldsSplatSourceKinds.AnimatedSimplexNoise, 2);
var later = ProceduralDocument(
0, 100, 50, EveFieldsSplatSourceKinds.AnimatedSimplexNoise, 7);
var firstValue = RenderFieldPixel(first, 64, 64);
var shiftedValue = RenderFieldPixel(shifted, 32, 64);
var laterValue = RenderFieldPixel(later, 64, 64);
Assert.That(shiftedValue, Is.EqualTo(firstValue).Within(0.015f),
"the same field-world coordinate must not swim when the viewport moves");
Assert.That(Mathf.Abs(laterValue - firstValue), Is.GreaterThan(0.02f),
"animation must use the document's simulation time rather than Unity wall time");
}
[Test]
public void RasterizerLowersPortableAnimatedCellNoiseB()
{
var first = ProceduralDocument(
0, 100, 50, EveFieldsSplatSourceKinds.AnimatedCellNoiseB, 2);
var later = ProceduralDocument(
0, 100, 50, EveFieldsSplatSourceKinds.AnimatedCellNoiseB, 11);
var firstValue = RenderFieldPixel(first, 57, 71);
var laterValue = RenderFieldPixel(later, 57, 71);
Assert.That(firstValue, Is.GreaterThanOrEqualTo(0));
Assert.That(Mathf.Abs(laterValue - firstValue), Is.GreaterThan(0.005f));
}
[Test]
public void RasterizerLowersPortableAnimatedRadialCosine()
{
var initial = RadialCosineDocument(0);
var halfTurnLater = RadialCosineDocument(Math.PI);
var center = RenderFieldPixel(initial, 64, 64);
var radial = RenderFieldPixel(initial, 80, 64);
var laterCenter = RenderFieldPixel(halfTurnLater, 64, 64);
var localX = (80.5f / 128f) * 2f - 1f;
var localY = (64.5f / 128f) * 2f - 1f;
var expected = Mathf.Cos(Mathf.Pow(Mathf.Sqrt(localX * localX + localY * localY), 1.25f) * Mathf.PI * 2f);
Assert.That(center, Is.GreaterThan(0.98f));
Assert.That(radial, Is.EqualTo(expected).Within(0.04f));
Assert.That(laterCenter, Is.LessThan(-0.98f),
"radial phase animation must use provider-published simulation time");
}
private static EveFieldsSplatsDocument RadialCosineDocument(double simulationTime)
{
return new EveFieldsSplatsDocument
{
SimulationTimeSeconds = simulationTime,
Viewport = new EveFieldsViewport { MinX = -1, MinY = -1, MaxX = 1, MaxY = 1 },
Splats = new EveFieldsSplatSoa
{
Count = 1,
CenterX = new[] { 0d },
CenterY = new[] { 0d },
HalfExtentX = new[] { 1d },
HalfExtentY = new[] { 1d },
RotationCos = new[] { 1d },
RotationSin = new[] { 0d },
Channel = new[] { 0 },
Falloff = new[] { EveFieldsSplatFalloffs.Solid },
ValueR = new[] { 1d },
ValueA = new[] { 1d },
LayerIndex = new[] { 0 },
SourceKind = new[] { EveFieldsSplatSourceKinds.AnimatedRadialCosine },
FrequencyX = new[] { Math.PI * 2d },
FrequencyY = new[] { 1.25d },
PhaseX = new[] { 0d },
AnimationSpeed = new[] { 1d }
}
};
}
private static EveFieldsSplatsDocument ProceduralDocument(
double min,
double max,
double center,
int sourceKind,
double simulationTime)
{
return new EveFieldsSplatsDocument
{
SimulationTimeSeconds = simulationTime,
Viewport = new EveFieldsViewport { MinX = min, MinY = 0, MaxX = max, MaxY = 100 },
Splats = new EveFieldsSplatSoa
{
Count = 1,
CenterX = new[] { center },
CenterY = new[] { 50d },
HalfExtentX = new[] { 50d },
HalfExtentY = new[] { 50d },
RotationCos = new[] { 1d },
RotationSin = new[] { 0d },
Channel = new[] { 0 },
Falloff = new[] { EveFieldsSplatFalloffs.Solid },
ValueR = new[] { 1d },
ValueA = new[] { 1d },
LayerIndex = new[] { 0 },
SourceKind = new[] { sourceKind },
FrequencyX = new[] { 0.037d },
FrequencyY = new[] { 0.041d },
PhaseX = new[] { 0.17d },
PhaseY = new[] { -0.23d },
AnimationSpeed = new[] { 0.31d },
SourceFlags = new[] { (double)EveFieldsSplatSourceFlags.AbsoluteValue }
}
};
}
private static float RenderFieldPixel(EveFieldsSplatsDocument document, int x, int y)
{
var host = new GameObject("eve-fields-procedural-capture");
var rasterizer = host.AddComponent<EveFieldsSplatRasterizer>();
var output = rasterizer.Render(document, 128, 128);
var previous = RenderTexture.active;
RenderTexture.active = output;
var readback = new Texture2D(128, 128, TextureFormat.RGBAFloat, false, true);
readback.ReadPixels(new Rect(0, 0, 128, 128), 0, 0);
readback.Apply();
RenderTexture.active = previous;
var value = readback.GetPixel(x, y).r;
UnityEngine.Object.DestroyImmediate(readback);
UnityEngine.Object.DestroyImmediate(host);
return value;
}
private sealed class CaptureDocument : IEveFieldsSplatsDocument
{
public string Schema => EveFieldsSchemas.Splats;
public long FrameId => 1;
public double SimulationTimeSeconds => 0;
public IEveFieldsViewport Viewport { get; } = new CaptureViewport();
public IReadOnlyList<IEveFieldsSplatLayer> Layers { get; } = Array.Empty<IEveFieldsSplatLayer>();
public IEveFieldsSplatSoa Splats { get; } = new CaptureSplats();
}
private static Dictionary<string, string> RequiredVolumeProgramMetadata() =>
new Dictionary<string, string>(StringComparer.Ordinal)
{
["unity.volume.pass.raymarch"] = "0",
["unity.volume.pass.composite"] = "2",
["unity.volume.texturePort.cloud"] = "_Cloud",
["unity.volume.matrixPort.cameraInverseViewProjection"] = "_CameraInverseViewProjection",
["unity.volume.vectorPort.cameraProjectionExtents"] = "_CameraProjectionExtents",
["unity.volume.vectorPort.viewportTransform"] = "_ViewportTransform",
["unity.volume.floatPort.raymarchOffset"] = "_RaymarchOffset"
};
private sealed class CaptureViewport : IEveFieldsViewport
{
public double MinX => -1;
public double MinY => -1;
public double MaxX => 1;
public double MaxY => 1;
}
private sealed class CaptureSplats : IEveFieldsSplatSoa
{
private static readonly double[] One = { 1d };
private static readonly double[] Zero = { 0d };
private static readonly int[] ZeroInt = { 0 };
public int Count => 1;
public IReadOnlyList<double> CenterX => Zero;
public IReadOnlyList<double> CenterY => Zero;
public IReadOnlyList<double> HalfExtentX => One;
public IReadOnlyList<double> HalfExtentY => One;
public IReadOnlyList<double> RotationCos => One;
public IReadOnlyList<double> RotationSin => Zero;
public IReadOnlyList<int> Channel => ZeroInt;
public IReadOnlyList<int> Falloff => ZeroInt;
public IReadOnlyList<double> ValueR => One;
public IReadOnlyList<double> ValueG => Zero;
public IReadOnlyList<double> ValueB => Zero;
public IReadOnlyList<double> ValueA => One;
public IReadOnlyList<string> SourceKey { get; } = new[] { "capture" };
public IReadOnlyList<int> LayerIndex => ZeroInt;
public IReadOnlyList<int> SourceKind => ZeroInt;
public IReadOnlyList<double> FrequencyX => One;
public IReadOnlyList<double> FrequencyY => One;
public IReadOnlyList<double> PhaseX => Zero;
public IReadOnlyList<double> PhaseY => Zero;
public IReadOnlyList<double> AnimationSpeed => Zero;
public IReadOnlyList<double> SourceFlags => Zero;
public IReadOnlyList<double> FalloffScale => One;
public IReadOnlyList<double> FalloffExponent => One;
}
}
}