cthangover/mod_cthangover_game
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Update cthangover_game implementation, assets and documentation

Browse Source
This commit is contained in:
cthangover committed 2026-10-31 15:28:50 +03:00
1 parent b42b35d79e
commit 65eb187bb2
42 files changed
+977 -2
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

test_suites/marao_avatars/tests/MaraoAvatarTests.cs
+120
View File
@@ -0,0 +1,120 @@
using System;
using System.Collections.Generic;
using System.Security.Cryptography;
using System.Text.Json;
using System.Threading.Tasks;
using Cthangover.Core.Mods.Resolvers;
using Cthangover.Core.Mods.Testing;
using Cthangover.Core.Utils;
using Cthangover.Mods.Avatars;
using Godot;
namespace Cthangover.Mods.MaraoAvatars.Tests
{
/// <summary>Auditions the actual story PNGs through preset state and the installed layered renderer.</summary>
public sealed class MaraoAvatarTests
{
private const string AvatarId = "cthangover/marao_test";
private const string Output = "res://gen/marao_avatar_test_20261030/";
private static string OutputFile(string name)
{
// The picture folder may be missing on a fresh checkout (the host has no gen/ subfolder).
var dir = ProjectSettings.GlobalizePath(Output);
DirAccess.MakeDirRecursiveAbsolute(dir);
return dir + name;
}
[ModTest("marao_avatars/all_ten_reactions_render_and_restore", TimeoutSeconds = 45)]
public static async Task Reactions(ModTestContext ctx)
{
ModAssert.True(GameEnvironment.IsRuntime, "visual audition requires the Godot runtime");
var tree = (SceneTree)Engine.GetMainLoop();
var viewport = new SubViewport { Size = new Vector2I(512, 768), TransparentBg = true,
Disable3D = true, RenderTargetUpdateMode = SubViewport.UpdateMode.Always };
var avatar = AvatarCatalog.Create(AvatarId);
var independent = AvatarCatalog.Create(AvatarId);
var definition = Entities.Collect<AvatarDefinition>()[AvatarId];
ModAssert.Equal(10, definition.Groups["reaction"].Presets.Count, "all requested reactions installed");
using var renderer = AvatarRenderers.Create(avatar);
var hashes = new HashSet<string>(StringComparer.Ordinal);
try
{
tree.Root.AddChild(viewport);
viewport.AddChild(renderer.View);
foreach (var preset in definition.Groups["reaction"].Presets.Keys)
{
avatar.ApplyPresets(new Dictionary<string, string> { ["reaction"] = preset });
renderer.Apply(avatar.Resolve());
await tree.ToSignal(RenderingServer.Singleton, RenderingServer.SignalName.FramePostDraw);
using var image = viewport.GetTexture().GetImage();
var visible = 0; var transparent = 0;
for (var y = 0; y < image.GetHeight(); y += 16)
for (var x = 0; x < image.GetWidth(); x += 16)
{
var alpha = image.GetPixel(x, y).A;
if (alpha > 0.9f) visible++;
if (alpha < 0.01f) transparent++;
}
ModAssert.True(visible > 100, preset + ": character has visible pixels");
ModAssert.True(transparent > 100, preset + ": transparent surroundings preserved");
ModAssert.True(hashes.Add(Convert.ToHexString(SHA256.HashData(image.GetData()))),
preset + ": reaction produces a distinct rendered image");
ModAssert.True(image.SavePng(OutputFile(preset + ".render.png")) == Error.Ok,
preset + ": rendered audition exported");
var saved = JsonSerializer.Deserialize<AvatarState>(JsonSerializer.Serialize(avatar.CaptureState()));
var restored = AvatarCatalog.Create(AvatarId, saved);
ModAssert.Equal(preset, restored.CaptureState().Presets["reaction"], "JSON save restores selection");
}
ModAssert.Equal("neutral", independent.CaptureState().Presets["reaction"], "another instance stays unchanged");
}
finally
{
renderer.Dispose(); viewport.GetParent()?.RemoveChild(viewport); viewport.Free();
}
}
[ModTest("marao_avatars/comparison_sheet", TimeoutSeconds = 45)]
public static async Task Comparison(ModTestContext ctx)
{
ModAssert.True(GameEnvironment.IsRuntime, "comparison sheet requires the Godot runtime");
var tree = (SceneTree)Engine.GetMainLoop();
var viewport = new SubViewport { Size = new Vector2I(1440, 960), TransparentBg = false,
Disable3D = true, RenderTargetUpdateMode = SubViewport.UpdateMode.Always };
var renderers = new List<IAvatarRenderer>();
try
{
tree.Root.AddChild(viewport);
viewport.AddChild(new ColorRect { Color = new Color("e4ded4"), Size = new Vector2(1440, 960) });
var index = 0;
foreach (var preset in Entities.Collect<AvatarDefinition>()[AvatarId].Groups["reaction"].Presets.Keys)
{
var x = (index % 5) * 288; var y = (index / 5) * 480;
viewport.AddChild(new ColorRect { Color = new Color(index % 2 == 0 ? "e4ded4" : "c5c6c5"),
Position = new Vector2(x, y), Size = new Vector2(288, 480) });
var avatar = AvatarCatalog.Create(AvatarId);
avatar.ApplyPresets(new Dictionary<string, string> { ["reaction"] = preset });
var renderer = AvatarRenderers.Create(avatar); renderers.Add(renderer);
viewport.AddChild(renderer.View);
renderer.View.Scale = new Vector2(0.5f, 0.5f);
renderer.View.Position = new Vector2(x + 16, y + 24);
var label = new Label { Text = (index + 1) + ". " + preset, Position = new Vector2(x + 12, y + 426),
Size = new Vector2(264, 36), HorizontalAlignment = HorizontalAlignment.Center };
label.AddThemeColorOverride("font_color", new Color("24232b"));
label.AddThemeFontSizeOverride("font_size", 18);
viewport.AddChild(label);
index++;
}
await tree.ToSignal(RenderingServer.Singleton, RenderingServer.SignalName.FramePostDraw);
using var sheet = viewport.GetTexture().GetImage();
ModAssert.True(sheet.SavePng(OutputFile("comparison.png")) == Error.Ok,
"comparison sheet exported from actual avatar renderer");
}
finally
{
foreach (var renderer in renderers) renderer.Dispose();
viewport.GetParent()?.RemoveChild(viewport); viewport.Free();
}
}
}
}
test_suites/marao_avatars/tests/PairedAvatarTests.cs
+134
View File
@@ -0,0 +1,134 @@
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text.Json;
using System.Threading.Tasks;
using Cthangover.Core.Mods.Resolvers;
using Cthangover.Core.Mods.Testing;
using Cthangover.Core.Utils;
using Cthangover.Mods.Avatars;
using Godot;
namespace Cthangover.Mods.MaraoAvatars.Tests
{
/// <summary>Both content avatars share the same named emotions while retaining independent view/pose state.</summary>
public sealed class PairedAvatarTests
{
private const string Marao = "cthangover/marao_test";
private const string Book = "cthangover/al_azif_test";
private const string Output = "res://gen/marao_azif_avatar_update_20261030/";
private static string OutputFile(string name)
{
// The picture folder may be missing on a fresh checkout (the host has no gen/ subfolder).
var dir = ProjectSettings.GlobalizePath(Output);
DirAccess.MakeDirRecursiveAbsolute(dir);
return dir + name;
}
[ModTest("paired_avatars/common_emotions_render_and_restore", TimeoutSeconds = 60)]
public static async Task CommonEmotions(ModTestContext ctx)
{
ModAssert.True(GameEnvironment.IsRuntime);
var definitions = Entities.Collect<AvatarDefinition>();
var states = definitions[Marao].Groups["emotion"].Presets.Keys.OrderBy(Identity, StringComparer.Ordinal).ToArray();
var bookStates = definitions[Book].Groups["emotion"].Presets.Keys.OrderBy(Identity, StringComparer.Ordinal).ToArray();
ModAssert.Equal(13, states.Length, "twelve shared states plus auto");
ModAssert.Equal(string.Join(",", states), string.Join(",", bookStates), "same public emotion names");
var tree = (SceneTree)Engine.GetMainLoop();
var viewport = new SubViewport { Size = new Vector2I(512, 768), TransparentBg = true,
Disable3D = true, RenderTargetUpdateMode = SubViewport.UpdateMode.Always };
try
{
tree.Root.AddChild(viewport);
foreach (var id in new[] { Marao, Book })
{
var avatar = AvatarCatalog.Create(id);
using var renderer = AvatarRenderers.Create(avatar);
viewport.AddChild(renderer.View);
foreach (var state in states)
{
avatar.ApplyPresets(new Dictionary<string, string> { ["emotion"] = state });
renderer.Apply(avatar.Resolve());
await tree.ToSignal(RenderingServer.Singleton, RenderingServer.SignalName.FramePostDraw);
using var image = viewport.GetTexture().GetImage();
var visible = 0; var transparent = 0;
for (var y = 0; y < 768; y += 24)
for (var x = 0; x < 512; x += 24)
{
var alpha = image.GetPixel(x, y).A;
if (alpha > 0.9f) visible++;
if (alpha < 0.01f) transparent++;
}
ModAssert.True(visible > 40 && transparent > 40, id + "/" + state + ": rendered with alpha");
var saved = JsonSerializer.Deserialize<AvatarState>(JsonSerializer.Serialize(avatar.CaptureState()));
var restored = AvatarCatalog.Create(id, saved);
ModAssert.Equal(state, restored.CaptureState().Presets["emotion"]);
}
}
var book = AvatarCatalog.Create(Book);
foreach (var view in new[] { "front", "angled", "back", "open" })
{
book.ApplyPresets(new Dictionary<string, string> { ["view"] = view, ["emotion"] = "angry_scream" });
using var renderer = AvatarRenderers.Create(book);
viewport.AddChild(renderer.View);
await tree.ToSignal(RenderingServer.Singleton, RenderingServer.SignalName.FramePostDraw);
using var image = viewport.GetTexture().GetImage();
ModAssert.True(image.SavePng(OutputFile("al_azif_" + view + ".render.png")) == Error.Ok);
var state = JsonSerializer.Deserialize<AvatarState>(JsonSerializer.Serialize(book.CaptureState()));
ModAssert.Equal(view, AvatarCatalog.Create(Book, state).CaptureState().Presets["view"]);
}
}
finally { viewport.GetParent()?.RemoveChild(viewport); viewport.Free(); }
}
[ModTest("paired_avatars/emotion_comparison_sheet", TimeoutSeconds = 60)]
public static async Task Comparison(ModTestContext ctx)
{
ModAssert.True(GameEnvironment.IsRuntime);
var tree = (SceneTree)Engine.GetMainLoop();
var viewport = new SubViewport { Size = new Vector2I(1920, 1920), TransparentBg = false,
Disable3D = true, RenderTargetUpdateMode = SubViewport.UpdateMode.Always };
var renderers = new List<IAvatarRenderer>();
try
{
tree.Root.AddChild(viewport);
viewport.AddChild(new ColorRect { Size = new Vector2(1920, 1920), Color = new Color("e4ded4") });
var index = 0;
foreach (var emotion in Entities.Collect<AvatarDefinition>()[Marao].Groups["emotion"].Presets.Keys)
{
if (emotion == "auto") continue;
var x = (index % 3) * 640; var y = (index / 3) * 480;
viewport.AddChild(new ColorRect { Position = new Vector2(x, y), Size = new Vector2(640, 480),
Color = new Color(index % 2 == 0 ? "e4ded4" : "c6c7c5") });
var side = 0;
foreach (var id in new[] { Marao, Book })
{
var avatar = AvatarCatalog.Create(id);
avatar.ApplyPresets(new Dictionary<string, string> { ["emotion"] = emotion });
var renderer = AvatarRenderers.Create(avatar); renderers.Add(renderer);
viewport.AddChild(renderer.View);
renderer.View.Scale = new Vector2(0.5f, 0.5f);
renderer.View.Position = new Vector2(x + 24 + side * 320, y + 24);
side++;
}
var label = new Label { Text = emotion, Position = new Vector2(x + 12, y + 428),
Size = new Vector2(616, 36), HorizontalAlignment = HorizontalAlignment.Center };
label.AddThemeColorOverride("font_color", new Color("24232b"));
label.AddThemeFontSizeOverride("font_size", 22);
viewport.AddChild(label); index++;
}
await tree.ToSignal(RenderingServer.Singleton, RenderingServer.SignalName.FramePostDraw);
using var image = viewport.GetTexture().GetImage();
ModAssert.True(image.SavePng(OutputFile("emotion_comparison.png")) == Error.Ok);
}
finally
{
foreach (var renderer in renderers) renderer.Dispose();
viewport.GetParent()?.RemoveChild(viewport); viewport.Free();
}
}
private static string Identity(string value) => value;
}
}