Expand description
Shared ordered resource resolver across source families. Shared resource resolver for ordered source families.
The resolver composes multiple source families and performs first-match
lookups for (resref, type) in the provided precedence order.
§Initial Source Families
- Override (in-memory source model)
- Composite module (
.rim,_s.rim,_dlg.erf) - KEY/BIF archive pair
§Texture Sidecar Helper
Resolver::resolve_texture_with_txiresolves a texture resource and then resolves an optional same-resrefTXIsidecar using independent global source precedence ordering (no same-container/source coupling).Resolver::resolve_tpc_with_txi_handoffresolves and parses TPC container data, exposing header/payload/footer plus conservative embedded-body hints.
§Model Companion Helper
Resolver::resolve_mdl_with_mdxresolves an MDL model resource and then resolves an optional same-resrefMDX vertex data companion using independent global source precedence.Resolver::resolve_mdl_with_mdx_handoffresolves and parses the MDL model (with MDX vertex data applied if available).
§Case Sensitivity Policy
- Queries are case-insensitive via canonical
ResRefnormalization. - Override collision handling is deterministic:
- canonical key:
(lowercase_resref, resource_type) - tie-break: keep first entry after deterministic source-label sorting
- later duplicates are retained in collision metadata and ignored for lookup
Structs§
- KeyBif
Binding - One BIF binding used by
KeyBifSource. - KeyBif
Source - KEY/BIF resolver source family.
- MdlWith
MdxHandoff Result - Resolver output for a parsed MDL model with optional MDX vertex data.
- MdlWith
MdxResult - Resolver output for an MDL model resource and optional MDX vertex data.
- Override
Collision - Collision metadata for duplicate canonical override keys.
- Override
Entry - One override entry.
- Override
Input - Input model used to build deterministic override sources.
- Override
Source - In-memory override source with deterministic duplicate handling.
- Resolver
- Shared ordered resolver.
- Resolver
Result - Resolver output view.
- Texture
With TxiResult - Resolver output for a texture resource and optional TXI sidecar.
- TpcWith
TxiHandoff Result - Resolver output for a TPC resource, parsed container payload, and optional external TXI sidecar.
Enums§
- MdlHandoff
Error - Errors produced by MDL handoff helper operations.
- Resolution
Provenance - Concrete provenance for a resolved resource.
- Resolver
Error - Errors produced by resolver setup/query operations.
- Resolver
Source Family - High-level source family used by the shared resolver.
- Resolver
Source Ref - Borrowed resolver source reference.
- TpcEmbedded
Payload Hint - Conservative interpretation hint for TPC embedded payload bytes.
- TpcHandoff
Error - Errors produced by TPC handoff helper operations.