ConstBorrowed container and sidecar access for one explicit admission profile.
The ingest inspector throws on its first container, structural, resource or profile violation; it does not repair data or certify complete glTF validity.
Complete container bytes, borrowed unchanged until inspection returns or throws.
Source identity whose case-insensitive .gltf, .glb or .vrm suffix selects decoding; no file is opened or path normalized.
Required profile spelling; the ingest runtime guard rejects values outside AutoMovieExternalModelIngestProfile.
OptionalresolveResource?: AutoMovieExternalModelResourceResolverSynchronous resolver called per external buffer/image declaration, including repeated URIs. Returns borrowed exact bytes or null for unavailable data; omission also means unavailable. Keep returned bytes stable through inspection. Caller effects and thrown errors propagate; ingest performs no fetch or URI caching. The ingest host implements synchronous URI resolution; inspectAutoMovieExternalModelBytes borrows returned exact bytes through inspection and owns profile admission.
New facts that hold no reference to the input bytes.
Parse and validate exact external model bytes before compilation.
The container is chosen by the path suffix:
.gltfis UTF-8 JSON,.glband.vrmare GLB 2.0 with one JSON chunk and at most one BIN chunk. JSON that is not strict UTF-8, does not parse, or repeats a member name after escape decoding is refused, because a last-wins duplicate could hide the value another loader reads. The document must declare asset version 2.0 and a forest of nodes; node mesh/skin/child links, scene roots, skin joints, primitive POSITION/indices and buffer/accessor references read here must resolve; buffers, buffer views, accessors, sparse ranges and images must fit their declared and resident bytes; and every non-data buffer sidecar must come back fromresolveResourcewith the declared length, while URI images require nonempty bytes. The selected profile then adds its own requirements, as AutoMovieExternalModelIngestProfile lists. This is a fixed-profile admission gate, not a complete glTF validator: material/texture links and unconsumed attributes are left to host loaders, sparse payload contents and image media formats are not decoded here, and the skin/motion owners state their additional restrictions. The inspector never guesses a profile or repairs input: the first violation throws with the JSON path it concerns.Under
vrm-humanoid-v1,VRMC_vrmis read with VRM 1.0 bone names, so a 1.0-beta file that still writes thumbs the VRM 0.x way is read as 1.0.