chunkypixel / TIATracker

A module to play TIATracker music in batari Basic and 7800basic
GNU General Public License v3.0
42 stars 0 forks source link
7800basic atari2600 atari7800 atariage bataribasic bb

TIATracker

Welcome to the TIATracker module for batari Basic and 7800basic allowing you to play TIATracker music in your Atari console games.

What is TIATracker

TIATracker is a tool created by Kylearan for making Atari VCS music on the PC and a new sound routine for the VCS. It features ADSR envelopes, up to 7 melodic and 15 percussion instruments, customizable pitch guides for optimizing the number of in-tune notes, a size-optimized and configurable replayer routine and much more.

More information is available on the AtariAge Forum

Examples

For a full example of incorporating your TIATracker music into your source check the following depending on your platform:

Known issues

Currently only one track per game can be added.

Instructions

The following outlines how to add the TIATracker module to your source and incorporate your music. If you are having issues refer to the example for assistance.

  1. Copy the tiatracker folder into the root of your source folder

  2. Copy the content of file tiatracker/tiatracker_variables.bas into your variable definitions of your source.

  3. Add the following to your source (either at the bottom of your file or bank depending on your requirements):

 rem include the tiatracker source
 asm
    include "tiatracker/tiatracker.asm"
end
  1. In the initalisation of your screen add the following to initialise the tracker:
 rem initialise tiatracker
 gosub tiatrackerinit
  1. In your screen loop, after the drawscreen call add the following:
 rem play track
 gosub tiatrackerplay

TIATracker

  1. Create your music or get someone to do the hard work!

  2. Select File > Export track data to dasm... from the menu. On the Save As dialog locate your tiatracker/track folder in your batari Basic game folder, enter a filename of 'track' and click the Save button to export your music.

  3. In file tiatracker/track/track_variables.asm remove the Permanent and Temporary variables from the file (otherwise you will receive a compilation error). Note: This will need to be done each time you export your data.

Change Log

The following enhancements and changes have been made to the TIATracker module:

1.2 - 20190926

1.1 - 20190125

1.0 - 20190123