home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / PPE / AEGIS / AGSHI10.ZIP / AGSHSC.DOC < prev    next >
Encoding:
Text File  |  1995-03-02  |  4.0 KB  |  126 lines

  1.                                          _    _  _ ___ ___/\
  2.     _________/\  /\_____________/\________________ ___ _  _ \/\______________
  3.    /      _    \/   _________  /    ______________________  /   __________  /
  4.  _/     __/     \    ____)___\/     \         \_/         \/\___________  \/_
  5.  \      \        \_  \        \_     \__       \_            \_        /    /
  6.   \______\        /____________/________________/_____________/____________/kP
  7.   ·-------`------'---------------------------------------------------------·
  8.  
  9. AEGiS CoRP HSC iNTERFACE V1.0
  10. -----------------------------
  11.  
  12. Well, this is another TPU file that allows you to use muzic in your Pascal
  13. productions... It only works with TP7.
  14.  
  15. The HSC format is not as powerful as MOD, S3M, XM ... but there are some
  16. reasons why you should use it instead of MOD files:
  17.  
  18. 1/ The player size : The TPU is just about 6Ko.
  19. 2/ The songs size : A MOD file is very BIG, like 50/200Ko, but a HSC file
  20.    size is just about 15Ko and a HSP is 5Ko.
  21. 3/ Playing a HSC file does not requires a SoundBlaster/GUS, you just need an
  22.    AdLib compatible soudcard.
  23.  
  24. uSAGE
  25. -----
  26.  
  27. In your program, just add a line "uses agshsc;" and you will be able to use
  28. the AEGiS HSC interface. An example .PAS file is included in the package.
  29.  
  30. AVAiLABLE PRoCEDuRES aND FUNCTiONS
  31. ----------------------------------
  32.  
  33. Function loadfile(filename:string) : boolean;
  34.  
  35. This function will load the HSC or HSP file given as "filename" into memory.
  36. If the file could not be loaded, the function result will be FALSE.
  37.  
  38. Procedure playmusic;
  39.  
  40. This procedure will play a previously loaded song.
  41.  
  42. Procedure stopmusic;
  43.  
  44. Hehe ... Guess ;)
  45.  
  46. Procedure freemusic;
  47.  
  48. WARNING! ALWAYS USE THIS PROCEDURE BEFORE EXITING YOUR PROGRAM OR LOADING
  49. ANOTHER SONG! IF YOU DON'T DO IT, YOUR COMPUTER WILL CRASH!
  50.  
  51. Procedure startmusic(music : pointer; oldirq : boolean);
  52.  
  53. This will play a HSC file (Not a HSP!) loaded at "music". If you set oldirq
  54. mode, the background player will save the 08h and 1Ch interrupt vectors and
  55. will call them 18.2 times / seconds. I strongly suggest you to set this one
  56. ON! This procedure allows you to link a HSC file to your EXE and play it.
  57.  
  58. Procedure getplayerstate;
  59.  
  60. This procedure will update a record with some useful infos:
  61.  
  62. playerstate.note : array[1..9] of byte;
  63. - This is an array of all notes being played on each of the 9 channels.
  64.  
  65. playerstate.instr : array[1..9] of byte;
  66. - This is an array of all active intruments on each of the 9 channels.
  67.  
  68. playerstate.equalizer : aray[1..9] of byte;
  69. - This is an array of all equalizer values (0 -> 15) on each channel.
  70.  
  71. playerstate.effect : array[1..9] of byte;
  72. - This is an array of all current effects on each channels.
  73.  
  74. Description of the effects (hexadecimal):
  75.  
  76. 00 : Nothing
  77. 01 : Jump to next pattern
  78. 02 : Pause
  79. 03 : Set instrument
  80. 1? : Manual slide up
  81. 2? : Manual slide down
  82. A? : Set carrier volume
  83. B? : Set modulator volume
  84. C? : Set instrument volume
  85. F? : Set speed
  86.  
  87. playerstate.pattern : byte;
  88. - The current pattern
  89.  
  90. playerstate.track : byte;
  91. - The current track
  92.  
  93. playerstate.position : byte;
  94. - The current position ;)
  95.  
  96. playerstate.playing : byte;
  97. - 0:Not playing / 1:playing
  98.  
  99. HSP FiLE FoRMAT
  100. ---------------
  101.  
  102. The HSP file format is just a RLE compressed version of the HSC. Thre are
  103. two EXE files included to covert HSC <-> HSP. The average compression ratio
  104. is about 40%
  105.  
  106. All compressor/decompressor source code are available, just ask me :)
  107.  
  108. oTHER THiNGS
  109. ------------
  110.  
  111. Big greetz to Chicken / ECR for writing the HSCOBJ !!
  112.  
  113. The AEGiS HSC iNTERFACE is compiled using the last vesion (1.6) of HSCOBJ.
  114. HSCOBJ was made by CHiCKEN / ECR.
  115. HSC Format is (c) Neo Software.
  116.  
  117. No commercial use is allowed withoutTrrRRrrZZZzzzzz...RRrrrRRRrZzzzZZZzzZZz
  118.  
  119. I just ask a little thing in exchange of your using of AGSHSC.TPU:
  120. Please greet me in any proggy using my interface.
  121. If you can, please upload it to my board :) [THE DEADLiNE +331-46486763]
  122.  
  123. Have phun with it.
  124.  
  125.                                                 Number Six / AEGiS
  126.