SPB Git

Repository Public License

model3d.md 57.9 KB

# 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 (module EngineModel3D, factory makeEngines()), depends on ../ORIXConvertCore and on the binary target CAssimp (EmbeddedEngines/assimp/CAssimp.xcframework, built by EmbeddedEngines/assimp/build.sh; see EmbeddedEngines/assimp/NOTICE.md).
  • Products: library EngineModel3D, executable orix-model3d-helper (must be copied into <App>.app/Contents/Helpers, see §5), executable EngineModel3DBench (development and benchmarks).
  • Tests: swift test from Packages/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-unknown warning.
  • 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 explicit unit.target is 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); metersPerUnit and upAxis are 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 author metersPerUnit is treated as "unit unknown", although USD's own fallback is centimetres. The USD writer does not use USD instancing, writes UsdPreviewSurface materials only, and .usd outputs are text layers (valid: .usd may hold either encoding).
  • USDC export goes through Model I/O: no metersPerUnit (hence centimetres), materials re-authored (names and count can change), not usdchecker-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-helper in 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 what Model3DPreviewLoader does anyway.
  • The detection of outside references in binary USD crate files is heuristic (§4).
  • The SHA-256 pinned in EmbeddedEngines/assimp/build.sh is the digest of the archive GitHub generated on 2026-11-21 for tag v6.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

  1. Animations, skins, morph targets, cameras and lights are not converted.
  2. Polygons are triangulated; point and line primitives are dropped.
  3. PBR materials are approximated with MTL Phong values (plus Pr/Pm lines).
  4. Textures are written as files next to the model; the output is then a folder.
  5. Vertex colours are not written.
  6. Only the first set of texture coordinates is written.
  7. Wavefront OBJ records neither a unit nor an up axis.
  8. STL has no materials: they are dropped.
  9. STL cannot hold textures: they are dropped.
  10. Texture coordinates are not written.
  11. STL records neither a unit nor an up axis.
  12. Facet normals are recomputed from the triangle winding.
  13. PLY has no materials: they are dropped.
  14. PLY cannot hold textures: they are dropped.
  15. PLY records neither a unit nor an up axis.
  16. Only PNG and JPEG textures are carried.
  17. glTF is in metres: a known source unit is converted, an unknown one is written unchanged.
  18. Wavefront OBJ states no unit: set the source unit, otherwise numbers are written unchanged.
  19. Model I/O cannot record metersPerUnit in a crate file: coordinates are converted to centimetres (USD's default) when the source unit is known.
  20. 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).
  21. PBR materials are approximated with COLLADA Phong values.
  22. Written by Assimp's COLLADA exporter; metallic and roughness are not part of COLLADA 1.4.
  23. Only the base colour of each material is kept.
  24. 3MF cannot hold textures: they are dropped.
  25. STL attribute bytes (colours) are ignored.
  26. STL states no unit: set the source unit, otherwise numbers are written unchanged.
  27. PLY states no unit: set the source unit, otherwise numbers are written unchanged.
  28. The node hierarchy is flattened: every mesh is written in world coordinates.
  29. The node hierarchy is flattened to one placed object per mesh.
  30. FBX import is experimental: it is only tested on files written by Assimp's own FBX exporter (no third-party FBX file was available).
  31. USD files that reference other files outside their folder are refused; variants, instancing and subdivision are resolved by Model I/O.
  32. 3MF textures, colour groups and multi-file (production) packages are not read.
Files main
Menu

Theme