[binvox] 3D mesh voxelizer
binvox thinvox viewvox meshconv
Introductionbinvox is a straight-forward program that reads a 3D model file, rasterizes it into a binary 3D voxel grid, and writes the resulting voxel file.
- input formats:
- nearly 100% VRML 2.0 support
- will parse Wavefront OBJ, Geomview OFF, Autocad DXF,
PLY and STL, if they contain polygons only
VRML 1.0 support added in version 1.08 (still in alpha) (Unigrafix UG, VTK, XGL, PovRay POV, BREP, and JOT support temporarily disabled, let me know if you really need this)
- output formats:
- runs fast if you have a current graphics card
- rasterizes to a cube grid of up to 1024x1024x1024 (if you have enough memory...)
Downloadversion 1.20, added 2 February 2014
Older source code of binvox and thinvox is available for download: binvox-0.4.tar.gz. The source compiles under Linux, Mac OS X, and Windows. You most likely need to compile GLUT to a library first: download the GLUT source here. Let me know if you run into compilation problems. The source code is released under the GNU General Public License. Note that the open source version of binvox only reads the OBJ and PLY 3D file formats (more formats to follow).
New in the Linux version: the -pb parameter, which makes binvox render to an offscreen buffer instead of to an onscreen window (if available). This increases the maximum dimension of the voxel grid from 1024 to 4096, depending of course on how much memory your system has (the memory use is dominated by the voxel grid, 1 byte per voxel).
- Linux 64 bit executable
compiled under CentOS 6.4, 64-bit, let me know if it doesn't work for you
- Mac OS X 10.10 executable
compiled under Mavericks, OS X 10.10.1, using the Xcode tools
Note that for newer versions of OS X, X11 has disappeared. You'll have to install XQuarts before you can run binvox
- 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.
(the binaries have been compressed to about 300K using the UPX executable compressor)(they are self-decompressing)
UsageRun binvox without parameters for a usage summary.
Normally you'd run binvox on your own PC, where it will use your installed graphics card.
To run binvox on a headless server instead, either:
- use a persistent display server
To start a virtual screen, run:
Xvfb :99 -screen 0 640x480x24 &
setenv DISPLAY :99 (or, if you're running bash, do: export DISPLAY=:99)
Then run binvox with the -pb option
- use a one time display server instance
xvfb-run -s "-screen 0 640x480x24" ./binvox -pb my_model.stl
(thanks to @vineet7kumar for figuring this out)
CreditIf you use binvox for your (published) work, please add a reference to me, to this site (as a link, you could use http://www.google.com/search?q=binvox), and to the paper by F. Nooruddin and G. Turk (see next paragraph). Unfortunately I've already seen one recent scientific paper using my software without proper credit. I'd love to hear what you use binvox for as well.
Note that binvox is free to download and use (in any environment). However, you are not allowed to charge others for the program. Type binvox -license for more information.
Eric Haines contributed the code for the exact voxelization method.
Qingnan Zhou wrote the code for the Gmsh .msh output.
binvox uses the lib3ds library for reading .3ds files.
Referencesbinvox uses the parity count method and (a slight variation of) the ray stabbing method described by Fakir Nooruddin and Greg Turk in Simplification and Repair of Polygonal Models Using Volumetric Techniques, GVU technical report 99-37 (later published in IEEE Trans. on Visualization and Computer Graphics, vol. 9, nr. 2, April 2003, pages 191-205). To speed up the parity counting, a hardware z-buffer "slicing" method is used, based on an idea originally by Emil Praun.
- Volumetric Model Repair for Virtual Reality Applications, by Andreas Kolb and Lars John, Eurographics 2001. They describe an implementation of Nooruddin and Turk's method, and convert the resulting voxel models back to 3D meshes.
- A Fast Depth-Buffer-Based Voxelization Algorithm, by Evaggelia-Aggeliki Karabassi, Georgios Papaioannou and Theoharis Theoharis, Journal of Graphics Tools, vol. 4, nr. 4, 1999. Simple z-buffer based carving (as also supported in binvox), and a surface voxelization method.
- Hardware Accelerated Voxelization, by Shiaofen Fang and Hongsheng Chen, Computers and Graphics, vol. 24, nr. 3, pages 433-442, June 2000.
- Complete Polygonal Scene Voxelization, by D. Haumont and N. Warzèe, Journal of Graphics Tools, vol. 7, nr. 3, pages 27-41, 2002.
- vxt, by Milos Sramek, is a tool for anti-aliased voxelization.
- Single-pass GPU solid voxelization for real-time applications, by Elmar Eisemann and Xavier Décoret. They present a very fast method for voxelizing watertight models.
FeedbackPlease send me e-mail (to patrick.n.min at gmail dot com) with your questions/comments/suggestions/bug reports. I'm also interested to hear about what you use binvox for.
Note that because of differences in hardware and software (drivers, the OpenGL implementation on your OS, etc.) the resulting voxel model will probably differ slightly from one setup to another.