# 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).

# 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_060_c2p).
Screen resolution: 320x256x8

## Program arguments

voxelspace [ARGUMENTS]...
arguments:
-h, --help              print help message and exit
-w, --world <number>    select world 1, 2, 3, 4 or 5 (default 1)
-d, --demo              enable demo 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

- 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!

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  811    1534  52.9% -lh5- ab92 Feb 23 10:37 voxelspace.info
[generic]               574942 1048584  54.8% -lh5- 77b9 Dec 19 10:27 voxelspace/assets/fifth_color_map_8bit.dat
[generic]                 1067    2680  39.8% -lh5- ae3a Dec 15 17:18 voxelspace/assets/fifth_color_map_palette.dat
[generic]               466586 1048584  44.5% -lh5- e21e Dec 15 17:18 voxelspace/assets/fifth_height_map.dat
[generic]                94293  614408  15.3% -lh5- 17a0 Dec 15 17:18 voxelspace/assets/fifth_sky.dat
[generic]                26278  153608  17.1% -lh5- 3576 Dec 15 17:18 voxelspace/assets/fifth_sky_lowres.dat
[generic]               378786 1048584  36.1% -lh5- 0589 Dec 19 10:27 voxelspace/assets/first_color_map_8bit.dat
[generic]                  706    2260  31.2% -lh5- 435f Dec 15 17:18 voxelspace/assets/first_color_map_palette.dat
[generic]               219323 1048584  20.9% -lh5- 4f5a Dec 15 17:18 voxelspace/assets/first_height_map.dat
[generic]                94293  614408  15.3% -lh5- f8b0 Dec 15 17:18 voxelspace/assets/first_sky.dat
[generic]                26278  153608  17.1% -lh5- 5bc6 Dec 15 17:18 voxelspace/assets/first_sky_lowres.dat
[generic]               647140 1048584  61.7% -lh5- 8b39 Dec 15 17:18 voxelspace/assets/fourth_color_map_8bit.dat
[generic]                 1053    2608  40.4% -lh5- cae0 Dec 15 17:18 voxelspace/assets/fourth_color_map_palette.dat
[generic]               325793 1048584  31.1% -lh5- 0cbf Dec 15 17:18 voxelspace/assets/fourth_height_map.dat
[generic]                94293  614408  15.3% -lh5- 638e Dec 15 17:18 voxelspace/assets/fourth_sky.dat
[generic]                26278  153608  17.1% -lh5- cacd Dec 15 17:18 voxelspace/assets/fourth_sky_lowres.dat
[generic]               607991 1048584  58.0% -lh5- 5127 Dec 15 17:18 voxelspace/assets/second_color_map_8bit.dat
[generic]                 1208    2980  40.5% -lh5- 7ecd Dec 15 17:18 voxelspace/assets/second_color_map_palette.dat
[generic]               281558 1048584  26.9% -lh5- bf8b Dec 15 17:18 voxelspace/assets/second_height_map.dat
[generic]                94286  614408  15.3% -lh5- 158c Dec 15 17:18 voxelspace/assets/second_sky.dat
[generic]                26273  153608  17.1% -lh5- e1da Dec 15 17:18 voxelspace/assets/second_sky_lowres.dat
[generic]               413839 1048584  39.5% -lh5- bec4 Dec 15 17:18 voxelspace/assets/third_color_map_8bit.dat
[generic]                  928    2776  33.4% -lh5- 9565 Dec 15 17:18 voxelspace/assets/third_color_map_palette.dat
[generic]               256353 1048584  24.4% -lh5- 8b88 Dec 15 17:18 voxelspace/assets/third_height_map.dat
[generic]                94286  614408  15.3% -lh5- 8c85 Dec 15 17:18 voxelspace/assets/third_sky.dat
[generic]                26278  153608  17.1% -lh5- 8b29 Dec 15 17:18 voxelspace/assets/third_sky_lowres.dat
[generic]                93860   93860 100.0% -lh0- 173f Dec 15 17:18 voxelspace/screenshots/voxelspace_world_1.png
[generic]                81017   81017 100.0% -lh0- 0f99 Dec 15 17:18 voxelspace/screenshots/voxelspace_world_2.png
[generic]                82733   82733 100.0% -lh0- 6fac Dec 15 17:18 voxelspace/screenshots/voxelspace_world_3.png
[generic]               118009  118009 100.0% -lh0- 0f55 Dec 15 17:18 voxelspace/screenshots/voxelspace_world_4.png
[generic]               111559  111559 100.0% -lh0- 2795 Dec 15 17:18 voxelspace/screenshots/voxelspace_world_5.png
[generic]                 1677    3588  46.7% -lh5- 038c Feb 23 07:37 voxelspace/voxelspace.readme
[generic]                29318   69948  41.9% -lh5- 91ad Feb 21 16:43 voxelspace/voxelspace_030_c2p
[generic]                31823   65600  48.5% -lh5- 326f Feb 21 15:53 voxelspace/voxelspace_060
[generic]                32052   66052  48.5% -lh5- 4358 Feb 21 15:54 voxelspace/voxelspace_060_c2p
[generic]                64257  146144  44.0% -lh5- aa14 Feb 21 15:53 voxelspace/voxelspace_mos_gcc
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        36 files 5427225 15179268  35.8%            Feb 24 00:16