# About

This is a little technical demo of a voxelspace renderer written in C99,
inspired by Comanche.
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.14.  
  You will need a 640x480x8 screen mode.
* AmigaOs: Tested on Amiga 4000T, 060, Cybervision 64/3D, Aos 3.2.3 and  
                     Amiga 1200, 060, AGA, Aos 3.2.3.  
  Requires c2p.library from aminet (https://aminet.net/dev/misc/c2plib.lha).
* Linux: tested on Ubuntu 20.10 (amd64)  
  It requires X11 server.

# Usage

Please start the binary 
(voxelspace_mos_gcc, voxelspace_060, voxelspace_060_c2p) from your 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.  
On Amiga with aga only, you should use voxelspace_060_c2p.  
This requires c2p.library (>=1.7) from aminet
(https://aminet.net/dev/misc/c2plib.lha).

## 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 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 Oct 26 06:53 voxelspace.info
[generic]               574942 1048584  54.8% -lh5- 77b9 Oct  4 16:27 voxelspace/assets/fifth_color_map_8bit.dat
[generic]                 1067    2680  39.8% -lh5- ae3a Oct  4 16:27 voxelspace/assets/fifth_color_map_palette.dat
[generic]               466586 1048584  44.5% -lh5- e21e Oct  4 16:27 voxelspace/assets/fifth_height_map.dat
[generic]                94293  614408  15.3% -lh5- 17a0 Oct  4 16:27 voxelspace/assets/fifth_sky.dat
[generic]                26278  153608  17.1% -lh5- 3576 Oct  4 16:27 voxelspace/assets/fifth_sky_lowres.dat
[generic]               378786 1048584  36.1% -lh5- 0589 Oct  4 16:27 voxelspace/assets/first_color_map_8bit.dat
[generic]                  706    2260  31.2% -lh5- 435f Oct  4 16:27 voxelspace/assets/first_color_map_palette.dat
[generic]               219323 1048584  20.9% -lh5- 4f5a Oct  4 16:27 voxelspace/assets/first_height_map.dat
[generic]                94293  614408  15.3% -lh5- f8b0 Oct  4 16:27 voxelspace/assets/first_sky.dat
[generic]                26278  153608  17.1% -lh5- 5bc6 Oct  4 16:27 voxelspace/assets/first_sky_lowres.dat
[generic]               647140 1048584  61.7% -lh5- 8b39 Oct  4 16:27 voxelspace/assets/fourth_color_map_8bit.dat
[generic]                 1053    2608  40.4% -lh5- cae0 Oct  4 16:27 voxelspace/assets/fourth_color_map_palette.dat
[generic]               325793 1048584  31.1% -lh5- 0cbf Oct  4 16:27 voxelspace/assets/fourth_height_map.dat
[generic]                94293  614408  15.3% -lh5- 638e Oct  4 16:27 voxelspace/assets/fourth_sky.dat
[generic]                26278  153608  17.1% -lh5- cacd Oct  4 16:27 voxelspace/assets/fourth_sky_lowres.dat
[generic]               607991 1048584  58.0% -lh5- 5127 Oct  4 16:27 voxelspace/assets/second_color_map_8bit.dat
[generic]                 1208    2980  40.5% -lh5- 7ecd Oct  4 16:27 voxelspace/assets/second_color_map_palette.dat
[generic]               281558 1048584  26.9% -lh5- bf8b Oct  4 16:27 voxelspace/assets/second_height_map.dat
[generic]                94286  614408  15.3% -lh5- 158c Oct  4 16:27 voxelspace/assets/second_sky.dat
[generic]                26273  153608  17.1% -lh5- e1da Oct  4 16:27 voxelspace/assets/second_sky_lowres.dat
[generic]               163660  921608  17.8% -lh5- 415c Oct  4 16:27 voxelspace/assets/sky.dat
[generic]                   29     100  29.0% -lh5- 9913 Oct  4 16:27 voxelspace/assets/texture_8bit_palette.dat
[generic]               413839 1048584  39.5% -lh5- bec4 Oct  4 16:27 voxelspace/assets/third_color_map_8bit.dat
[generic]                  928    2776  33.4% -lh5- 9565 Oct  4 16:27 voxelspace/assets/third_color_map_palette.dat
[generic]               256353 1048584  24.4% -lh5- 8b88 Oct  4 16:27 voxelspace/assets/third_height_map.dat
[generic]                94286  614408  15.3% -lh5- 8c85 Oct  4 16:27 voxelspace/assets/third_sky.dat
[generic]                26278  153608  17.1% -lh5- 8b29 Oct  4 16:27 voxelspace/assets/third_sky_lowres.dat
[generic]                93860   93860 100.0% -lh0- 173f Oct  4 16:27 voxelspace/screenshots/voxelspace_world_1.png
[generic]                81017   81017 100.0% -lh0- 0f99 Oct  4 16:27 voxelspace/screenshots/voxelspace_world_2.png
[generic]                82733   82733 100.0% -lh0- 6fac Oct  4 16:27 voxelspace/screenshots/voxelspace_world_3.png
[generic]               118009  118009 100.0% -lh0- 0f55 Oct  4 16:27 voxelspace/screenshots/voxelspace_world_4.png
[generic]               111559  111559 100.0% -lh0- 2795 Oct  4 16:27 voxelspace/screenshots/voxelspace_world_5.png
[generic]                 1602    3449  46.4% -lh5- b0ec Oct 26 06:53 voxelspace/voxelspace.readme
[generic]                30499   60468  50.4% -lh5- 05bf Oct 23 20:17 voxelspace/voxelspace_060
[generic]                30707   60916  50.4% -lh5- 2fff Oct 23 20:17 voxelspace/voxelspace_060_c2p
[generic]                62660  140228  44.7% -lh5- 58ef Oct  4 16:34 voxelspace/voxelspace_mos_gcc
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        37 files 5557255 16014705  34.7%            Oct 26 22:29