118 lines
5.1 KiB
Plaintext
118 lines
5.1 KiB
Plaintext
|
______________________________________________________________________________
|
|||
|
|
..............................................................................
|
|||
|
|
...................................................................2222222....
|
|||
|
|
................................................................22222222220...
|
|||
|
|
...................................................222........222222.....222..
|
|||
|
|
..............................................2202222222222..22000............
|
|||
|
|
..................................22000.....20222222222200000200002...........
|
|||
|
|
.................................2002202...2222200222.220000000200000000022...
|
|||
|
|
....................220002......22222200..2200002.......2200000...20000000000.
|
|||
|
|
....................22222202....2220000022200000..........200002........200000
|
|||
|
|
.....200000.........2222200000222200220000000002..........200002........20000.
|
|||
|
|
.....00222202........2220022000000002200002000002........2000002000020000000..
|
|||
|
|
....2222200000.......220002200000002.2000000000000222222000000..2000000002....
|
|||
|
|
....220000200002......20000..200002..220000200000000000000002.......22........
|
|||
|
|
...2220002.2200002....220002...22.....200002..0000000000002...................
|
|||
|
|
...220000..222000002...20000..........200000......2222........................
|
|||
|
|
...000000000000000000..200000..........00002..................................
|
|||
|
|
..220000000022020000002.200002.........22.......______________________________
|
|||
|
|
..0000002........2000000220022.................|
|
|||
|
|
.200000............2002........................| AMOSPro Extension System
|
|||
|
|
.200002........................................| 23/09/1992
|
|||
|
|
220002.........................................|______________________________
|
|||
|
|
______________________________________________________________________________
|
|||
|
|
|
|||
|
|
This information is valid for AMOSPro V1.0. It may have changed with older
|
|||
|
|
version of AMOSPro. Please ask for the latest update.
|
|||
|
|
______________________________________________________________________________
|
|||
|
|
|
|||
|
|
|
|||
|
|
Hello everybody! Fran<61>ois typing on the keyboard to give you more information
|
|||
|
|
on the AMOSPro Extension system.
|
|||
|
|
|
|||
|
|
1. Starting an extension from scratch.
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
You have never created an extension before and you want to make
|
|||
|
|
your new instruction set.
|
|||
|
|
|
|||
|
|
No problemo. All you need is:
|
|||
|
|
|
|||
|
|
- An assembler (GenAm2 or 3 preferably)
|
|||
|
|
|
|||
|
|
- All the include files in this folder
|
|||
|
|
|
|||
|
|
- Skill, and patience. All the necessary explanations
|
|||
|
|
are given in the file |Music.s.
|
|||
|
|
I suggest that instead of starting an extension from scratch,
|
|||
|
|
you begin by changing one that already exists. A simple
|
|||
|
|
one like |Compact.s is a good example. This way, all the crucial
|
|||
|
|
inits are already provided.
|
|||
|
|
|
|||
|
|
- Note, you can easily debug you code by placing an "Illegal" in
|
|||
|
|
your code. This will stop AMOSPro and you can then press [Amiga]+[A]
|
|||
|
|
to flip back to the workbench display. This works because Amiga-A is
|
|||
|
|
handled by interrupts.
|
|||
|
|
|
|||
|
|
|
|||
|
|
2. Transfering an AMOS1.3 extension.
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
First of all, sorry for changing the format of the equates file,
|
|||
|
|
and forcing you to re-assemble your code. I have had to change things
|
|||
|
|
so that I could implement all the nice features of AMOSpro. I have also
|
|||
|
|
progressed a lot since the first AMOS, and I have discovered ugly things that
|
|||
|
|
NEEDED to be removed.
|
|||
|
|
|
|||
|
|
On the bright side, 99.9% of change is a simple re-assemble of your code using
|
|||
|
|
the new equates, and then it should work.
|
|||
|
|
|
|||
|
|
What exactly has changed?
|
|||
|
|
|
|||
|
|
- The equates, as mentioned before. Just use "Include |AMOS_Include.s"
|
|||
|
|
|
|||
|
|
- The RJsr calls to the main AMOSPro function library.
|
|||
|
|
The new ones are much better, and more powerful. For example
|
|||
|
|
all the necessary bank handling functions are re-written.
|
|||
|
|
You can now call the file selector from within your extension.
|
|||
|
|
You must read the "|Music.s" file to have the list of
|
|||
|
|
all available instructions.
|
|||
|
|
|
|||
|
|
- WARNING: L_Bnk.OrAdr uses D0 to input the number of the
|
|||
|
|
bank, and not D3 any more! Check your code if you use it.
|
|||
|
|
|
|||
|
|
- The title format has also changed: the "10" character is
|
|||
|
|
no longer needed. You can also have AMOS call your own
|
|||
|
|
title routine if you want.
|
|||
|
|
|
|||
|
|
The AMOSPro compiler will accept your extension code.
|
|||
|
|
|
|||
|
|
I can inform you now, when new Commodore machines are out,
|
|||
|
|
you (and I) will have to create new extension code to use the new
|
|||
|
|
features. But, that's the way it goes.
|
|||
|
|
|
|||
|
|
|
|||
|
|
3. What number should you use for your extension.
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
Please use a number from 26 and downwards. Official AMOSpro
|
|||
|
|
extensions are from 1 upward. This way yours and ours will
|
|||
|
|
never collide!
|
|||
|
|
|
|||
|
|
The extension number is CRUCIAL for your code to work. AMOSPro
|
|||
|
|
will refuse to boot if the number of the extension in the list
|
|||
|
|
is not the same as the one returned by the code.
|
|||
|
|
So check your code.
|
|||
|
|
|
|||
|
|
To register an official AMOS Extension contact Richard Vanner at
|
|||
|
|
Europress Software. He will confirm the numbers validity and ensure
|
|||
|
|
future extensions don't collide.
|
|||
|
|
|
|||
|
|
|
|||
|
|
4. Why do I use a "|" character before all my source names?
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
Hehehe. Doing this ensures all the source code file are automatically
|
|||
|
|
sorted at the end of the file selector display. Faster and easier to
|
|||
|
|
locate!
|
|||
|
|
|
|||
|
|
|
|||
|
|
Well, that's all for now, have fun. Francois.
|
|||
|
|
|