

                    * Remdy Soundsystem V0.5 documentation *



Some generals infos are written in this infofile.
The differents procedures are better explained in the two .ASM examples:

MAIN1.ASM  (to assemble with make1.BAT, the shortest example i could give,
just play a module and exit when a key is pressed.)

MAIN2.ASM  (to assemble with make2.BAT, in this example some special effects
like external samples playing are used.)

MAIN3.ASM  (to assemble with make3.BAT, in this example some special effects
like external samples playing are used, i also uses a data file with music,
and two .iff samples included.)


* INTRODUCTION:

it's a Realmode SB/GUS soundsystem for 100% asm coders, it's very easy to
use. It's not completely finished yet (some module will sounds weird...) but
everything else is working fine, and since i won't be able to finish it soon,
and it's already sleeping on my HD for too much time i thought i should
better release it now...

(by the way i used TASM V3.2 and TLINK V5.1)
 
 Let's descrive some of the player features:

* SB AND GUS support :

The player is made in order that you don't have to care whether it is a GUS
or a lame SB, just check the results when you load a file and you won't
have any problems.

* AUTODETECTION :

The routines will first try to autodetect the sound card present by checking
the environment,so you must have this in your AUTOEXEC.BAT:
    
       SoundBlaster :
             SET BLASTER = A220 I7 D1 T1
                                    > 1 = Sound Blaster
                                         2 = Sound Blaster Pro
                                         3 = Sound Blaster 2.0
                                         4 = Sound Blaster 16
                                  > DMA
                                > Irq
                             > Port
      Gravis UltraSound :

             SET ULTRASND=220,1,1,7,7
                                  > Irq
                               > DMA
                             > Port

if there's no environment detection it will try an hardware testing...

* WHY .RMD files instead of .MOD ?

The player will be using .RMD files because they are closer to the way i 
coded my routines. I could have included the convertion inside the .OBJ and 
convert every .MOD given before playing it, but that would have been a waste
of bytes and time.
A MOD2RMD convertor is included so i don't think it is a problem.
(and .RMD files are less commun to rip !!!)

IMPORTANT: you MUST re-save a .MOD into FT2 before converting it.
(and make sure FT2 didn't save it in .XM, as it always try!)

* SPECIAL BONUS SAMPLE (SOUND FX) ROUTINES !

You can play a extra-sample when a music is played or not,anytime you want.
You can use samples that are in the currently played module or external
samples (normal FT2 8bits .IFF files), that you can load using the
LOAD_BONUS_SAMPLE procedure.
There are 4 independant channels (both on GUS and SB) where you can
play your extra-samples.  All you have to do is to fill the BLOW_WHAT
variables (Note that the routines will modify what you wrote after
reading it, so ONLY do it once for each sample you want to play...)
You can also modify the frequency of a currently played bonus sample.
(very usefull with looping samples for vroooooom vrooooooom and so on...)

* DATA FILES SUPPORT !

You can pick up the needed module or any .IFF files, wherever you want in a
big data file by giving a correct OFFSET in the input of the LOAD_FILE and 
LOAD_BONUS_SAMPLE procedures.

* SYNCHRO SUPPORT !

You can READ theses variables to know, where you're playing in the module:

line_in_current_played_pattern         dw  0
number_played_in_pattern_playlist      dw  0
pattern_number                         dw  0

* SET PANNING POSITION (only for GUS) :

You can easily select the default panning position (Stereo) for each gus 
channel, just fill theses variables: panning_gus db  12 dup (8)
the 8 first bytes correspond to the eight first channels (for music playing)
the 4 last bytes are used for the FX channels.
Variables in 'panning_gus db  12 dup (8)' must be between 0 and 15 and mean:
0=RIGHT... 8=MIDDLE (normal) ... 15=LEFT.

NOTE:
- That won't do anything with an SB.
- The panning can also be changed by the .MOD effect number 8, so if you
want to define a special panning you should better check in the module that
this effect is not used...

* INFO TO MAKE YOUR .MOD SOUNDS BETTER WITH SB'S :

+ To reduce the 'pffuuuu' lame noive with SB cards:
  for each sample better give it the maximum default volume (40),
  and try to play all sample as loud as possible during the song.

+ Better not load data from disks while playing... its works but sounds bad.

* LEGAL INFOS ...

This Soundsystem is FREEWARE and may be freely distributed as long as all
the files are included in the package.

TRIPTO13.MOD             ; a nice mode made by BENJI/JFF (thanks)
MODRMD05.EXE             ; convert .MOD files to .RMD files. 
TRIPTO13.RMD             ; TRIPTO13 MOD converted into a .RMD file
REMDY-05.OBJ             ; SB and GUS routines.  
MAKE1   .BAT             ; .BAT to assemble MAIN1.ASM
MAIN1   .ASM             ; short example how to use REMDY-05.OBJ
                         ; (simple module playing)
MAIN2   .ASM             ; another example but with extra sample using.
MAKE2   .BAT             ; .BAT to assemble MAIN2.ASM
NON     .IFF             ; a sample file...
OUI     .IFF             ; another sample file...
MAIN3   .ASM             ; another example pick files in a big .DAT
MAKE3   .BAT             ; .BAT to assemble MAIN2.ASM
REMDY-05.TXT             ; this documentation.
 FILE_ID.DIZ             ; ID file.

your are allowed to include this package (REMDY-05.ZIP) on every PD
collection, CD Roms, BBS, DISKS, etc...

If you make FREEWARE software, you are free to use it if you like it.
(that would be nice to send me your productions...or send me a EMAIL telling
me the .ZIP names or send it uuencoded (even huge files!) -my email is:
e6082@iut-orsay.fr)
If you make SHAREWARE software, you are also allowed to use it,but:
You MUST send me a complete/registred version of your SHAREWARE...
(if you ask me not to spread the things you send me i won't.)

Franck Gotthold, 3 rue Jean Moulin,18570 La chapelle St Ursin.FRANCE

For other commercial use (why not!?!), contact me.

If you use my routines please credit me ! (Franck Gotthold)
thanks.



next versions will be advailable on:


                               ,s$$$s       .s,,s.
   ..,,ss,                    ^    ^$$      $$$$$$
.s$$$$$$$$                           $$      $$
$$$^   $$ .s$$$s$ $s   ,$ .s$$$s    $$    ,s,..,s, ,s,.,s, .s$$$s. s$$$$$s
$$$    ,  $$^$$ $$   $$    ^$$  .$    $$$$$$ $$$$$ $$^$$ $$   $
$$$ss      $$   $$ $$   $$ .s$$s$$ .$$        $$        ,$$ $$   $$ $$   ,
$$$      $$   $$ $$   $$ $$^$$ $$         $$    .$$$$  $$s,s$ $$
$$$    s  $$   $$ $$   $$ $$   $$ $$    ,    $$    $^$s,  $$    , $$
$$$s,   $$ $$s,s$$ $$s,s$$ $$s,s$$ $$s,s$$ s,s$$s,s     $, $$s,,s$ $$
 $$$$$$$$  $$$$$  $$$$  $$$$ $^$ $^^$      $$  $$$  $ -X-
   ^^^^    .$$                                        $$
              $$ ,                                      .$
              $$,$                    .                 $     
              $$$                     $.             .$    EQUALIZER BBS 
                $                      $s          .$$         call...
                                        $s,....,s$$      +33-1-4525-1131
                                           $$$$         +33-1-4525-1923





                                           La Chapelle St Ursin.January 1997.
