Files

146 lines
8.0 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.
# Baseball original resources and VR07 fixture
2026-11-02. Original serialized resources and decoded pixels were read locally;
originals were not modified or executed. Binary activation/projectile/target
behavior belongs to the separate Baseball contract investigation. This report
records asset identity and a resource interface suitable for integration.
`tools/extractors/baseball_resources.py` exposes `export_baseball(original, output)`
and writes schema1 `baseball.json`. It preserves five exact canvases from
RetainedSprites.omt and the authored VR07 start/target/intro properties, including
every property source offset/raw bytes and duplicate target tags. It rejects
original subtree/ancestor outputs and existing descendant symlinks, checks both
archive and GAM identities before writing, and guards dimensions/pixel hashes.
```bash
python3 tools/extractors/baseball_resources.py ../Original --output artifacts/vehicle-assets/baseball
python3 -m unittest discover -s tests -p test_baseball_resources.py -v
```
Six regression checks pass: exact RGBA/PNG/provenance, original aim/glyph pixels,
six distinct target
records with authored property bytes, protected output paths, changed decoded
pixels and changed archive identity. Local output and test log are
`artifacts/vehicle-assets/baseball/` and `artifacts/vehicle-assets/baseball-tests.log`.
No shared prepare/runtime/build files were changed by this investigator.
## Port visual implementation and tested limits
`Application/BaseballVisuals.cs` appends20 hidden world alpha quads to a supplied
Mesh, preserving its collision metadata and existing draws/textures. `Update`
uses the caller's pool visibility/position, exact Canv2 and25×25 world dimensions.
It does not animate frames2..5 or invent a lifetime. Camera-facing centered
billboard orientation is a declared modern policy pending exact inherited sprite
render recovery. Degenerate straight-up/down cameras use a finite orthonormal
basis. Resource paths are bounded to the prepared Baseball directory, input
size/depth/dimensions and exact original pixel hashes are validated.
`Application/BaseballAimOverlay.cs` uses exact screens.omt Canv253 CrossHairs
15×210 pixels, SHA256
`2e16e11b151c8474ba68fd5017d1a3a6304a594a7f34c3b423f3417c7edfb453`.
The complete strip stays stationary at logical(315,100), without frame cropping.
Visibility follows AimVisible; text reads the separate prior-capture DisplayPitch,
not the newly captured SavedPitch. Source numeric position is
`y=trunc((45-DisplayPitch)*4.3+100)`, source text anchorx286, with positive-space
plus two zero-padded decimal digits from `% .2d`.
The subsequent [TIME font recovery](baseball-font.md) closes that binding:
set5 digits use alpha.omt118,127,120..126,119, all16×16. A null positive-space
glyph has zero advance; visible digits begin286 and302. Exact green pixels are
preserved with white vertex tint. Runtime/exporter/tests now use that source
mapping; the temporary SMAL policy is superseded.
The exporter writes these plus the source strip into `aimTextures`, each with
its source database key, byte range and decoded hash. `aimArchiveSha256` guards
screens.omt and alpha.omt. Source table, formatting and advance Evidence is in
baseball-font.md.
UiViewport retains uniform scale and centered640×480 placement at widescreen
and portrait sizes. Screen/world quads use alpha blending with unmodified source
texture alpha. Six standalone checks pass in
`artifacts/vehicle-assets/baseball-visual-tests.log`:20-slot/pixel/source metadata,
billboard bounds/camera degeneracies, stationary aim/number/selected glyphs,
widescreen and portrait scaling, combined world/overlay isolation and rejection
of altered pixels/dimensions/path traversal. Invocation:
```bash
source scripts/env.sh
dotnet run --project tests/GamePort.BaseballVisualTests
```
These are compiled port-side deterministic mesh/pixel checks. They do not verify
a displayed Vulkan frame, original source execution or native Windows behavior.
## Projectile and retained target artwork
Archive `omt/RetainedSprites.omt` SHA256
`b584ffa4a38f4bc809b3ea8f4321e0c08f2719e22df41a3fb4cd143ed89b3bef`.
This archive contains Canv resources, not 3D shapes.
| Canv / name | Offset / bytes | Dimensions | Decoded RGBA SHA256 |
| --- | --- | --- | --- |
|2 ball0000|72372 /3786|32×32|`68904b758e69139de0b01329b2a9844ecd2a466f31598c24324affaccfa2cab9`|
|3 ball0001|68582 /3790|32×32|`005def070e18111fbdb067e75285dad8ec677c1608020f55c3db7a4b9745205c`|
|4 ball0002|64788 /3794|32×32|`c368a59d5d7a57824c1c6b56b617cf058f5d5d53e18e5e48989710413490c536`|
|5 ball0003|58830 /3794|32×32|`e5da21c359d3215759e5c3c238107f526f7109203c0ff9fa391a3c8bc40c17ed`|
|8 target|48796 /10034|64×64|`8d31014cb9b9661ebed902c864bf740f562460e74da3f6b86ed3d2be4d10f0ec`|
Manifest `textures` records id/name/width/height/path/png/sourceOffset/sourceBytes/
sourceSha256/rgbaSha256. `ballCanvasIds` lists source IDs2..5 in source-number
order, without assigning animation cadence. `retainedTargetCanvasId:8` names
the literal retained artwork only; it is not the six VR07 target actors' artwork.
Pixels are neither recolored nor resized. The source target8 image visibly has
a four-corner frame/cross pattern; inspected original pixels are available as
`artifacts/vehicle-assets/retained_8.png`.
The contract investigator corrected an early interpretation of constructor40FC50:
its complete57C=25 is the inherited sprite dimension, complete580=2 the initial
canvas ID, and complete5F8..604 retain IDs2..5. It is not shape25. Exact REA
Evidence, frame selection, billboarding, size and render-state policy belong in
that investigator's source report; this exporter embeds no unverified cadence.
## Actual VR07 target visuals
All six authored `3TAR` records explicitly serialize `SpriteDatabase=sprites.omt`,
`SpriteIndex=135`, `SpriteSize=150`. The source resource is Canv135 **star**,
128×128 at offset2750568/35394 bytes. It is a pale purple jagged starburst with
8,016 alpha255 and8,368 alpha0 pixels. Exact RGBA SHA256:
`42bbea6c33fc2889cad0cd659af2274f936be10643254af233779c44f1e41e07`.
Archive SHA256:
`c8e016ea73e6104b9b672139b1d0b0ac83afc4feff6cc744a7fa4f6ba919e2a2`.
Inspected pixels: `artifacts/vehicle-assets/sprites_135.png`.
The existing `prepare_entities` exporter already follows this explicit sprite
database/index and can supply the exact texture; no duplicate sprite export is
necessary. Primary independently traced actual factory45CA06 to430220, inheriting
the sprite base441980; it is distinct from the Jimmy-owned retained target actor
and from the other class constructor4453B0 sharing a FourCC. That factory/default
recovery is separate from the serialized values verified here. The integration
must establish that the source loader respects the serialized overrides before
claiming runtime target appearance parity.
## Authored tutorial instances
VR07.gam SHA256
`1260b75d82ec794f9375ada30e186424746bc1dd4e4b0540c9b69bb7ad12d0b1`.
Six target offsets are0x885,0xAD6,0xD27,0xF78,0x11C9,0x141C. Every target uses
the same tag `C3DMOVINGTARGET`; identify instances by source offset/ordinal.
All serialize Speed100, HitsRequired3, NumPoints10, RespawnTime15 and
ActivateObject=`none`. These are data values, not reconstructed hit/motion rules.
| Offsets | Authored start | Authored destination |
| --- | --- | --- |
|885,AD6,D27|(-755,188,277)|(815,188,277)|
|F78,11C9,141C|(815,333,1520)|(-755,333,1520)|
Do not silently replace each instance's serialized Position with StartPos; both
are retained in the manifest. Constructor/postload/frame behavior determines how
these fields interact. PHONEBOOTH is STRT0x48C, authored position
(7.5705023,216.7101440,-1525.1119385), yaw0, StartTrigger=`bb1`.
Intro3MCA0x1892 serializes PlayerControlled=`NULL`, DeactivateInv1,
NextTrigger=`default` and source voicepractice IDs36,19,35,33,34.
This fixture has authored visuals sufficient for projectile and six target
rendering using the current sprite infrastructure. Source targeting, motion,
contacts, inventory/intro state, score, respawn and original/native Windows
execution comparison remain independent implementation/verification gates.