Goxel

Version 0.12.0

By Guillaume Chereau [email protected]

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.

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.

Changes in this fork

- Tools
    - New doodad placer tool - select a file and place it at will
        - Can rotate the imported voxels non-destructively, offset from an origin point
        - Copy the current selection into the placer
        - Cut the current selection into the placer
    - Selection tool
        - Holding 'shift' temporarily switches to 'move' rather than 'resize' mode
        - 'Select entire layer' button
        - Copy the current selection into the placer
        - Cut the current selection into the placer
    - Brush can set width/height/depth separately
    - Move tool can do 'destructive rotation'
- Layers
    - Layers panel permanently on right and scrolls internally
    - Merge layer down
- Colours
    - Colour picker also integrated directly into the tools panel for tools like the brush
    - Blend mode added
        - User = the user's chosen color
        - Inherited = the colour of the block beneath
        - Interpolated = USER <> INHERITED, the midpoint
- Camera
    - First person camera (#)
        - Arrow keys for forward/back/left/right, Page Up/Down for up/down, RMB or MMB for look
        - Speed
        - FOV
        - Manual X/Y/Z
    - Rotational camera (default) FOV setting (and its base value is higher than it was before)
- Image
    - "Crop to visible & reset origin", uses only visible layers, crops to the size of those layers, resets the origin
- Import/Export
    - Heightmap export .bmp file in greyscale, z0 = black, (zN = 8 + ((zN-1) * 4) = max 64 height
    - Colourmap export .bmp file
    - voxlap import (e.g. kvx) no longer retains bounding box bg on import
    - Imports now automatically add to a new layer, which is named after the file
- Hotkeys
    - Move plane up/down = < >
    - Plane visibility = /
    - FPV Camera = #
    - Select layer under cursor = '
- UI
    - Always add arrows to number fields < >

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