From: br326@cleveland.Freenet.Edu (Raphael Pungin)
Newsgroups: comp.music
Subject: WinMod Documentation in English
Date: 4 Sep 1992 16:08:48 GMT
Organization: Case Western Reserve University, Cleveland, OH (USA)
Distribution: inet
Reply-To: br326@cleveland.Freenet.Edu (Raphael Pungin)
NNTP-Posting-Host: hela.ins.cwru.edu


As promissed here is the English translation of the WinMod documentaion:
========================================================================
Translated by: Harald Zappe
Notes:         The format of the original document was MS-Windows-Write
	       (.WRI). I have converted it to standard text file format
	       without changing the meaning of the text.
	       (max. 76 char/line for mailers + <lf>)
               Furthermore I have changed the ANSI characters in the range
               0x80 til 0xFF to Latex conventions {\..}, so that they can
               be posted with 7bit mail systems. {\"a} means a Umlaut, and
               so on. I don't know on whitch system this document is cur-
               rently read and (if at all) which 8bit character set it uses.
	       So fell free to use your favorite editor to convert them
	       "back" to their original look. I did NOT use the very common
               method of writing 'u Umlaut' as 'ue', because there are many
               words in german causing trouble when converting the document
               back (e.g. "bauen" [to build] has to be kept as it is).
 
               For those who are interested in the original text, I kept it
               and translated paragraph by paragraph.
               (Is there anyone speeking french ??
               Mes connaissances en fran{,c}ais sons tr{\`e}s terribles.
               Y Espa{\~n}iol por los Mexicanos ??
                __    |
               |__| --+--  ?  [It's hard to write Yomikata in ASCII]
               |__|  /+\
 
               (Isn't it funny that only english has no probs with 7bit...)
 
               Harald
#--------------------------------------------------------------------------
 
(D)------------------------------------------------------------------------
 
WinMod -- der erste(?) Windows MOD-Player
 
Wenn jemand eine gro{\ss}artige Anleitung zu diesem kleinen Programm er-
wartet, mu{\ss} ich ihn leider entt{\"a}uschen. WinMod ist ein Programm,
da{\ss} zwischen T{\"u}r und Angel entstanden ist, als ich die Spezifika-
tion zur Windows Multimedia-Schnittstelle in die Finger bekommen hatte.
Ich hatte gerade meinen Soundblaster bekommen, und mich f{\"u}r die MOD-
Dateien interessiert. Was lag n{\"a}her, als "mal eben" einen kleinen
Mod-Player zu bauen? Man mu{\ss}te doch  mal testen, ob die Windows-Funk-
tionen  was taugen.
 
(world)--------------------------------------------------------------------
 
WinMod -- der first(?) Windows MOD-Player
 
If there is any one expecting a great instruction (manual) for this little
program, I'm so sorry to disappoint him. WinMod is a program being build
"while about to leave", when I got the specifications of the Windows Mul-
timedia Interface into my fingers. I had just gotten my Soundblaster, and
I was interested in the MOD-Files. What would be more obvious than just
even to build a little MOD-Player. It should be tested whether the Windows
Functions are of use.
 
(D)------------------------------------------------------------------------
 
Herausgekommen ist dann dieser Player. Er ist kein durchgestyltes und aus-
gefeiltes Programm, weder in der Oberfl{\"a}che noch in der "Technik" unter
der Oberfl{\"a}che. Man mu{\ss} deshalb folgende Features in Kauf nehmen:
WinMod ...
 
-   stellt eine gewaltige Belastungsprobe f{\"u}r die Windows-Speicherver-
    waltung dar
-   unterst{\"u}tzt l{\"a}ngst nicht alle Effekte, die in MOD-Dateien be-
    nutzt werden
-   erreicht nicht die Klangqualit{\"a}t anderer (Dos-)MOD-Player, weil
    keine Tricks wie FFT benutzt wurden
-   hat Probleme mit einigen MOD-Dateien (keine Ahnung warum)
-   kann nur ein Modul abspielen (keine Jukebox).
 
(world)--------------------------------------------------------------------
 
It has come out this player. It is not a 'styled' and 'filed(?)' program,
neither at the surface (GUI) nor in the technic behind the surface. There-
for you must accept the following 'features': WinMod ...
 
-   does not nearly support all the effects used in Mod-Files
-   does not reach the sound quality of other (Dos-)MOD-Players, because
    there aren't used any tricks like FFT
-   has problems with some MOD-Files (no matter why)
-   can only play one Modul (not a Jukebox).
 
(D)------------------------------------------------------------------------
 
Aber weil WinMod eben die meisten MOD-Dateien in akzeptabler Qualit{\"a}t
unter Windows abspielt, ohne den Rechner v{\"o}llig zu blockieren, und weil
es anscheinend immer noch der einzige Windows-Player ist, stelle ich das
Programm hiermit auch anderen zur Verf{\"u}gung stellen. Wer die oben ge-
nannten Schw{\"a}chen akzeptiert, bekommt einen kleinen Player, der auch
bereits auf relativ langsamen Maschinen (25 MHz 386er ohne Cache) im Hin-
tergrund Musik spielt.
 
(world)--------------------------------------------------------------------
 
But because WinMod even plays the most Mod-Files with acceptable quality,
without completely blocking the computer, and because it still seems to be
the only Windows-Player, I make the program available for others too.
Those who accept the above noted weaknesses get a little player which al-
ready plays music in the background on relatively slow machines (25 MHz 386
without cache).
 
(D)------------------------------------------------------------------------
 
Voraussetzungen f{\"u}r WinMod
 
Um WinMod benutzen zu k{\"o}nnen, ben{\"o}tigt man unbedingt drei Dinge:
 
-   einen Rechner mit 386er Prozessor (386SX reicht). Sorry, ihr armen
    286er Besitzer!
-   Windows 3.1
-   eine Soundkarte, die digitale Samples abspielen kann, und einen ent-
    sprechenden Windows-Treiber (Soundblaster, PAS, Mediavision Thunder-
    board etc.)
 
(world)--------------------------------------------------------------------
 
Conditions for WinMod
 
To be able to use WinMod you absolutely need three things:
 
-   a computer with a 386 processor (386SX is enough). Sorry, you poor
    286 owners!
-   Windows 3.1
-   a sound card which can play digital samples, and an according Windows
    Driver (Soundblaster, PAS, Mediavision Thunderboard etc.)
 
(D)------------------------------------------------------------------------
 
Installation
 
F{\"u}r WinMod ist keine besondere Installtionsprozedur n{\"o}tig. Man ko-
piere das Programm "irgendwo hin" und starte es. F{\"u}r maximalen Komfort
sollte man aber den Player noch mit den MOD-Dateien verkn{\"u}pfen. Das
geht wie folgt:
 
-   Im Programm-Manager Datei/Ausf{\"u}hren anw{\"a}hlen, und das Programm
    REGEDIT starten.
-   Im Registrier-Editor den Befehl Bearbeiten/Dateityp hinzuf{\"u}gen an-
    w{\"a}hlen
-   Die Dialog wie folgt ausf{\"u}llen:
	Bezeichner: ModFile
	Dateityp: Mod-Datei
	Ma{\ss}nahme: {\"O}ffnen
	Befehl: <pfadname\>winmod.exe %1
		also zum Beispiel c:\windows\winmod\winmod.exe %1
	oder Durchsuchen anklicken und winmod.exe ausw{\"a}hlen
	Verwende DDE: nicht ankreuzen
-   OK klicken und RegEdit beenden.
-   Dateimanager starten, und den Befehl Datei/Verkn{\"u}pfen anw{\"a}hlen.
-   Als Dateinamenerweiterung MOD angeben, unter Verkn{\"u}pfen mit den
    Eintrag MOD-Datei ausw{\"a}hlen. Anschlie{\ss}end OK klicken.
-   Das wars.
 
(world)--------------------------------------------------------------------
 
Installation
 
WinMod doesn't need a special installation routine. You copy the program
to "anywhere" and start it. For maximum comfort you should associate the
player with the MOD-Files. This works as follows:
 
-   In the Program Manager choose File/Run... and start REGEDIT.
-   In the registration editor choose Edit/Add Filetype...
-   Fill in the dialog as follows:
	Identifier: Modfile
	File Type:  Mod-File
	Action:     (.) Open
	Command:    <path\>winmod.exe %1
		    e.g. c:\windows\winmod\winmod.exe %1
	or click Browse and choose winmod.exe
	Uses DDE:   [ ] (not X'd)
-   Click OK and terminate REGEDIT.
-   Start the File Manager and choose File/Associate.
-   Files with Extension: MOD
    Associate with:       MOD-File
    Then you click OK.
-   That's all.
 
(D)------------------------------------------------------------------------
 
Abspielen von Musikst{\"u}cken
 
Jetzt k{\"o}nnen Mod-Dateien auf drei verschiedene Arten abgespielt werden:
 
1.  Starten von WinMod, und laden eines Musikst{\"u}ckes {\"u}ber das
    Men{\"u} Datei/{\"O}ffnen.
2.  WinMod unterst{\"u}tzt das Windows-Drag/Drop Protokoll. Mann kann
    Dateien aus dem Datei-Manager in das in das WinMod-Fenster ziehen und
    dort loslassen.
3.  Wenn die Verkn{\"u}pfung wie oben beschrieben erfolgt ist, kann man
    auch die MOD-Dateien direkt starten. Egal, ob WinMod bereits geladen
    ist oder nicht, man kann im Datei-Manager mit einem Doppelklick oder
    mit dem Druck auf die Return- Taste die markierte Datei abspielen. Das
    ist besonders praktisch, weil man so recht einfach in eine Liste von
    Mod-Dateien hineinh{\"o}ren kann. Mit den Pfeiltasten im Datei-Manager
    die Datei ausw{\"a}hlen und mit Return abspielen. Will man die
    n{\"a}chste Datei anh{\"o}ren, w{\"a}hlt man diese ebenso aus. WinMod
    stoppt das Abspielen der alten Datei und startet sofort mit der neuen.
 
(world)--------------------------------------------------------------------
 
Playing the pieces of music
 
Now the MOD-Files can be played in three different ways:
 
1.  Start WinMod and load a piece of music in the menu 'Datei/{\"O}ffnen'
    (File/Open).
2.  WinMod supports the Windows Drag/Drop Protokol. You can drag files out
    of the File Manager into the WinMod Window and drop them there.
3.  When the association has been made as described above, you can start
    the MOD-Files directly, too. No matter, whether WinMod is already
    loaded or not, in the File Manager you can play a file marked by a
    double click. That's very handy, because you can quite easy listen
    into a list of Mod-Files. With the cursor keys in the File Manager
    choose the file and play it with Return. Do you want to listen to the
    next file, this one is choosen in the same way. WinMod stops playing
    the old file and immediately starts the new one.
 
(D)------------------------------------------------------------------------
 
An dieser Stelle sei noch erw{\"a}hnt, da{\ss} die Punkte Aufl{\"o}sung und
Modus in der Dialogbox Einstellungen Dummies sind und auch bei Karten mit
entsprechenden F{\"a}higkeiten keine Verbesserung der Klangqualit{\"a}t be-
wirken. Au{\ss}erdem ist die Sampling-Rate 44,1 KHz nicht getestet, da mein
Soundblaster 1.0 diesen Modus nicht beherrscht.
 
F{\"u}r das merkw{\"u}rdige Blubbern, das man beim Soundblaster 1.0 unter
Windows im erweiterten Modus ab und zu h{\"o}ren kann, ist nicht WinMod
verantwortlich. Es liegt an Windows und am Soundblaster, und kommt von der
hohen "Interrupt Latency" im protected Mode des 386er Prozessors. Im Stan-
dard-Mode oder beim Soundblaster 2 tritt dieser Effekt nicht auf.
 
Konstruktive Kritik und Anregungen (vielleicht der Source f{\"u}r eine ent-
sprechende FFT-Routine f{\"u}r MOD-Dateien) nehme ich gerne entgegen. Be-
leidigungen,  Beschwerden und Flames bitte an NUL schicken.
 
(world)--------------------------------------------------------------------
 
It should be mentioned here that the points 'Aufl{\"o}sung' (resolution)
and 'Modus' in the dialog box 'Einstellungen' (settings) are dummies and
also with cards with the according features they don't result any improve-
ment of the sound quality. Besides the sampling rate 44.1 Khz is not tes-
ted, because my Soundblaster 1.0 doesn't control this mode.
 
WinMod is not responsable for the funny bubbling that you can sometimes
hear with the Soundblaster 1.0 in the Enhanced Mode of Windows. It's a
matter of Windows and the Soundblaster, the long 'interrupt latency' is
responsable in the Protected Mode of the 386
processor. In the Standard Mode or with the Soundblaster 2 this effect
does not occure.
 
I'll like to get constructive criticism and suggestions (perhaps the source
code for an according FFT-Routine for MOD-Files). Please send insults,
complaints and flames to NUL.
 
(D)------------------------------------------------------------------------
 
Norbert Unterberg
K{\"o}hlerstr. 12c
5802 Wetter 2
 
Fido: 2:245/36.4
Internet: Norbert_Unterberg@softstream.fido.de
 
#--------------------------------------------------------------------------
 
translated into english by
Harald Zappe
M{\"u}lenstr. 39a
D1000 Berlin 46
Germany
 
#--------------------------------------------------------------------------
Internet: zappe@mikro.tu-berlin.de   | |         Doctors speak Latin
	  zappe@sony1.sietec.de      |-+-        Programmers speak English
	  zappe@idefix.sietec.de     | |/        Computers speak 10101101
				       /
				      /__
#--------------------------------------------------------------------------
Xref: sparky comp.music:4320 rec.music.misc:22673