Skip to content
Keith Sloan edited this page Oct 6, 2026 · 8 revisions

ImportExport 3DM — Wiki

FreeCAD import/export for Rhino .3dm files, geometry preserved as true NURBS.

Pages

  • Import Gallery — rendered imports of the openNURBS V1–V6 sample set, for eyeballing import quality.
  • Gallery Utility — the make_3dm_gallery macro that builds a gallery for any folder of .3dm files.
  • Trimmed Surfaces — trimmed-Brep export and enhanced trimmed import with the optional trim3dm extension, and the untrimmed fallback without it.
  • Serpentine Gallery — every sample import checked side-by-side against Serpentine3D (white-background comparison gallery), plus a surface-area cross-check against Serpentine3D and Rhino's own render meshes.
  • AstoCAD Forms — AstoCAD Forms workbench support: importing Rhino SubD as editable Forms (importForms3DM prototype), and the Forms export test cases.

Import type

File → Open / Import offers a single 3DM (*.3dm) type (import3DM), which imports Rhino curves, NurbsSurfaces, trimmed Breps and meshes, with SubD objects arriving as their smooth subdivided limit surface.

When the compiled trim3dm C++/OpenNURBS extension is detected, import3DM uses it for files that contain trimmed Breps (complex solids such as v4_TreeFrog), reading the real 2D trim data so nothing is dropped (e.g. TreeFrog keeps both eyes). If any trimmed Brep sits on a Rhino layer the file keeps hidden, the native trim reconstruction is used instead so layer visibility is respected — a hidden construction history (Camera, HumanHead, Soccer tutorials) is not imported as visible geometry. Without a build, imports fall back to the native rhino3dm reconstruction and startup prints:

import 3DM - Trimmed Edges NOT SUPPORTED - Please build Trim3D

Build & placement instructions: Trimmed Surfaces.

Model units

From import3DM 0.6.0, geometry is scaled from the file's model unit system to FreeCAD's millimetres — e.g. an inch file (v4_TreeFrog) is scaled ×25.4, a metre file (v3_my_points) ×1000 — and the Report View states the units and factor. Unitless files (most V1 samples) are treated as millimetres. The preference ImportScaleToMillimetres (default on, in BaseApp/Preferences/Mod/ImportExport_3DM) turns this off to import raw file coordinates as before. The same setting applies to the AstoCAD Forms importer.

AstoCAD and the Forms workbench

AstoCAD is an open-source soft fork of FreeCAD with a reworked user interface; ImportExport_3DM installs and runs in it just as in FreeCAD. Its Forms workbench (AstoCAD 2026.09.01) adds subdivision-surface modelling: shapes driven by an editable control cage, like Rhino's SubD.

  • importForms3DM.py (new, prototype, AstoCAD only) imports Rhino SubD objects as native, editable Forms — the SubD control net and its creases become the Form's control cage — instead of the fixed limit-surface Part shape that import3DM produces.
  • Export: Forms are ordinary solids to export3DM; 21 Forms test cases check the round trip with and without trimmed-Brep export.

Details, the Rhino SubD logo example and the test cases: AstoCAD Forms.

Import quality

The gallery below reflects import3DM 0.5.0 (2026-09-08), which resolves the previously tracked issues #4 … #10:

  • #4 Points — Rhino Point / PointCloud import as visible Points::Features.
  • #5 Lights & named views — light objects are skipped with an informative Report View message; the spot-light samples' 20×20 target surface imports normally.
  • #6 Empty files — V6/my_surfaces contains no geometry (header-only file); the gallery shows a "No geometry to import" thumbnail and the Report View explains.
  • #7 Trim edges — invalid faces are dropped and untrimmed-fallback faces larger than ~3× their trim wire are rejected; layer-hidden construction objects no longer render.
  • Trimmed-face reconstruction (October 2026) — correctly trimmed faces are no longer rejected for the untrimmed surface, holes are kept, and faces at seams and poles are rebuilt in (u, v); found through the Serpentine Gallery surface-area cross-check, where import3DM now agrees with Rhino's stored render meshes to within about 0.5 % (one creased-surface measurement exception, DinerMug, is explained there).
  • #8 Wireframe — Speeder LHS / SphericalSpiral stripes are genuine Rhino curves and surfaces, imported faithfully.
  • #9 Soccer stray box — objects on invisible Rhino layers are hidden (ImportRespectLayerVisibility).
  • #10 Sew hang — OCCT Part.Shell sewing is capped by ImportSewFaceLimit (default 8); larger Breps import as a valid compound, so v5_ring / v4_DVDCase_Solid no longer hang or go invalid.

Thumbnails that read "No geometry to import" are files whose only content is non-geometric (lights/views) or empty — the Report View explains each.

The enhanced trim reader (trim3dm) is what the default importer uses for Brep-only trimmed files when the extension is built — see Trimmed Surfaces.

Clone this wiki locally