Skip to content

Editing and arranging

3D models and depth maps

Import an STL, OBJ, 3MF, AMF, PLY or OFF model and turn it into a 16-bit depth map: orient it, size it to the stock, insert it, edit it later.

Dusty imports 3D models — STL (binary or text), OBJ, 3MF, AMF (compressed or not), PLY (text or binary) and OFF — and turns them into a depth map: a grayscale image seen from above, white for the highest point of the model, black for the lowest point and the background. It is used by 3D relief: relief roughing machines it; finishing is not available yet. Choose the file with File › Import… (or drop it on the canvas): the Import 3D Model window opens; nothing is placed before Insert.

The preview shows the model as the map will capture it: seen from above, lit at an angle so its relief can be read, with the stock dashed at the same scale. It updates with every setting.

  • Rotate the model: drag in the preview (to the right, its top tips to the right; downward, toward the front). Dusty Studio: the arrow keys too.
  • Pan the view: drag with the middle button, or with Shift (Dusty Studio); on Mac, iPad and iPhone, choose Pan the View above the preview, then drag.
  • Zoom the view: scroll wheel, or pinch (trackpad, touch screen); + and − on the keyboard in Dusty Studio. Zoom to Model resets the view.
  • Scale the model: scroll wheel with Ctrl or ⌘ (Dusty Studio), or the size fields.
  • Help: the card of these gestures, over the preview.

Orientation

Viewpoint menu — the faces (top, bottom, front, back, left and right sides), the top tilted 45° forward, backward, left or right, and four isometric views —, Rotation X, Y, Z fields (in degrees: around X, then Y, then Z, the stock’s axes), Reset Rotation.

Size

Size X, Y, Z of the oriented model — X and Y are the size of the map placed on the drawing, Z the thickness of the relief —, as measurements or as a percentage of the file’s size. Uniform Scale (the padlock): changing one size changes all three; without it, each axis is free (to flatten a relief in Z, for example). Fit to Stock: the largest size, proportions kept, that fits within the stock’s width and depth; Reset Size: the file’s size; Reset All: the file’s size and orientation. A model larger than the stock is reduced to fit when it opens; a relief thicker than the stock is reported. Below the sizes, the size of the map in pixels: 10 pixels per millimeter, reduced if needed (6,000 pixels per side and 36 million pixels at most).

Depth Map Settings… shows the map that will be placed and its settings (resolution, 8 or 16 bits, transparent background, inversion, equalization, cutoff, closed outline: see Depth map settings); Edit 3D Model goes back to the model. Insert places the map at the center of the stock, on an image layer, as a single undoable action (⌘Z); Cancel closes the window without changing anything.

Edit 3D Model… (Draw menu, context menu, image properties) reopens the window on the selected map, with the settings that made it; Insert then replaces its map, in place, as one undoable action. The model’s file and its settings are saved with the project (compressed in the .dusty); a copy of the map (duplicate, paste) can be edited too. A project opened by a version of Dusty from before 3D model import shows the map there as an ordinary grayscale image; if it is saved there, the map can no longer be edited.

Limits

Files of 256 MB and 4 million triangles at most (simplify a more detailed model in a slicer or 3D software); 3MF and AMF archives of 512 MB at most once decompressed. A damaged or truncated file is refused with a message that names it. Support objects of a 3MF are left out; placed copies of an AMF (constellations) are not followed. A model that is flat seen from above (standing on its edge) gives no map: choose another viewpoint. A model with holes or not closed gives a map with holes: repair it first in a slicer. 3D models in a MillMage project are not imported: import the model’s file.

Differences from MillMage: the preview is seen from above, like the map, not in perspective.

This manual is also built into Dusty: press F1, or open the Help menu, to read the topic for what you are doing. A mistake, a missing answer? Tell us

Try it in Dusty, for free.

Free CNC milling software: design, toolpaths and machine control. Mac, iPad, iPhone, Windows and Linux.