home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
World of A1200
/
World_Of_A1200.iso
/
datafiles
/
c64_music
/
playsid3.0
/
developer.doc
< prev
next >
Wrap
Text File
|
1995-02-27
|
3KB
|
120 lines
PLAYSID.LIBRARY V1.0 (C)1994 Per Håkan Sundell & Ron Birk
Release date: 1 June 1994
INFO
Several people suggested the development of a library to help programs
having support for PlaySID modules, and that is exactly what this is.
It is a standard Amiga shared, runtime library and is called exactly
like all the other Amiga libraries. Using this library, it will be very
simple to make your program 'PlaySID compatible'.
USING THE LIBRARY
If you are a C programmer all you need to do is to include the correct
headers and open playsid.library. After that you can use the functions
in the library as if they were C functions. If your program quits it
must of course close the library again.
Assembly programmers should also include the correct files and open
playsid.library. To call a function you must load A6 with the library
base, put the arguments in the appropriate registers and jump to the
library vector offset of the function you want to call.
The library can only be used by one application at a time. If a second
program tries to open the library it will fail.
LIBRARY API:
LONG AllocEmulResource( void );
D0
Allocates and initilizes memory resources.
void FreeEmulResource ( void );
Frees memory resources.
LONG ReadIcon(char *filename, APTR header );
D0 A0 A1
Reads icon info of supplied name (without .info suffix) and stores it at "header".
LONG CheckModule( APTR header );
D0 A0
Checks if supplied header is a valid playsid header. One part files starts with
the header.
void SetModule( APTR header, APTR fileLocation, UWORD fileLength );
A0 A1 D0:16
Sets a new module. Next time a song is started this module is used. In one part
files the file location and header could be the same, becuase the function skips
the headers.
LONG StartSong( UWORD tune );
D0 D0:16
Starts to play the supplied tune number. The audio device, timers and interrupts
are allocated.
void StopSong( void );
Stops the current song. The audio device, timers and interrupts are freed.
void PauseSong( void );
Same as Stop except that the song could be continued afterwards.
LONG ContinueSong( void );
D0
Same as start except it is used to continue a paused song.
void ForwardSong( UWORD speed );
D0:16
Used to fast forward a currently playing song. The play routine will be called
as many times as given in the speed parameter.
void RewindSong( UWORD speed );
D0:16
Used to rewind a currently playing song. The play routine will be called
as many times as given in the speed parameter. The reverse flag needs to be set!
void SetVertFreq( UWORD frequency );
D0:16
Sets the simulated TV system frequence. 50Hz for PAL or 60Hz for NTSC.
void SetChannelEnable( BOOL flags[4] );
A0
Sets the status of the four channels. "flags" is a pointer to an array of
four boolean values (16 bits each).
void SetReverseEnable( BOOL flag );
D0:16
Sets the status of the reverse flag.