Reconstruct lab story, interactions, patrol and jet pack practice flow
This commit is contained in:
1 parent
58424120bb
commit
c929f942e1
84 files changed
+7957
-305
No files matched your search
@@ -0,0 +1,120 @@
|
||||
# Source-backed static scene models
|
||||
|
||||
Implemented 2026-10-24 in `tools/extractors/models.py` and
|
||||
`Application/StaticSceneVisuals.cs`. This adds the original model consumers for
|
||||
OMT props, phone booths and explicit ASE/PNG entities. It does not establish
|
||||
complete interaction, door collision, animation playback or visual fidelity.
|
||||
|
||||
## Evidence and prepared fixtures
|
||||
|
||||
LV1B has nine relevant model instances, sharing six source models:
|
||||
|
||||
| Source entities | Original model | Triangles per instance | Texture binding |
|
||||
|---|---|---:|---|
|
||||
| PHONE1 / PHONE2 | `phone.omt`, `3DSh:0` | 90 | Three original material/canvas links |
|
||||
| bars | GAM `ASEFile=bars.ase` | 54 | GAM `PNGFile=chain.png` |
|
||||
| Two `C3DBUTTON` records | GAM `Up.ase` / `Down.ase` | 16 each variant | GAM `UpDown.Png=switch.png` |
|
||||
| dino | GAM `objects.omt`, `3DSh:27` | 256 | Original material27 -> canvas26 |
|
||||
| plant1 / plant2 / plant3 | GAM `objects.omt`, `3DSh:28` | 168 | Original material28 -> canvas27 |
|
||||
|
||||
VR01 has two phone booths, using the same verified `phone.omt:3DSh:0` source
|
||||
binding. Both booth instances remain separate even though their GAM tags match.
|
||||
|
||||
The phone class opens `phone.omt` at EXE `0x43579d` and selects shape0 at
|
||||
`0x4357c9`. The similarly named `phone.ASE` and standalone `phone.png` are other
|
||||
assets and are not substituted. Its three material links are `{0:Canv1,
|
||||
1:Canv0,2:Canv2}`. The 90 triangles span **five** source material draw ranges,
|
||||
with index counts `[120,6,12,6,126]`; retaining only a single final draw would omit
|
||||
parts of the booth.
|
||||
|
||||
Button resource registrations are recovered at EXE `0x411695`, `0x4116c3`,
|
||||
`0x411722`. InitObject at `0x411b93` selects literal `UP` (`0x4ed9bc`), so the
|
||||
default static variant is source-backed. The consumer recognizes `UP` / `HIUP`
|
||||
and `DOWN` / `HIDOWN`. It displays the first authored pose of the selected
|
||||
variant; it does not imply that button morph transition timing is reconstructed.
|
||||
Bars and other explicit ASEFile/PNGFile pairs retain the first authored sample
|
||||
and the proven ASE-to-OMT axis/UV conversion. No additional node transform or
|
||||
floor correction is introduced.
|
||||
|
||||
## Preparation interface
|
||||
|
||||
```python
|
||||
prepare_models(original: Path, level_file: str, output: Path) -> dict
|
||||
```
|
||||
|
||||
From `GamePort/`:
|
||||
|
||||
```sh
|
||||
python3 tools/extractors/models.py --level level1b.gam --output artifacts/extracted/level1b/models
|
||||
python3 tools/extractors/models.py --level VR01.gam --output artifacts/extracted/VR01/models
|
||||
python3 -m unittest discover -s tests -p test_models.py -v
|
||||
```
|
||||
|
||||
`models.json` schema1 contains:
|
||||
|
||||
- Source GAM path/hash and level code.
|
||||
- `models`: unique keys, relative scene JSON paths, source hashes/resource
|
||||
identities and geometry counts.
|
||||
- `actors`: original ordinal/byte offset/tag/class, default variant, variant-to-
|
||||
model-key references, and mapping evidence.
|
||||
- `unresolved`: incomplete explicit mappings; no class default is invented.
|
||||
|
||||
Each OMT model exports only its selected `3DSh` and transitively referenced
|
||||
`3DMa` / `Canv` resources. Source material/texture IDs remain local inside each
|
||||
model scene file. No unrelated archive geometry is copied. Existing ASE and PNG
|
||||
assets are decoded locally, without modifying originals.
|
||||
|
||||
The source corpus contains one Level3C button at GAM offset33909 whose explicit
|
||||
`UpDown.Png` is `none`. It is recorded unresolved and omitted from model actors
|
||||
until its actual constructor/fallback binding is recovered. LV1B/VR01 have no
|
||||
unresolved entries in this subset. Other classes without explicit bindings are
|
||||
outside this consumer and are not presumed invisible or complete.
|
||||
|
||||
## Runtime interface and invariants
|
||||
|
||||
```csharp
|
||||
new StaticSceneVisuals(Mesh combined, SceneDirector director,
|
||||
string assetsRoot, string preparedRoot);
|
||||
Mesh Mesh { get; }
|
||||
void Update(Mesh destination);
|
||||
```
|
||||
|
||||
`preparedRoot` is the scene's `models` directory containing `models.json`.
|
||||
All required geometry/texture bytes are prepared; no speculative runtime fallback
|
||||
uses `assetsRoot`. Actor lookup uses original source GAM byte offsets rather than
|
||||
tags, preserving duplicate tags. The integration can append later consumers and
|
||||
pass the resulting combined mesh to `Update`.
|
||||
|
||||
All source model vertex/index/draw ranges are retained. Each instance/variant
|
||||
gets distinct texture IDs starting at `int.MinValue+20000`; preexisting identity
|
||||
collisions are rejected. The actual lab consumer adds19 original draw ranges
|
||||
and15 texture identities. Every phone material draw follows actor visibility.
|
||||
Button inactive variants keep allocated ranges but do not draw.
|
||||
|
||||
Director position/rotation updates transform original local vertices directly.
|
||||
The current shared actor rotation convention is X, negative yaw Y, then Z,
|
||||
followed by the director position. Exact general Euler composition still requires
|
||||
original comparison; tests establish the implemented translation and yaw behavior.
|
||||
No character grounding/floor correction is applied to these props. Bars movement
|
||||
is visible only when a separate recovered gameplay consumer changes its actor
|
||||
root; this visual consumer itself does not invent opening motion.
|
||||
|
||||
Null material handling matches the existing original DX rule: preserve geometry
|
||||
but skip draws whose original material is null or unresolved. The original LV1B
|
||||
invisible proxies reference absent material18; selective extraction preserves
|
||||
those links and reports `nullMaterialIds` rather than fabricating a white material.
|
||||
An explicit empty draw list stays empty on mesh integration.
|
||||
|
||||
## Verification
|
||||
|
||||
Eight Python test groups include a locally compiled .NET10 consumer harness.
|
||||
They verify actual phone geometry and all five material ranges, explicit model
|
||||
bindings, OMT subset export, duplicate tags, source hashes/output boundaries,
|
||||
missing mapping reporting, distinct texture IDs, translation/yaw/no floor
|
||||
correction, hide/show, independent button variants, retained combined buffers,
|
||||
reserved-ID conflict rejection, and null-material geometry without invented draws.
|
||||
|
||||
The main C# project builds with zero warnings/errors after adding the consumer.
|
||||
Prepared asset and managed harness checks are not GPU or original-runtime fidelity
|
||||
verification. Primary integration must verify scene rendering, updating the final
|
||||
combined buffers, source entity transitions, packaging, and native platform behavior.
|
||||
Reference in new issue
Block a user