Skip to content

Match 50 PAL engine and menu functions #95

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Sumaiter wants to merge 2 commits into
base: main
Choose a base branch
from
+3,731 −585
Open

Match 50 PAL engine and menu functions #95

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d2f3c6c
Match 50 PAL engine and menu functions
Sumaiter Nov 4, 2026
f6be894
Share viewport state across matching PAL helpers
Sumaiter Nov 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,11 +79,11 @@ Each distinct function counts once: frontbin's copy of the menus is the main ima
<!-- progress:begin SCES_532.85 (tools/progress.py --write) -->
| | Functions (exact) | Code (exact) | Fuzzy |
| --- | ---: | ---: | ---: |
| **Main program** | 3,295 of 8,945 | 274,528 of 2,202,512 bytes (12.46%) | 12.87% |
| **Main program** | 3,345 of 8,945 | 286,384 of 2,202,512 bytes (13.00%) | 13.41% |
| Engine core (core.text) | 772 of 1,668 | 73,404 of 288,232 bytes (25.47%) | 26.03% |
| libgcc | 26 of 33 | 6,148 of 10,836 bytes (56.74%) | 56.74% |
| Network (net.text) | 494 of 2,441 | 16,240 of 465,620 bytes (3.49%) | 4.50% |
| Resident menus (.text) | 2,000 of 4,786 | 178,156 of 1,422,048 bytes (12.53%) | 12.71% |
| Resident menus (.text) | 2,050 of 4,786 | 190,012 of 1,422,048 bytes (13.36%) | 13.54% |
| frontbin's own code | 3 of 17 | 580 of 15,776 bytes (3.68%) | 3.68% |
| **Shared level code** | 1,643 of 5,088 | 127,280 of 2,008,520 bytes (6.34%) | 6.99% |
| **Level-specific code** | 1,094 of 4,080 | 95,808 of 1,601,892 bytes (5.98%) | 6.39% |
Expand All @@ -101,9 +101,9 @@ Each distinct function counts once: frontbin's copy of the menus is the main ima
| Level 14: Ghost Station (and 34) | 6 of 23 | 444 of 8,884 bytes (5.00%) | 5.00% |
| Level 15: Control Level (and 35) | 23 of 134 | 2,540 of 116,624 bytes (2.18%) | 2.18% |
| Level 41: Battledome Tower (all 22 multiplayer maps) | 141 of 374 | 14,568 of 140,340 bytes (10.38%) | 12.24% |
| **Total** | 6,032 of 18,113 | 497,616 of 5,812,924 bytes (8.56%) | 9.05% |
| **Total** | 6,082 of 18,113 | 509,472 of 5,812,924 bytes (8.76%) | 9.26% |

Each distinct function counts once: frontbin's copy of the menus is the main image's, and a level function counts once however many of the 47 levels have it. 274,528 bytes (4.72%) are in units with nothing left to decompile.
Each distinct function counts once: frontbin's copy of the menus is the main image's, and a level function counts once however many of the 47 levels have it. 286,384 bytes (4.93%) are in units with nothing left to decompile.
<!-- progress:end -->

</details>
Expand Down
14 changes: 14 additions & 0 deletions THIRD_PARTY_NOTICES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -439,3 +439,17 @@ These PAL reconstructions also use the public RAC3 sources pinned below; each ta
| `src/pal/overlays/shared/L00_006F2370.c` | `src/levels/shared/L39_00662678.c` | `func_L39_00665CC0` | `cd0e7c20fd8a93116566ba2e024fa2f3536bd30c` |
| `src/pal/overlays/l41_battledome_tower/L41_00411F80.c` | `src/levels/shared/L40_00420998.c` | `func_L40_004224F8` | `cd0e7c20fd8a93116566ba2e024fa2f3536bd30c` |
| `src/pal/overlays/l41_battledome_tower/L41_00621CE8.c` | `src/levels/shared/L40_005416F0.c` | `func_L40_005416F0` | `cd0e7c20fd8a93116566ba2e024fa2f3536bd30c` |

## Further PAL engine-family references

The additional PAL reconstructions listed in
[`config/pal/crossgame_parallel01.tsv`](config/pal/crossgame_parallel01.tsv)
use public RAC3 decompilations as algorithm and interface references, including
the unified OpenRAC checkout. Each row records the repository, immutable commit,
file and reference function; the C sources also carry their credits.

The RAC3 game-source scope is described in the earlier public-decompilations
notice and the reference project's `LEGAL.md`. Fingerprints identify candidates;
these reconstructions were checked independently against RAC4 PAL instructions,
actual address targets and caller/callee interfaces. No proprietary SDK source,
samples or headers were used.
13 changes: 13 additions & 0 deletions config/pal/crossgame_parallel01.tsv
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Public references for independently reconstructed PAL functions.
# Fingerprints are candidate metadata; acceptance requires RAC4 retail audits.
name repository commit path reference_function fingerprint
func_0042BA60 OpenRAC/rac3-decomp cd0e7c20fd8a93116566ba2e024fa2f3536bd30c src/levels/shared/L01_00314158.c func_L01_00315800 1618af86d8d943eb
func_0044B100 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/37E0F0.c func_00387B10 c314de3988bc1f3f
func_00454C38 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/3896E8.c func_003899B8 03eda974ec39dcfc
func_00459FD0 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/3896E8.c func_0038DF10 6e59892a8fe0710a
func_004644A8 OpenRAC/rac3-decomp cd0e7c20fd8a93116566ba2e024fa2f3536bd30c src/levels/shared/L01_0042B4F8.c func_L01_0042C370 17bef0551d1644ad
func_00489550 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/39BC00.c func_0039C028 2ae2ba1adad65e1c
func_00493D48 OpenRAC/rac3-decomp cd0e7c20fd8a93116566ba2e024fa2f3536bd30c src/levels/shared/L01_0046A938.c func_L01_0046ABC0 895824762f6e3406
func_004E3C48 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/3C9888.c func_003C99D0 e297d0b7984082fb
func_004F16C8 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/3ABA48.c func_003ABA48 4a299efcf138e3d3
func_004F2D88 OpenRAC/OpenRAC 73f725bf54bb1bf6d8b9bb5b1511ed00d551fbde games/rac3/ntsc/src/frontbin/3ABA48.c func_003AD108 1bc2c8df1ccd99fd
Loading
Loading