MOD-PLAYER 1.0 av Christian Dahl                                     950129


 ________     ___          _________    ___     ___   _____     _______
|            |   |        /         \  |   |   :   | |         |       \
|    __    | |   :       |           | |   :   .   : |    -    |   __   |
|   |      | |   .       |     __    | |   .       . |   |_    |   _
|       __/  |           |           : |             |         |       |
|            |           |   |____   .  \__     __/  |    __|  |   |\
|            |           |                 |   .     |   |__   |
|   .        |         | |   |             |   :     |         |          \
|___:        |_________| |___|    |_       |___|     |________ |___|  |___|


                                                   11          000000
                                                  111        000    000
                                                 1111        000    000
                                                  111        000    000
                                                  111        000    000
                                                  111        000    000
                                                  111   ...  0000000000
                                                 11111  ...   00000000


----------------------------------------- Installationsrekomendationer ---


Om man anvnder ...

... Icke multitaskande krna samt skal som klarar av att snda VA_START 
(t.ex. vanliga TOS + GEMINI) br man installera programmet som en .ACC, och 
sen installera s att nr man dubbelklickar p *.MOD s aktiveras .ACCn.

... Icke multitaskande krna samt skal som inte klarar av VA_START (t.ex. 
vanliga TOS + vanlig desktop) br man installera programmet som .PRG, och 
nr man dubbelklickar p *.MOD s startas programmet.

... Multitaskande krna (Mag!X/MagiC/MTOS) samt skal som klarar av att snda 
VA_START (t.ex. Mag!X + Gemini (Oslagbar kombination!)) br man installera 
programmet som .PRG, och nr man dubbelklickar p *.MOD s startas 
programmet om det inte redan r startas fr d aktiveras det via VA_START 
(kom ihg och stt flaggan fr VA_START i Gemini eller liknande skal!)

... Multitaskande krna samt skal som inte klarar av att snda VA_START, byt 
skal till ett skal som klarar av VA_START!

... I huvudtaget s rekommenderas ett skal som klarar av att snda VA_START, 
vilket gr anvndandet mycket enklare (inte bara av detta program utan det 
finns ganska mnga som supportar det).

  Detta r dock bara rekommendationer fr enkelt anvndande av MODulspelande 
i GEM, programmet gr utmrkt att kra utan dessa installationer.


------------------------------------------------------ Handhavandetext ---


  Modul-spelaren har tv menyer, Spelare och Fil. Observera att om 
programmet krs som en .ACC finns inga menyer utan bara snabbtangenter (dvs 
lr dig de frst innan en installation som .ACC utfrs, eller om man trycker 
p en icke giltig snabbtangent fr man upp en kort lista med 
snabbtangenter). I Spelare fr man fram en kort information om programmet. I 
Fil-menyn finns flera alternativ:


    o  Ladda modul; Visar en filvljare dr man fr vlja en modul att ladda 
                    in.
    o  Nsta modul; Har man flera moduler inladdade kan man vxla aktivt 
                    fnster med detta val.
    o  Stng modul; Stnger aktiv modul, och om den aktiva modulen spelas 
                    stoppas musiken.


    o  Spela aktuell; Spelar aktiv modul.

    o  Stoppa musiken; Stoppar modulen som spelas fr tillfllet.


    o  Instllningar; ppnar ett instllningsformulr.


    o  Avsluta; Avslutar programmet. Om en modul spelas dyker det upp en 
                alertbox som frgar om programmet verkligen skall 
                avslutas. (Fungerar endast nr spelaren krs som .PRG).


  Snabbtangenter finns till alla menyval. Notera att de fljer samma 
standard som t.ex. Gemini.

  Innan en modul kan brja spela s mste det finnas tillrckligt med minne 
fr uppspelarrutinen (c:a 200 000 bytes fr 4 kanaler resp. 360 000 bytes 
fr 8 kanaler). MusikDMAt mste ocks vara ledigt, om det inte r det se 
till och stng av det (troligtvis ngot annat program som anvnder det fr 
tillfllet). ven en viss interupt (som heter timer A) mste vara ledig fr 
att det skall fungera. Om inte interupten r ledigt, avsluta det program som 
anvnder den.

  Nr vl en modul brjar spelas, ppnas den modulens fnster upp och man 
fr se lite information om aktuell status; CPUtid (anvnd av interupten fr 
musiken) samt p vilken position som spelaren befinner sig. Notera att 
filnamnet str i fnsterlisten efter informationen om antalet kanaler (4,6 
eller 8). Notera ven att 4 kanaler tar maximalt 40% i CPUtid, 8 kanaler max 
90% (dock tar de oftast mindre CPUtid). Notera dock att CPUtidsanvndandet 
stiger nr man rr p musen, vilken i 8kanalslget kan resultera i overload 
(mrker man p att musiken brjar hacka). Detta r inget som r spelarens 
fel utan beror p operativsystemets stt att hantera musen. ven andra saker 
kan f 8kanalslget att overloada, t.ex. vid kraftig laddning frn HDn eller 
vid kraftig belastning frn serieporten.

  Man kan ven f lite mera information om modulen nr den vl spelas genom 
att trycka p "fullern" p fnstret (om man har valt "uppdatering P" i 
instllningar). D blir fnstret strre och man fr se CPU-belastning, 
position, lngd, omstart, sngnamn, allokerat minne fr modulen, inladdade 
moduler, samt VU-metrar. Trycker man p "fullern" igen, s blir fnstret 
litet igen.

  Man kan gra fyra olika instllningar av programmet (genom att vlja 
Instllningar i Fil-menyn). "Uppdatera varje xxx ms" talar om hur ofta den 
skall uppdatera fnstret med informationen om aktuellt spelande modul. En 
tid mellan 25-200 millisekunder brukar vara lagom. Om man ihuvudtaget inte 
vill ha ngon uppdatering av fnstret s kan man sl av det genom att stta 
"uppdatering AV". Detta gr att man i fnstret endast ser vilken sngnamn 
som spelas. Frdelen med detta alternativ r att ingen belastning sker p 
GEMdelen iom att timern i GEM stngs av fr spelaren. "Emulera 
tempokontroll" br vara tillslagen, men om en modul spelar i helt fel tempo 
s kan man prva med att sl av den hr flaggan. "Visa CPUbelastning i 
frger" gr att interupten visuellt visar hur lnge den hller p vid varje 
musikskapning. Detta alternativ fyller normal ingen nytta (endast fr mig 
som utvecklare). Man kan spara instllningarna genom att trycka p spara. 
Notera att d sparas ven aktuellt path och filnamn, s nsta gng man 
vljer i filvljaren s kommer man direkt till det sparade stllet. ven 
fnsterplaceringarna sparas, s att fnsterna placeras p just ditt 
favoritstlle vid nsta startupp.

  Om man vill byta upplsning, s se d till att alla modulfnster stngs, 
annars gr allt t pipan. Resultatet p min dator blir att modulen 
fortstter och spela, men iom att en ny PLAYER.ACC laddas, s kommer man 
inte kunna stnga av spelaren, inte heller kunna starta en ny modul eftersom 
interupt och DMA anvnds redan.


-------------------------------------------------- Teknisk information ---


  Skalet r 100% skrivet i assembler. Programmet r testat under TOS 1.62, 
TOS 2.06, Mag!X 2.01 och MultiTOS. Fr att spela upp musiken anvnds 
OCTALYSER STE's matare (Amiga ProTracker-kompatibel) till Lance 4 och 8 
kanaliga UMPmoduler (50kHz 4 eller 8 kanaler!). Spelaren klarar av att ladda 
in moduler sparade av OCTALYSER STE (som anvnder basfrekvensen 16 kHz).


--------------------------------------------------------- Knda buggar ---


  Hr fljer en lista ver knda buggar, om du upptcker en bugg och kan 
reproducera den, var god kontakta mig s att jag kan tgrda den!


- I vanliga TOS hnger sig uppdateringen av fnstret, och kommer igng 
igen s fort som ett meddelande till programmet kommer.
+ Fixat, dock visar CPU-mtaren ngra procent fr mycket.

- Under Mag!X anvnds $DF2 fr att stoppa multitaskingen, utan att ska upp 
adressen p laglig vg (finns det ngon?).
+ Det finns ingen, denna version fungerar endast under Mag!X 2.01

- Krashar under MTOS (samband med TOS's hngning av uppdateringen av 
fnstret?).
+ Delvis fixad, verkar krasha nr man har uppdateringen igng av fnstret av 
ngon konstig anledning. Dessutom instabil interupt av ngon nnu konstigare 
anledning, vilket gr att musiken inte lter s bra under MTOS.

- Ibland meddelas att musikdmat r upptaget fastn det inte r det. Om man 
vljer play igen s fungerar det.


---------------------------------------------------- Att vidarutveckla ---


- Fixa till s att jag anvnder VDI-strngutskrift/boxritning istllet fr 
AES uppdatering av formen.

- Ordna till paus av mus samt koll om den behvs ta bort fr uppdateringen.

- Ordna 68030-kompatibilitet.

- Lgga in en DSPspelare.


----------------------------------------------------------- Copyrights ---


  Detta program fr fritt kopieras och distrubieras om ingen kostnad tas fr 
programmet. I sjlva programfilen fr inga ndringar gras, dock fr 
.RSCfilen ndras fritt, s lnge det framgr att jag (Christian Dahl) 
programmerat spelaren och att Mrten Rnge programmerat UMPerna. Programmet 
anvnds p egen risk, och varken Christian Dahl eller Mrten Rnge kan 
stllas ansvarig fr frstrelse av ngot slag som detta program 
stadkommer.


-------------------------------------------------------- Programmerare ---


  Skalet och mataren skriven av Christian Dahl, skriv till mig om buggar, 
problem eller av ren tacksamhet;

Christian Dahl
Frdingshjd 21
654 73  Karlstad
Sweden
(46)-54-839483

di3dah@f_utbserv.adbutb.hks.se (InterNet)
cd@p4.tnogobl.ct.se (InterNet)
Christian Dahl 2:203/611.4 (FidoNet)
Christian Dahl 90:1103/104.0 (NeST)
Christian Dahl 7:108/102.0 (FujiNet)


  UMP-modulerna skrivna av Mrten Rnge;

Mrten Rnge
Mejerigatan 2/232
412 76 GTEBORG
SVERIGE

d3marten@dtek.chalmers.se (InterNet)


---------------------------------------------------------- End of File ---