Files

98 lines
5.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Scooter / Rocketship resource contract
2026-11-02. Read-only original asset inspection. No original executable was run
and no original file was modified. Source binding recovery belongs to
`scooter_contract`; geometry/sample/pixel observations here do not establish
attachment, steering, visibility, sound ownership or interpolation policy.
`tools/extractors/scooter_resources.py` exposes `export_scooter(original, output)`.
Its schema1 `scooter.json` references two independent original OMT shape scenes,
Jimmy's two renderable Scooter animation manifests, and the two unbound Goddard
Scooter source morphs. It checks original hashes before output, rejects original
subtrees/ancestors and existing descendant symlinks, and uses portable
case-insensitive asset lookup. Original PNG pixels and OMT canvas alpha are kept.
```bash
python3 tools/extractors/scooter_resources.py ../Original --output artifacts/vehicle-assets/scooter
python3 -m unittest discover -s tests -p test_scooter_resources.py -v
```
Five checks pass: shape/material/pixel identity, exact Jimmy base topology and
sample positions, preserved unbound source times/absent UVs, source/output
protection and changed-source rejection before output. Generated inspection data
is `artifacts/vehicle-assets/inventory.json`; generated resources are under
`artifacts/vehicle-assets/scooter/`. No shared prepare/runtime files were edited.
## Usable Scooter geometry
Archive `omt/scooter.omt` SHA256
`8d4ffdafee5fd819c5220ee4f608c901a5988fe6b8b13316e15618f5eec75e81`.
| Original resource | Offset / bytes | Geometry / exact texture link |
| --- | --- | --- |
|3DSh0 `goddard01`|104 /19342|98 indexed vertices,176 triangles; material0|
|3DSh1 `wheel`|92304 /5814|32 indexed vertices,56 triangles; material1 plus null-material polygons|
|3DMa0 `goddard128`|19446 /52|Canv1|
|3DMa1 `scooterwheel2`|19498 /52|Canv0|
|Canv0 `scooterwheel2`|22568 /3966|32×32, RGBA SHA256 `92dfef71def8079db70ba4eaa47e973d45a0b3987418e87dbf65cc3cf0bf823b`|
|Canv1 `goddard128`|26534 /65770|128×128, RGBA SHA256 `b22651171a7b9f2c99831a1ff4fd8d01d11ccabfc276d71dd91bacd710cd1cba`|
This corrects the ambiguous material/canvas ordering in gadget-assets.md:
body material0 points to **canvas1**, wheel material1 to **canvas0**.
Each shape gets a separate `shape_ID/scene.json` compatible with the existing
OMT scene loader, expanded source positions, source normals/materials/UVs,
transitively referenced decoded canvas and provenance. Null wheel materials stay
null (`material:-1`), rather than receiving an invented visible material.
Neither shape is translated, scaled or instanced by this exporter. Runtime must
use the separately recovered original body/wheel attachment contract.
## Morph compatibility
| Original ASE | Indexed vertices / faces | Sample times | fps / ticks per frame | Available base |
| --- | --- | --- | --- | --- |
|jimscooter|426 /814|0,480|10 /480|jimstop426; base supplies original UV/topology|
|jimscooterstop|426 /814|0,480|10 /480|jimstop426; base supplies original UV/topology|
|godscooter|195 /370|0,161|30 /160|none recovered|
|godscooter2|195 /370|0,161|30 /160|none recovered|
|godrocket|222 /411|0,960,1920|5 /960|count-compatible godpoint222, binding separate|
|jimdrive|426 /814|0,480|10 /480|count-compatible jimstop426, binding separate|
Jimmy exports use the existing `export_ase` family format and exact original
`png/jimycarl.png` (SHA256
`55ed165aaffe177cb62558a08d13fc3b2210da6e353065b108849d46df9dacb6`).
Each animation is source-named, with relative `../jimycarl.rgba` texture and
two expanded geometry frames. No family action names or playback times are
assigned. Existing `prepare_actor` can express these Jimmy clips directly.
Flat reconstructed ASE normals remain the existing exporter limitation.
Both Scooter dog morphs have **no UV tables**. Their195 positions differ from
both OMT body98 and the existing Goddard godpoint222 base. Existing morph export
correctly rejects these combinations. `godscooter-unbound.json` and
`godscooter2-unbound.json` preserve all parsed positions/faces and exact sample
times, without fabricated UVs or rendering them as a valid actor. The second
sample's161 ticks is intentionally retained, not rounded to160. Material-list
filenames include many unrelated scene leftovers; these do not prove binding.
## Rocketship and Baseball boundary
`godrocket.ASE` lacks UVs but has222 vertices/411 faces, the same count as
`godpoint.ASE` (textured high-detail Goddard base). This permits existing actor
export mechanics *if* binary binding establishes that base. It does not justify
claiming the gadget renders that clip. `jimdrive.ASE` similarly has426 positions
and no UVs. `rocket.ASE` is a separate textured16-vertex/22-face mesh (one sample,
5fps/960 ticks), and `rocketfire.ASE` has4 vertices/3 faces at0/960/1920 with UVs.
The material texts mention rocket.bmp/fire.png; no Rocketship gadget attachment
is inferred. `objects.omt` contains3DSh26 `rocketship`135 vertices/236 polygons;
that name also does not close the gadget's resource binding.
No baseball-named ASE or PNG was found by bounded filename search. This does not
establish that the source lacks a ball asset. The separate Baseball investigation
has recovered constructor40FC50 using RetainedSprites.omt Canv2 at sprite size25;
25 is not a shape ID. Exact resources and TIME font are in `baseball-assets.md`
and `baseball-font.md`. Original HUD/control/sound identity
is already inventoried in `gadget-assets.md` and should not be duplicated.
Static asset extraction and the five Python checks are verified. Gadget rendering,
wheel motion, source animation timing, original execution comparison and native
Windows behavior remain unverified.