Amiga programming examples
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
alpine9000 fd81af3cca removed NDK prereq from bootblock 4 months ago
000.trackdisk Update README.md 3 years ago
001.simple_image Got build working on newer OSX, included missing ADFs 4 months ago
002.sprite_display Removed conflicting ADF name 3 years ago
003.music Got build working on newer OSX, included missing ADFs 4 months ago
004.copper_bars Update README.md 3 years ago
005.copper_vert Update README.md 3 years ago
006.simple_blit Got build working on newer OSX, included missing ADFs 4 months ago
007.masked_blit Got build working on newer OSX, included missing ADFs 4 months ago
008.shift_blit Got build working on newer OSX, included missing ADFs 4 months ago
009.anim_blit Got build working on newer OSX, included missing ADFs 4 months ago
010.blit_speed Got build working on newer OSX, included missing ADFs 4 months ago
011.ehb_mode Got build working on newer OSX, included missing ADFs 4 months ago
012.ham_mode Got build working on newer OSX, included missing ADFs 4 months ago
013.dithered_ham Got build working on newer OSX, included missing ADFs 4 months ago
014.lace_mode Got build working on newer OSX, included missing ADFs 4 months ago
015.sliced_ham Got build working on newer OSX, included missing ADFs 4 months ago
016.copper_fun Got build working on newer OSX, included missing ADFs 4 months ago
017.dual_playfield Got build working on newer OSX, included missing ADFs 4 months ago
018.vert_scroll Got build working on newer OSX, included missing ADFs 4 months ago
019.hori_scroll Got build working on newer OSX, included missing ADFs 4 months ago
020.shrinkler removed NDK prereq from bootblock 4 months ago
021.calling_c Got build working on newer OSX, included missing ADFs 4 months ago
022.photons_bootloader Got build working on newer OSX, included missing ADFs 4 months ago
023.slideshow Got build working on newer OSX, included missing ADFs 4 months ago
024.simple_text Got build working on newer OSX, included missing ADFs 4 months ago
025.scroll_text Got build working on newer OSX, included missing ADFs 4 months ago
026.tile_hscroll Got build working on newer OSX, included missing ADFs 4 months ago
027.parallax Got build working on newer OSX, included missing ADFs 4 months ago
028.bs updates for test 1 3 years ago
assets File used for resize test 3 years ago
doc Cleanup 3 years ago
examples Simple blit 3 years ago
include spiked playing samples 3 years ago
shared removed NDK prereq from bootblock 4 months ago
tools Got build working on newer OSX, included missing ADFs 4 months ago
.gitignore render pathways until empty column 3 years ago
LICENSE updated license 3 years ago
Makefile Got build working on newer OSX, included missing ADFs 4 months ago
README.md Update README.md 3 years ago

README.md

(re)Learning how to program an Amiga after a 20 year break

introduction

This repo contains example programs I have written as I re-learn how to program an amiga. The programs are written in assembler and directly access the hardware. Most of the examples have been tested using FS-UAE and my Amiga 500. Some require 1mb of chip ram, most work fine with 512kb.

Don’t use this as an amiga programming guide. I don’t do things the “correct” way. There are heaps of great guides out there if you want to do things the right way. My a68k asm vocab starts out pretty small, and grows only very slowly, so again, this is not guide on the best way to do things.

documentation

Most of the sites I have used during the learning process:

examples

Each example tries to introduce only one new concept, often building on the previous examples.

See each example’s README.md for a limited description as well as a clickable link to run the example in your browser using my hacked version of Scripted Amiga Emulator

Most of the examples are only tested on a 512kb chip ram A500. Some examples have an option extended versoin that might require more chip ram, and in that case an A600 would be the best option.

cross development environment

These examples are developed on a mac using cahirwpz’s AmigaOS cross compiler for Linux / MacOSX / Windows.

https://github.com/cahirwpz/amigaos-cross-toolchain

The support tools I have developed have additional requirements which you may not have on your system.

For a dump of what I did to install them see installing the cross development environment

building

Build all examples by running make at the top level directory.

Individual examples can be built by entering the directory and running make:

# cd 001.simple_image
# make

this will create a bootable ADF image in the bin directory.

Load this file directly into your emulator of choice as DF0:, or even better, run it on the real hardware.

emulators

The following are the emulators I have used so far:

they each have strengths and weaknesses, so it’s worth giving them each a try.

tools

The following cross development tools have been developed to support the examples:

  • imagecon # create amiga compatible raw image data from true color images
  • resize # resize images ready for imagecon
  • croppa # crop images ready for imagecon
  • mapgen # generate amiga data from tiled maps
  • fade # generate data for fading between palettes
  • makeadf # make ADF disk image

external tools

The following cross development tools have been sourced from external authors:

  • shrinkler # compress for maximum compression, slow decompression
  • doynamite68k # compress for fast decompression

Each tool has a test to check if any changes you have made have broken basic functionality:

# cd tools/imagecon
# make test
______  ___   _____ _____ ___________
| ___ \/ _ \ /  ___/  ___|  ___|  _  \
| |_/ / /_\ \\ `--.\ `--.| |__ | | | |
|  __/|  _  | `--. \`--. \  __|| | | |
| |   | | | |/\__/ /\__/ / |___| |/ /
\_|   \_| |_/\____/\____/\____/|___/
#

or test all by running make test at the top level

license

Some of the code I have included in this repository is copyright by various authors and provided under various licenses. Copyright notices are preseved where possible.

Some of the tools use GPL licensed libraries which would mean they could only be distributed under the conditions of the respective version of the GPL.

All code without a copyright notice is licensed as per the terms in LICENSE.