[viewvox]   3D voxel model viewer

---

binvox     thinvox     viewvox     meshconv    

---

Introduction

viewvox is a program that reads a 3D voxel file as produced by binvox or thinvox and shows it in a window. You can then use the mouse to move the camera around the model.

• input formats:
  
  • .binvox, as produced by the binvox 3D mesh voxelizer
  • MIRA
  • nrrd

Download

version 0.50, added 21 April 2023

• Linux 64 bit executable
  compiled under Rocky Linux 8.6, 64-bit, let me know if it doesn't work for you
  
  For (slightly) older distributions, here's a version compiled with CentOS 6.3:
  Linux 64 bit
  
  
• Mac OS X 10.14 executable
  compiled under Ventura, OS X 13.2 Ventura, let me know if it doesn't work for you
  Note that for newer versions of OS X, X11 has disappeared. See the binvox page for more info.
  
  
• Windows executable
  compiled using a cross compiler You also need to have GLUT installed (or at least have glut32.dll somewhere in your PATH). This executable also runs under Linux using Wine.

Usage

viewvox   [-ki] <model filename>

-ki: keep internal voxels (removed by default) -fps: print fps (frames per second) info to console Mouse left button = rotate middle = pan right = zoom Key r = reset view arrow keys = move 1 voxel step along x (left, right) or y (up, down) =,- = move 1 voxel step along z q = quit a = toggle alternating colours p = toggle between orthographic and perspective projection u = set z axis up r = reset camera x, y, z = set camera looking down X, Y, or Z axis X, Y, Z = set camera looking up X, Y, or Z axis 1 = toggle show x, y, and z coordinates 6 = toggle thick grid lines every 4/16 voxels s = show single slice n = show both/above/below slice neighbour(s) t = toggle neighbour transparency j = move slice down k = move slice up G = toggle show grid g = toggle show grid at slice level Alt + g = change grid orientation A lot of the key commands were added to make viewvox more useful when building voxel models in minecraft.

Feedback

Please send me e-mail (to patrick.n.min at gmail dot com) with your questions, comments, suggestions, bug reports, etc.

---

Feature requests

• better rotational viewing (using quaternions)
• "free roam" interface (to be able to zoom in on any part)

---

Changelog

0.50: added -fps frames per second info feature (21 April 2023)
0.49: a bug fix for Windows only, viewvox hangs when running delete[] after adding border (17 March 2023)
0.48: added feature to toggle between 4 and 16 voxels step size for thick grid lines (22 January 2023)
0.47: updated support for reading NRRD files as produced by binvox and thinvox (8 March 2021)
0.46: updated info about certain key functions (27 June 2020)
0.45: added support for changing the grid orientation by pressing Alt + g (29 December 2017)
0.44: proper error message when voxel memory cannot be allocated (8 May 2016)
0.43: fixed bug when visualizing models with non-equal dimensions (7 Mar 2015)
0.42: orthographic mode properly restored, reasonable behaviour when using arrow and zoom in/out (-/=) keys in orthographic mode, window size now also saved and restored (10 Nov 2012)

Patrick Min