Files
Neutron/docs/gameplay/baseball-font.md
T

115 lines
7.0 KiB
Markdown
Raw 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 TIME font closure
2026-11-02. Static original-binary and asset recovery. No original executable was
run or original file modified. This closes the font resource/advance/tint
questions, not displayed original pixel alignment or general renderer parity.
Primary owns the exporter and runtime changes; this investigation edits only this
report and generated `artifacts/baseball-font/`.
## Recommended integration
Replace the temporary SMAL digits with TIME set5's original **16×16** alpha.omt
canvases. Decimal0..9 maps to **118,127,120,121,122,123,124,125,126,119**.
The format is `% .2d`, but TIME's leading positive space maps to a null glyph
and has **zero advance**. For the current declared logical overlay rectangles,
draw the visible digits at **x286 and302**, width/height16, and the existing
source y formula. Do not add an8- or16-unit leading-space advance.
Retain the exact source RGBA with white vertex tint. All ten glyphs have opaque
RGB **(17,255,73)** and alpha0/255; preserve these green pixels without recoloring.
The leaf sets material RGB=(1,1,1), alpha from global4F4ED4 (initially1), and blend
enums from4F4ECC/4F4ED0 (initial6/7). The text function resets that alpha global
to1 after ordinary text. The Baseball caller does not supply an additional tint.
Exact shared-alpha scheduling across all possible text callers is outside this
bounded recovery; ordinary opaque glyph material alpha1 is the evidenced default.
## REA Evidence and supporting bytes
REA analyzed the existing generated copy
`artifacts/uncontrolled-phases/rea/Neutron.exe`, SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Ghidra12.1.4 returned all four requested routines. Complete replies, exported
Evidence and the closed snapshot are in `artifacts/baseball-font/rea-local/`.
| Routine | REA Evidence |
| --- | --- |
|4683E0 font initialization|`ev_f5dd8e211882ec340474745de486b4d431a981816a512773fd57a51cb6bfa1bc`|
|468660 formatted text/layout|`ev_e20b6c0cc47aa285935609ad63ea77cf92d9d23b3ca18fe52c7dd6fc286f2308`|
|4689F0 glyph emission|`ev_8a5c0ce796b76993a6e86e19a1d2a36fb1945f1a23c6416ad446213e1e0e043c`|
|468B80 font/character selection|`ev_bd91c2e5548e4e627af7f3faf7e8d5f2a70fa830bff9c3a5bbcbeb55c545e5d9`|
The first sandboxed attempt failed when Ghidra's local Unix socket bind returned
Operation not permitted. The task's owned failed batch was interrupted and its
session closed; its complete failure replies remain in `rea/`. The approved
local static run resolved that host IPC restriction without configuration edits.
This was not a source-execution observation. Both owned sessions are closed.
`font-assembly.txt` and `aim-call-assembly.txt` cross-check the same generated
EXE's instructions. `source-spans.json` records original VAs/file offsets/lengths/
SHA256 for the four functions, bounded Baseball call and font table. Ghidra's
468660 prototype loses its variadic arguments, and4689F0 reports a spurious
unaff_retaddr parameter. Argument and x-advance facts below therefore come from
checked instructions, not literal translation of those pseudocode signatures.
The four code entries map to file offsets683E0,68660,689F0,68B80; the font
table maps toF4ED8. `tools/binary/baseball.py` also guards/exports the table hash,
TIME digit IDs and null-space mapping so this binding remains reproducible.
## Table and glyph identity
4683E0 loads alpha.omt via string4F51D8, then at46844A..46849F walks six groups
of64 signed16-bit table entries startingVA4F4ED8. Index−1 stores a null pointer;
all other IDs are looked up through477890. Runtime pointer table is5091E0.
468B80 uppercases the character, admits ASCII32..95, and selects TIME
`54494D45`→set5 at468C23; SMAL `534D414C` instead selects set1 at468C39.
Runtime index is `font*64+uppercase(character)-32`. The set5 table starts4F5158;
digit0's word is4F5178. The768 source table bytes have SHA256
`910bef1d7aca6f1aa328ba9f671831bdbbda19b419fb0c693117cb096d542226`.
alpha.omt SHA256
`53cb9f47a588b1f19eb0adc4d43c8066a8b78aedd764b9e9314c81e287991126`.
Every digit below is16×16. `glyphs.json` records exact source resource byte
ranges, RGBA SHA256, alpha counts and opaque RGB. No regenerated substitute font
or scaling of the existing8×8 SMAL images is needed.
| Character | Canv / name | Source offset / bytes | RGBA SHA256 |
| --- | --- | --- | --- |
|0|118 t1600|74484 /642|`edc60e65dcf7320813a80d4312e3c45951ccfc566ea79dfabf7a22ebc4b96049`|
|1|127 t1601|25406 /466|`1fd058ad5bdc0f8a064ef7d2d52b2b036df3f35515691a366799d7e8aab5297f`|
|2|120 t1602|73236 /450|`62aaeaaf107300a6f4f7ff52e98106c1520a9edbe2137626ee41091cf243e5c5`|
|3|121 t1603|76660 /450|`d78bf1895f5838b9eb8c6a22565a9588dae4fc8f7106697df373f4408aae634c`|
|4|122 t1604|19604 /562|`f6d628639de4e40005f62f63a49308ff9ee0656a36bb6eb7787230b4830a5ed9`|
|5|123 t1605|19154 /450|`9f58cad5621d89b7a7012036daa8532b2397b0d9d267ab7d1aa5a7cd10d7ae87`|
|6|124 t1606|73872 /530|`49cdc9ec812f4ef3826011d542c30afbb10229c4b4ce549e7820233bbaa53dd9`|
|7|125 t1607|17298 /458|`aaef2d59c2636c059b446bed643985ca55d15b2d070b0582b2d8994b3bf74f1e`|
|8|126 t1608|23440 /610|`bade574a4624a3f763ddd9c87fa2f102562b00d8d604e9faf32a43b372de64e0`|
|9|119 t1609|2438 /530|`0a663ddf2df9f1065f5e4ffe27b4d1fa96edd5f19b6323217bad4148f8d2f3d7`|
|space|−1 /null|table word4F5158|no canvas/no advance|
|minus|−1 /null|table word4F5172|no canvas/no advance|
## Formatting, advance and material facts
Baseball426754..42678D truncates the previously captured1D68 pitch to an integer,
pushes format string4EF440 (`25 20 2e 32 64 00`, `% .2d`), fontTIME, computed y
andx286 into468660. Y is `trunc((45-priorPitch)*4.3+100)`, with45 as source
float49D5C8 and4.3/100 as doubles4A3E40/4A3130. This occurs before4268A3..8A9
captures current camera pitch into1D68, supporting the separate DisplayPitch.
468660 formats into its local buffer and iterates characters.46891A gets the
glyph pointer,468931 calls the glyph emitter, and468939 tests that pointer.
For null pointers46893B jumps directly to46894C, skipping the x addition.
For non-null pointers46893D..468948 advances by `canvas.width*screenWidth/640`.
Therefore TIME space and minus are absent and zero-width. Every available digit
advances16 logical units; there is no kerning or extra letter spacing in this
path. A format result ` 09` draws0 and9 consecutively with no leading gap.
Pitch is clamped0..45 in the sustained-hold path, so a negative-number glyph is
not required for this bounded Baseball label.
4689F0 rejects null glyphs immediately at4689F8..4689FA and allocates no slot.
For a real glyph it binds the source canvas, sets custom width/height from its
pixel dimensions scaled byscreenWidth/640 andscreenHeight/480, alignment fields
BC=1/C0=2, source blend globals, white RGB at468AFE/468B08/468B0F and alpha from
4F4ED4 at468B17. 4689BF resets global alpha to1 after ordinary formatted text.
This closes the resource sizes, per-glyph step and material tint. General sprite
alignment caches, original frame scheduling, fixed-function alpha tests and
widescreen policy remain renderer boundaries rather than font-table gaps.