Skip to main content

Module resolver

Module resolver 

Source
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_txi resolves a texture resource and then resolves an optional same-resref TXI sidecar using independent global source precedence ordering (no same-container/source coupling).
  • Resolver::resolve_tpc_with_txi_handoff resolves and parses TPC container data, exposing header/payload/footer plus conservative embedded-body hints.

§Model Companion Helper

  • Resolver::resolve_mdl_with_mdx resolves an MDL model resource and then resolves an optional same-resref MDX vertex data companion using independent global source precedence.
  • Resolver::resolve_mdl_with_mdx_handoff resolves and parses the MDL model (with MDX vertex data applied if available).

§Case Sensitivity Policy

  • Queries are case-insensitive via canonical ResRef normalization.
  • 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§

KeyBifBinding
One BIF binding used by KeyBifSource.
KeyBifSource
KEY/BIF resolver source family.
MdlWithMdxHandoffResult
Resolver output for a parsed MDL model with optional MDX vertex data.
MdlWithMdxResult
Resolver output for an MDL model resource and optional MDX vertex data.
OverrideCollision
Collision metadata for duplicate canonical override keys.
OverrideEntry
One override entry.
OverrideInput
Input model used to build deterministic override sources.
OverrideSource
In-memory override source with deterministic duplicate handling.
Resolver
Shared ordered resolver.
ResolverResult
Resolver output view.
TextureWithTxiResult
Resolver output for a texture resource and optional TXI sidecar.
TpcWithTxiHandoffResult
Resolver output for a TPC resource, parsed container payload, and optional external TXI sidecar.

Enums§

MdlHandoffError
Errors produced by MDL handoff helper operations.
ResolutionProvenance
Concrete provenance for a resolved resource.
ResolverError
Errors produced by resolver setup/query operations.
ResolverSourceFamily
High-level source family used by the shared resolver.
ResolverSourceRef
Borrowed resolver source reference.
TpcEmbeddedPayloadHint
Conservative interpretation hint for TPC embedded payload bytes.
TpcHandoffError
Errors produced by TPC handoff helper operations.