98 lines
5.6 KiB
Markdown
98 lines
5.6 KiB
Markdown
# 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.
|