3D model engine (EngineModel3D)
Engine id model3d — OBJ (+MTL), STL, PLY, glTF 2.0 / GLB, FBX (import only, experimental), USD / USDA / USDC / USDZ,
COLLADA (DAE) and 3MF.
State of this document: 2026-11-21, measured on the build machine (Apple M5 Max, 18 cores, 48 GB, macOS 27.0, Xcode 27.2, Swift 6.4.2). "Supported" means implemented, tested and passing on that machine on that day.
- Package:
Packages/EngineModel3D(moduleEngineModel3D, factorymakeEngines()), depends on../ORIXConvertCoreand on the binary targetCAssimp(EmbeddedEngines/assimp/CAssimp.xcframework, built byEmbeddedEngines/assimp/build.sh; seeEmbeddedEngines/assimp/NOTICE.md). - Products: library
EngineModel3D, executableorix-model3d-helper(must be copied into<App>.app/Contents/Helpers, see §5), executableEngineModel3DBench(development and benchmarks). - Tests:
swift testfromPackages/EngineModel3D— 66 tests in 11 suites, all passing; the parameterised matrix test alone converts and validates the 132 declared paths. - Core contract: no change, nothing added.
1. What does the work
Every importer produces one neutral in-memory scene (Scene3D: node hierarchy with 4×4 transforms, triangle meshes
with positions / normals / tangents / UV sets / vertex colours / indices, PBR materials with base colour, metallic,
roughness, emissive and base-colour / metallic-roughness / normal / emissive / occlusion texture references,
embedded or external textures, unit and up-axis metadata) and every exporter consumes it.
Animations, skins, bones, morph targets, cameras, lights, points and lines are counted, never converted.
| Format | Import | Export | Output re-read by (validation) |
|---|---|---|---|
| STL (ASCII, binary) | own Swift reader | own Swift writer | Assimp |
| PLY (ASCII, binary LE/BE) | own Swift reader | own Swift writer (ASCII, binary LE) | Assimp |
| 3MF | own Swift reader (ZIP + XML) | own Swift writer | Assimp |
| OBJ + MTL | Assimp | own Swift writer (OBJ + MTL + textures) | Assimp, plus the MTL and texture files checked by the engine |
| 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 |
| FBX | Assimp (experimental) | — not declared | — |
| 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 |
| USDA, USD (text) | Model I/O (layer metadata read by the engine) | own Swift writer | Model I/O |
| 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 |
| 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 |
What Apple's frameworks do on this Mac (checked at run time, the paths are only declared when it holds):
MDLAsset.canImportFileExtension is true for obj, stl, ply, abc, usd, usda, usdc, usdz and false for dae, fbx, gltf,
glb, 3mf; canExportFileExtension is true for obj, stl, ply, abc, usd, usda, usdc and false for usdz.
Model I/O exposes upAxis but not metersPerUnit, and drops it when it re-exports a layer; it applies neither.
SceneKit writes USDZ, DAE, SCN, USDC, USDA from an SCNScene, but always stamps metersPerUnit = 1 whatever the
data and converts the material colours (0.8 → 0.97): it is not used to write anything. SCNScene(url:) on a DAE goes
through an XPC service that failed in the test environment ("Failed to retrieve scene from XPC service"), so SceneKit
is not used to read DAE either; it is used to re-read USDC outputs, which works in-process.
Assimp 6.0.2 is built with only the OBJ, STL, PLY, glTF, FBX, COLLADA and 3MF importers and exporters, without
Draco, without tools, tests or samples, against the zlib of macOS (configuration and compiled third-party code in
EmbeddedEngines/assimp/NOTICE.md). libCAssimp.a is 7 172 480 bytes, CAssimp.xcframework 7.9 MB.
It is used through its C API (cimport.h, cexport.h, scene.h, material.h) and a small C target
(CAssimpShim) that (a) imports with aiProcess_ValidateDataStructure, measures the face kinds, enforces the
vertex / face limits before triangulating, then applies aiProcess_Triangulate | aiProcess_SortByPType,
(b) gives Assimp a file-access layer that only opens files really located inside the model's folder
(symbolic links resolved), (c) flattens the structs that are awkward to read from Swift, and (d) builds an
aiScene from flat arrays for export.
2. Order of operations
import (in the helper process for Assimp and Model I/O) → structural sanitising (out-of-range indices, non-finite
coordinates, wrong-length attribute arrays, cycles in the node graph are removed and reported) → unit scale, axis
rotation, optional mirroring → hierarchy flattening (when the destination has no hierarchy, or on request) →
vertex welding → normals → simplification (+ error measurement) → destination-specific warnings → write →
measured facts. validate then re-reads the output.
3. Options (keys of ConversionOptions)
| Key | Values (default first) | Notes |
|---|---|---|
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. |
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). |
axis.source |
auto, y, z |
auto = glTF Y-up, 3MF Z-up (by specification), USD upAxis, COLLADA <up_axis>, FBX UpAxis. |
axis.target |
same, y, z |
Right-handed rotation: Z-up → Y-up is (x, y, z) → (x, z, −y). |
axis.mirror |
false |
Mirrors Z and reverses the winding (left-handed sources). |
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. |
hierarchy.flatten |
false |
Hierarchical destinations only. |
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. |
weld.tolerance |
0.0001 (10⁻⁷…1000) |
In source units. |
normals.mode |
keep, smooth, flat, remove |
|
normals.crease-angle |
60 (0…180°) |
For smooth: faces meeting at a larger angle keep a hard edge; area-weighted. |
simplify.enabled |
false |
|
simplify.ratio |
0.5 (0.01…1) |
Fraction of triangles kept in each mesh. |
simplify.target-triangles |
0 |
When above zero, replaces the ratio (shared between meshes in proportion to their size). |
simplify.preserve-boundary |
true |
|
simplify.preserve-seams |
true |
UV seams and hard edges. |
simplify.measure-error |
true |
|
materials.write |
true |
Not offered for STL and PLY. |
textures.write |
true |
Not offered for STL, PLY, 3MF. |
encoding |
binary, ascii |
STL and PLY only. |
gltf.embed |
false |
.gltf only: one self-contained file with base64 buffer and images. |
Triangulation is not an option: every importer triangulates (Assimp's triangulation; fans for PLY polygons, USD
quads and n-gons), and the number of polygons the file contained is reported by inspect when the importer knows it.
4. Behaviour that must be known
Units are never changed silently. The applied factor is always in the output facts (unit.source,
unit.output, unit.factor) and, when it is not 1, in an unit-converted warning.
- glTF / GLB are in metres by specification: a known source unit is converted to metres; an unknown one is written
unchanged with a
unit-unknownwarning. - USDA, USD, USDZ, COLLADA record the unit (
metersPerUnit,<unit meter>); 3MF records one of its named units (another unit is converted to millimetres). When the source unit is unknown nothing is recorded (3MF: its default, millimetres, with a warning). - USDC is written by Model I/O, which cannot author
metersPerUnit; USD readers then assume centimetres, so the coordinates are converted to centimetres when the source unit is known (reported). An explicitunit.targetis honoured with a warning that the file cannot say so. - Asking for an output unit or up axis while the source states none is refused (
invalidOption), not guessed. - OBJ, STL and PLY record neither unit nor up axis.
Axes. glTF is Y-up and 3MF Z-up by specification: a known source axis is rotated to it, an unknown one is
written unrotated with an axis-unknown warning. USD records upAxis (Y or Z; an X-up source becomes Y-up),
COLLADA records <up_axis>.
Hierarchy. glTF, GLB, USD*, DAE keep the node tree. glTF keeps instancing (a mesh used by several nodes is
stored once); the USD writer writes one mesh per use; a node holding several meshes gets child nodes in glTF.
OBJ, STL, PLY are written in world coordinates (hierarchy-flattened warning when there was a hierarchy);
3MF gets one object per mesh and one build item per use, carrying the world transform.
Materials. glTF, GLB, USDA, USD, USDZ, USDC carry the PBR values. OBJ gets MTL Phong values derived from them
(Kd, Ks from metalness, Ns from roughness, Ke, d) plus the widely read Pr / Pm lines, with a
materials-approximated warning; COLLADA gets what Assimp's exporter writes (diffuse, emission, transparency,
textures); 3MF only a base material with an sRGB display colour; STL and PLY nothing (materials-dropped).
Material features of the source that the neutral model does not carry (clearcoat, sheen, transmission, volume,
specular-glossiness, anisotropy, emissive strength, textures in other channels) are named in a
material-features-dropped warning. Assimp's synthetic grey "DefaultMaterial" for files without materials is removed.
Vertex colours are copied numerically (no colour-space conversion); PLY stores them on 8 bits.
Textures. Embedded in GLB (buffer views) and USDZ (textures/ entries); written as files next to .gltf,
.obj, .usda, .usd, .usdc, .dae. Only PNG and JPEG are written by the glTF and USD writers (others are
dropped with a texture-format warning). When an output consists of several files the engine returns one folder
named after the output (name/name.gltf, name/name.bin, name/checker.png…), so nothing is orphaned; when it
is a single file it returns the file. A texture that is absent, outside the model's folder or remote is left out
with a texture-missing warning naming the reference and the reason.
References inside models are confined to the model's own folder. Relative paths only; absolute paths, drive
letters, .. components (also percent-encoded or with back-slashes), URLs (http, https, ftp, file, any
scheme://) and symbolic links leading outside are refused; nothing is ever fetched. This applies to MTL
libraries and glTF buffers (Assimp's file access is confined in the C layer, reference-blocked warning), to
textures of every format, and to USD: a USD file that refers to another file outside its folder or on the
network is refused entirely, because Model I/O would follow sublayers, references and payloads itself.
Limit of that last check: text layers are scanned for @…@ asset paths; in binary crate layers the token table is
scanned for strings that look like file references (known extensions or ://), so a crate layer referring to an
outside file with an unusual extension is not detected.
Bounds. ModelLimits: file size 4 GB, 60 M vertices, 40 M triangles, 500 000 nodes, 256 MB per texture and
1 GB of textures, 512 MB for a JSON / XML document; smaller bounds (ModelLimits.preview: 1 GB, 20 M vertices,
12 M triangles) for inspection and previews. Declared counts are checked against the real file size before
anything is allocated (binary STL header, PLY element counts and list lengths, ZIP entry sizes, glTF accessors).
Format limits are errors, not truncations: binary STL 4 294 967 295 triangles, GLB / 3MF / USDZ 4 GB (no ZIP64).
Progress is measured during simplification (collapses done / to do) and writing of STL, PLY and OBJ
(elements written); it is indeterminate (fraction: nil) during import and the other writers.
5. Isolation of the third-party and system parsers
Assimp and Model I/O parse untrusted files in orix-model3d-helper, a separate executable of this package
run through ProcessRunner; it writes the neutral scene to a private temporary file (JSON header + raw arrays),
which the engine reads back with every length checked, then sanitises. A parser crash is reported as
"the parser stopped unexpectedly…" (malformedInput) and nothing else is affected. The helper is looked up with
BundledTools.url(for: "orix-model3d-helper") (the app's Contents/Helpers, EmbeddedEngines/tools,
ORIX_CONVERT_TOOLS), then next to the running binary (SwiftPM builds).
Model3DEngine(isolation:): .automatic (default: helper when found, in-process otherwise), .required
(fails when the helper is missing), .inProcess. Model3DEngine.isHelperAvailable tells which applies; inspection
shows "(separate process)" next to the decoder. The engine's own readers (STL, PLY, 3MF, glTF checker, USD layer
metadata, COLLADA checker) are memory-safe Swift and run in-process.
In the tests, 204 truncated or corrupted files (17 variants of each of the 12 source fixtures) went through the helper: every one ended in an error or a valid conversion, and none made Assimp 6.0.2 or Model I/O crash. That is a small corpus, not a proof.
6. Inspection, preflight, validation, preview
inspect imports the file within the preview bounds and returns only what was read: decoder, format version
(glTF asset.version / generator, FBX version, COLLADA version and authoring tool, USD text / crate version and
creator), encoding (STL, PLY), meshes, vertices and triangles as placed (and as stored when meshes are instanced),
faces and polygons of the source when known, bounding box and dimensions with the unit when it is known, unit and
up axis with their origin ("glTF specification", "USD layer metadata (metersPerUnit)", "Not stated by the
file"…), normals / UV sets / vertex colours / tangents, nodes and depth, materials, textures embedded / external /
missing, animations, skins, bones, morph targets, cameras, lights, points and lines, extensions, material features
not carried, and edge manifoldness (boundary, non-manifold, inconsistently wound edges, degenerate triangles,
watertight yes / no) on scenes up to 6 000 000 triangles.
preflight reads that inspection and warns, for the chosen destination and options: animations, skins, morph
targets, cameras, lights, points / lines (data loss), materials dropped / reduced / approximated, textures dropped
or missing, vertex colours or UVs dropped, several UV sets reduced to one, extensions and material features not
carried, hierarchy flattened, mesh not watertight for STL / 3MF (informational, with the edge counts), unknown
unit or up axis for destinations that need one, format size limits, FBX experimental.
Without an inspection only the warnings that do not depend on the file are returned.
validate re-reads the output with a decoder that did not write it (table in §1) and compares: triangle count
(exact), bounding box, and the set of vertex positions in world coordinates, order-independent, both ways,
within a tolerance of 2·10⁻⁵ × max(bounding-box diagonal, largest coordinate); for glTF / GLB also the structural
requirements of the specification (required properties, buffer and buffer-view lengths, accessor bounds, index
values below the vertex count, node / scene / material / texture / image references, GLB chunk layout), material
and image counts; for OBJ the MTL materials and that every referenced texture file exists; for USDZ that the first
entry is a USD layer, that entries are stored and 64-byte aligned, and the number of textures; for USD text
outputs the materials and textures Model I/O resolves. What was written is kept in memory by the engine until
validate consumes it (bounded: positions are subsampled above 6 000 000 vertices); if validate runs in
another process only the triangle count from the output facts is compared.
Outside the test suite, five USDA / USDZ outputs were also checked with Apple's usdchecker (and
usdchecker --arkit) on the build machine: all passed. USDC outputs, which Model I/O writes, do not pass
usdchecker (Model I/O authors float3 where color3f is expected).
Preview API (for the app's SCNView):
Model3DPreviewLoader.load(_:format:limits:isolation:) async throws -> Model3DPreview (the neutral scene +
Model3DSummary, bounded by ModelLimits.preview), then
Model3DPreviewLoader.makeSCNScene(from:convertToYUp:) -> SCNScene on the thread that owns the view
(physically based materials, textures decoded from memory, Z-up models stood upright under an ORIX_up_axis
node). A test renders the result off screen with Metal and checks that the texture is the right way up.
7. Measured performance
Release build, generated bumpy sphere with normals and UVs (998 000 and 4 995 224 triangles), times of
convert alone (validation not included), split as reported in the output facts
(seconds.import / seconds.process / seconds.write). "Process" is mostly vertex welding. Peak resident
memory of the process over the conversion and the validation that follows, and of the largest helper process
(import, or the re-read done by validation). Two runs each; the slower one is shown.
| Conversion | Triangles | Import | Process | Write | Total | Peak RSS | Largest helper RSS |
|---|---|---|---|---|---|---|---|
| OBJ → GLB | 998 000 | 0.60 s (Assimp) | 0.36 s | 0.02 s | 0.98 s | 378 MB | 532 MB |
| STL → PLY | 998 000 | 0.08 s (own) | 0.14 s | 0.07 s | 0.30 s | 186 MB | 84 MB |
| GLB → USDZ | 998 000 | 0.11 s (Assimp) | 0.05 s | 0.41 s | 0.57 s | 232 MB | 679 MB |
| OBJ → GLB | 4 995 224 | 3.05 s (Assimp) | 1.76 s | 0.07 s | 4.88 s | 1 842 MB | 2 562 MB |
| STL → PLY | 4 995 224 | 0.23 s (own) | 0.52 s | 0.31 s | 1.07 s | 836 MB | 333 MB |
| GLB → USDZ | 4 995 224 | 0.43 s (Assimp) | 0.39 s | 2.10 s | 2.93 s | 1 190 MB | 2 929 MB |
Source files: OBJ 107 MB / 591 MB, binary STL 50 MB / 250 MB, GLB 28 MB / 140 MB. For GLB → USDZ the largest helper is Model I/O re-reading the 5 M-triangle USDZ during validation (2.9 GB).
Simplification of the 998 000-triangle mesh to 100 000 triangles (449 000 collapses, target reached):
| Input | Simplification alone | Simplification + error measurement | Measured distance to the original (80 000 samples) | Peak RSS |
|---|---|---|---|---|
| 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) |
| 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 |
The simplifier is a quadric-error-metric edge collapse written for this engine (area-weighted plane quadrics, 4-ary heap with lazy invalidation, half-edge collapses: the vertices of the result are a subset of the source vertices, so positions, normals, UVs and colours of surviving vertices are exact). Open borders are held by constraint planes and border vertices only move along the border; vertices duplicated for their attributes (UV seams, hard edges) only collapse along the seam; collapses that flip a face or break the edge-manifold topology are refused. The error is a sampled two-sided surface distance (vertices + area-stratified points, closest point on the other surface through a uniform grid), not an exact Hausdorff distance, expressed in mesh coordinates.
8. Tests
swift test from Packages/EngineModel3D: 66 tests in 11 suites, all passing (about 8 s).
| Suite | What it checks |
|---|---|
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 |
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 |
MeshProcessingTests |
flat / smooth / crease-angle normals, exact and tolerance welding, topology reports, sanitising |
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 |
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 |
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 |
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 |
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 |
RuntimeTests |
preview API for five formats, limits enforced by every backend, helper process vs in-process results identical, scene hand-off format, cancellation |
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 |
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 |
Fixtures are generated in code (cube, UV sphere, textured quad with a generated PNG, two-node hierarchy with
translation / rotation / scale, vertex colours, two materials) or hand-written (OBJ + MTL, ASCII STL, ASCII PLY,
glTF with a base64 buffer, COLLADA, USDA, a 3MF assembled as a stored ZIP with CRC-32 computed in the test).
Binary-format fixtures come from the available writers (GLB and USDZ from the engine, USDC / USD from Model I/O,
FBX from Assimp's exporter). One small binary fixture is committed: Fixtures/usdcat-cm-zup.usdc (1 816 bytes),
written by Apple's usdcat from the hand-written text layer, because nothing in the test process can author
metersPerUnit = 0.01 in a crate file.
9. Evaluated and not implemented, or limited
- FBX export: Assimp's FBX exporter works, but no reader independent of Assimp exists on this Mac (Model I/O and SceneKit do not read FBX), so its output cannot be validated: not declared.
- FBX import is declared
experimental: no FBX file existed on this Mac and none was downloaded, so the only evidence is that files written by Assimp's FBX exporter are read back by Assimp's FBX importer with the same geometry. Behaviour on FBX files from Maya, 3ds Max or Blender is untested. (Assimp's exporter labels its files as centimetres without rescaling them; the engine reports the declared unit as read.) - Animations, skinning, morph targets, cameras, lights: detected and counted, not converted.
- Polygons are always triangulated; quads are not preserved, even OBJ → OBJ.
- Points and lines (point clouds, line sets) are not converted; a file with nothing else is refused.
- Draco and meshopt compressed glTF: refused with a clear message (Assimp is built without Draco).
- KTX2 / Basis, WebP and other texture formats: carried through the neutral scene but only PNG and JPEG are written by the glTF and USD writers. Embedded textures stored as raw texels (possible in FBX) are not converted.
- 3MF: textures (materials extension), colour groups, composite materials, beam lattices, slices and multi-file "production" packages are not read (reported as data loss); the writer produces core 3MF with base materials only. Embedding textures in 3MF is not implemented.
- USD: no USD library is bundled. Import is whatever Model I/O resolves (it triangulates, so the source polygon
count is unknown; variants, subdivision and instancing are resolved by it);
metersPerUnitandupAxisare read by the engine's own reader of text layers and of the token / field tables of crate files (crate 0.4.0 and later; on any surprise the unit stays unknown). A layer that does not authormetersPerUnitis treated as "unit unknown", although USD's own fallback is centimetres. The USD writer does not use USD instancing, writesUsdPreviewSurfacematerials only, and.usdoutputs are text layers (valid:.usdmay hold either encoding). - USDC export goes through Model I/O: no
metersPerUnit(hence centimetres), materials re-authored (names and count can change), notusdchecker-clean. - COLLADA export is Assimp's exporter (Phong materials, first UV set); the validation reader is the engine's own minimal COLLADA reader, which understands what that exporter writes, not all of COLLADA.
- Alembic (
abc), which Model I/O imports, is not declared: the core catalog has no such format. - Tangents are carried from sources that have them to glTF only; they are not generated.
- Vertex colours: no colour-space conversion between formats; OBJ vertex-colour extension not written.
- STL facet normals and attribute bytes are not imported (normals come from the winding; attribute bytes are reported when present).
- Welding within a tolerance is grid snapping, not a nearest-neighbour search: two points closer than the tolerance but on either side of a grid boundary stay apart.
- Simplification works mesh by mesh (no collapse across meshes), has no texture-aware or normal-aware error term, and its error is measured in mesh coordinates.
- ZIP64 is not supported: 3MF and USDZ packages are limited to 4 GB, as is GLB by design.
10. Known defects and caveats
- Without
orix-model3d-helperin the app bundle the engine still works, but Assimp and Model I/O then parse untrusted files inside the application process. The app should bundle the helper and may require it (isolation: .required). - Assimp is linked into both the application and the helper (about 7 MB each, before dead-stripping).
- Validation re-reads the whole output: on the 5 M-triangle USDZ, Model I/O needed 2.9 GB to do so.
- The USDA / USDZ writers build the text layer in memory (1.19 GB peak for 5 M triangles).
SCNScene(url:)could not read DAE in the test environment (XPC service); DAE preview therefore goes through Assimp like every other format, which is whatModel3DPreviewLoaderdoes anyway.- The detection of outside references in binary USD crate files is heuristic (§4).
- The SHA-256 pinned in
EmbeddedEngines/assimp/build.shis the digest of the archive GitHub generated on 2026-11-21 for tagv6.0.2; it was not compared with a digest published by the Assimp project (none is).
11. Declared paths (132)
121 conversions between different formats and 11 same-format re-exports (operation model.reprocess: simplify,
rescale, repair, re-encode). 121 supported, 11 experimental (every path whose source is FBX).
Test: MatrixTests.declaredPath(id:), parameterised with the path identifier shown.
The numbers in "Limitations" refer to the notes under the table (they are the path's limitations, shown to the
user before converting).
| Source | Destination | Operation | Status | Fidelity | Preserves | Decoder → writer → validator | Limitations (notes) | Test |
|---|---|---|---|---|---|---|---|---|
| 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 |
| obj | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 8, 9, 5, 10, 11, 12 | declaredPath(id:) with model3d:obj>stl |
| obj | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 13, 14, 6, 15 | declaredPath(id:) with model3d:obj>ply |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| obj | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 23, 24, 5, 10, 18 | declaredPath(id:) with model3d:obj>3mf |
| stl | obj | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 6, 7, 25 | declaredPath(id:) with model3d:stl>obj |
| 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 |
| stl | ply | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 6, 15, 25 | declaredPath(id:) with model3d:stl>ply |
| 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 |
| 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 |
| stl | usda | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 26, 25 | declaredPath(id:) with model3d:stl>usda |
| 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 |
| stl | usd | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 26, 25 | declaredPath(id:) with model3d:stl>usd |
| stl | usdz | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 26, 25 | declaredPath(id:) with model3d:stl>usdz |
| 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 |
| stl | 3mf | — | supported | structural | coordinateSystem, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 26, 25 | declaredPath(id:) with model3d:stl>3mf |
| ply | obj | — | supported | structural | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 6, 7 | declaredPath(id:) with model3d:ply>obj |
| ply | stl | — | supported | structural | dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 11, 12 | declaredPath(id:) with model3d:ply>stl |
| 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 |
| 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 |
| 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 |
| ply | usda | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 27 | declaredPath(id:) with model3d:ply>usda |
| 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 |
| ply | usd | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 27 | declaredPath(id:) with model3d:ply>usd |
| ply | usdz | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → ORIX writer → Model I/O | 1, 2, 27 | declaredPath(id:) with model3d:ply>usdz |
| ply | dae | — | supported | structural | attributes, coordinateSystem, dimensions | ORIX reader → Assimp → ORIX COLLADA checker | 1, 2, 6, 27, 22 | declaredPath(id:) with model3d:ply>dae |
| ply | 3mf | — | supported | structural | coordinateSystem, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 5, 10, 27 | declaredPath(id:) with model3d:ply>3mf |
| 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 |
| gltf | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12 | declaredPath(id:) with model3d:gltf>stl |
| gltf | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15 | declaredPath(id:) with model3d:gltf>ply |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| gltf | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16 | declaredPath(id:) with model3d:gltf>usdz |
| 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 |
| gltf | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10 | declaredPath(id:) with model3d:gltf>3mf |
| 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 |
| glb | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12 | declaredPath(id:) with model3d:glb>stl |
| glb | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15 | declaredPath(id:) with model3d:glb>ply |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| glb | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16 | declaredPath(id:) with model3d:glb>usdz |
| 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 |
| glb | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10 | declaredPath(id:) with model3d:glb>3mf |
| 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 |
| 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 |
| fbx | ply | — | experimental | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15, 30 | declaredPath(id:) with model3d:fbx>ply |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| dae | stl | — | supported | partial | dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 8, 9, 5, 10, 11, 12 | declaredPath(id:) with model3d:dae>stl |
| dae | ply | — | supported | partial | attributes, dimensions | Assimp → ORIX writer → Assimp | 1, 2, 28, 13, 14, 6, 15 | declaredPath(id:) with model3d:dae>ply |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| dae | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials, textures | Assimp → ORIX writer → Model I/O | 1, 2, 16 | declaredPath(id:) with model3d:dae>usdz |
| 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 |
| dae | 3mf | — | supported | partial | coordinateSystem, dimensions, materials | Assimp → ORIX writer → Assimp | 1, 2, 29, 23, 24, 5, 10 | declaredPath(id:) with model3d:dae>3mf |
| 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 |
| 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 |
| 3mf | ply | — | supported | partial | attributes, dimensions | ORIX reader → ORIX writer → Assimp | 1, 2, 28, 13, 6, 15, 32 | declaredPath(id:) with model3d:3mf>ply |
| 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 |
| 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 |
| 3mf | usda | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Model I/O | 1, 2, 32 | declaredPath(id:) with model3d:3mf>usda |
| 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 |
| 3mf | usd | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Model I/O | 1, 2, 32 | declaredPath(id:) with model3d:3mf>usd |
| 3mf | usdz | — | supported | structural | attributes, coordinateSystem, dimensions, materials | ORIX reader → ORIX writer → Model I/O | 1, 2, 32 | declaredPath(id:) with model3d:3mf>usdz |
| 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 |
| 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 |
Notes
- Animations, skins, morph targets, cameras and lights are not converted.
- Polygons are triangulated; point and line primitives are dropped.
- PBR materials are approximated with MTL Phong values (plus Pr/Pm lines).
- Textures are written as files next to the model; the output is then a folder.
- Vertex colours are not written.
- Only the first set of texture coordinates is written.
- Wavefront OBJ records neither a unit nor an up axis.
- STL has no materials: they are dropped.
- STL cannot hold textures: they are dropped.
- Texture coordinates are not written.
- STL records neither a unit nor an up axis.
- Facet normals are recomputed from the triangle winding.
- PLY has no materials: they are dropped.
- PLY cannot hold textures: they are dropped.
- PLY records neither a unit nor an up axis.
- Only PNG and JPEG textures are carried.
- glTF is in metres: a known source unit is converted, an unknown one is written unchanged.
- Wavefront OBJ states no unit: set the source unit, otherwise numbers are written unchanged.
- Model I/O cannot record metersPerUnit in a crate file: coordinates are converted to centimetres (USD's default) when the source unit is known.
- 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).
- PBR materials are approximated with COLLADA Phong values.
- Written by Assimp's COLLADA exporter; metallic and roughness are not part of COLLADA 1.4.
- Only the base colour of each material is kept.
- 3MF cannot hold textures: they are dropped.
- STL attribute bytes (colours) are ignored.
- STL states no unit: set the source unit, otherwise numbers are written unchanged.
- PLY states no unit: set the source unit, otherwise numbers are written unchanged.
- The node hierarchy is flattened: every mesh is written in world coordinates.
- The node hierarchy is flattened to one placed object per mesh.
- FBX import is experimental: it is only tested on files written by Assimp's own FBX exporter (no third-party FBX file was available).
- USD files that reference other files outside their folder are refused; variants, instancing and subdivision are resolved by Model I/O.
- 3MF textures, colour groups and multi-file (production) packages are not read.