Sidigi v0.3 manual


Sidigi is a program for attaching Digi-Organizer tracks to
a SID music with playroutine and constructing a proper .SID
out of them.



Notes

This program has only really been tested on GoatTracker tunes
thus far. SID post-relocation in Sidigi doesn't really work all
that well. The digi-player and associated datas will always start
at $9000. SIDs should be located near $9000, the common location
of $1000 doesn't really work until I figure out how to make it
work. You can't really change any flags in the resultant PSID
file, thus the SIDs produced are always PAL 6581.
Contact me if you can help with these issues.



Usage

Make a SID tune in your favourite player. Pack it and relocate
it so that the data ends before $9000. (For example, $8500.)
Take note of the init and play addresses. Now compose the digi
channel in Digi-Organizer and save.

Now open Sidigi and in the Files panel, load the SID tune you
did. The "Addresses (SID)" panel should get the correct values
automatically, but at least the Play address might not be
correct depending on the playroutine your SID uses.
Now load the Digi-Organizer file you did and fill in the
text fields for the SID. Choose the correct speed for your
digi track. Now just click "Create SID!" and you will be asked
where you want to save the SID. That should be it.

Note: only the data part of the Digi-Organizer file will be
used. The player part is taken from some PSID rip in HVSC as
it seems different (and it works) than the default one created
by Digi-Organizer.



Converting samples

Simply load a WAV file where you'd normally load a SID tune and
it will be converted to 4-bit format ready to be used in Digi-
Organizer. Note! Only mono 8-bit samples are currently supported.



Relocating SIDs

This is pretty lame and only works in theory really. It uses
"relocdiff" files that contain the locations and value offsets
of the bytes to modify in a SID playroutine. If your playroutine
doesn't have a relocdiff file, you need to create it by saving
two differently relocated versions of the same SID tune (they
need to be identical, only relocated to a different location.
The actual memory locations don't really matter). Load the two
versions of the file as SID and Digi in Sidigi and click on the
"Create relocdiff" button.
Now you can load any SID tune that uses the same playroutine and
relocate it where you want in Sidigi. Click on the "Load:" label
next to the Address field and the best (closest to $9000) address
will be filled in, along with the proper Init and Play addresses.
Sidigi relocdiff file format:
word	bytes to patch (=n)
word*n	positions of bytes to patch
byte*n	byte offsets (relative to high byte of start addr.)



Contact

www:   http://www.hukka.furtopia.org/
email: hukka@despammed.com

hukka 2004-05-26