fix(rendering): bound portal resource lifetime

Separate logical ownership, render publication, and GPU retirement across live entities, landblocks, particles, textures, mesh arenas, portal/UI teardown, and per-frame scratch storage. Add bounded DAT/texture caches, upload budgets, three-frame fence retirement, exact-incarnation appearance reconciliation, frame pacing, and extensive lifetime conformance coverage.\n\nThe seven-destination connected route now cuts peak working/private memory roughly in half, returns Caul to 125-153 FPS locally, and produces no WER or AMD reset.\n\nCo-authored-by: OpenAI Codex <codex@openai.com>
This commit is contained in:
Erik 2026-07-18 21:35:16 +02:00
parent 3971997689
commit 749e8ceeb1
225 changed files with 29107 additions and 3914 deletions

View file

@ -1,5 +1,25 @@
namespace AcDream.App.Rendering.Wb;
/// <summary>
/// Reports the physical outcome when a mesh-reference callback cannot provide
/// the normal strong exception guarantee. <see cref="MutationCommitted"/> lets
/// a transactional owner reconcile its marker without guessing whether a
/// throwing backend already changed the reference count.
/// </summary>
public sealed class MeshReferenceMutationException : Exception
{
public MeshReferenceMutationException(
string message,
bool mutationCommitted,
Exception innerException)
: base(message, innerException)
{
MutationCommitted = mutationCommitted;
}
public bool MutationCommitted { get; }
}
/// <summary>
/// Mockable interface over <see cref="WbMeshAdapter"/> so adapters that
/// drive ref-count lifecycle (e.g. LandblockSpawnAdapter, EntitySpawnAdapter)
@ -7,7 +27,17 @@ namespace AcDream.App.Rendering.Wb;
/// </summary>
public interface IWbMeshAdapter
{
/// <summary>
/// Acquires one logical reference. A normal exception guarantees that no
/// reference was acquired; <see cref="MeshReferenceMutationException"/>
/// explicitly reports the exceptional backend case where it was committed.
/// </summary>
void IncrementRefCount(ulong id);
/// <summary>
/// Releases one logical reference under the same committed-outcome contract
/// as <see cref="IncrementRefCount"/>.
/// </summary>
void DecrementRefCount(ulong id);
/// <summary>