         Advanced Desktop Presentation Creator - Module Notes
         ====================================================

All the effects avaliable with this package are created using the 
module provided inside the !ADPC directory. To use the module an area 
of memory must first be allocated for use. This can be done from basic 
using the following lines :-

DIM adpc% 200000
OSCLI("ADPCInitialise "+STR$adpc%+" 200000")

The command 'ADPCInitialise' command is used to allocate the memory. It 
must be followed by the address of the block of the memory and the size 
of the memory. To determine how much memory you will need, 256 bytes 
are used of the allocated memory and any memory left is used to store 
the screens. Each screen takes exactly 81920 bytes. 

The screens are stored in a special format. They must be the screen 
data only, i.e. raw screen memory. An example program to create a 
special format file from a sprite file, use the following program (it 
assumes you have allocated sufficient memory).

*SCREENLOAD filename1
*ADPCGET 1
OSCLI("SAVE filename2 "+STR$~(adpc%!0)+" +14000")
*ADPCPALETTESAVE palette

Replace the filenames with the required values, and the same with the 
palette filename.

The restrictions which must be accounted for whilst using this module 
is that all the screens used must be of either mode 12, or mode 13 and 
all the screens must be of the same mode. Also in mode 12, the palette 
has to stay the same.

Commands :-

ADPCLoad <slot> <filename>

This command is used to load a file into a slot for use in fades. It 
must be followed by the slot number (in the range 1 to 20) and then the 
filename.

ADPCGet <slot>

This command is used to get the current screen into a slot position.

ADPCCursorOff

This command just turns of the cursor.

ADPCCursorOn

This command turns the cursor on again.

ADPCPaletteLoad <filename>

This takes the special format palette files and sets the current 
colours.

ADPCPaletteSave <filename>

This saves the current palette as the file specified filename.

Fades avaliable :-

ADPCShow <slot>

This displays the picture stored in <slot> on the screen.

ADPCUp <slot>

This fades the specified screen up from the bottom.

ADPCDown <slot>

This fades the specified screen down from the top.

ADPCShut <slot>

This divides this picture in half and fades each half from the top and 
bottom.

ADPCExplodes <slot>

Fades the screen from the centre outwards.

ADPCShutter <slot>

This displays the picture as if it were on shutters being closed.

ADPCBounce <slot 1> <slot 2>

This will bounce the screen in <slot1> over the screen stored in 
<slot 2>

ADPCRollerUp <slot>

This displays the screen by rolling it up the screen.

ADPCRollerDown <slot>

This displays the screen by rolling it down the screen.

ADPCBars <slot>

This displays the screen by interlacing bars alternatly rising and 
descending down the screen.

ADPCSmoothuUp <slot 1> <slot 2>

This will scroll the screen in <slot 1> up the screen whilst scrolling 
the screen in <slot 2> out of the screen.

ADPCSmoothDown <slot 1> <slot 2>

This will scroll the screen in <slot 2> down the screen whilst 
scrolling the screen in <slot 2> out of the screen.
