Repository navigation
Home
FreeCAD import/export for Rhino .3dm files, geometry preserved as true NURBS.
- Import Gallery — rendered imports of the openNURBS V1–V6 sample set, for eyeballing import quality.
-
Gallery Utility — the
make_3dm_gallerymacro that builds a gallery for any folder of.3dmfiles. -
Trimmed Surfaces — trimmed-Brep export and enhanced trimmed import with the optional
trim3dmextension, 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 (
importForms3DMprototype), and the Forms export test cases.
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.
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 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 thatimport3DMproduces. -
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.
The gallery below reflects import3DM 0.5.0 (2026-09-08), which resolves the previously tracked issues #4 … #10:
-
#4 Points — Rhino
Point/PointCloudimport as visiblePoints::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_surfacescontains 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.Shellsewing is capped byImportSewFaceLimit(default 8); larger Breps import as a valid compound, sov5_ring/v4_DVDCase_Solidno 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.