SPB Git

Repository Public License

model3d.md 57.9 KB 503 lines markdown

1# 3D model engine (`EngineModel3D`)23Engine id `model3d` — OBJ (+MTL), STL, PLY, glTF 2.0 / GLB, FBX (import only, experimental), USD / USDA / USDC / USDZ,4COLLADA (DAE) and 3MF.56State of this document: 2026-11-21, measured on the build machine (Apple M5 Max, 18 cores, 48 GB, macOS 27.0,7Xcode 27.2, Swift 6.4.2). "Supported" means implemented, tested and passing on that machine on that day.89- Package: `Packages/EngineModel3D` (module `EngineModel3D`, factory `makeEngines()`), depends on `../ORIXConvertCore`10  and on the binary target `CAssimp` (`EmbeddedEngines/assimp/CAssimp.xcframework`, built by11  `EmbeddedEngines/assimp/build.sh`; see `EmbeddedEngines/assimp/NOTICE.md`).12- Products: library `EngineModel3D`, executable **`orix-model3d-helper`** (must be copied into13  `<App>.app/Contents/Helpers`, see §5), executable `EngineModel3DBench` (development and benchmarks).14- Tests: `swift test` from `Packages/EngineModel3D` — **66 tests in 11 suites, all passing**; the parameterised15  matrix test alone converts and validates the **132 declared paths**.16- Core contract: no change, nothing added.1718## 1. What does the work1920Every importer produces one neutral in-memory scene (`Scene3D`: node hierarchy with 4×4 transforms, triangle meshes21with positions / normals / tangents / UV sets / vertex colours / indices, PBR materials with base colour, metallic,22roughness, emissive and base-colour / metallic-roughness / normal / emissive / occlusion texture references,23embedded or external textures, unit and up-axis metadata) and every exporter consumes it.24Animations, skins, bones, morph targets, cameras, lights, points and lines are **counted, never converted**.2526| Format | Import | Export | Output re-read by (validation) |27|---|---|---|---|28| STL (ASCII, binary) | own Swift reader | own Swift writer | Assimp |29| PLY (ASCII, binary LE/BE) | own Swift reader | own Swift writer (ASCII, binary LE) | Assimp |30| 3MF | own Swift reader (ZIP + XML) | own Swift writer | Assimp |31| OBJ + MTL | Assimp | own Swift writer (OBJ + MTL + textures) | Assimp, plus the MTL and texture files checked by the engine |32| glTF / GLB | Assimp | own Swift writer (`.gltf` + `.bin` + textures, self-contained `.gltf`, `.glb`) | own structural checker and geometry reader, then Assimp as a second reader |33| FBX | Assimp (experimental) | — not declared | — |34| COLLADA (DAE) | Assimp (unit and up axis read from the file header by the engine) | Assimp's exporter, header rewritten with the real unit and up axis | own minimal COLLADA reader |35| USDA, USD (text) | Model I/O (layer metadata read by the engine) | own Swift writer | Model I/O |36| USDZ | Model I/O (textures read from the package by the engine) | own Swift writer (text layer + textures, stored, 64-byte aligned) | Model I/O, plus the package layout checked by the engine |37| USDC | Model I/O (layer metadata read from the crate tables by the engine) | own text layer converted to a crate file by Model I/O | SceneKit |3839What Apple's frameworks do on this Mac (checked at run time, the paths are only declared when it holds):40`MDLAsset.canImportFileExtension` is true for obj, stl, ply, abc, usd, usda, usdc, usdz and false for dae, fbx, gltf,41glb, 3mf; `canExportFileExtension` is true for obj, stl, ply, abc, usd, usda, usdc and **false for usdz**.42Model I/O exposes `upAxis` but **not** `metersPerUnit`, and drops it when it re-exports a layer; it applies neither.43SceneKit writes USDZ, DAE, SCN, USDC, USDA from an `SCNScene`, but always stamps `metersPerUnit = 1` whatever the44data and converts the material colours (0.8 → 0.97): it is not used to write anything. `SCNScene(url:)` on a DAE goes45through an XPC service that failed in the test environment ("Failed to retrieve scene from XPC service"), so SceneKit46is not used to read DAE either; it is used to re-read USDC outputs, which works in-process.4748Assimp 6.0.2 is built with only the OBJ, STL, PLY, glTF, FBX, COLLADA and 3MF importers and exporters, without49Draco, without tools, tests or samples, against the zlib of macOS (configuration and compiled third-party code in50`EmbeddedEngines/assimp/NOTICE.md`). `libCAssimp.a` is 7 172 480 bytes, `CAssimp.xcframework` 7.9 MB.51It is used through its C API (`cimport.h`, `cexport.h`, `scene.h`, `material.h`) and a small C target52(`CAssimpShim`) that (a) imports with `aiProcess_ValidateDataStructure`, measures the face kinds, enforces the53vertex / face limits **before** triangulating, then applies `aiProcess_Triangulate | aiProcess_SortByPType`,54(b) gives Assimp a file-access layer that only opens files really located inside the model's folder55(symbolic links resolved), (c) flattens the structs that are awkward to read from Swift, and (d) builds an56`aiScene` from flat arrays for export.5758## 2. Order of operations5960import (in the helper process for Assimp and Model I/O) → structural sanitising (out-of-range indices, non-finite61coordinates, wrong-length attribute arrays, cycles in the node graph are removed and reported) → unit scale, axis62rotation, optional mirroring → hierarchy flattening (when the destination has no hierarchy, or on request) →63vertex welding → normals → simplification (+ error measurement) → destination-specific warnings → write →64measured facts. `validate` then re-reads the output.6566## 3. Options (keys of `ConversionOptions`)6768| Key | Values (default first) | Notes |69|---|---|---|70| `unit.source` | `auto`, `mm`, `cm`, `m`, `in`, `ft` | `auto` = the unit the file declares (glTF: metres by specification; USD `metersPerUnit`; COLLADA `<unit meter>`; 3MF `unit`; FBX `UnitScaleFactor`). STL, OBJ and PLY declare none. |71| `unit.target` | `same`, `mm`, `cm`, `m`, `in`, `ft` | Exact factor `source metres-per-unit / target metres-per-unit` (mm 0.001, cm 0.01, m 1, in 0.0254, ft 0.3048). |72| `axis.source` | `auto`, `y`, `z` | `auto` = glTF Y-up, 3MF Z-up (by specification), USD `upAxis`, COLLADA `<up_axis>`, FBX `UpAxis`. |73| `axis.target` | `same`, `y`, `z` | Right-handed rotation: Z-up → Y-up is (x, y, z) → (x, z, −y). |74| `axis.mirror` | `false` | Mirrors Z and reverses the winding (left-handed sources). |75| `transform.apply` | `bake`, `root` | Hierarchical destinations only. `bake`: vertices and node transforms rewritten (M′ = C·M·C⁻¹). `root`: a parent node `ORIX_coordinate_conversion` carries the change. |76| `hierarchy.flatten` | `false` | Hierarchical destinations only. |77| `weld.mode` | `exact`, `tolerance`, `none` | `exact`: position and every attribute identical. `tolerance`: positions snapped to a grid of `weld.tolerance`, attributes compared at 10⁻⁴; degenerate triangles produced by the merge are removed. |78| `weld.tolerance` | `0.0001` (10⁻⁷…1000) | In source units. |79| `normals.mode` | `keep`, `smooth`, `flat`, `remove` | |80| `normals.crease-angle` | `60` (0…180°) | For `smooth`: faces meeting at a larger angle keep a hard edge; area-weighted. |81| `simplify.enabled` | `false` | |82| `simplify.ratio` | `0.5` (0.01…1) | Fraction of triangles kept in each mesh. |83| `simplify.target-triangles` | `0` | When above zero, replaces the ratio (shared between meshes in proportion to their size). |84| `simplify.preserve-boundary` | `true` | |85| `simplify.preserve-seams` | `true` | UV seams and hard edges. |86| `simplify.measure-error` | `true` | |87| `materials.write` | `true` | Not offered for STL and PLY. |88| `textures.write` | `true` | Not offered for STL, PLY, 3MF. |89| `encoding` | `binary`, `ascii` | STL and PLY only. |90| `gltf.embed` | `false` | `.gltf` only: one self-contained file with base64 buffer and images. |9192Triangulation is not an option: every importer triangulates (Assimp's triangulation; fans for PLY polygons, USD93quads and n-gons), and the number of polygons the file contained is reported by `inspect` when the importer knows it.9495## 4. Behaviour that must be known9697**Units are never changed silently.** The applied factor is always in the output facts (`unit.source`,98`unit.output`, `unit.factor`) and, when it is not 1, in an `unit-converted` warning.99- glTF / GLB are in metres by specification: a known source unit is converted to metres; an unknown one is written100  unchanged with a `unit-unknown` warning.101- USDA, USD, USDZ, COLLADA record the unit (`metersPerUnit`, `<unit meter>`); 3MF records one of its named units102  (another unit is converted to millimetres). When the source unit is unknown nothing is recorded (3MF: its default,103  millimetres, with a warning).104- USDC is written by Model I/O, which cannot author `metersPerUnit`; USD readers then assume centimetres, so the105  coordinates are converted to centimetres when the source unit is known (reported). An explicit `unit.target` is106  honoured with a warning that the file cannot say so.107- Asking for an output unit or up axis while the source states none is refused (`invalidOption`), not guessed.108- OBJ, STL and PLY record neither unit nor up axis.109110**Axes.** glTF is Y-up and 3MF Z-up by specification: a known source axis is rotated to it, an unknown one is111written unrotated with an `axis-unknown` warning. USD records `upAxis` (Y or Z; an X-up source becomes Y-up),112COLLADA records `<up_axis>`.113114**Hierarchy.** glTF, GLB, USD*, DAE keep the node tree. glTF keeps instancing (a mesh used by several nodes is115stored once); the USD writer writes one mesh per use; a node holding several meshes gets child nodes in glTF.116OBJ, STL, PLY are written in world coordinates (`hierarchy-flattened` warning when there was a hierarchy);1173MF gets one object per mesh and one build item per use, carrying the world transform.118119**Materials.** glTF, GLB, USDA, USD, USDZ, USDC carry the PBR values. OBJ gets MTL Phong values derived from them120(Kd, Ks from metalness, Ns from roughness, Ke, d) plus the widely read `Pr` / `Pm` lines, with a121`materials-approximated` warning; COLLADA gets what Assimp's exporter writes (diffuse, emission, transparency,122textures); 3MF only a base material with an sRGB display colour; STL and PLY nothing (`materials-dropped`).123Material features of the source that the neutral model does not carry (clearcoat, sheen, transmission, volume,124specular-glossiness, anisotropy, emissive strength, textures in other channels) are named in a125`material-features-dropped` warning. Assimp's synthetic grey "DefaultMaterial" for files without materials is removed.126Vertex colours are copied numerically (no colour-space conversion); PLY stores them on 8 bits.127128**Textures.** Embedded in GLB (buffer views) and USDZ (`textures/` entries); written as files next to `.gltf`,129`.obj`, `.usda`, `.usd`, `.usdc`, `.dae`. Only PNG and JPEG are written by the glTF and USD writers (others are130dropped with a `texture-format` warning). When an output consists of several files the engine returns **one folder**131named after the output (`name/name.gltf`, `name/name.bin`, `name/checker.png`…), so nothing is orphaned; when it132is a single file it returns the file. A texture that is absent, outside the model's folder or remote is left out133with a `texture-missing` warning naming the reference and the reason.134135**References inside models are confined to the model's own folder.** Relative paths only; absolute paths, drive136letters, `..` components (also percent-encoded or with back-slashes), URLs (`http`, `https`, `ftp`, `file`, any137`scheme://`) and symbolic links leading outside are refused; nothing is ever fetched. This applies to MTL138libraries and glTF buffers (Assimp's file access is confined in the C layer, `reference-blocked` warning), to139textures of every format, and to USD: a USD file that refers to another file outside its folder or on the140network is **refused entirely**, because Model I/O would follow sublayers, references and payloads itself.141Limit of that last check: text layers are scanned for `@…@` asset paths; in binary crate layers the token table is142scanned for strings that look like file references (known extensions or `://`), so a crate layer referring to an143outside file with an unusual extension is not detected.144145**Bounds.** `ModelLimits`: file size 4 GB, 60 M vertices, 40 M triangles, 500 000 nodes, 256 MB per texture and1461 GB of textures, 512 MB for a JSON / XML document; smaller bounds (`ModelLimits.preview`: 1 GB, 20 M vertices,14712 M triangles) for inspection and previews. Declared counts are checked against the real file size before148anything is allocated (binary STL header, PLY element counts and list lengths, ZIP entry sizes, glTF accessors).149Format limits are errors, not truncations: binary STL 4 294 967 295 triangles, GLB / 3MF / USDZ 4 GB (no ZIP64).150151**Progress** is measured during simplification (collapses done / to do) and writing of STL, PLY and OBJ152(elements written); it is indeterminate (`fraction: nil`) during import and the other writers.153154## 5. Isolation of the third-party and system parsers155156Assimp and Model I/O parse untrusted files in **`orix-model3d-helper`**, a separate executable of this package157run through `ProcessRunner`; it writes the neutral scene to a private temporary file (JSON header + raw arrays),158which the engine reads back with every length checked, then sanitises. A parser crash is reported as159"the parser stopped unexpectedly…" (`malformedInput`) and nothing else is affected. The helper is looked up with160`BundledTools.url(for: "orix-model3d-helper")` (the app's `Contents/Helpers`, `EmbeddedEngines/tools`,161`ORIX_CONVERT_TOOLS`), then next to the running binary (SwiftPM builds).162`Model3DEngine(isolation:)`: `.automatic` (default: helper when found, **in-process otherwise**), `.required`163(fails when the helper is missing), `.inProcess`. `Model3DEngine.isHelperAvailable` tells which applies; inspection164shows "(separate process)" next to the decoder. The engine's own readers (STL, PLY, 3MF, glTF checker, USD layer165metadata, COLLADA checker) are memory-safe Swift and run in-process.166167In the tests, 204 truncated or corrupted files (17 variants of each of the 12 source fixtures) went through the168helper: every one ended in an error or a valid conversion, and **none made Assimp 6.0.2 or Model I/O crash**.169That is a small corpus, not a proof.170171## 6. Inspection, preflight, validation, preview172173`inspect` imports the file within the preview bounds and returns only what was read: decoder, format version174(glTF `asset.version` / generator, FBX version, COLLADA version and authoring tool, USD text / crate version and175creator), encoding (STL, PLY), meshes, vertices and triangles as placed (and as stored when meshes are instanced),176faces and polygons of the source when known, bounding box and dimensions with the unit when it is known, unit and177up axis **with their origin** ("glTF specification", "USD layer metadata (metersPerUnit)", "Not stated by the178file"…), normals / UV sets / vertex colours / tangents, nodes and depth, materials, textures embedded / external /179missing, animations, skins, bones, morph targets, cameras, lights, points and lines, extensions, material features180not carried, and edge manifoldness (boundary, non-manifold, inconsistently wound edges, degenerate triangles,181watertight yes / no) on scenes up to 6 000 000 triangles.182183`preflight` reads that inspection and warns, for the chosen destination and options: animations, skins, morph184targets, cameras, lights, points / lines (data loss), materials dropped / reduced / approximated, textures dropped185or missing, vertex colours or UVs dropped, several UV sets reduced to one, extensions and material features not186carried, hierarchy flattened, mesh not watertight for STL / 3MF (informational, with the edge counts), unknown187unit or up axis for destinations that need one, format size limits, FBX experimental.188Without an inspection only the warnings that do not depend on the file are returned.189190`validate` re-reads the output with a decoder that did not write it (table in §1) and compares: triangle count191(exact), bounding box, and the **set of vertex positions in world coordinates, order-independent**, both ways,192within a tolerance of 2·10⁻⁵ × max(bounding-box diagonal, largest coordinate); for glTF / GLB also the structural193requirements of the specification (required properties, buffer and buffer-view lengths, accessor bounds, index194values below the vertex count, node / scene / material / texture / image references, GLB chunk layout), material195and image counts; for OBJ the MTL materials and that every referenced texture file exists; for USDZ that the first196entry is a USD layer, that entries are stored and 64-byte aligned, and the number of textures; for USD text197outputs the materials and textures Model I/O resolves. What was written is kept in memory by the engine until198`validate` consumes it (bounded: positions are subsampled above 6 000 000 vertices); if `validate` runs in199another process only the triangle count from the output facts is compared.200201Outside the test suite, five USDA / USDZ outputs were also checked with Apple's `usdchecker` (and202`usdchecker --arkit`) on the build machine: all passed. USDC outputs, which Model I/O writes, do **not** pass203`usdchecker` (Model I/O authors `float3` where `color3f` is expected).204205**Preview API** (for the app's `SCNView`):206`Model3DPreviewLoader.load(_:format:limits:isolation:) async throws -> Model3DPreview` (the neutral scene +207`Model3DSummary`, bounded by `ModelLimits.preview`), then208`Model3DPreviewLoader.makeSCNScene(from:convertToYUp:) -> SCNScene` on the thread that owns the view209(physically based materials, textures decoded from memory, Z-up models stood upright under an `ORIX_up_axis`210node). A test renders the result off screen with Metal and checks that the texture is the right way up.211212## 7. Measured performance213214Release build, generated bumpy sphere with normals and UVs (998 000 and 4 995 224 triangles), times of215`convert` alone (validation not included), split as reported in the output facts216(`seconds.import` / `seconds.process` / `seconds.write`). "Process" is mostly vertex welding. Peak resident217memory of the process over the conversion **and** the validation that follows, and of the largest helper process218(import, or the re-read done by validation). Two runs each; the slower one is shown.219220| Conversion | Triangles | Import | Process | Write | Total | Peak RSS | Largest helper RSS |221|---|---|---|---|---|---|---|---|222| OBJ → GLB | 998 000 | 0.60 s (Assimp) | 0.36 s | 0.02 s | 0.98 s | 378 MB | 532 MB |223| STL → PLY | 998 000 | 0.08 s (own) | 0.14 s | 0.07 s | 0.30 s | 186 MB | 84 MB |224| GLB → USDZ | 998 000 | 0.11 s (Assimp) | 0.05 s | 0.41 s | 0.57 s | 232 MB | 679 MB |225| OBJ → GLB | 4 995 224 | 3.05 s (Assimp) | 1.76 s | 0.07 s | 4.88 s | 1 842 MB | 2 562 MB |226| STL → PLY | 4 995 224 | 0.23 s (own) | 0.52 s | 0.31 s | 1.07 s | 836 MB | 333 MB |227| GLB → USDZ | 4 995 224 | 0.43 s (Assimp) | 0.39 s | 2.10 s | 2.93 s | 1 190 MB | 2 929 MB |228229Source files: OBJ 107 MB / 591 MB, binary STL 50 MB / 250 MB, GLB 28 MB / 140 MB. For GLB → USDZ the largest230helper is Model I/O re-reading the 5 M-triangle USDZ during validation (2.9 GB).231232Simplification of the 998 000-triangle mesh to 100 000 triangles (449 000 collapses, target reached):233234| Input | Simplification alone | Simplification + error measurement | Measured distance to the original (80 000 samples) | Peak RSS |235|---|---|---|---|---|236| binary STL (positions only) | 2.0–2.4 s (three runs) | 2.3–2.7 s (three runs) | mean 1.42·10⁻⁴, largest 2.09·10⁻³ = 0.0575 % of the bounding-box diagonal (3.635) | 451 MB (310 MB without the measurement) |237| GLB (normals, UVs, seam preserved) | not timed separately | 2.3–2.8 s (three runs) | mean 1.41·10⁻⁴, largest 1.92·10⁻³ = 0.0528 % of the diagonal | 413 MB |238239The simplifier is a quadric-error-metric edge collapse written for this engine (area-weighted plane quadrics,2404-ary heap with lazy invalidation, **half-edge collapses**: the vertices of the result are a subset of the source241vertices, so positions, normals, UVs and colours of surviving vertices are exact). Open borders are held by242constraint planes and border vertices only move along the border; vertices duplicated for their attributes243(UV seams, hard edges) only collapse along the seam; collapses that flip a face or break the edge-manifold244topology are refused. The error is a **sampled** two-sided surface distance (vertices + area-stratified points,245closest point on the other surface through a uniform grid), not an exact Hausdorff distance, expressed in mesh246coordinates.247248## 8. Tests249250`swift test` from `Packages/EngineModel3D`: 66 tests in 11 suites, all passing (about 8 s).251252| Suite | What it checks |253|---|---|254| `MatrixTests` | each of the 132 declared paths converts a real fixture; core generic checks + the engine's validation (triangles, positions, bounding box, materials / textures where applicable) all pass |255| `UnitAxisTests` | exact vertex positions after mm → m and Z-up → Y-up; unknown units never rescaled; refusal of an output unit without a source unit; inches → millimetres (25.4); USD `metersPerUnit` / `upAxis` read and honoured; root-transform option; 3MF unit recorded in USD; USDC converted to centimetres; COLLADA unit / up-axis round trip; mirroring keeps faces outward |256| `MeshProcessingTests` | flat / smooth / crease-angle normals, exact and tolerance welding, topology reports, sanitising |257| `SimplifyTests` | target reached on a closed sphere with max error < 2 % and mean < 0.5 % of the diagonal, result still watertight and a subset of the source vertices; open border kept (outline length and corners); UV seam kept (no triangle spans it, every surviving position + UV pair is a source pair); cancellation; distance grid against brute force; engine-level facts and validation |258| `OutputTests` | PNG bytes embedded unchanged in GLB and USDZ; folders for multi-file outputs with every reference resolving; single file when nothing accompanies the model; data-loss warnings; PBR values through glTF / GLB / USDA / USDZ; 3MF colour; ASCII / binary STL and PLY; hierarchy kept or flattened; validation failing on tampered outputs |259| `AttributeTests` | UVs, normals and vertex colours keep their values and orientation through GLB, glTF, OBJ, PLY, USDA, USDZ, USDC, DAE; off-screen render of the preview scene |260| `PathSafetyTests` | reference rules; MTL textures and glTF image URIs escaping the folder (relative, absolute, percent-encoded, URL) are left out and their bytes never reach an output; `mtllib` and glTF buffers outside the folder are not opened; symbolic links; USD layers referring outside are refused |261| `InspectionTests` | summary of every fixture, format-specific facts, crate metadata reader (a file written by Apple's `usdcat`, one by SceneKit, one by Model I/O), a glTF with animation, skin, camera, light, morph target, two UV sets and clearcoat → counts and preflight warnings, options, invalid options |262| `RuntimeTests` | preview API for five formats, limits enforced by every backend, helper process vs in-process results identical, scene hand-off format, cancellation |263| `MalformedTests` | 17 truncated / corrupted variants of each of the 12 source fixtures through the helper; empty, random, mislabelled files of every format; lying headers (STL, PLY, ZIP sizes, cyclic 3MF components); 2 951 mutants (227 of each of 13 seed files) through the engine's own readers in-process; Draco and meshopt refused clearly; point clouds and line sets refused |264| `CodecTests` | glTF checker on hand-made structural errors, PLY variants (big-endian, doubles, extra properties), STL variants, ZIP writer / reader (also checked with `/usr/bin/unzip -t`), 3MF components / units / colours, the Assimp build contains exactly the needed formats, FBX round trip through Assimp |265266Fixtures are generated in code (cube, UV sphere, textured quad with a generated PNG, two-node hierarchy with267translation / rotation / scale, vertex colours, two materials) or hand-written (OBJ + MTL, ASCII STL, ASCII PLY,268glTF with a base64 buffer, COLLADA, USDA, a 3MF assembled as a stored ZIP with CRC-32 computed in the test).269Binary-format fixtures come from the available writers (GLB and USDZ from the engine, USDC / USD from Model I/O,270FBX from Assimp's exporter). One small binary fixture is committed: `Fixtures/usdcat-cm-zup.usdc` (1 816 bytes),271written by Apple's `usdcat` from the hand-written text layer, because nothing in the test process can author272`metersPerUnit = 0.01` in a crate file.273274## 9. Evaluated and not implemented, or limited275276- **FBX export**: Assimp's FBX exporter works, but no reader independent of Assimp exists on this Mac (Model I/O277  and SceneKit do not read FBX), so its output cannot be validated: not declared.278- **FBX import** is declared `experimental`: no FBX file existed on this Mac and none was downloaded, so the only279  evidence is that files written by Assimp's FBX exporter are read back by Assimp's FBX importer with the same280  geometry. Behaviour on FBX files from Maya, 3ds Max or Blender is untested. (Assimp's exporter labels its files281  as centimetres without rescaling them; the engine reports the declared unit as read.)282- **Animations, skinning, morph targets, cameras, lights**: detected and counted, not converted.283- **Polygons** are always triangulated; quads are not preserved, even OBJ → OBJ.284- **Points and lines** (point clouds, line sets) are not converted; a file with nothing else is refused.285- **Draco and meshopt** compressed glTF: refused with a clear message (Assimp is built without Draco).286- **KTX2 / Basis, WebP and other texture formats**: carried through the neutral scene but only PNG and JPEG are287  written by the glTF and USD writers. Embedded textures stored as raw texels (possible in FBX) are not converted.288- **3MF**: textures (materials extension), colour groups, composite materials, beam lattices, slices and289  multi-file "production" packages are not read (reported as data loss); the writer produces core 3MF with base290  materials only. Embedding textures in 3MF is not implemented.291- **USD**: no USD library is bundled. Import is whatever Model I/O resolves (it triangulates, so the source polygon292  count is unknown; variants, subdivision and instancing are resolved by it); `metersPerUnit` and `upAxis` are read293  by the engine's own reader of text layers and of the token / field tables of crate files (crate 0.4.0 and later;294  on any surprise the unit stays unknown). A layer that does not author `metersPerUnit` is treated as "unit295  unknown", although USD's own fallback is centimetres. The USD writer does not use USD instancing, writes296  `UsdPreviewSurface` materials only, and `.usd` outputs are text layers (valid: `.usd` may hold either encoding).297- **USDC export** goes through Model I/O: no `metersPerUnit` (hence centimetres), materials re-authored (names and298  count can change), not `usdchecker`-clean.299- **COLLADA export** is Assimp's exporter (Phong materials, first UV set); the validation reader is the engine's300  own minimal COLLADA reader, which understands what that exporter writes, not all of COLLADA.301- **Alembic** (`abc`), which Model I/O imports, is not declared: the core catalog has no such format.302- **Tangents** are carried from sources that have them to glTF only; they are not generated.303- **Vertex colours**: no colour-space conversion between formats; OBJ vertex-colour extension not written.304- **STL facet normals and attribute bytes** are not imported (normals come from the winding; attribute bytes are305  reported when present).306- **Welding within a tolerance** is grid snapping, not a nearest-neighbour search: two points closer than the307  tolerance but on either side of a grid boundary stay apart.308- **Simplification** works mesh by mesh (no collapse across meshes), has no texture-aware or normal-aware error309  term, and its error is measured in mesh coordinates.310- **ZIP64** is not supported: 3MF and USDZ packages are limited to 4 GB, as is GLB by design.311312## 10. Known defects and caveats313314- Without `orix-model3d-helper` in the app bundle the engine still works, but Assimp and Model I/O then parse315  untrusted files inside the application process. The app should bundle the helper and may require it316  (`isolation: .required`).317- Assimp is linked into both the application and the helper (about 7 MB each, before dead-stripping).318- Validation re-reads the whole output: on the 5 M-triangle USDZ, Model I/O needed 2.9 GB to do so.319- The USDA / USDZ writers build the text layer in memory (1.19 GB peak for 5 M triangles).320- `SCNScene(url:)` could not read DAE in the test environment (XPC service); DAE preview therefore goes through321  Assimp like every other format, which is what `Model3DPreviewLoader` does anyway.322- The detection of outside references in binary USD crate files is heuristic (§4).323- The SHA-256 pinned in `EmbeddedEngines/assimp/build.sh` is the digest of the archive GitHub generated on324  2026-11-21 for tag `v6.0.2`; it was not compared with a digest published by the Assimp project (none is).325326## 11. Declared paths (132)327328121 conversions between different formats and 11 same-format re-exports (operation `model.reprocess`: simplify,329rescale, repair, re-encode). 121 `supported`, 11 `experimental` (every path whose source is FBX).330Test: `MatrixTests.declaredPath(id:)`, parameterised with the path identifier shown.331The numbers in "Limitations" refer to the notes under the table (they are the path's `limitations`, shown to the332user before converting).333334| Source | Destination | Operation | Status | Fidelity | Preserves | Decoder → writer → validator | Limitations (notes) | Test |335|---|---|---|---|---|---|---|---|---|336| obj | obj | model.reprocess | supported | partial | attributes, dimensions, materials, textures | Assimp → ORIX writer → Assimp | 1, 2, 3, 4, 5, 6, 7 | `declaredPath(id:)` with `model3d:obj>obj#model.reprocess` |337| obj | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 8, 9, 5, 10, 11, 12 | `declaredPath(id:)` with `model3d:obj>stl` |338| obj | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 13, 14, 6, 15 | `declaredPath(id:)` with `model3d:obj>ply` |339| obj | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17, 18 | `declaredPath(id:)` with `model3d:obj>gltf` |340| obj | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17, 18 | `declaredPath(id:)` with `model3d:obj>glb` |341| obj | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16, 18 | `declaredPath(id:)` with `model3d:obj>usda` |342| obj | usdc | — | supported | structural | attributes, dimensions, materials, textures | Assimp → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 18, 20 | `declaredPath(id:)` with `model3d:obj>usdc` |343| obj | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16, 18 | `declaredPath(id:)` with `model3d:obj>usd` |344| obj | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16, 18 | `declaredPath(id:)` with `model3d:obj>usdz` |345| obj | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Assimp → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 18, 22 | `declaredPath(id:)` with `model3d:obj>dae` |346| obj | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 23, 24, 5, 10, 18 | `declaredPath(id:)` with `model3d:obj>3mf` |347| stl | obj | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 6, 7, 25 | `declaredPath(id:)` with `model3d:stl>obj` |348| stl | stl | model.reprocess | supported | structural | dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 11, 12, 25 | `declaredPath(id:)` with `model3d:stl>stl#model.reprocess` |349| stl | ply | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 6, 15, 25 | `declaredPath(id:)` with `model3d:stl>ply` |350| stl | gltf | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 17, 26, 25 | `declaredPath(id:)` with `model3d:stl>gltf` |351| stl | glb | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 17, 26, 25 | `declaredPath(id:)` with `model3d:stl>glb` |352| stl | usda | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 26, 25 | `declaredPath(id:)` with `model3d:stl>usda` |353| stl | usdc | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer + Model I/O → SceneKit | 1, 2, 6, 19, 26, 20, 25 | `declaredPath(id:)` with `model3d:stl>usdc` |354| stl | usd | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 26, 25 | `declaredPath(id:)` with `model3d:stl>usd` |355| stl | usdz | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 26, 25 | `declaredPath(id:)` with `model3d:stl>usdz` |356| stl | dae | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → Assimp → ORIX COLLADA checker | 1, 2, 6, 26, 22, 25 | `declaredPath(id:)` with `model3d:stl>dae` |357| stl | 3mf | — | supported | structural | coordinateSystem, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 26, 25 | `declaredPath(id:)` with `model3d:stl>3mf` |358| ply | obj | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 6, 7 | `declaredPath(id:)` with `model3d:ply>obj` |359| ply | stl | — | supported | structural | dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 11, 12 | `declaredPath(id:)` with `model3d:ply>stl` |360| ply | ply | model.reprocess | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 6, 15 | `declaredPath(id:)` with `model3d:ply>ply#model.reprocess` |361| ply | gltf | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 17, 27 | `declaredPath(id:)` with `model3d:ply>gltf` |362| ply | glb | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 17, 27 | `declaredPath(id:)` with `model3d:ply>glb` |363| ply | usda | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 27 | `declaredPath(id:)` with `model3d:ply>usda` |364| ply | usdc | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer + Model I/O → SceneKit | 1, 2, 6, 19, 27, 20 | `declaredPath(id:)` with `model3d:ply>usdc` |365| ply | usd | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 27 | `declaredPath(id:)` with `model3d:ply>usd` |366| ply | usdz | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 27 | `declaredPath(id:)` with `model3d:ply>usdz` |367| ply | dae | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → Assimp → ORIX COLLADA checker | 1, 2, 6, 27, 22 | `declaredPath(id:)` with `model3d:ply>dae` |368| ply | 3mf | — | supported | structural | coordinateSystem, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 27 | `declaredPath(id:)` with `model3d:ply>3mf` |369| gltf | obj | — | supported | partial | attributes, dimensions, materials, textures | Assimp → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7 | `declaredPath(id:)` with `model3d:gltf>obj` |370| gltf | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12 | `declaredPath(id:)` with `model3d:gltf>stl` |371| gltf | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15 | `declaredPath(id:)` with `model3d:gltf>ply` |372| gltf | gltf | model.reprocess | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17 | `declaredPath(id:)` with `model3d:gltf>gltf#model.reprocess` |373| gltf | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17 | `declaredPath(id:)` with `model3d:gltf>glb` |374| gltf | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16 | `declaredPath(id:)` with `model3d:gltf>usda` |375| gltf | usdc | — | supported | structural | attributes, dimensions, materials, textures | Assimp → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20 | `declaredPath(id:)` with `model3d:gltf>usdc` |376| gltf | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16 | `declaredPath(id:)` with `model3d:gltf>usd` |377| gltf | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16 | `declaredPath(id:)` with `model3d:gltf>usdz` |378| gltf | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Assimp → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22 | `declaredPath(id:)` with `model3d:gltf>dae` |379| gltf | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10 | `declaredPath(id:)` with `model3d:gltf>3mf` |380| glb | obj | — | supported | partial | attributes, dimensions, materials, textures | Assimp → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7 | `declaredPath(id:)` with `model3d:glb>obj` |381| glb | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12 | `declaredPath(id:)` with `model3d:glb>stl` |382| glb | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15 | `declaredPath(id:)` with `model3d:glb>ply` |383| glb | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17 | `declaredPath(id:)` with `model3d:glb>gltf` |384| glb | glb | model.reprocess | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17 | `declaredPath(id:)` with `model3d:glb>glb#model.reprocess` |385| glb | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16 | `declaredPath(id:)` with `model3d:glb>usda` |386| glb | usdc | — | supported | structural | attributes, dimensions, materials, textures | Assimp → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20 | `declaredPath(id:)` with `model3d:glb>usdc` |387| glb | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16 | `declaredPath(id:)` with `model3d:glb>usd` |388| glb | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16 | `declaredPath(id:)` with `model3d:glb>usdz` |389| glb | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Assimp → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22 | `declaredPath(id:)` with `model3d:glb>dae` |390| glb | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10 | `declaredPath(id:)` with `model3d:glb>3mf` |391| fbx | obj | — | experimental | partial | attributes, dimensions, materials, textures | Assimp → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7, 30 | `declaredPath(id:)` with `model3d:fbx>obj` |392| fbx | stl | — | experimental | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12, 30 | `declaredPath(id:)` with `model3d:fbx>stl` |393| fbx | ply | — | experimental | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15, 30 | `declaredPath(id:)` with `model3d:fbx>ply` |394| fbx | gltf | — | experimental | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17, 30 | `declaredPath(id:)` with `model3d:fbx>gltf` |395| fbx | glb | — | experimental | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17, 30 | `declaredPath(id:)` with `model3d:fbx>glb` |396| fbx | usda | — | experimental | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16, 30 | `declaredPath(id:)` with `model3d:fbx>usda` |397| fbx | usdc | — | experimental | structural | attributes, dimensions, materials, textures | Assimp → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20, 30 | `declaredPath(id:)` with `model3d:fbx>usdc` |398| fbx | usd | — | experimental | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16, 30 | `declaredPath(id:)` with `model3d:fbx>usd` |399| fbx | usdz | — | experimental | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16, 30 | `declaredPath(id:)` with `model3d:fbx>usdz` |400| fbx | dae | — | experimental | partial | attributes, coordinateSystem, dimensions, materials, textures | Assimp → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22, 30 | `declaredPath(id:)` with `model3d:fbx>dae` |401| fbx | 3mf | — | experimental | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10, 30 | `declaredPath(id:)` with `model3d:fbx>3mf` |402| usd | obj | — | supported | partial | attributes, dimensions, materials, textures | Model I/O → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7, 31 | `declaredPath(id:)` with `model3d:usd>obj` |403| usd | stl | — | supported | partial | dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12, 31 | `declaredPath(id:)` with `model3d:usd>stl` |404| usd | ply | — | supported | partial | attributes, dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15, 31 | `declaredPath(id:)` with `model3d:usd>ply` |405| usd | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17, 31 | `declaredPath(id:)` with `model3d:usd>gltf` |406| usd | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17, 31 | `declaredPath(id:)` with `model3d:usd>glb` |407| usd | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usd>usda` |408| usd | usdc | — | supported | structural | attributes, dimensions, materials, textures | Model I/O → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20, 31 | `declaredPath(id:)` with `model3d:usd>usdc` |409| usd | usd | model.reprocess | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usd>usd#model.reprocess` |410| usd | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 16, 31 | `declaredPath(id:)` with `model3d:usd>usdz` |411| usd | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22, 31 | `declaredPath(id:)` with `model3d:usd>dae` |412| usd | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Model I/O → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10, 31 | `declaredPath(id:)` with `model3d:usd>3mf` |413| usda | obj | — | supported | partial | attributes, dimensions, materials, textures | Model I/O → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7, 31 | `declaredPath(id:)` with `model3d:usda>obj` |414| usda | stl | — | supported | partial | dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12, 31 | `declaredPath(id:)` with `model3d:usda>stl` |415| usda | ply | — | supported | partial | attributes, dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15, 31 | `declaredPath(id:)` with `model3d:usda>ply` |416| usda | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17, 31 | `declaredPath(id:)` with `model3d:usda>gltf` |417| usda | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17, 31 | `declaredPath(id:)` with `model3d:usda>glb` |418| usda | usda | model.reprocess | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usda>usda#model.reprocess` |419| usda | usdc | — | supported | structural | attributes, dimensions, materials, textures | Model I/O → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20, 31 | `declaredPath(id:)` with `model3d:usda>usdc` |420| usda | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usda>usd` |421| usda | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 16, 31 | `declaredPath(id:)` with `model3d:usda>usdz` |422| usda | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22, 31 | `declaredPath(id:)` with `model3d:usda>dae` |423| usda | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Model I/O → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10, 31 | `declaredPath(id:)` with `model3d:usda>3mf` |424| usdc | obj | — | supported | partial | attributes, dimensions, materials, textures | Model I/O → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7, 31 | `declaredPath(id:)` with `model3d:usdc>obj` |425| usdc | stl | — | supported | partial | dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12, 31 | `declaredPath(id:)` with `model3d:usdc>stl` |426| usdc | ply | — | supported | partial | attributes, dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15, 31 | `declaredPath(id:)` with `model3d:usdc>ply` |427| usdc | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17, 31 | `declaredPath(id:)` with `model3d:usdc>gltf` |428| usdc | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17, 31 | `declaredPath(id:)` with `model3d:usdc>glb` |429| usdc | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usdc>usda` |430| usdc | usdc | model.reprocess | supported | structural | attributes, dimensions, materials, textures | Model I/O → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20, 31 | `declaredPath(id:)` with `model3d:usdc>usdc#model.reprocess` |431| usdc | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usdc>usd` |432| usdc | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 16, 31 | `declaredPath(id:)` with `model3d:usdc>usdz` |433| usdc | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22, 31 | `declaredPath(id:)` with `model3d:usdc>dae` |434| usdc | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Model I/O → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10, 31 | `declaredPath(id:)` with `model3d:usdc>3mf` |435| usdz | obj | — | supported | partial | attributes, dimensions, materials, textures | Model I/O → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7, 31 | `declaredPath(id:)` with `model3d:usdz>obj` |436| usdz | stl | — | supported | partial | dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12, 31 | `declaredPath(id:)` with `model3d:usdz>stl` |437| usdz | ply | — | supported | partial | attributes, dimensions | Model I/O → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15, 31 | `declaredPath(id:)` with `model3d:usdz>ply` |438| usdz | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17, 31 | `declaredPath(id:)` with `model3d:usdz>gltf` |439| usdz | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17, 31 | `declaredPath(id:)` with `model3d:usdz>glb` |440| usdz | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usdz>usda` |441| usdz | usdc | — | supported | structural | attributes, dimensions, materials, textures | Model I/O → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20, 31 | `declaredPath(id:)` with `model3d:usdz>usdc` |442| usdz | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 4, 16, 31 | `declaredPath(id:)` with `model3d:usdz>usd` |443| usdz | usdz | model.reprocess | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → ORIX writer → Model I/O | 1, 2, 16, 31 | `declaredPath(id:)` with `model3d:usdz>usdz#model.reprocess` |444| usdz | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Model I/O → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22, 31 | `declaredPath(id:)` with `model3d:usdz>dae` |445| usdz | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Model I/O → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10, 31 | `declaredPath(id:)` with `model3d:usdz>3mf` |446| dae | obj | — | supported | partial | attributes, dimensions, materials, textures | Assimp → ORIX writer → Assimp | 1, 2, 28, 3, 4, 5, 6, 7 | `declaredPath(id:)` with `model3d:dae>obj` |447| dae | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12 | `declaredPath(id:)` with `model3d:dae>stl` |448| dae | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15 | `declaredPath(id:)` with `model3d:dae>ply` |449| dae | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 4, 16, 17 | `declaredPath(id:)` with `model3d:dae>gltf` |450| dae | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 16, 17 | `declaredPath(id:)` with `model3d:dae>glb` |451| dae | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16 | `declaredPath(id:)` with `model3d:dae>usda` |452| dae | usdc | — | supported | structural | attributes, dimensions, materials, textures | Assimp → ORIX writer + Model I/O → SceneKit | 1, 2, 4, 16, 6, 19, 20 | `declaredPath(id:)` with `model3d:dae>usdc` |453| dae | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 4, 16 | `declaredPath(id:)` with `model3d:dae>usd` |454| dae | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16 | `declaredPath(id:)` with `model3d:dae>usdz` |455| dae | dae | model.reprocess | supported | partial | attributes, coordinateSystem, dimensions, materials, textures | Assimp → Assimp → ORIX COLLADA checker | 1, 2, 21, 4, 6, 22 | `declaredPath(id:)` with `model3d:dae>dae#model.reprocess` |456| dae | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10 | `declaredPath(id:)` with `model3d:dae>3mf` |457| 3mf | obj | — | supported | partial | attributes, dimensions, materials | ORIX reader → ORIX writer → Assimp | 1, 2, 28, 3, 5, 6, 7, 32 | `declaredPath(id:)` with `model3d:3mf>obj` |458| 3mf | stl | — | supported | partial | dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 28, 8, 5, 10, 11, 12, 32 | `declaredPath(id:)` with `model3d:3mf>stl` |459| 3mf | ply | — | supported | partial | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 28, 13, 6, 15, 32 | `declaredPath(id:)` with `model3d:3mf>ply` |460| 3mf | gltf | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 17, 32 | `declaredPath(id:)` with `model3d:3mf>gltf` |461| 3mf | glb | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → ORIX glTF checker + Assimp | 1, 2, 17, 32 | `declaredPath(id:)` with `model3d:3mf>glb` |462| 3mf | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Model I/O | 1, 2, 32 | `declaredPath(id:)` with `model3d:3mf>usda` |463| 3mf | usdc | — | supported | structural | attributes, dimensions, materials | ORIX reader → ORIX writer + Model I/O → SceneKit | 1, 2, 6, 19, 20, 32 | `declaredPath(id:)` with `model3d:3mf>usdc` |464| 3mf | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Model I/O | 1, 2, 32 | `declaredPath(id:)` with `model3d:3mf>usd` |465| 3mf | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Model I/O | 1, 2, 32 | `declaredPath(id:)` with `model3d:3mf>usdz` |466| 3mf | dae | — | supported | partial | attributes, coordinateSystem, dimensions, materials | ORIX reader → Assimp → ORIX COLLADA checker | 1, 2, 21, 6, 22, 32 | `declaredPath(id:)` with `model3d:3mf>dae` |467| 3mf | 3mf | model.reprocess | supported | partial | coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Assimp | 1, 2, 29, 23, 5, 10, 32 | `declaredPath(id:)` with `model3d:3mf>3mf#model.reprocess` |468469**Notes**4704711. Animations, skins, morph targets, cameras and lights are not converted.4722. Polygons are triangulated; point and line primitives are dropped.4733. PBR materials are approximated with MTL Phong values (plus Pr/Pm lines).4744. Textures are written as files next to the model; the output is then a folder.4755. Vertex colours are not written.4766. Only the first set of texture coordinates is written.4777. Wavefront OBJ records neither a unit nor an up axis.4788. STL has no materials: they are dropped.4799. STL cannot hold textures: they are dropped.48010. Texture coordinates are not written.48111. STL records neither a unit nor an up axis.48212. Facet normals are recomputed from the triangle winding.48313. PLY has no materials: they are dropped.48414. PLY cannot hold textures: they are dropped.48515. PLY records neither a unit nor an up axis.48616. Only PNG and JPEG textures are carried.48717. glTF is in metres: a known source unit is converted, an unknown one is written unchanged.48818. Wavefront OBJ states no unit: set the source unit, otherwise numbers are written unchanged.48919. Model I/O cannot record metersPerUnit in a crate file: coordinates are converted to centimetres (USD's default) when the source unit is known.49020. The crate layer is produced by Model I/O from the text layer ORIX writes: Model I/O re-authors the materials (their names and number can change).49121. PBR materials are approximated with COLLADA Phong values.49222. Written by Assimp's COLLADA exporter; metallic and roughness are not part of COLLADA 1.4.49323. Only the base colour of each material is kept.49424. 3MF cannot hold textures: they are dropped.49525. STL attribute bytes (colours) are ignored.49626. STL states no unit: set the source unit, otherwise numbers are written unchanged.49727. PLY states no unit: set the source unit, otherwise numbers are written unchanged.49828. The node hierarchy is flattened: every mesh is written in world coordinates.49929. The node hierarchy is flattened to one placed object per mesh.50030. FBX import is experimental: it is only tested on files written by Assimp's own FBX exporter (no third-party FBX file was available).50131. USD files that reference other files outside their folder are refused; variants, instancing and subdivision are resolved by Model I/O.50232. 3MF textures, colour groups and multi-file (production) packages are not read.503
Files main
Menu

Theme