voxelspace 1.0

Technical demo of a voxelspace renderer

Short:        Technical demo of a voxelspace renderer
Author:       eliot@exdev.de (Andre Geisler)
Uploader:     eliot exdev de (Andre Geisler)
Type:         misc/misc
Version:      1.0
Replaces:     misc/misc/voxelspace.lha
Requires:     dev/misc/c2plib.lha
Architecture: m68k-amigaos >= 3.1.4; ppc-morphos
Distribution: Aminet
Kurz:         Technische Demo eines Voxel Renderers
URL:          https://github.com/eliot-exdev/exdev-gfx

# About

This is a little technical demo of a voxelspace renderer written in C99.
It was created for testing purposes and private research only.
Currently I cannot say how it will develop in the future.

This demo provides five different worlds taken from the game Comanche
developed by Novalogic.

- World 1: pyramid
- World 2: desert
- World 3: winter
- World 4: canyon
- World 5: rocky

You can select them by passing program arguments.

Have fun!

# Requirements

* MorphOs: any MorphOs system should work.
  Tested it on a Mac Mini G4 Silent Upgrade with MorphOs 3.19.
  You will need a 640x480x8 screen mode.
* AmigaOs:
  Tested on Amiga 4000T, 060, Cybervision 64/3D, AmigaOs 3.2.3 and
                  Amiga 1200, 060, AGA, AmigaOs 3.2.3.
  AGA version requires c2p.library from aminet
  (see https://aminet.net/dev/misc/c2plib.lha).
* Window mode required MorphOs or graphics card (P96)

# Usage

Please start the binary
(voxelspace_mos_gcc, voxelspace_060, voxelspace_060_c2p, voxelspace_030_c2p)
from your Amiga shell.
To get a complete arguments list of the program, please start it with '-h'.
You can quit the program by hitting ESC.

On Amiga with gfx card, you should use voxelspace_060.
Screen resolution: 320x240x8.

On Amiga with AGA only, you should use voxelspace_060_c2p
(or voxelspace_030_c2p).
Screen resolution: 320x256x8

## Program arguments

voxelspace [ARGUMENTS]...
arguments:
 -h, --help              print help message and exit
 -m, --map <number>      select map 1, 2, 3, 4 or 5 (default 1)
 -d, --demo              enable demo mode
 -w, --window            enable window mode
 -v, --version           print version

## Controls

w               move up
s               move down
a               strafe left
d               strafe right
cursors         navigate forward/backward and turn left/right

## Options

ESC                quit
F1                 enable/disable show fps
F2                 max detail
F4                 decrease render distance
F5                 increase render distance

# History
- 1.0 2026-07-18
  - introduced window mode
  - more speed improvements

- 0.9.2 2026-02-21
  - fixed screenmode requester
  - fixed stack issue
  - slightly speed improvements
  - add 68030 executable (no fpu, AGA)

- 0.9.1 2025-10-31
  - changed AGA/C2P resolution to 320x256

- 0.9 2025-06-05
  - optimized sky rendering
  - replaced voxelspace_mos with voxelspace_mos_gcc
    (this is the faster binary)

- 0.8 2025-06-05
  - add AGA support
  - optimizations

- 0.6 2020-12-05 before XMas release
  - fixed crash due float overflow
  - implemented set render quality at runtime (+dither x option)
  - optimized a little bit more
  - implemented strafing left/right
  - add simple font rendering and add first font "mia1"
    (thanks to my daughter)
  - implemented showing frames per second

- 0.5 2020-11-22 8bit release
  - rendering in 8 bit, which should be faster
  - add demo option
  - add 5th world (rocky)
  - add linux version

- 0.4 2020-10-27 Before lockdown release
  - much faster world loading

- 0.3 2020-10-24 Third public release
  - this might be a little bit faster

- 0.2 2020-10-21 Second public release
  - add Amiga 060 binary
  - implemented better key event handling
  - add 4th world (canyon)

- 0.1 2020-10-15 First public release
  - hello world!