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

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                    811    1534  52.9% -lh5- ab92 Jul 18 12:41 voxelspace.info
[Amiga]                 574942 1048584  54.8% -lh5- 77b9 Jan  9  2022 voxelspace/assets/fifth_color_map_8bit.dat
[Amiga]                   1067    2680  39.8% -lh5- ae3a Nov  6  2024 voxelspace/assets/fifth_color_map_palette.dat
[Amiga]                 466586 1048584  44.5% -lh5- e21e Jan  9  2022 voxelspace/assets/fifth_height_map.dat
[Amiga]                  94293  614408  15.3% -lh5- 17a0 Nov  9  2024 voxelspace/assets/fifth_sky.dat
[Amiga]                  26278  153608  17.1% -lh5- 3576 Dec 11  2024 voxelspace/assets/fifth_sky_lowres.dat
[Amiga]                 378786 1048584  36.1% -lh5- 0589 Jan  9  2022 voxelspace/assets/first_color_map_8bit.dat
[Amiga]                    706    2260  31.2% -lh5- 435f Nov  6  2024 voxelspace/assets/first_color_map_palette.dat
[Amiga]                 219323 1048584  20.9% -lh5- 4f5a Jan  9  2022 voxelspace/assets/first_height_map.dat
[Amiga]                  94293  614408  15.3% -lh5- f8b0 Nov  9  2024 voxelspace/assets/first_sky.dat
[Amiga]                  26278  153608  17.1% -lh5- 5bc6 Dec 11  2024 voxelspace/assets/first_sky_lowres.dat
[Amiga]                 647140 1048584  61.7% -lh5- 8b39 Jan  9  2022 voxelspace/assets/fourth_color_map_8bit.dat
[Amiga]                   1053    2608  40.4% -lh5- cae0 Nov  6  2024 voxelspace/assets/fourth_color_map_palette.dat
[Amiga]                 325793 1048584  31.1% -lh5- 0cbf Jan  9  2022 voxelspace/assets/fourth_height_map.dat
[Amiga]                  94293  614408  15.3% -lh5- 638e Nov  9  2024 voxelspace/assets/fourth_sky.dat
[Amiga]                  26278  153608  17.1% -lh5- cacd Dec 11  2024 voxelspace/assets/fourth_sky_lowres.dat
[Amiga]                 607991 1048584  58.0% -lh5- 5127 Jan  9  2022 voxelspace/assets/second_color_map_8bit.dat
[Amiga]                   1208    2980  40.5% -lh5- 7ecd Nov  6  2024 voxelspace/assets/second_color_map_palette.dat
[Amiga]                 281558 1048584  26.9% -lh5- bf8b Jan  9  2022 voxelspace/assets/second_height_map.dat
[Amiga]                  94286  614408  15.3% -lh5- 158c Nov  9  2024 voxelspace/assets/second_sky.dat
[Amiga]                  26273  153608  17.1% -lh5- e1da Dec 11  2024 voxelspace/assets/second_sky_lowres.dat
[Amiga]                 413839 1048584  39.5% -lh5- bec4 Jan  9  2022 voxelspace/assets/third_color_map_8bit.dat
[Amiga]                    928    2776  33.4% -lh5- 9565 Nov  6  2024 voxelspace/assets/third_color_map_palette.dat
[Amiga]                 256353 1048584  24.4% -lh5- 8b88 Jan  9  2022 voxelspace/assets/third_height_map.dat
[Amiga]                  94286  614408  15.3% -lh5- 8c85 Nov  9  2024 voxelspace/assets/third_sky.dat
[Amiga]                  26278  153608  17.1% -lh5- 8b29 Dec 11  2024 voxelspace/assets/third_sky_lowres.dat
[Amiga]                  93860   93860 100.0% -lh0- 173f Dec 12  2025 voxelspace/screenshots/voxelspace_world_1.png
[Amiga]                  81017   81017 100.0% -lh0- 0f99 Dec 12  2025 voxelspace/screenshots/voxelspace_world_2.png
[Amiga]                  82733   82733 100.0% -lh0- 6fac Dec 12  2025 voxelspace/screenshots/voxelspace_world_3.png
[Amiga]                 118009  118009 100.0% -lh0- 0f55 Dec 12  2025 voxelspace/screenshots/voxelspace_world_4.png
[Amiga]                 111559  111559 100.0% -lh0- 2795 Dec 12  2025 voxelspace/screenshots/voxelspace_world_5.png
[Amiga]                   1740    3759  46.3% -lh5- 90a5 Jul 18 12:40 voxelspace/voxelspace.readme
[Amiga]                  29384   70164  41.9% -lh5- 429f Jul 18 12:41 voxelspace/voxelspace_030_c2p
[Amiga]                  32030   66112  48.4% -lh5- a11e Jul 18 12:41 voxelspace/voxelspace_060
[Amiga]                  32171   66368  48.5% -lh5- 4d67 Jul 18 12:41 voxelspace/voxelspace_060_c2p
[Amiga]                  71096  154820  45.9% -lh5- 9fcb Jul 18 12:41 voxelspace/voxelspace_mos
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        36 files 5434519 15189159  35.8%            Jul 19 00:12