Anleitung zu              

              ============================================     
                       MUSIKDUSCHE  V0.5 STE/TT   
                             15.9.1992
              ============================================                                              
              FREEWARE !!
              100% Assembler (was denn sonst ?)

              von Falco Bethke 

              Songinterpreter v. Sascha Springer

Das Programm ist in allen Versionen kleiner V1.00 vllig frei zu benutzen
und kopierbar. Das Kopieren von und in Mailboxen ist ausdrcklich
erwnscht ! 
Der Verkauf und gewinnorientierte Vertrieb (PD-Versand) ist allerdings 
nicht gestattet, sofern dies nicht persnlich mit dem Autor abgesprochen 
wurde.
Das Archiv MUSDUSCH.LZH sollte folgende Dateien enthalten:
MUSDUSCH.TTP ;das Programm
MUSDUSCH.TXT ;dieser Text
und optional ein beliebiges Module
Das Programm bitte nur KOMPLETT (TTP und TXT) weitergeben/kopieren !!

----------------------------------------------------------------------------
EINLEITENDE WORTE:

Wie man vielleicht schon erraten kann, handelt es sich bei dem Programm
um einen Moduleplayer, der im Hintergrund fr stndigen Musikgenu sorgt,
also auch bei der Arbeit :-)
Da es von der Sorte ja nun wirklich schon genug gibt, mchte ich gleich
am Anfang die grten Unterschiede zu den "Alten Hasen" aufzhlen:

- Musikdusche ist schnell !! 
  Man braucht also nicht mehr unbedingt einen getunten ST oder TT. Es taugt
  also auch sehr gut fr 8 MHz STEs.

- Es handelt sich noch um eine ziemlich zusammengestrickte Version, die ich
  erst mal nur zu Test- und Demonstrationzwecken in Umlauf schicke !
  Einige Verbesserungen werden in den nchsten Tagen oder Wochen noch 
  folgen. Bei entsprechender Nachfrage und Resonanz werden diese auch 
  greren Umfang einnehmen.
  Das bisherige "bel": Alle Player, die ich in den Fingern hatte
  (MPlayer, Paula, Jukebox) waren entweder sehr absturzfreudig oder machen
  erst auf einem Mega STE oder TT Sinn. Fr einen normalen 8 MHz STE 
  sind diese zu langsam, so da sich nur mit dumpfen oder leierndem Sound
  vernuenftig arbeiten lie.
  Da aber in dem 68000er mehr steckt als so manche denken, habe ich eine
  ziemlich optimale Demoplayerroutine TOS-tauglich gemacht. 
  Diese zeichnet sich dadurch aus, da sie sehr stabil luft und
  auf meinem 8 MHz STE bei 25 kHz Stereo mit Oversampling nur etwa 
  33 % (!!!) der Rechenleistung klaut.

- Musikdusche ist (noch ?) ein TTP-TSR-Programm, also ein TOS-Programm.
  Also ist schon mal nix mit bequem aus jedem GEM-Programm per Accessory
  und Fileselectbox neue Musik whlen und Parameter einstellen.
  Da die Speicherverwaltung bei residenten Programmen nicht ganz so einfach
  ist (oder irre ich mich da ?), lt sich z.Z. nur ein Module anhren und  
  nicht wieder aus dem Speicher entfernen.

- Es ist noch sehr unflexibel. D.h. die Samplingrate ist fest auf 25 kHz
  mit Oversampling eingestellt. Es kann nur zwischen Stereo und Mono
  gewhlt werden.

- Das Programm benutzt die DMA-Sound-Fhigkeiten des STE/TTs und luft daher
  auch nur auf diesen ! Ob es auf Megas STEs und TTs luft, habe ich zwar 
  noch nicht berprft (ich werde in den nchsten Tagen mal einen Atari-
  Hndler belstigen und dieses auch auf dem Falcon testen) aber es spricht
  eigentlich nichts dagegen (also: kein selbstmodifizierender Code !!). 
  Die Leute, die immer noch keinen STE/TT haben, knnen es mal mit dem 
  Programm PETRA (liegt in vielem Mailboxen) probieren. 


ANWENDUNG:
---------
Einfach das TTP-Programm anklicken und das gewnschte Module mit Extender 
(also ".MOD") eingeben. "?" und "*" sind auch erlaubt.
MUSDUSCH [Pfad]Dateiname [/m] oder x
/m spielt das Module in Mono. Sonst immer in Stereo.
Wird nur 'x' bergeben, wird einfach die Musikwiedergabe gestoppt.
Oder halt Musikdusche mit "Anwendung anmelden" fr "MOD"-Dateien aktivieren.
Dann nur noch das Module doppelt anklicken ...
Befinden sich die Module nicht im aktuellen Laufwerk/Ordner, mu auch noch
der dazugehrige Pfad eingegeben werden.
Nachdem das Module geladen und initialsiert wurde, kehrt man wieder zum 
Desktop (oder zum aufrufendem Programm) zurck und kann sich von der guten 
(je nach Module) Musik berieseln lassen.
Die Parameterbergabe klappt jetzt auch endlich mit KAOS-Desk 100%.


TECHNISCHE DETAILS:
-------------------
Anhand des _SND-Cookies wird zuerst festgestellt, ob es sich um einen ST
mit DMA-Sound handelt, wird dieser Keks nicht gefunden, kann auch keine
Musik gespielt werden.
Der Interruptvektor des Timer A vom MFP wurde nach dem XBRA-Standard
(ID: 'MUDU') auf die Soundroutine verbogen.
Da die Soundroutine vom Timer A aufgerufen wird, arbeitet sie 
unabhngig von der Bildschirmfrequenz. Leider flackert die Maus dadurch 
leicht jedoch unauffllig. Einflsse von wilden Mausbewegungen auf die
Musikwiedergabe konnte ich nicht feststellen. Z.Z bereitet es noch jedem
Hintergrundplayer, wie auch Musikdusche, Probleme, parallel zu den beim
Rainbow-TOS erscheinenden Regenbogenfarben zu laufen. Das TOS scheint dabei
etwas tiefer in die MFP-Interna einzugreifen. Bis das behoben ist (ich denke
bald), sollte man Mausbewegungen whrend der Rainbow-TOS Copyrightmeldung
vermeiden. Wenn das Module geladen und initialisiert worden ist, kehrt 
Musikdusche mit PTermRes zurck und hat den Speicher je nach Module etwas 
schrumpfen lassen.
Das Programm berechnet mit einer Frequenz von 12.5 kHz fr jeden der vier
Kanle die anfallenden Sampledaten, addiert sie und schreibt sie doppelt 
(Oversampling !) in einen Stereopuffer. Dieser Puffer wird von dem STE-
Sound DMA mit 25 kHz pro Stereokanal gelesen, gewandelt, durch einen 12 und 
16 kHz Tiefpassfilter geschickt und ausgegeben. Wenn auf Mono geschaltet
wurde, kommt noch eine zweite Oversamplingstufe per Hardware hinzu. Dann 
werden beide Kanle mit 50 kHz bedient. Das dann vierfache Oversampling 
macht sich jedoch teilweise etwas negativ bemerkbar, ist aber Geschmacks-
sache.
Um die Qualitt subjektiv ein bichen zu steigern, werden die Hhen und 
die Tiefen der Musik etwas verstrkt. Die Leutchen, die stndig ihr 
CPX-Modul geladen haben, mgen mir verzeihen.
Das Programm baut auf einer Moduleplayerroutine von Sascha Springer auf,
die vor ca. 3 Jahren auch fr den CDPLAYER benutzt wurde.
Den Kern der Routine (die Sampleaufbereitung) habe ich inzwischen auf
gut doppelte Geschwindigkeit optimiert und mchte mal behaupten, da da 
kaum noch was 'rauszuholen ist  :-)
------------------------------------

Fr Anregungen, Fehlerbeschreibungen und Wnsche habe ich ein offenes Ohr. 
Man wende sich an:

gelbe Post:
-------------
Falco Bethke
Postfach 100121
5628 Heiligenhaus
Tel. 02056/2989

Oder etwas moderner per E-Mail:
-------------------------------
Im Fido-Netz  Falco Bethke @ 2:245/8 oder einfach in der Atari.Ger.

dann mal bis nur nchsten Version ...
Ciao, Falco

