da42c1fce6
Plugin markup's <slider> always drew RetailScrollbarChrome's sprite
track/thumb, the same "big gold DAT art next to a plain plugin panel"
mismatch <menu style> already fixed for dropdowns. <slider style="..."> now
uses the identical plain/retail grammar (ValidateArtStyle, renamed and
generalized from the menu-only ValidateMenuStyle): plain (the default)
draws a flat dark track, 1px border, and a small flat nub via new
UiScrollbar.RetailArt=false + DrawPlainScalar — no SpriteResolve dependency
at all; style="retail" keeps RetailScrollbarChrome.ApplyHorizontal exactly
as before. RetailArt defaults to true on UiScrollbar itself, so every
non-plugin caller of this widget (retail LayoutDesc import, chat opacity
sliders, etc.) is byte-for-byte unaffected — only <slider>'s own
MarkupDocument case sets it false by default.
Every existing MossTank <slider> (Vitals' nine sliders, Buffs, Items'
Refill Worn Mana) has no style attribute, so they all switch to the plain
look automatically — consistent with the whole campaign's "no gold art"
direction, no XML changes needed.
Fixed a red pin this change created: Slider_MinMax_DrawsTheThumbAtTheRescaledNormalizedPosition
asserted the retail sprite thumb on a slider with no style attribute, which
now builds plain by default — opted it into style="retail" (same fix
shape as item 1's menu-scroll pin) and added a plain sibling,
Slider_NoStyleAttribute_DrawsAPlainFlatNubAtTheRescaledNormalizedPosition.
Mutation check: hardcoding DrawPlainScalar's horizontal nub x to 0 turned
the new plain test red ("expected a plain flat nub offset right of the
origin at 25%"); restoring the real ScalarPosition-driven x turns it green.
Documented <slider style> in docs/plugin-ui-markup.md, mirroring the
existing <menu style> paragraph.
tests/AcDream.Plugins.MossTank.Tests: 671/671 (unchanged — pure App-layer
rendering change, MossTank markup only sets no/default style).
tests/AcDream.App.Tests --filter Markup|Plugin|UiMenu|Slider: 278/3 skipped/281 (was 277/3/280, +1 new test).
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
697 lines
28 KiB
C#
697 lines
28 KiB
C#
using System.Linq;
|
|
using System.Numerics;
|
|
using AcDream.App.Rendering;
|
|
using AcDream.App.Rendering.Gpu;
|
|
using AcDream.App.Tests.Rendering.Gpu;
|
|
using AcDream.App.UI;
|
|
|
|
namespace AcDream.App.Tests.UI;
|
|
|
|
public class MarkupDocumentTests
|
|
{
|
|
private sealed class EditorBinding
|
|
{
|
|
public string Draft { get; private set; } = "initial";
|
|
public string Submitted { get; private set; } = string.Empty;
|
|
public string Selected { get; private set; } = "First";
|
|
public int SelectedIndex { get; private set; }
|
|
public IReadOnlyList<string> Choices => ["First", "Second"];
|
|
public IReadOnlyList<uint> ChoiceColors => [0xFF0000u, 0x00FF00u];
|
|
public Action<string> ChangeDraft => value => Draft = value;
|
|
public Action<string> SubmitDraft => value => Submitted = value;
|
|
public Action<string> SelectChoice => value => Selected = value;
|
|
public Action<int> SelectIndex => value => SelectedIndex = value;
|
|
}
|
|
|
|
[Fact]
|
|
public void FieldAndMenuBindEditablePluginState()
|
|
{
|
|
const string xml = """
|
|
<panel x="0" y="0" w="240" h="120">
|
|
<field x="4" y="4" w="120" h="20" text="{Draft}"
|
|
onchange="{ChangeDraft}" onsubmit="{SubmitDraft}" />
|
|
<menu x="4" y="32" w="120" h="20" items="{Choices}"
|
|
selected="{Selected}" onchange="{SelectChoice}" />
|
|
<list x="132" y="4" w="100" h="40" items="{Choices}"
|
|
colors="{ChoiceColors}"
|
|
selected="{SelectedIndex}" onchange="{SelectIndex}" />
|
|
</panel>
|
|
""";
|
|
var binding = new EditorBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml,
|
|
binding,
|
|
_ => (1u, 32, 32));
|
|
|
|
UiField field = Assert.IsType<UiField>(panel.Children[0]);
|
|
UiMenu menu = Assert.IsType<UiMenu>(panel.Children[1]);
|
|
UiMarkupList list = Assert.IsType<UiMarkupList>(panel.Children[2]);
|
|
field.SetText("named profile");
|
|
field.OnSubmit?.Invoke(field.Text);
|
|
menu.OnSelect?.Invoke("Second");
|
|
list.OnEvent(new UiEvent
|
|
{
|
|
Type = UiEventType.MouseDown,
|
|
Data2 = 19,
|
|
});
|
|
|
|
Assert.Equal("named profile", binding.Draft);
|
|
Assert.Equal("named profile", binding.Submitted);
|
|
Assert.Equal("Second", binding.Selected);
|
|
Assert.Equal(1, binding.SelectedIndex);
|
|
Assert.Equal(2, menu.Items.Count);
|
|
Assert.Equal([0xFF0000u, 0x00FF00u], list.ItemColorsSource());
|
|
Assert.False(menu.OpenUpward);
|
|
}
|
|
|
|
[Fact]
|
|
public void ControlIdAndNameBecomeStablePluginControlNames()
|
|
{
|
|
const string xml = """
|
|
<panel x="0" y="0" w="200" h="80">
|
|
<button id="ById" x="4" y="4" w="80" h="20" text="One" />
|
|
<label name="ByName" x="4" y="28" text="Two" />
|
|
</panel>
|
|
""";
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, new object(), _ => (1u, 32, 32));
|
|
|
|
Assert.Equal("ById", panel.Children[0].Name);
|
|
Assert.Equal("ByName", panel.Children[1].Name);
|
|
}
|
|
|
|
private sealed class FakeBinding
|
|
{
|
|
public float HealthPercent => 0.5f;
|
|
public uint? HealthCurrent => 109;
|
|
public uint? HealthMax => 218;
|
|
public float? ManaPercent => null;
|
|
public uint? ManaCurrent => null;
|
|
public uint? ManaMax => null;
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_CreatesPanelWithMeterFillLabelAndGeometry()
|
|
{
|
|
const string xml =
|
|
"<panel id=\"acdream.vitals\" x=\"10\" y=\"30\" w=\"220\" h=\"96\" title=\"Vitals\">" +
|
|
" <meter id=\"health\" x=\"8\" y=\"24\" w=\"200\" h=\"14\" fill=\"{HealthPercent}\" cur=\"{HealthCurrent}\" max=\"{HealthMax}\" color=\"#FFFF0000\"/>" +
|
|
"</panel>";
|
|
|
|
var panel = MarkupDocument.Build(xml, new FakeBinding(), _ => ((uint)1, 32, 32));
|
|
|
|
Assert.IsType<UiNineSlicePanel>(panel);
|
|
Assert.Equal(10f, panel.Left);
|
|
Assert.Equal(220f, panel.Width);
|
|
Assert.Equal(2, panel.Children.Count); // title UiLabel + 1 meter
|
|
var meter = Assert.IsType<UiMeter>(panel.Children[1]);
|
|
Assert.Equal(8f, meter.Left);
|
|
Assert.Equal(200f, meter.Width);
|
|
Assert.Equal(0.5f, meter.Fill());
|
|
Assert.Equal("109/218", meter.Label());
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_NullBindingValuesYieldNullFillAndLabel()
|
|
{
|
|
const string xml =
|
|
"<panel id=\"v\" x=\"0\" y=\"0\" w=\"10\" h=\"10\" title=\"V\">" +
|
|
" <meter id=\"mana\" x=\"0\" y=\"0\" w=\"10\" h=\"2\" fill=\"{ManaPercent}\" cur=\"{ManaCurrent}\" max=\"{ManaMax}\" color=\"#FF0000FF\"/>" +
|
|
"</panel>";
|
|
var panel = MarkupDocument.Build(xml, new FakeBinding(), _ => ((uint)1, 32, 32));
|
|
var meter = Assert.IsType<UiMeter>(panel.Children[1]);
|
|
Assert.Null(meter.Fill());
|
|
Assert.Null(meter.Label());
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_ResizeAttrX_SetsHorizontalOnly()
|
|
{
|
|
const string xml = "<panel id=\"v\" x=\"0\" y=\"0\" w=\"100\" h=\"50\" title=\"V\" resize=\"x\"></panel>";
|
|
var panel = MarkupDocument.Build(xml, new object(), _ => ((uint)1, 32, 32));
|
|
Assert.True(panel.ResizeX);
|
|
Assert.False(panel.ResizeY);
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_ParsesNineSliceBarSpriteIds()
|
|
{
|
|
const string xml = "<panel id=\"v\" x=\"0\" y=\"0\" w=\"100\" h=\"50\" title=\"V\">" +
|
|
"<meter id=\"h\" x=\"0\" y=\"0\" w=\"100\" h=\"14\" fill=\"{HealthPercent}\" " +
|
|
"backleft=\"0x06001141\" backtile=\"0x06001140\" backright=\"0x0600113F\" " +
|
|
"frontleft=\"0x06001131\" fronttile=\"0x06001132\" frontright=\"0x06001133\"/>" +
|
|
"</panel>";
|
|
var panel = MarkupDocument.Build(xml, new FakeBinding(), _ => ((uint)7, 32, 32));
|
|
var meter = Assert.IsType<UiMeter>(panel.Children[1]);
|
|
Assert.Equal(0x06001141u, meter.BackLeft);
|
|
Assert.Equal(0x06001140u, meter.BackTile);
|
|
Assert.Equal(0x0600113Fu, meter.BackRight);
|
|
Assert.Equal(0x06001131u, meter.FrontLeft);
|
|
Assert.Equal(0x06001132u, meter.FrontTile);
|
|
Assert.Equal(0x06001133u, meter.FrontRight);
|
|
Assert.NotNull(meter.SpriteResolve);
|
|
}
|
|
|
|
private sealed class ButtonBinding
|
|
{
|
|
public int Clicks { get; private set; }
|
|
public string Status { get; set; } = "idle";
|
|
public Action Go => () => Clicks++;
|
|
public Action? Missing => null;
|
|
public bool CanGo { get; set; } = true;
|
|
public bool OptionsSelected { get; set; } = true;
|
|
public bool OptionsVisible { get; set; } = true;
|
|
public bool CombatEnabled { get; set; }
|
|
public float AttackPower { get; private set; } = 0.5f;
|
|
public Action ShowOptions => () => OptionsSelected = true;
|
|
public Action ToggleCombat => () => CombatEnabled = !CombatEnabled;
|
|
public Action<float> SetAttackPower => value => AttackPower = value;
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_ButtonInvokesTheBoundActionOnClick()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"100\" h=\"60\">" +
|
|
" <button x=\"4\" y=\"8\" w=\"60\" h=\"20\" text=\"Buff\" onclick=\"{Go}\"/>" +
|
|
"</panel>";
|
|
|
|
var binding = new ButtonBinding();
|
|
var panel = MarkupDocument.Build(xml, binding, _ => ((uint)1, 32, 32));
|
|
|
|
var button = Assert.IsType<UiSimpleButton>(panel.Children[0]);
|
|
Assert.Equal("Buff", button.Text);
|
|
Assert.Equal(60f, button.Width);
|
|
|
|
button.OnEvent(new UiEvent { Type = UiEventType.Click });
|
|
button.OnEvent(new UiEvent { Type = UiEventType.Click });
|
|
Assert.Equal(2, binding.Clicks);
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_ButtonWithUnresolvableHandlerFailsLoudly()
|
|
{
|
|
// A silently dead button is worse than a panel that refuses to load:
|
|
// the user clicks and nothing happens, with nothing to diagnose.
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"100\" h=\"60\">" +
|
|
" <button x=\"0\" y=\"0\" w=\"10\" h=\"10\" text=\"X\" onclick=\"{NoSuchProperty}\"/>" +
|
|
"</panel>";
|
|
|
|
Assert.Throws<FormatException>(
|
|
() => MarkupDocument.Build(xml, new ButtonBinding(), _ => ((uint)1, 32, 32)));
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_BoundLabelTracksTheBindingRatherThanFreezing()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"100\" h=\"60\">" +
|
|
" <label x=\"2\" y=\"4\" text=\"{Status}\"/>" +
|
|
"</panel>";
|
|
|
|
var binding = new ButtonBinding();
|
|
var panel = MarkupDocument.Build(xml, binding, _ => ((uint)1, 32, 32));
|
|
|
|
var label = Assert.IsType<UiLabel>(panel.Children[0]);
|
|
Assert.Equal("idle", label.TextSource!());
|
|
|
|
binding.Status = "casting";
|
|
Assert.Equal("casting", label.TextSource!());
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_LiteralLabelTextIsUsedVerbatim()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"100\" h=\"60\">" +
|
|
" <label x=\"0\" y=\"0\" text=\"MossTank\"/>" +
|
|
"</panel>";
|
|
|
|
var panel = MarkupDocument.Build(xml, new ButtonBinding(), _ => ((uint)1, 32, 32));
|
|
var label = Assert.IsType<UiLabel>(panel.Children[0]);
|
|
Assert.Equal("MossTank", label.TextSource!());
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_ProjectsBoundEnabledAndButtonColors()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"100\" h=\"60\">" +
|
|
"<button x=\"0\" y=\"0\" w=\"50\" h=\"20\" text=\"Go\" " +
|
|
"onclick=\"{Go}\" enabled=\"{CanGo}\" " +
|
|
"background=\"#FF112233\" border=\"#FF445566\"/>" +
|
|
"</panel>";
|
|
var binding = new ButtonBinding();
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, _ => ((uint)1, 32, 32));
|
|
var button = Assert.IsType<UiSimpleButton>(panel.Children[0]);
|
|
|
|
Assert.NotNull(button.EnabledSource);
|
|
Assert.True(button.EnabledSource!());
|
|
binding.CanGo = false;
|
|
Assert.False(button.EnabledSource!());
|
|
Assert.Equal(new System.Numerics.Vector4(
|
|
0x11 / 255f, 0x22 / 255f, 0x33 / 255f, 1f),
|
|
button.BackgroundColor);
|
|
Assert.Equal(new System.Numerics.Vector4(
|
|
0x44 / 255f, 0x55 / 255f, 0x66 / 255f, 1f),
|
|
button.BorderColor);
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_RuntimeTooltipUsesRetailPopupLocatorAndLiveBinding()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"100\" h=\"60\">" +
|
|
"<button x=\"0\" y=\"0\" w=\"50\" h=\"20\" text=\"Go\" " +
|
|
"tooltip=\"{Status}\"/>" +
|
|
"</panel>";
|
|
var binding = new ButtonBinding();
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, _ => ((uint)1, 32, 32));
|
|
var button = Assert.IsType<UiSimpleButton>(panel.Children[0]);
|
|
|
|
Assert.Equal("idle", button.GetTooltipText());
|
|
Assert.True(button.AuthoredTooltipEnabled);
|
|
Assert.Equal(0x10000397u, button.AuthoredTooltipRootElementId);
|
|
Assert.Equal(0x21000041u, button.AuthoredTooltipLayoutDid);
|
|
|
|
binding.Status = "casting";
|
|
Assert.Equal("casting", button.GetTooltipText());
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_NestedGroupTabToggleAndSliderStayLiveAndInteractive()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"300\" h=\"180\">" +
|
|
"<tab x=\"4\" y=\"4\" w=\"60\" h=\"18\" text=\"Options\" " +
|
|
"selected=\"{OptionsSelected}\" onclick=\"{ShowOptions}\"/>" +
|
|
"<group x=\"4\" y=\"28\" w=\"280\" h=\"140\" visible=\"{OptionsVisible}\">" +
|
|
"<toggle x=\"2\" y=\"2\" w=\"140\" h=\"20\" text=\"Enable Combat\" " +
|
|
"checked=\"{CombatEnabled}\" onclick=\"{ToggleCombat}\"/>" +
|
|
"<slider x=\"2\" y=\"30\" w=\"140\" h=\"16\" value=\"{AttackPower}\" " +
|
|
"onchange=\"{SetAttackPower}\"/>" +
|
|
"</group></panel>";
|
|
var binding = new ButtonBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml,
|
|
binding,
|
|
_ => ((uint)1, 16, 16));
|
|
|
|
var tab = Assert.IsType<UiMarkupTabButton>(panel.Children[0]);
|
|
var group = Assert.IsType<UiPanel>(panel.Children[1]);
|
|
var toggle = Assert.IsType<UiMarkupToggle>(group.Children[0]);
|
|
var slider = Assert.IsType<UiScrollbar>(group.Children[1]);
|
|
Assert.True(tab.IsSelected);
|
|
Assert.True(group.VisibleSource!());
|
|
Assert.False(toggle.IsChecked);
|
|
|
|
toggle.OnEvent(new UiEvent { Type = UiEventType.Click });
|
|
Assert.True(binding.CombatEnabled);
|
|
Assert.True(toggle.IsChecked);
|
|
|
|
slider.ScalarChanged!(0.78f);
|
|
Assert.Equal(0.78f, binding.AttackPower);
|
|
Assert.Equal(0.78f, slider.ScalarPositionSource!());
|
|
}
|
|
|
|
// ── Campaign VT slice 7 S7.2: <slider min max> (KB 08 §3 gap) ────────
|
|
|
|
private sealed class RangeBinding
|
|
{
|
|
public float Value { get; private set; } = 50f;
|
|
public Action<float> SetValue => value => Value = value;
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_SliderWithNoMinMax_KeepsTheHistoricZeroToOneIdentityRange()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"160\" h=\"20\">" +
|
|
"<slider x=\"0\" y=\"0\" w=\"150\" h=\"16\" value=\"{Value}\" " +
|
|
"onchange=\"{SetValue}\"/>" +
|
|
"</panel>";
|
|
// Value defaults to 50 in RangeBinding, but with no declared range a
|
|
// pre-existing <slider> must keep treating it as an already-normalized
|
|
// 0-1 scalar (unchanged from before this attribute existed) — clamped,
|
|
// not rescaled.
|
|
var binding = new RangeBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, _ => (1u, 16, 16));
|
|
var slider = Assert.IsType<UiScrollbar>(panel.Children[0]);
|
|
|
|
Assert.Equal(1f, slider.ScalarPositionSource!());
|
|
|
|
slider.ScalarChanged!(0.6f);
|
|
Assert.Equal(0.6f, binding.Value, 3);
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_SliderWithMinMax_RescalesTheDeclaredRangeToAndFromTheInternalZeroToOnePosition()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"160\" h=\"20\">" +
|
|
"<slider x=\"0\" y=\"0\" w=\"150\" h=\"16\" min=\"0\" max=\"200\" " +
|
|
"value=\"{Value}\" onchange=\"{SetValue}\"/>" +
|
|
"</panel>";
|
|
var binding = new RangeBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, _ => (1u, 16, 16));
|
|
var slider = Assert.IsType<UiScrollbar>(panel.Children[0]);
|
|
|
|
// 50 out of a declared 0-200 range normalizes to 0.25 internally —
|
|
// this is the value UiScrollbar's own drag/click math operates on.
|
|
Assert.Equal(0.25f, slider.ScalarPositionSource!()!.Value, 3);
|
|
|
|
// The reverse direction: an internal drag position of 0.6 (60%) must
|
|
// be rescaled back up into the declared 0-200 range before it ever
|
|
// reaches the plugin's bound Action<float>.
|
|
slider.ScalarChanged!(0.6f);
|
|
Assert.Equal(120f, binding.Value, 3);
|
|
}
|
|
|
|
// Fix round B item 11: <slider> now defaults to the PLAIN style
|
|
// (RetailArt=false), so a markup slider with no style attribute never
|
|
// reaches RetailScrollbarChrome.ApplyHorizontal's sprite thumb any more
|
|
// — it draws UiScrollbar.DrawPlainScalar's flat nub instead. This test
|
|
// now opts INTO style="retail" to keep exercising the retail sprite
|
|
// path; the plain default gets its own sibling below.
|
|
[Fact]
|
|
public void Slider_MinMax_DrawsTheThumbAtTheRescaledNormalizedPosition()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"160\" h=\"20\">" +
|
|
"<slider x=\"0\" y=\"0\" w=\"150\" h=\"16\" min=\"0\" max=\"200\" " +
|
|
"value=\"{Value}\" style=\"retail\"/>" +
|
|
"</panel>";
|
|
var binding = new RangeBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, id => (id, 16, 16));
|
|
var slider = Assert.IsType<UiScrollbar>(panel.Children[0]);
|
|
Assert.True(slider.RetailArt);
|
|
|
|
var device = new RecordingGpuDevice();
|
|
var renderer = new TextRenderer(device, new NullGpuFrameSource(), "unused");
|
|
renderer.Begin(new Vector2(800f, 600f));
|
|
var ctx = new UiRenderContext(renderer, new Vector2(800f, 600f));
|
|
|
|
// TickSelfAndChildren pulls ScalarPositionSource into ScalarPosition —
|
|
// the same per-frame step the real host performs before drawing.
|
|
slider.TickSelfAndChildren(0);
|
|
Assert.Equal(0.25f, slider.ScalarPosition, 3);
|
|
|
|
slider.DrawSelfAndChildren(ctx);
|
|
|
|
// The horizontal thumb sprite (RetailScrollbarChrome.ApplyHorizontal's
|
|
// HThumbMidNormal) must be drawn strictly right of the left edge —
|
|
// proof the 0.25 normalized position (not the raw declared value 50,
|
|
// and not a full 1.0) reached the actual draw call.
|
|
var thumb = Assert.Single(
|
|
renderer.DebugSpriteSegmentVerts,
|
|
s => s.Texture == RetailScrollbarChrome.HThumbMidNormal);
|
|
float thumbMinX = Enumerable.Range(0, thumb.Verts.Count / 8)
|
|
.Min(i => thumb.Verts[i * 8]);
|
|
Assert.True(
|
|
thumbMinX > 0f,
|
|
$"expected the thumb offset right of the origin at 25%, got x={thumbMinX}");
|
|
}
|
|
|
|
[Fact]
|
|
public void Slider_NoStyleAttribute_DrawsAPlainFlatNubAtTheRescaledNormalizedPosition()
|
|
{
|
|
const string xml =
|
|
"<panel x=\"0\" y=\"0\" w=\"160\" h=\"20\">" +
|
|
"<slider x=\"0\" y=\"0\" w=\"150\" h=\"16\" min=\"0\" max=\"200\" " +
|
|
"value=\"{Value}\"/>" +
|
|
"</panel>";
|
|
var binding = new RangeBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, id => (id, 16, 16));
|
|
var slider = Assert.IsType<UiScrollbar>(panel.Children[0]);
|
|
Assert.False(slider.RetailArt);
|
|
|
|
var device = new RecordingGpuDevice();
|
|
var renderer = new TextRenderer(device, new NullGpuFrameSource(), "unused");
|
|
renderer.Begin(new Vector2(800f, 600f));
|
|
var ctx = new UiRenderContext(renderer, new Vector2(800f, 600f));
|
|
|
|
slider.TickSelfAndChildren(0);
|
|
Assert.Equal(0.25f, slider.ScalarPosition, 3);
|
|
|
|
slider.DrawSelfAndChildren(ctx);
|
|
|
|
// An untextured segment batches every DrawFill call in submission
|
|
// order together (background track + nub both use texture=0), so
|
|
// scan per-quad (6 verts x 8 floats = 48 floats) for one whose
|
|
// color is PlainNubColor and whose left edge sits right of the
|
|
// origin (proof the 25% position, not 0 or 1.0, drove the nub).
|
|
const int floatsPerQuad = 6 * 8;
|
|
bool foundOffsetNub = renderer.DebugSpriteSegmentVerts.Any(s =>
|
|
{
|
|
if (s.Texture != 0u) return false;
|
|
for (int q = 0; q + floatsPerQuad <= s.Verts.Count; q += floatsPerQuad)
|
|
{
|
|
float xMin = float.MaxValue;
|
|
for (int v = 0; v < 6; v++)
|
|
xMin = MathF.Min(xMin, s.Verts[q + v * 8]);
|
|
float r = s.Verts[q + 4], g = s.Verts[q + 5], b = s.Verts[q + 6], a = s.Verts[q + 7];
|
|
bool isNubColor = MathF.Abs(r - slider.PlainNubColor.X) < 0.01f
|
|
&& MathF.Abs(g - slider.PlainNubColor.Y) < 0.01f
|
|
&& MathF.Abs(b - slider.PlainNubColor.Z) < 0.01f
|
|
&& MathF.Abs(a - slider.PlainNubColor.W) < 0.01f;
|
|
if (isNubColor && xMin > 0f)
|
|
return true;
|
|
}
|
|
return false;
|
|
});
|
|
Assert.True(foundOffsetNub, "expected a plain flat nub offset right of the origin at 25%");
|
|
}
|
|
|
|
// ── Campaign VT slice 7 S7.2: <menu scroll="true"> (KB 08 §3 gap) ────
|
|
|
|
[Fact]
|
|
public void Build_MenuWithNoScrollAttribute_KeepsScrollableFalse()
|
|
{
|
|
const string xml = """
|
|
<panel x="0" y="0" w="160" h="40">
|
|
<menu x="4" y="4" w="120" h="20" items="{Choices}"
|
|
selected="{Selected}" onchange="{SelectChoice}" />
|
|
</panel>
|
|
""";
|
|
var binding = new EditorBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, _ => (1u, 32, 32));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
|
|
Assert.False(menu.Scrollable);
|
|
}
|
|
|
|
[Fact]
|
|
public void Build_MenuWithScrollAttribute_SetsUiMenuScrollableAndItsChromeSprites()
|
|
{
|
|
const string xml = """
|
|
<panel x="0" y="0" w="160" h="40">
|
|
<menu x="4" y="4" w="120" h="20" items="{Choices}"
|
|
selected="{Selected}" onchange="{SelectChoice}"
|
|
scroll="true" />
|
|
</panel>
|
|
""";
|
|
var binding = new EditorBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, _ => (1u, 32, 32));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
|
|
Assert.True(menu.Scrollable);
|
|
Assert.NotEqual(0u, menu.ScrollTrackSprite);
|
|
Assert.NotEqual(0u, menu.ScrollThumbSprite);
|
|
Assert.NotEqual(0u, menu.ScrollUpSprite);
|
|
Assert.NotEqual(0u, menu.ScrollDownSprite);
|
|
}
|
|
|
|
// Campaign VT slice 7 fix round B item 1: <menu> now defaults to the
|
|
// PLAIN style (RetailButtonArt=false — see the "BIG gold/yellow buttons"
|
|
// owner fix), so a markup menu with no style attribute never reaches the
|
|
// retail sprite-scrollbar path (DrawPopupScrollbar) any more — it draws
|
|
// DrawPopupScrollbarPlain's flat DrawFill thumb instead. This test now
|
|
// opts INTO style="retail" to keep exercising the retail sprite path;
|
|
// the plain default gets its own sibling below.
|
|
[Fact]
|
|
public void Menu_Scroll_DrawsAScrollbarWhenTheMarkupItemCountOverflowsTheVisibleRows()
|
|
{
|
|
const string xml = """
|
|
<panel x="0" y="0" w="160" h="40">
|
|
<menu x="4" y="4" w="120" h="18" items="{ManyChoices}"
|
|
selected="{Selected}" onchange="{SelectChoice}"
|
|
rows="6" rowheight="18" scroll="true" style="retail" />
|
|
</panel>
|
|
""";
|
|
var binding = new ManyChoicesBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, id => (id, 16, 16));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
Assert.True(menu.RetailButtonArt);
|
|
|
|
var device = new RecordingGpuDevice();
|
|
var renderer = new TextRenderer(device, new NullGpuFrameSource(), "unused");
|
|
renderer.Begin(new Vector2(800f, 600f));
|
|
var ctx = new UiRenderContext(renderer, new Vector2(800f, 600f));
|
|
|
|
// Open the popup, then a zero-delta wheel configures PopupScroll from
|
|
// Items.Count/RowsPerColumn/RowHeight — the same "configure right
|
|
// before use" step UiMenuTests' own Scrollable coverage relies on.
|
|
menu.OnEvent(new UiEvent(0, menu, UiEventType.MouseDown, 0, 10, 5));
|
|
menu.OnEvent(new UiEvent(0, menu, UiEventType.Scroll, Data0: 0));
|
|
Assert.True(menu.PopupScroll.HasOverflow);
|
|
|
|
menu.DrawOverlays(ctx);
|
|
|
|
Assert.Contains(
|
|
renderer.DebugSpriteSegmentVerts,
|
|
s => s.Texture == menu.ScrollThumbSprite);
|
|
}
|
|
|
|
// Plain sibling (default style, no style attribute): the flat thumb fill
|
|
// is an untextured DrawFill quad (UiTextureTableHandle.None == 0) sized
|
|
// ScrollbarWidth-2 wide and tinted PlainBorderColor — see
|
|
// UiMenu.DrawPopupScrollbarPlain. This is what actually renders today for
|
|
// any markup menu that doesn't opt into style="retail".
|
|
[Fact]
|
|
public void Menu_Scroll_DrawsAPlainFlatThumbFillWhenTheMarkupItemCountOverflowsTheVisibleRows()
|
|
{
|
|
const string xml = """
|
|
<panel x="0" y="0" w="160" h="40">
|
|
<menu x="4" y="4" w="120" h="18" items="{ManyChoices}"
|
|
selected="{Selected}" onchange="{SelectChoice}"
|
|
rows="6" rowheight="18" scroll="true" />
|
|
</panel>
|
|
""";
|
|
var binding = new ManyChoicesBinding();
|
|
|
|
UiNineSlicePanel panel = MarkupDocument.Build(
|
|
xml, binding, id => (id, 16, 16));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
Assert.False(menu.RetailButtonArt);
|
|
|
|
var device = new RecordingGpuDevice();
|
|
var renderer = new TextRenderer(device, new NullGpuFrameSource(), "unused");
|
|
renderer.Begin(new Vector2(800f, 600f));
|
|
var ctx = new UiRenderContext(renderer, new Vector2(800f, 600f));
|
|
|
|
menu.OnEvent(new UiEvent(0, menu, UiEventType.MouseDown, 0, 10, 5));
|
|
menu.OnEvent(new UiEvent(0, menu, UiEventType.Scroll, Data0: 0));
|
|
Assert.True(menu.PopupScroll.HasOverflow);
|
|
|
|
menu.DrawOverlays(ctx);
|
|
|
|
// An untextured segment batches every DrawFill call in submission order
|
|
// together (same texture=0 for background/border/row-fills/thumb), so
|
|
// scan per-QUAD (6 verts x 8 floats = 48 floats) inside each segment
|
|
// rather than treating a whole segment as one quad.
|
|
const int floatsPerQuad = 6 * 8;
|
|
float expectedThumbWidth = menu.ScrollbarWidth - 2f;
|
|
bool foundThumb = renderer.DebugSpriteSegmentVerts.Any(s =>
|
|
{
|
|
if (s.Texture != 0u) return false;
|
|
for (int q = 0; q + floatsPerQuad <= s.Verts.Count; q += floatsPerQuad)
|
|
{
|
|
float xMin = float.MaxValue, xMax = float.MinValue;
|
|
for (int v = 0; v < 6; v++)
|
|
{
|
|
float x = s.Verts[q + v * 8];
|
|
if (x < xMin) xMin = x;
|
|
if (x > xMax) xMax = x;
|
|
}
|
|
float width = xMax - xMin;
|
|
if (MathF.Abs(width - expectedThumbWidth) > 0.5f) continue;
|
|
float r = s.Verts[q + 4], g = s.Verts[q + 5], b = s.Verts[q + 6], a = s.Verts[q + 7];
|
|
if (MathF.Abs(r - menu.PlainBorderColor.X) < 0.01f
|
|
&& MathF.Abs(g - menu.PlainBorderColor.Y) < 0.01f
|
|
&& MathF.Abs(b - menu.PlainBorderColor.Z) < 0.01f
|
|
&& MathF.Abs(a - menu.PlainBorderColor.W) < 0.01f)
|
|
return true;
|
|
}
|
|
return false;
|
|
});
|
|
Assert.True(foundThumb, "expected a plain flat thumb fill (untextured quad, "
|
|
+ $"width~{expectedThumbWidth}, tinted PlainBorderColor) among the drawn segments");
|
|
}
|
|
|
|
private sealed class ManyChoicesBinding
|
|
{
|
|
public string Selected { get; private set; } = "Item 0";
|
|
public IReadOnlyList<string> ManyChoices { get; } =
|
|
Enumerable.Range(0, 18).Select(i => $"Item {i}").ToArray();
|
|
public Action<string> SelectChoice => value => Selected = value;
|
|
}
|
|
|
|
private sealed class NullGpuFrameSource : ICurrentGpuFrameSource
|
|
{
|
|
public IGpuFrame? CurrentFrame => null;
|
|
}
|
|
|
|
// ── S7 fix ("BIG gold/yellow buttons has to go" — owner live-client
|
|
// report 2026-09-07): <menu style="..."> selects UiMenu.RetailButtonArt.
|
|
|
|
private sealed class MenuStyleBinding
|
|
{
|
|
public IReadOnlyList<string> Choices => ["First", "Second"];
|
|
public string Selected { get; } = "First";
|
|
}
|
|
|
|
private static string MenuXml(string? styleAttribute) =>
|
|
"<panel x=\"0\" y=\"0\" w=\"240\" h=\"60\">" +
|
|
$"<menu x=\"4\" y=\"4\" w=\"120\" h=\"20\" items=\"{{Choices}}\" selected=\"{{Selected}}\"{styleAttribute}/>" +
|
|
"</panel>";
|
|
|
|
[Fact]
|
|
public void Menu_NoStyleAttribute_DefaultsToPlain_RetailButtonArtFalse()
|
|
{
|
|
var panel = MarkupDocument.Build(MenuXml(styleAttribute: ""), new MenuStyleBinding(), _ => (1u, 32, 32));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
|
|
Assert.False(menu.RetailButtonArt);
|
|
}
|
|
|
|
[Fact]
|
|
public void Menu_StylePlain_Explicit_RetailButtonArtFalse()
|
|
{
|
|
var panel = MarkupDocument.Build(
|
|
MenuXml(" style=\"plain\""), new MenuStyleBinding(), _ => (1u, 32, 32));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
|
|
Assert.False(menu.RetailButtonArt);
|
|
}
|
|
|
|
[Fact]
|
|
public void Menu_StyleRetail_OptsIntoTheGoldButtonArt()
|
|
{
|
|
var panel = MarkupDocument.Build(
|
|
MenuXml(" style=\"retail\""), new MenuStyleBinding(), _ => (1u, 32, 32));
|
|
var menu = Assert.IsType<UiMenu>(panel.Children[0]);
|
|
|
|
Assert.True(menu.RetailButtonArt);
|
|
}
|
|
|
|
[Fact]
|
|
public void Menu_UnknownStyle_ThrowsFormatException_NamingTheElement()
|
|
{
|
|
var ex = Assert.Throws<FormatException>(
|
|
() => MarkupDocument.Build(
|
|
MenuXml(" style=\"chrome\""), new MenuStyleBinding(), _ => (1u, 32, 32)));
|
|
|
|
Assert.Contains("menu", ex.Message);
|
|
Assert.Contains("chrome", ex.Message);
|
|
}
|
|
}
|