c6ca5ce9e7
Promote the F10 ship-capture correlator from an example into a reusable, unit- tested library module (ship_capture): parse_capture (log -> per-draw rigid WorldView from the c0..c2 WVP constants), correlate (match parts to draws by vertex count, express each in the reference part's frame), and a checked-in placement-table format (serialize_table/parse_table, embedded via embedded_placement from data/ship_placements.txt). build_ship_model now prefers a ship's captured placement over the static assemble_ship when a table entry exists (empty table -> unchanged fallback). correlate_capture example refactored onto the module + gains --emit to print a table block. Doc updated: bake plumbing done; remaining is running real F10 captures to populate the table (needs the emulator). 5 new ship_capture tests (parse/normalize/correlate/table round-trip); 76 formats-lib tests + viewer build green. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
85 lines
2.3 KiB
Rust
85 lines
2.3 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;
|
|
|
|
// 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;
|
|
|
|
// 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 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};
|