Skip to content

Import, Export & 3D Printing

crisprintsstuff edited this page Nov 5, 2026 · 1 revision

Import, Export & 3D Printing

OxyBrush is engineered for high interoperability with the wider 3D ecosystem, including Blender, Unreal Engine, Unity, Godot, ZBrush, and all major 3D printing slicers (Bambu Studio, PrusaSlicer, OrcaSlicer, Cura, and Lychee).


Supported File Formats

Format Extension Import Export Features Supported
glTF 2.0 / GLB .gltf, .glb Yes Yes High performance, vertex colors (COLOR_0), hierarchy, PBR materials.
Wavefront OBJ .obj Yes Yes Universal compatibility, quad/triangle meshes, extended vertex colors, MTL materials.
Stereolithography .stl Yes Yes Standard 3D printing format (Binary and ASCII).
Polygon File Format .ply Yes Yes Full-color 3D scan data, point clouds, per-vertex RGBA colors.
OxyBrush Native .oxy Yes Yes Preserves full multiresolution subdivision hierarchy, layers, and undo states.

Preparing Models for 3D Printing

Whether printing on an FDM printer (like a Bambu Lab X1 or Prusa MK4) or an SLA resin printer (like an Elegoo Saturn or Anycubic Photon), follow these steps to guarantee clean, fail-safe prints:

1. Ensure Watertight (Manifold) Geometry

3D slicers require a continuous, closed outer surface with no holes, inverted normals, or internal intersecting geometry.

  • If you built your sculpt using multiple overlapping pieces (e.g. eyes, teeth, horns, clothing):
    1. Open the Mesh / Topology panel.
    2. Select all pieces in the outliner.
    3. Click Voxel Union (Ctrl + R).
    4. OxyBrush will dissolve all interior geometry and generate a single, continuous, 100% watertight shell.

2. Flatten the Base for Bed Adhesion

A flat base eliminates the need for messy supports under the contact plate:

  1. Select the Planar Trim brush.
  2. Hold Ctrl or Shift to constrain the cut plane horizontally.
  3. Slice across the bottom of the sculpt to create a flat base.

3. Decimate to Slicer-Friendly Polycounts

Modern slicing software does not need 10 million polygons. In fact, meshes over 2 million polygons cause slicer stuttering without improving the physical print resolution (since the printer's mechanical stepper motors cannot resolve sub-micron facets).

  • Recommended target for 3D printing: 200,000 to 1,000,000 triangles.
  • Use the Quadric Decimation tool in OxyBrush to reduce the mesh by 70%–90%. Silhouettes and sharp features will remain crisp.

4. Exporting as STL or 3MF

  • Go to File > Export > STL (.stl).
  • Choose Binary STL for compact file size.
  • Open directly in your preferred slicer.

Game Engine & Animation Pipeline

When preparing models for Unreal Engine 5, Unity, or Godot:

  1. Step down to Base Multires Level (Shift + D): Export the low-poly base mesh as .obj or .glb for rigging and UV unwrapping.
  2. Export High-Poly (D to maximum): Export the high-poly version to bake Normal, Ambient Occlusion, and Curvature maps in Marmoset Toolbag, Substance Painter, or Blender.
  3. Vertex Color Albedo: If you painted colors in OxyBrush, export as .glb—game engines will automatically load the vertex colors into their material shaders without requiring a separate diffuse texture map.

Headless Batch Processing (oxybrush-cli)

For automated production pipelines and game studios, OxyBrush provides a standalone headless command-line tool: oxybrush-cli.

Installation

oxybrush-cli is included in all official release archives and can be run without launching a graphical window or requiring a GPU display server.

CLI Usage Examples

1. Decimating Meshes in Batch

oxybrush-cli decimate input_sculpt.obj output_lowpoly.obj --target-triangles 50000

2. Voxel Remeshing

oxybrush-cli remesh raw_scan.stl cleaned_watertight.stl --voxel-size 0.015

3. Format Conversion

Convert between any supported formats:

oxybrush-cli convert character.glb character.stl
oxybrush-cli convert scan.ply model.obj

4. Automated LOD Chain Script

You can automate LOD generation across an entire assets directory with a simple bash loop:

for file in assets/*.obj; do
  base=$(basename "$file" .obj)
  oxybrush-cli decimate "$file" "lods/${base}_lod1.obj" --ratio 0.50
  oxybrush-cli decimate "$file" "lods/${base}_lod2.obj" --ratio 0.20
  oxybrush-cli decimate "$file" "lods/${base}_lod3.obj" --ratio 0.05
done

Clone this wiki locally