Skip to content

Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.

Guide and notes: Edit > Preferences paths

islandmed24b140fbd124
diff --git a/changes/feat-real-world-units.md b/changes/feat-real-world-units.md
index fd60ad8a..b6f5e182 100644
--- a/changes/feat-real-world-units.md
+++ b/changes/feat-real-world-units.md
@@ -1,9 +1,9 @@
---
whats_new: **Real-world size**: parts for 3D printing keep their size through every export. Pick the unit sizes show in
- (mm, cm, m, in) in **Preferences > Interface > Units**; **Tool** shows the Part's size and **File** the size exports
+ (mm, cm, m, in) in **Edit > Preferences > Interface > Units**; **Tool** shows the Part's size and **File** the size exports
write. OBJ and PLY files can be read in mm, cm, m or in (**OBJ/PLY in**). Asked for by @Swar55.
highlight: Parts keep their real-world size, in mm, cm, m or in
-added: **Units** (Preferences > Interface, #148, thanks @Swar55): sizes show in mm, cm, m or inches: the brush size,
+added: **Units** (Edit > Preferences > Interface, #148, thanks @Swar55): sizes show in mm, cm, m or inches: the brush size,
the active Part's width x height x depth under its name in Tool, and the size exports write in File > Import /
Export. **OBJ/PLY in** reads the numbers in OBJ and PLY files (which have no units) as mm, cm, m (the default) or
inches; `open`, `open_obj` and `part_append` take `unit=` for scripts, and STL files may be read as inches too.
@@ -16,8 +16,8 @@ fixed: USD files in centimetres (`metersPerUnit = 0.01`, as Maya and Houdini wri
testers:
- Open an STL from your slicer (e.g. a 20 mm calibration cube): Tool shows 20 x 20 x 20 mm. File > Export OBJ and
Export STL, open both in the slicer: both are 20 mm.
- - Preferences > Interface > Units > in: Tool and the brush size read in inches; restart, it is kept.
- - Preferences > Interface > OBJ/PLY in > mm, open an OBJ made for printing (numbers in mm): Tool shows its mm size;
+ - Edit > Preferences > Interface > Units > in: Tool and the brush size read in inches; restart, it is kept.
+ - Edit > Preferences > Interface > OBJ/PLY in > mm, open an OBJ made for printing (numbers in mm): Tool shows its mm size;
Export STL; the slicer shows the same size.
- A .usda from Maya (centimetres): opens at its real size (a 180 cm figure is 1.8 m, not 180 m).
---
diff --git a/docs/guide/exporting.md b/docs/guide/exporting.md
index a003edef..67a530b9 100644
--- a/docs/guide/exporting.md
+++ b/docs/guide/exporting.md
@@ -65,10 +65,10 @@ A part keeps the size it was opened with through every export:
- OBJ, PLY and STL have no units. A scene opened from one of them remembers its unit: exporting OBJ or PLY writes
that unit back (an STL opened in millimetres exports a 50 mm OBJ, not 0.05), and an STL written from an STL
keeps its numbers. Decimal sizes come back exactly (12.7 stays 12.7). Projects remember the unit.
-- **Preferences > Interface > OBJ/PLY in** says what OBJ and PLY numbers mean: **m** (the default; Blender and game
+- **Edit > Preferences > Interface > OBJ/PLY in** says what OBJ and PLY numbers mean: **m** (the default; Blender and game
tools), or **mm** for files made for 3D printing, **cm** or **in**. STL is always read as millimetres. From
scripts: `open path=part.obj unit=mm` (`open_obj` and `part_append` take `unit=` too; `unit=in` reads an inch STL).
-- **Preferences > Interface > Units** picks the unit sizes show in: mm, cm, m or in. The active Part's width x
+- **Edit > Preferences > Interface > Units** picks the unit sizes show in: mm, cm, m or in. The active Part's width x
height x depth shows under its name in **Tool**, the size the exports write in **File** (Import / Export), and the
brush size by the brush ring.