Fabian Hamm
c4c914ff59
`cargo fmt --all -- --check` has failed on every run in this repository's history, identically on `main` and on every branch. This is #12. Mechanical: `cargo fmt --all`, nothing else. 154 files, all `.rs`, no other extension touched. `cargo check --workspace` exits 0 afterwards, so nothing changed semantically. ON THE ORDERING, WHICH WAS THE REAL QUESTION. HANDOFF-2026-09-06 section 7 warns this is the expensive fix: a whole-tree reformat before #7 and #8 return "would put a conflict in every file of 861 commits and make the reviews those items exist to enable unreadable". That is measurably too pessimistic, and it had been reasoned rather than tested. Measured here by three-way merging a rustfmt'd `main` against both unmerged branches, file by file: file/branch pairs tested 32 merges CLEAN 28 merges CONFLICTING 4 (8 conflict hunks total) sylpheed-cli/src/main.rs 1 hunk sylpheed-export/src/check.rs 1 sylpheed-export/src/screen.rs 4 sylpheed-export/src/video.rs 2 All four are against `auto/frame-blend-draw-path` only; `auto/port-p6-audio` does not conflict anywhere. The earlier framing -- 154 dirty files, 133 that cannot collide, 21 that can, the collision set carrying 147 of 774 hunks (19%) -- reproduces exactly. What it did not say is that most of the 21 still merge cleanly, because rustfmt's edits and the branches' edits rarely land on the same lines. So the cost of sweeping now is 4 files and 8 hunks for one branch, against a check that is otherwise red forever. Deliberately NOT folded into the WASM PR: 154 reformatted files would make that one unreviewable. Closes #12
100 lines
2.9 KiB
Rust
100 lines
2.9 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;
|
|
|
|
/// Assembling media whose bytes are not one archive entry — segment-spanning
|
|
/// reads, multi-sub-wave banks, and the continuous cutscene-voice stream.
|
|
pub mod media;
|
|
|
|
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, IxudField, IxudObject, IxudRecord, Subtitle};
|
|
pub use mesh::{GameMesh, Xbg7Model};
|
|
pub use movie_subtitle::{SubCue, SubLang};
|
|
pub use pak::{PakArchive, PakEntry, PakError};
|
|
pub use ratc::RatcChild;
|
|
pub use t8ad::T8adImage;
|
|
pub use texture::{X360Texture, X360TextureFormat};
|
|
pub use vfs::{GameAssets, VfsError};
|