dc96bace6f
Two independent lines landed a `.rat` reading and neither was the whole
picture, so this merges them into one module and fixes what the merge exposed.
ui_layout — the screen is the BUNDLE, not the set of .rat records
------------------------------------------------------------------
`feat/ui-layout-preview` parsed `.rat` records; the autopilot stack documented
the RATC header and probed it in `examples/screen_layout.rs` but never landed a
library module. The `.rat`-only reading structurally cannot see an element that
has no record -- the `eff*` frame corners, the `deli*` dividers, `msg` -- which
is exactly what the committed real-vs-rebuilt capture shows missing. Rebuilt
around the header:
* element declaration table at 0x20 (60-byte entries: name, parent index at
+32, kind flags, pivot) = the back-to-front draw list;
* the placement region after it = per-element keyframe groups.
Verified against the disc, each against a fact the docs state independently:
`pgpeff02a` -> parent 3 = `pgpeff02`; `pgp_ttrl_btn10` rests at (546,288); the
pause buttons sit at 268/337/407/478, the documented 70 px pitch; the Arsenal
carries X = -516. The tutorial PAUSE menu now composites 11/11 elements and
matches the real screen more closely than the earlier rebuild did.
Three defects found while validating, none of which any test would have caught:
* the keyframe block is 40 bytes with X/Y/time at +28/+32/+36 and an
alpha-ramping ARGB at +0 -- the fade, previously unread;
* a group's data stops 4 bytes short of its last block's time slot, so that
word is the NEXT group's element index. Reading it produced times like
1869640736 and silently corrupted the max-dwell pick. Last-frame time is
now `None`;
* the `.rat` sprite-name field is not 16 bytes. Capping it there truncated
`pgp_ttrl_title.t32` to `pgp_ttrl_title.t`, which resolved against nothing
and dropped 4 of 11 tutorial elements from the composite.
Max-dwell also needed a tie-break: on equal gaps take the LATER frame, or
`pgpmsg` reports the y=645 fly-through instead of the y=605 it settles at.
savegame -- a Rust port of tools/re-capture/savegame.py
------------------------------------------------------
GDHA container, zlib payload, chunk stream (GDAA / phase / GHAD 122 B / 16x20 B
SHAB / trailer). Every GHAD word carries its own confidence rather than the
block being presented as solved: 6 named, 2 recorded as REFUTED (+36, +56 were
tested as difficulty and as stage and are neither), 7 still unknown.
Tested against the three real saves committed under docs/re/captures -- no disc
and no emulator needed. The load-bearing assertion is the byte-identical
round-trip; the develop differential is asserted as a property (spending 4000 P
moves +24 and not its twin +28, steps the clear ratio, and moves exactly two
blob entries), and the header summary is checked to agree with the payload it
mirrors -- the trap that makes the Details panel a bad oracle.
CLI: `screen list|info|render` and `save info`, so both are checkable headlessly
in the same spirit as `mesh render`.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
96 lines
2.7 KiB
Rust
96 lines
2.7 KiB
Rust
//! # sylpheed-formats
|
|
//!
|
|
//! Asset format parsers for Project Sylpheed: Arc of Deception (Xbox 360).
|
|
//!
|
|
//! This crate handles:
|
|
//! - Reading game files from XISO disc images (native only)
|
|
//! - Reading IPFB archives (`*.pak` / `*.pNN`) and the `IDXD` definition objects inside
|
|
//! - Parsing Xbox 360 texture formats (XPR2 containers + DXT de-tiling)
|
|
//! - Parsing mesh formats (to be reverse engineered)
|
|
//! - Parsing audio formats (XMA → standard PCM)
|
|
//!
|
|
//! ## Platform notes
|
|
//! XISO reading is only available on native (Windows/macOS/Linux).
|
|
//! On WASM, assets must be pre-extracted and served over HTTP.
|
|
|
|
pub mod texture;
|
|
pub mod vfs;
|
|
|
|
// IPFB TOC name-hash (path → 32-bit key), recovered from the retail title
|
|
pub mod hash;
|
|
|
|
// IPFB archive (`*.pak` index + `*.pNN` segments) reader
|
|
pub mod pak;
|
|
|
|
// IDXD reflective object (ship / weapon / effect / menu definitions) reader
|
|
pub mod idxd;
|
|
|
|
// IXUD localized string / subtitle table reader
|
|
pub mod ixud;
|
|
|
|
// Embedded font (OTF / TTF / ttcf) metadata
|
|
pub mod font;
|
|
|
|
// T8aD 2D UI/HUD texture
|
|
pub mod t8ad;
|
|
|
|
// RATC nested resource bundle
|
|
pub mod ratc;
|
|
|
|
/// UI screen layout (`.rat` / RATC) — reassemble a screen from its pak.
|
|
pub mod ui_layout;
|
|
|
|
/// The retail `savedata` file: GDHA container, zlib payload, chunk stream.
|
|
pub mod savegame;
|
|
|
|
// LSTA sprite list (inline T8aD frames)
|
|
pub mod lsta;
|
|
|
|
// XISO reading is not available in-browser
|
|
#[cfg(not(target_arch = "wasm32"))]
|
|
pub mod xiso;
|
|
|
|
// Mesh parsing — scaffold for reverse engineering
|
|
pub mod mesh;
|
|
|
|
// Audio parsing — scaffold for XMA handling
|
|
pub mod audio;
|
|
|
|
// Movie cutscene subtitles — the movie → track → text chain.
|
|
pub mod movie_subtitle;
|
|
|
|
// XACT `.slb` sound banks (voice / music) → decodable XMA1 RIFF.
|
|
pub mod slb;
|
|
|
|
// The movie manifest: authoritative movie → subtitle → voice index.
|
|
pub mod movie_manifest;
|
|
|
|
pub mod movie_voice;
|
|
|
|
pub mod game_data;
|
|
|
|
pub mod localization;
|
|
|
|
// Whole-ship assembly from XBG7 part families (capital ships as split parts).
|
|
pub mod ship;
|
|
|
|
/// The runtime layout of a unit / vessel definition object, read out of the
|
|
/// title's loader and verified against a live mission (see the module docs).
|
|
pub mod unit_layout;
|
|
|
|
// Exact capital-ship placement from a runtime F10 ship-capture (ground truth).
|
|
pub mod ship_capture;
|
|
|
|
/// Re-export the most commonly used types at the crate root.
|
|
pub use audio::{AudioCodec, AudioInfo, GameAudio};
|
|
pub use font::FontInfo;
|
|
pub use idxd::{IdxdError, IdxdObject};
|
|
pub use ixud::{Cue, Subtitle};
|
|
pub use movie_subtitle::{SubCue, SubLang};
|
|
pub use mesh::{GameMesh, Xbg7Model};
|
|
pub use ratc::RatcChild;
|
|
pub use t8ad::T8adImage;
|
|
pub use pak::{PakArchive, PakEntry, PakError};
|
|
pub use texture::{X360Texture, X360TextureFormat};
|
|
pub use vfs::{GameAssets, VfsError};
|