351 lines
14 KiB
C#
351 lines
14 KiB
C#
using System.Collections.Generic;
|
|
using System.Linq;
|
|
using Age.Engine.Model;
|
|
using Age.Engine.Sys4;
|
|
using Age.Engine.Vm;
|
|
using Xunit;
|
|
|
|
public class GfxAnimationTests
|
|
{
|
|
// ---- Native independent matrix channels + separate cyclic rotation (see engine-re.md). ----
|
|
|
|
[Fact]
|
|
public void ScaleAndTranslationChannels_AreIndependent()
|
|
{
|
|
var g = new GfxState();
|
|
g.BindDraw(0x1000, 1, 0, 0, 1, 1, 0, 0);
|
|
g.SetScaleChannel(0x1000, delayMs: 7, durationMs: 900, percent: (200, 50, 100));
|
|
g.SetTranslationChannel(0x1000, delayMs: 9, durationMs: 1200, target: (80, -25, 6));
|
|
var o = g.TryGet(0x1000)!;
|
|
Assert.Equal((2.0, 0.5, 1.0), o.ScaleTarget);
|
|
Assert.Equal((80.0, -25.0, 6.0), o.TranslationTarget);
|
|
Assert.Equal((7, 900), (o.ScaleDelayMs, o.ScaleDurationMs));
|
|
Assert.Equal((9, 1200), (o.TranslationDelayMs, o.TranslationDurationMs));
|
|
Assert.True(o.ScaleEnabled);
|
|
Assert.True(o.TranslationEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public void CurrentScaleSetter_ExpandsGlowAroundItsAnchor()
|
|
{
|
|
var g = new GfxState();
|
|
g.SetSurface(6, 0x29, -1);
|
|
g.BindDraw(0xcb8e, 6, 0, 0, 800, 800, 0, 550);
|
|
g.GetOrCreate(0xcb8e).V18 = (400, 950, 0);
|
|
g.SetCurrentScale(0xcb8e, (210, 210, 100));
|
|
|
|
var v = g.SnapshotVisibleObjects().Single();
|
|
var top = Transform2DMath.Build(v.Transform).FromLocalOrigin(v.DstX, v.DstY).Apply(400, 0);
|
|
Assert.Equal(2.1, v.Transform.ScaleX, 3);
|
|
Assert.Equal(2.1, v.Transform.ScaleY, 3);
|
|
Assert.Equal(110, top.Y, 3);
|
|
}
|
|
|
|
[Fact]
|
|
public void RotationCycle_DoesNotOverwriteMatrixChannels()
|
|
{
|
|
var g = new GfxState();
|
|
g.BindDraw(0x1000, 1, 0, 0, 1, 1, 0, 0);
|
|
g.SetScaleChannel(0x1000, 0, 100, (150, 150, 100));
|
|
g.SetTranslationChannel(0x1000, 0, 100, (10, 20, 0));
|
|
g.SetRotationCycle(0x1000, periodMs: 30, axis: (0, 0, 5));
|
|
var o = g.TryGet(0x1000)!;
|
|
Assert.Equal((1.5, 1.5, 1.0), o.ScaleTarget);
|
|
Assert.Equal((10.0, 20.0, 0.0), o.TranslationTarget);
|
|
Assert.Equal((0L, 0L, 5L), o.RotationAxis);
|
|
Assert.Equal(30, o.RotationPeriodMs);
|
|
Assert.True(o.RotationEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public void PreBindMatrixChannels_CreateNeutralPlaceholderWithoutLatentMotion()
|
|
{
|
|
// SC0000 calls op 0x220 on background handle 0xcb20 before BG001A is bound. Native creates the
|
|
// object (so op 0x215 returns slot 0) but ignores all three matrix setters while visible bit 0 is clear.
|
|
var g = new GfxState();
|
|
g.SetScaleChannel(0xcb20, 0, 500, (200, 200, 100));
|
|
g.SetRotationChannel(0xcb20, 0, 500, (0, 0, 1), 90);
|
|
g.SetTranslationChannel(0xcb20, 0, 500, (0, 600, 0));
|
|
|
|
var placeholder = g.TryGet(0xcb20)!;
|
|
Assert.Equal(0, g.QuerySlot(0xcb20));
|
|
Assert.False(placeholder.Visible);
|
|
Assert.False(placeholder.ScaleEnabled);
|
|
Assert.False(placeholder.RotationChannelEnabled);
|
|
Assert.False(placeholder.TranslationEnabled);
|
|
Assert.Equal((0.0, 0.0, 0.0), placeholder.TranslationTarget);
|
|
|
|
g.BindDraw(0xcb20, 4, 0, 0, 800, 500, 0, -500);
|
|
g.SetTranslationChannel(0xcb20, 0, 500, (0, 600, 0));
|
|
Assert.True(placeholder.TranslationEnabled);
|
|
Assert.Equal((0.0, 600.0, 0.0), placeholder.TranslationTarget);
|
|
}
|
|
|
|
[Fact]
|
|
public void ActiveVisualPresentation_ExcludesStaticWaits_ButIncludesAmbientChannels()
|
|
{
|
|
static GfxState VisibleObject()
|
|
{
|
|
var state = new GfxState();
|
|
state.SetSurface(1, 5, -1);
|
|
state.BindDraw(7, 1, 0, 0, 64, 64, 0, 0);
|
|
return state;
|
|
}
|
|
|
|
var unchanged = VisibleObject();
|
|
Assert.False(unchanged.HasActiveVisualPresentation(1000));
|
|
|
|
var spritesheet = VisibleObject();
|
|
spritesheet.SetSrcRect(7, 4, 1, 0, 800);
|
|
Assert.True(spritesheet.HasActiveVisualPresentation(1000));
|
|
|
|
var color = VisibleObject();
|
|
color.SetColorAnim(7, 1000, GfxState.PackColor(0x80, 0xff0000));
|
|
Assert.True(color.HasActiveVisualPresentation(1000));
|
|
|
|
var rotation = VisibleObject();
|
|
rotation.SetRotationCycle(7, 1000, (0, 0, 1));
|
|
Assert.True(rotation.HasActiveVisualPresentation(1000));
|
|
}
|
|
|
|
[Fact]
|
|
public void LoopingSpritesheet_PreservesCellSize_AdvancesRowMajor_AndWraps()
|
|
{
|
|
var g = new GfxState();
|
|
g.SetSurface(4, 0x37, -1);
|
|
g.BindDraw(0xcf3a, 4, 0, 0, 200, 200, 300, 100); // AE001H: 800x400, eight 200x200 cells
|
|
g.SetSrcRect(0xcf3a, frameCount: 8, columns: 4, cell: 0, period: 100);
|
|
|
|
var first = g.SnapshotVisibleObjects(1000).Single();
|
|
var second = g.SnapshotVisibleObjects(1100).Single();
|
|
var fifth = g.SnapshotVisibleObjects(1400).Single();
|
|
var eighth = g.SnapshotVisibleObjects(1700).Single();
|
|
var wrapped = g.SnapshotVisibleObjects(1800).Single();
|
|
|
|
Assert.Equal((0, 0, 200, 200), (first.SrcX, first.SrcY, first.W, first.H));
|
|
Assert.Equal((200, 0, 200, 200), (second.SrcX, second.SrcY, second.W, second.H));
|
|
Assert.Equal((0, 200, 200, 200), (fifth.SrcX, fifth.SrcY, fifth.W, fifth.H));
|
|
Assert.Equal((600, 200, 200, 200), (eighth.SrcX, eighth.SrcY, eighth.W, eighth.H));
|
|
Assert.Equal((0, 0, 200, 200), (wrapped.SrcX, wrapped.SrcY, wrapped.W, wrapped.H));
|
|
}
|
|
|
|
[Fact]
|
|
public void OneShotRotation_SharesMatrixClockAndMatchesNativeSample()
|
|
{
|
|
var g = new GfxState();
|
|
g.SetSurface(6, 1, -1); g.BindDraw(0xcb8e, 6, 0, 0, 800, 800, 300, 200);
|
|
g.GetOrCreate(0xcb8e).V18 = (700, 600, 0);
|
|
g.SetScaleChannel(0xcb8e, 500, 390, (110, 110, 100));
|
|
g.GetOrCreate(0xcb8e).ScaleCurrent = (0.9, 0.9, 1);
|
|
g.SetRotationChannel(0xcb8e, 500, 390, (0, 0, 1), 30);
|
|
g.SnapshotVisibleObjects(1000);
|
|
var sample = g.SnapshotVisibleObjects(1511).Single();
|
|
var m = Transform2DMath.Build(sample.Transform);
|
|
Assert.Equal(0.9055, m.XX, 4);
|
|
Assert.Equal(0.0134, m.XY, 4);
|
|
Assert.Equal(-0.0134, m.YX, 4);
|
|
Assert.Equal(74.1449, m.TX, 3);
|
|
Assert.Equal(47.3127, m.TY, 3);
|
|
}
|
|
|
|
[Fact]
|
|
public void CyclicRotation_FloorsDegreesAndWrapsAtPeriod()
|
|
{
|
|
var g = new GfxState();
|
|
g.SetSurface(1, 1, -1); g.BindDraw(7, 1, 0, 0, 1, 1, 0, 0);
|
|
g.SetRotationCycle(7, 1000, (0, 0, -1));
|
|
Assert.Equal(0, g.SnapshotVisibleObjects(5000).Single().Rotation.AngleDegrees);
|
|
Assert.Equal(89, g.SnapshotVisibleObjects(5249).Single().Rotation.AngleDegrees);
|
|
Assert.Equal(0, g.SnapshotVisibleObjects(6000).Single().Rotation.AngleDegrees);
|
|
}
|
|
|
|
[Fact]
|
|
public void SetAnimClock_SetsGlobalDurationAndBumpsClockGeneration()
|
|
{
|
|
var g = new GfxState();
|
|
var cg0 = g.AnimClockGeneration;
|
|
g.SetAnimClock(400);
|
|
Assert.Equal(400, g.AnimClockDurationTicks);
|
|
Assert.Equal(cg0 + 1, g.AnimClockGeneration);
|
|
}
|
|
|
|
// ---- Tasks 3-5: VM dispatch + snapshot (synthesized scenes) ----
|
|
|
|
private static OpcodeTable T() => OpcodeTableJson.Load(Paths.OpcodesJson);
|
|
private static Operand G(int a) => new(3, a);
|
|
private static Operand I(long v) => new(0, v);
|
|
private static (int, Operand[]) MovGI(int d, long v) => (0x55, new[] { G(d), I(v) });
|
|
private static (int, Operand[]) Exit() => (0x2, System.Array.Empty<Operand>());
|
|
|
|
[Fact]
|
|
public void MatrixOpcodeDispatch_RecordsSeparateChannels()
|
|
{
|
|
var t = T();
|
|
// 0x220 sets translation; 0x21e sets scale percentages without overwriting it.
|
|
var scene = ScriptAssembler.Assemble(t, "ANIM", new List<(int, Operand[])>
|
|
{
|
|
MovGI(1, 0x1000), MovGI(2, 7), MovGI(3, 9), MovGI(4, 800), MovGI(5, 500), MovGI(6, 0),
|
|
(0x1fb, new[] { G(1), I(0), I(0), I(0), I(1), I(1), I(0), I(0) }),
|
|
(0x220, new[] { G(1), G(2), G(3), G(4), G(5), G(6) }),
|
|
MovGI(4, 200), MovGI(5, 50), MovGI(6, 100),
|
|
(0x21e, new[] { G(1), G(2), G(3), G(4), G(5), G(6) }),
|
|
MovGI(4, 0), MovGI(5, 0), MovGI(6, 1), MovGI(7, 30),
|
|
(0x21f, new[] { G(1), G(2), G(3), G(4), G(5), G(6), G(7) }),
|
|
Exit(),
|
|
}, System.Array.Empty<string>());
|
|
var vm = new VirtualMachine(scene, t, new RecordingHost());
|
|
vm.Run();
|
|
var o = vm.Gfx.TryGet(0x1000)!;
|
|
Assert.Equal((800.0, 500.0, 0.0), o.TranslationTarget);
|
|
Assert.Equal((2.0, 0.5, 1.0), o.ScaleTarget);
|
|
Assert.True(o.TranslationEnabled);
|
|
Assert.True(o.ScaleEnabled);
|
|
Assert.Equal((0.0, 0.0, 1.0, 30.0), o.RotationTarget);
|
|
Assert.True(o.RotationChannelEnabled);
|
|
}
|
|
|
|
[Fact]
|
|
public void Op0x1fd_SetsCurrentScalePercentages()
|
|
{
|
|
var t = T();
|
|
var scene = ScriptAssembler.Assemble(t, "STATIC_SCALE", new List<(int, Operand[])>
|
|
{
|
|
MovGI(1, 0xcb8e), MovGI(2, 210), MovGI(3, 240), MovGI(4, 100),
|
|
(0x1fd, new[] { G(1), G(2), G(3), G(4) }), Exit(),
|
|
}, System.Array.Empty<string>());
|
|
var vm = new VirtualMachine(scene, t, new RecordingHost());
|
|
vm.Run();
|
|
Assert.Equal((2.1, 2.4, 1.0), vm.Gfx.TryGet(0xcb8e)!.ScaleCurrent);
|
|
}
|
|
|
|
[Fact]
|
|
public void RotationCycleAndClock_DispatchRemainSeparate()
|
|
{
|
|
var t = T();
|
|
// The legacy anim-start name is a rotation period+axis; 0x238 remains its own clock service.
|
|
var scene = ScriptAssembler.Assemble(t, "ANIM", new List<(int, Operand[])>
|
|
{
|
|
MovGI(1, 0x1000), MovGI(2, 30), MovGI(3, 0), MovGI(4, 0), MovGI(5, 5), MovGI(6, 400),
|
|
(0x234, new[] { G(1), G(2), G(3), G(4), G(5) }),
|
|
(0x238, new[] { G(6) }),
|
|
Exit(),
|
|
}, System.Array.Empty<string>());
|
|
var vm = new VirtualMachine(scene, t, new RecordingHost());
|
|
vm.Run();
|
|
var o = vm.Gfx.TryGet(0x1000)!;
|
|
Assert.Equal((0L, 0L, 5L), o.RotationAxis);
|
|
Assert.Equal(30, o.RotationPeriodMs);
|
|
Assert.True(o.RotationEnabled);
|
|
Assert.Equal((1.0, 1.0, 1.0), o.ScaleCurrent);
|
|
Assert.Equal((0.0, 0.0, 0.0), o.TranslationCurrent);
|
|
Assert.Equal(400, vm.Gfx.AnimClockDurationTicks);
|
|
Assert.Equal(1, vm.Gfx.AnimClockGeneration);
|
|
}
|
|
|
|
[Fact]
|
|
public void CurrentTranslationSetter_ReplacesTheLiveMatrixImmediately()
|
|
{
|
|
var t = T();
|
|
var scene = ScriptAssembler.Assemble(t, "CURRENTTRANSLATION", new List<(int, Operand[])>
|
|
{
|
|
MovGI(1, 0xcb20), MovGI(2, 12), MovGI(3, 34), MovGI(4, 5),
|
|
(0x1ff, new[] { G(1), G(2), G(3), G(4) }),
|
|
Exit(),
|
|
}, System.Array.Empty<string>());
|
|
var vm = new VirtualMachine(scene, t, new RecordingHost());
|
|
vm.Run();
|
|
var o = vm.Gfx.TryGet(0xcb20)!;
|
|
Assert.Equal((12.0, 34.0, 5.0), o.TranslationCurrent);
|
|
Assert.Equal((12L, 34L, 5L), o.V16c);
|
|
}
|
|
|
|
[Fact]
|
|
public void ResetAnimClock_DispatchClearsOnlyGlobalServiceClock()
|
|
{
|
|
var t = T();
|
|
var scene = ScriptAssembler.Assemble(t, "CLOCKRESET", new List<(int, Operand[])>
|
|
{
|
|
MovGI(1, 400),
|
|
(0x238, new[] { G(1) }),
|
|
(0x243, System.Array.Empty<Operand>()),
|
|
Exit(),
|
|
}, System.Array.Empty<string>());
|
|
var vm = new VirtualMachine(scene, t, new RecordingHost());
|
|
vm.Run();
|
|
Assert.Equal(0, vm.Gfx.AnimClockDurationTicks);
|
|
Assert.Equal(2, vm.Gfx.AnimClockGeneration);
|
|
}
|
|
|
|
[Fact]
|
|
public void SnapshotSamplesDelayedMatrixChannels_WithoutUsingZAsOpacity()
|
|
{
|
|
var g = new GfxState();
|
|
g.SetSurface(4, 0x25, -1);
|
|
g.BindDraw(0xA, 4, 0, 0, 100, 80, 120, 70);
|
|
g.GetOrCreate(0xA).V18 = (100, 50, 0);
|
|
g.SetScaleChannel(0xA, delayMs: 100, durationMs: 200, percent: (200, 50, 300));
|
|
g.SetTranslationChannel(0xA, delayMs: 100, durationMs: 200, target: (40, -10, 99));
|
|
g.SetRotationCycle(0xA, periodMs: 30, axis: (0, 0, 5));
|
|
|
|
var start = g.SnapshotVisibleObjects(1000).Single();
|
|
Assert.Equal((1.0, 1.0, 1.0), (start.Transform.ScaleX, start.Transform.ScaleY, start.Transform.ScaleZ));
|
|
Assert.Equal((0.0, 0.0, 0.0),
|
|
(start.Transform.TranslateX, start.Transform.TranslateY, start.Transform.TranslateZ));
|
|
|
|
var held = g.SnapshotVisibleObjects(1100).Single();
|
|
Assert.Equal((1.0, 1.0, 1.0), (held.Transform.ScaleX, held.Transform.ScaleY, held.Transform.ScaleZ));
|
|
Assert.Equal((0.0, 0.0, 0.0),
|
|
(held.Transform.TranslateX, held.Transform.TranslateY, held.Transform.TranslateZ));
|
|
|
|
var halfway = g.SnapshotVisibleObjects(1200).Single();
|
|
Assert.Equal((1.5, 0.75, 2.0),
|
|
(halfway.Transform.ScaleX, halfway.Transform.ScaleY, halfway.Transform.ScaleZ));
|
|
Assert.Equal((20.0, -5.0, 49.5),
|
|
(halfway.Transform.TranslateX, halfway.Transform.TranslateY, halfway.Transform.TranslateZ));
|
|
Assert.Equal(255, halfway.Alpha);
|
|
|
|
var done = g.SnapshotVisibleObjects(1300).Single();
|
|
Assert.Equal((2.0, 0.5, 3.0), (done.Transform.ScaleX, done.Transform.ScaleY, done.Transform.ScaleZ));
|
|
Assert.Equal((40.0, -10.0, 99.0),
|
|
(done.Transform.TranslateX, done.Transform.TranslateY, done.Transform.TranslateZ));
|
|
Assert.True(done.Rotation.Enabled);
|
|
Assert.Equal(255, done.Alpha); // scale-Z=3, translation-Z=99, rotation-axis-Z=5: still opaque
|
|
}
|
|
|
|
[Fact]
|
|
public void Transform2D_UsesNativeAnchoredRowVectorOrder_AndDirectProjection()
|
|
{
|
|
var t = new TransformState(2, 3, 99, 10, -7, 1234, 100, 50, 888);
|
|
var p = Transform2DMath.Apply(120, 60, t);
|
|
Assert.Equal((150.0, 73.0), p);
|
|
}
|
|
|
|
[Fact]
|
|
public void Transform2D_NegativeScaleMovesFarEdgeAcrossAnchor()
|
|
{
|
|
var t = new TransformState(-2, 1, 1, 0, 0, 0, 100, 0, 0);
|
|
var left = Transform2DMath.Apply(90, 0, t);
|
|
var right = Transform2DMath.Apply(110, 0, t);
|
|
Assert.Equal((120.0, 0.0), left);
|
|
Assert.Equal((80.0, 0.0), right);
|
|
}
|
|
|
|
[Fact]
|
|
public void Transform2D_MatchesCapturedNativeSc0000ScaleEndpoint()
|
|
{
|
|
// Native handle 0xcbc0: base=(0,600), anchor=(400,1000), scale=5.
|
|
var t = new TransformState(5, 5, 1, 0, 0, 0, 400, 1000, 0);
|
|
Assert.Equal((-1600.0, -1000.0), Transform2DMath.Apply(0, 600, t));
|
|
}
|
|
|
|
[Fact]
|
|
public void Transform2D_CyclicRotationOccursAfterTranslation()
|
|
{
|
|
var t = new TransformState(2, 1, 1, 10, 0, 0, 100, 50, 0);
|
|
var cycle = new RotationCycleState(true, 1000, 0, 0, 1, 90);
|
|
var p = Transform2DMath.Apply(120, 50, t, cycle);
|
|
Assert.Equal(100.0, p.X, 10);
|
|
Assert.Equal(100.0, p.Y, 10);
|
|
}
|
|
}
|