johangardhage / amiga-realtime3d

The 3D engine from the book "Amiga Real-Time 3D Graphics"

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

amiga-realtime3d

The 3D engine from the book "Amiga Real-Time 3D Graphics".

Screenshot

Prerequisites

To build and run the Amiga demos, you must first install the following tools:

For cross-compiling the Amiga demos, you can install the following tools:

Install FS-UAE

openSUSE

Follow the instructions here, alternatively download a generic package here

Ubuntu

Follow the instructions here, alternatively download a generic package here

Configuration

  1. Create FS-UAE run-configuration directory

    $ mkdir -p ~/FS-UAE/Configurations
    
  2. Create default Amiga run-configuration files

    Create a file called ~/FS-UAE/Configurations/A1200.fs-uae with the following contents:

    [fs-uae]
    amiga_model = A1200/020
    floppy_drive_volume_empty = 0
    hard_drive_0 = $HOME/FS-UAE/AmigaForever/Amiga Files/Shared/hdf/workbench-311.hdf
    hard_drive_1 = $HOME/FS-UAE/AmigaForever/Amiga Files/Shared/dir/Work
    hard_drive_2 = $HOME/git/github/amiga-realtime3d
    hard_drive_2_label = Sources
    joystick_port_1_mode = nothing
    

    Create a file called ~/FS-UAE/Configurations/A500+.fs-uae with the following contents:

    [fs-uae]
    amiga_model = A500+
    chip_memory = 1024
    floppy_drive_volume_empty = 0
    hard_drive_0 = $HOME/FS-UAE/AmigaForever/Amiga Files/Shared/hdf/workbench-211.hdf
    hard_drive_1 = $HOME/FS-UAE/AmigaForever/Amiga Files/Shared/dir/Work
    hard_drive_2 = $HOME/git/github/amiga-realtime3d
    hard_drive_2_label = Sources
    joystick_port_1_mode = nothing
    

    Create a file called ~/FS-UAE/Configurations/A500.fs-uae with the following contents:

    [fs-uae]
    chip_memory = 1024
    floppy_drive_volume_empty = 0
    hard_drive_0 = $HOME/FS-UAE/AmigaForever/Amiga Files/Shared/hdf/workbench-135.hdf
    hard_drive_1 = $HOME/FS-UAE/AmigaForever/Amiga Files/Shared/dir/Work
    hard_drive_2 = $HOME/git/github/amiga-realtime3d
    hard_drive_2_label = Sources
    joystick_port_1_mode = nothing
    

Install Wine

openSUSE

$ sudo zypper install wine

Ubuntu

$ sudo apt install wine

Install Amiga Forever

  1. Execute the Amiga Forever installation program

    $ env WINEPREFIX="$HOME/.wine-amigaforever" wine start AmigaForever7Plus.msi
    
  2. Copy the installed Amiga Forever files to the FS-UAE working directory

    $ mkdir -p ~/FS-UAE/AmigaForever
    $ cp -a ~/.wine-amigaforever/drive_c/users/Public/Documents/"Amiga Files" ~/FS-UAE/AmigaForever/
    

Native compilation

Install AsmOne

  1. Download AsmOne

    $ curl -O http://www.theflamearrows.info/ftp/asmonev149-RC2.lha
    
  2. Unpack the AsmOne archive into the FS-UAE working directory

    $ lha xw=~/FS-UAE/AmigaForever/"Amiga Files"/Shared/dir/Work/AsmOne/ asmonev149-RC2.lha
    

Build demos with AsmOne

  1. Start FS-UAE with the A1200 run-configuration

    $ fs-uae ~/FS-UAE/Configurations/A1200.fs-uae
    
  2. Start AsmOne

    Open the Work disk and execute AsmOne

    Enter Chip and 200 to allocate 200 KB of chip memory

  3. Open demo source file

    Enter r to open file

    Enter sources:src/Program_01.s to open demo source file

  4. Build demo source file

    Enter a to assemble demo

    Enter wo sources:build/Program_01 to write demo to disk

Cross-compilation

Install vasm

  1. Download vasm

    $ curl -O http://sun.hasenbraten.de/vasm/release/vasm.tar.gz
    
  2. Build vasm

    $ make CPU=m68k SYNTAX=mot
    

    The build will generate a binary vasmm68k_mot. Put this binary in a user-reachable location (for example ~/bin/).

Build demos with vasm

To build the Amiga demo programs, run:

$ ninja

A build directory will be created, containing the demo programs.

License

Licensed under Creative Commons Attribution Share Alike 4.0 International. See LICENSE for more information.

Authors

  • Johan Gardhage
  • General ideas and code from Andrew Tyler's book Amiga Real-Time 3D Graphics
  • Original source code and a scanned pdf of the book can be found here

Screenshots

Screenshot Screenshot Screenshot Screenshot Screenshot Screenshot

About

The 3D engine from the book "Amiga Real-Time 3D Graphics"

License:Creative Commons Attribution Share Alike 4.0 International


Languages

Language:Assembly 100.0%