Skip to content

guillaumechereau/goxel

Repository files navigation

Goxel

Version 0.15.1

By Guillaume Chereau [email protected]

Build Status DebianBadge

Official webpage: https://goxel.xyz

About

You can use goxel to create voxel graphics (3D images formed of cubes). It works on Linux, BSD, Windows and macOS.

Download

The last release files can be downloaded from there.

Goxel is also available for iOS and Android.

goxel screenshot 0 Fisherman house, made with Goxel by Thibault Simar

Licence

Goxel is released under the GNU GPL3 licence. If you want to use the code with a commercial project please contact me: I am willing to provide a version of the code under a commercial license.

Features

  • 24 bits RGB colors.
  • Unlimited scene size.
  • Unlimited undo buffer.
  • Layers.
  • Marching Cube rendering.
  • Procedural rendering.
  • Export to obj, pyl, png, magica voxel, qubicle.
  • Ray tracing.

Usage

  • Left click: apply selected tool operation.
  • Middle click: rotate the view.
  • right click: pan the view.
  • Left/Right arrow: rotate the view.
  • Mouse wheel: zoom in and out.

Building

The building system uses scons. You can compile in debug with 'scons', and in release with 'scons mode=release'. On Windows, currently possible to build with msys2 or try prebuilt goxel package directly. The code is in C99, using some gnu extensions, so it does not compile with msvc.

Linux/BSD

Install dependencies using your package manager. On Debian/Ubuntu:

- scons
- pkg-config
- libglfw3-dev
- libgtk-3-dev

Then to build, run the command:

make release

Windows

You need to install msys2 mingw, and the following packages:

pacman -S mingw-w64-x86_64-gcc
pacman -S mingw-w64-x86_64-glfw
pacman -S mingw-w64-x86_64-libtre-git
pacman -S scons
pacman -S make

Then to build:

make release

Contributing

In order for your contribution to Goxel to be accepted, you have to sign the Goxel Contributor License Agreement (CLA). This is mostly to allow me to distribute the mobile branch goxel under a non GPL licence.

Also, please read the contributing document.

Donations

I you feel like it, you can support the development of Goxel with a donation at the following bitcoin address: 1QCQeWTi6Xnh3UJbwhLMgSZQAypAouTVrY