Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Expose immutable humanoid correctives

Yuechen Li040c1dd9bd68
diff --git a/Aetheris.Humanoid/HumanoidGameplayBody.cs b/Aetheris.Humanoid/HumanoidGameplayBody.cs
index 082846f0..59d7f479 100644
--- a/Aetheris.Humanoid/HumanoidGameplayBody.cs
+++ b/Aetheris.Humanoid/HumanoidGameplayBody.cs
@@ -47,11 +47,16 @@ public sealed class HumanoidGameplayBody
};
Id = artifact.Id;
binding = new(Surface, Skeleton, correctives: artifact.Correctives);
+ Correctives = Array.AsReadOnly(artifact.Correctives.Select(corrective => corrective with
+ {
+ Vertices = Array.AsReadOnly(corrective.Vertices.ToArray()),
+ }).ToArray());
}
public string Id { get; }
public HumanoidSurface Surface { get; }
public HumanoidSkeleton Skeleton { get; }
+ public IReadOnlyList<HumanoidPoseCorrective> Correctives { get; }
public HumanoidSolveResult Solve(string poseId, IReadOnlyList<AnatomicalJointRequest> requests)
{
diff --git a/docs/public/humanoid-gameplay-body.md b/docs/public/humanoid-gameplay-body.md
index f627587f..b34a7489 100644
--- a/docs/public/humanoid-gameplay-body.md
+++ b/docs/public/humanoid-gameplay-body.md
@@ -69,14 +69,18 @@ artifact as a canonical humanoid.
`CreatePalette` prepares two float4 quaternions per joint in XYZW order, in
O(joints) time. `Evaluate` is the CPU reference, including corrective application.
-An Aurelian Vulkan skinning adapter is **not implemented or qualified here**.
-It must apply pre-skin correctives and the same normalized dual-quaternion blend,
-including quaternion sign alignment. Preserve all six possible influences.
+`Correctives` exposes an immutable snapshot of the authored shape bank for
+presentation adapters. Copeland's `Aurelian.Humanoid` integration now implements
+Vulkan compute skinning with the pre-skin correctives, the same normalized
+dual-quaternion blend, quaternion sign alignment and all six possible influences.
+Its Character Lab owns GPU/runtime qualification; run `characterlab.cmd --proof`
+in Copeland and inspect its evidence. See Copeland's
+`docs/Aurelian/humanoid-animation.md` for the API and bounded animation coverage.
Ordinary glTF/GLB skinning does not encode this dual-quaternion convention.
Do not export this body and silently substitute linear-blend skinning: the
qualification would no longer apply. Use the Blender authoring asset and typed
-body artifact until the engine's matching skinning path is available.
+body artifact with the matching Aurelian DQS adapter.
## Reproduce
@@ -124,5 +128,6 @@ Deep crouches and large hip flexion need further authored correction work.
The body is a usable base, not a complete DAZ-grade character product: facial
animation, hair, clothing, LODs, production texture maps, full-body retargeting,
-candidate-specific morph/attachment admission and GPU integration remain future
-work. No automatic canonical promotion is performed.
+candidate-specific morph/attachment admission remain future work. Aurelian's
+bounded GPU animation integration is separate from this body's source
+qualification. No automatic canonical promotion is performed.