443
edits
-
Changes
m
[==NOTE]==
<nowiki> /*
</nowiki>
no edit summary
;INST .BAT :Bat file to append files of this library to other appropriate library.
;KINLIB .TXT :This file.
;HIKIN .COM :Sample program of this library.
;HIKIN .C :C language part of sample program for this library.
;HIKINA .AS :Assembler part of sample program for this library.
;MKHIKIN .BAT :Bat file to build sample program.
;All of files which has .AS extension other than HIKINA.AS :are source file of each functions of this library.
;<nowiki>* .O </nowiki>:Object of functions of this library.
;REMAKE .BAT :Bat file to re-compile this library.;LICENCE .BAT :License text of this library.
==Setting up==
;char kinrou_play1(void *data,unsigned char count);
:Starts playing music with this function. Function kinrou_init should be executed before this function. Valuable "data" is the first address of BGM data (excluded BSAVE header). BGM data should be located at same address as address specified when data was compiled. Valuable "count" is :repeat times. "0" is eternal loop.:Returns "0" when succeed and "1" when failed playing music.
;char kinrou_play2(void *data,unsigned char count);
:This function uses BSAVE header of BGM data and get both of two addresses which Kinrou 5 Gou needed - a top address of BGM data and address specified when data was compiled. Then Kinrou 5 Gou process internally and plays BGM data. Valuable "data" is the first address of BGM data (excluded BSAVE header).
:BGM data does not have to be located at same address as address specified when data was compiled.
:Valuable "count" is repeat times. "0" is eternal loop. Returns "0" when succeed and "1" when failed playing music.
;char kinrou_checkplay(void);
:Checks status of playing music.
:When music is playing, bit 0 is "1" and when music is paused bit 1 is "1".
;void kinrou_pause(void);
:Obtains parameters by calling GETPAR function call in Kinrou 5 Gou version 1.00 or higher. Gets first address of data as "data" and parameter number as "kind".
* Refer Official specification document of Kinrou 5 Gou for "parameter number" and "parameters".
==References==
Enjoy your programming with BGM by this library.
These programs and source codes are unders BSD copyright.
Refer LICENSE.TXT about BSD copyright in this package.
<nowiki>http://openlab.etl.go.jp/freesoft/BSD-j.htm</nowiki>
* Copyright (c) 1998-2000 Tatsuhiko Syoji, Japan . All rights reserved.
*
* POSSIBILITY OF SUCH DAMAGE.
*/
