Skip to content

gharielsl/voxel-mesh-editor

Repository files navigation

Overview

Visit live demo - Github Pages.

The Voxel Mesh Editor is a tool for creating and editing voxel-based 3D models.

It allows to import and voxelify 3D models, sculpt with voxels, and to smooth out voxel meshes.

Current and future features:

  • Object mode
    • Copy paste
    • Transform
    • Undo
    • Fly controls
  • Voxel mode
    • Add/Remove
    • Spray
    • Select
  • Scene tree and property editor
    • Hide/Show/Select
    • March cubes
    • Transform
    • Voxelify mesh
  • Materials
    • Selection
    • Voxel mesh shader
    • Delete / Replace / Move
  • Import/Export
    • Save/Open
    • Import
  • Misc
    • Measuring
    • First person walk
    • 3d annotations

Controls

General

  • Left Mouse Button + Drag: Orbit.
  • Right Mouse Button + Drag: Fly.
  • Left Mouse Button + W A S D: Fly - move.
  • Shift + Drag: Pan.
  • Tab: Switch between object mode and voxel mode.

Object Mode

  • T: Translate.
  • R: Rotate.
  • G: Scale.
  • F: Select.
  • Del: Delete selected objects.
  • Ctrl + C: Copy selected objects.
  • Ctrl + V: Paste the copied object.

Voxel Mode

  • Left Click: Add a voxel.
  • Right Click: Remove a voxel.
  • Ctrl + Drag: Spray voxels.
  • Alt + Drag: Select voxels.

Voxelifying Imported Mesh

  • On the menu bar select File.
  • Import GLB/GLTF.
  • Select your file.
  • On the properties panel in the bottom right click convert to voxel mesh.

Smoothing Voxel Meshes

  • Select the mesh.
  • On the properties panel tick march cubes.
  • Tick smooth.