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 anv„nder ...

... Icke multitaskande k„rna samt skal som klarar av att s„nda VA_START 
(t.ex. vanliga TOS + GEMINI) b”r man installera programmet som en .ACC, och 
sen installera s† att n„r man dubbelklickar p† *.MOD s† aktiveras .ACCn.

... Icke multitaskande k„rna samt skal som inte klarar av VA_START (t.ex. 
vanliga TOS + vanlig desktop) b”r man installera programmet som .PRG, och 
n„r man dubbelklickar p† *.MOD s† startas programmet.

... Multitaskande k„rna (Mag!X/MagiC/MTOS) samt skal som klarar av att s„nda 
VA_START (t.ex. Mag!X + Gemini (Oslagbar kombination!)) b”r man installera 
programmet som .PRG, och n„r man dubbelklickar p† *.MOD s† startas 
programmet om det inte redan „r startas f”r d† aktiveras det via VA_START 
(kom ih†g och s„tt flaggan f”r VA_START i Gemini eller liknande skal!)

... Multitaskande k„rna samt skal som inte klarar av att s„nda VA_START, byt 
skal till ett skal som klarar av VA_START!

... I huvudtaget s† rekommenderas ett skal som klarar av att s„nda VA_START, 
vilket g”r anv„ndandet mycket enklare (inte bara av detta program utan det 
finns ganska m†nga som supportar det).

  Detta „r dock bara rekommendationer f”r enkelt anv„ndande av MODulspelande 
i GEM, programmet g†r utm„rkt att k”ra utan dessa installationer.


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


  Modul-spelaren har tv† menyer, Spelare och Fil. Observera att om 
programmet k”rs som en .ACC finns inga menyer utan bara snabbtangenter (dvs 
l„r dig de f”rst innan en installation som .ACC utf”rs, eller om man trycker 
p† en icke giltig snabbtangent f†r man upp en kort lista med 
snabbtangenter). I Spelare f†r man fram en kort information om programmet. I 
Fil-menyn finns flera alternativ:


    o  Ladda modul; Visar en filv„ljare d„r man f†r v„lja en modul att ladda 
                    in.
    o  N„sta modul; Har man flera moduler inladdade kan man v„xla aktivt 
                    f”nster med detta val.
    o  St„ng modul; St„nger aktiv modul, och om den aktiva modulen spelas 
                    stoppas musiken.


    o  Spela aktuell; Spelar aktiv modul.

    o  Stoppa musiken; Stoppar modulen som spelas f”r tillf„llet.


    o  Inst„llningar; ™ppnar ett inst„llningsformul„r.


    o  Avsluta; Avslutar programmet. Om en modul spelas dyker det upp en 
                alertbox som fr†gar om programmet verkligen skall 
                avslutas. (Fungerar endast n„r spelaren k”rs som .PRG).


  Snabbtangenter finns till alla menyval. Notera att de f”ljer samma 
standard som t.ex. Gemini.

  Innan en modul kan b”rja spela s† m†ste det finnas tillr„ckligt med minne 
f”r uppspelarrutinen (c:a 200 000 bytes f”r 4 kanaler resp. 360 000 bytes 
f”r 8 kanaler). MusikDMAt m†ste ocks† vara ledigt, om det inte „r det se 
till och st„ng av det (troligtvis n†got annat program som anv„nder det f”r 
tillf„llet). ˇven en viss interupt (som heter timer A) m†ste vara ledig f”r 
att det skall fungera. Om inte interupten „r ledigt, avsluta det program som 
anv„nder den.

  N„r v„l en modul b”rjar spelas, ”ppnas den modulens f”nster upp och man 
f†r se lite information om aktuell status; CPUtid (anv„nd av interupten f”r 
musiken) samt p† vilken position som spelaren befinner sig. Notera att 
filnamnet st†r i f”nsterlisten 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 CPUtidsanv„ndandet 
stiger n„r man r”r p† musen, vilken i 8kanalsl„get kan resultera i overload 
(m„rker man p† att musiken b”rjar hacka). Detta „r inget som „r spelarens 
fel utan beror p† operativsystemets s„tt att hantera musen. ˇven andra saker 
kan f† 8kanalsl„get att overloada, t.ex. vid kraftig laddning fr†n HDn eller 
vid kraftig belastning fr†n serieporten.

  Man kan „ven f† lite mera information om modulen n„r den v„l spelas genom 
att trycka p† "fullern" p† f”nstret (om man har valt "uppdatering P¸" i 
inst„llningar). D† blir f”nstret st”rre och man f†r se CPU-belastning, 
position, l„ngd, omstart, s†ngnamn, allokerat minne f”r modulen, inladdade 
moduler, samt VU-metrar. Trycker man p† "fullern" igen, s† blir f”nstret 
litet igen.

  Man kan g”ra fyra olika inst„llningar av programmet (genom att v„lja 
Inst„llningar i Fil-menyn). "Uppdatera varje xxx ms" talar om hur ofta den 
skall uppdatera f”nstret med informationen om aktuellt spelande modul. En 
tid mellan 25-200 millisekunder brukar vara lagom. Om man ihuvudtaget inte 
vill ha n†gon uppdatering av f”nstret s† kan man sl† av det genom att s„tta 
"uppdatering AV". Detta g”r att man i f”nstret endast ser vilken s†ngnamn 
som spelas. F”rdelen med detta alternativ „r att ingen belastning sker p† 
GEMdelen iom att timern i GEM st„ngs av f”r spelaren. "Emulera 
tempokontroll" b”r vara tillslagen, men om en modul spelar i helt fel tempo 
s† kan man pr”va med att sl† av den h„r flaggan. "Visa CPUbelastning i 
f„rger" g”r att interupten visuellt visar hur l„nge den h†ller p† vid varje 
musikskapning. Detta alternativ fyller normal ingen nytta (endast f”r mig 
som utvecklare). Man kan spara inst„llningarna genom att trycka p† spara. 
Notera att d† sparas „ven aktuellt path och filnamn, s† n„sta g†ng man 
v„ljer i filv„ljaren s† kommer man direkt till det sparade st„llet. ˇven 
f”nsterplaceringarna sparas, s† att f”nsterna placeras p† just ditt 
favoritst„lle vid n„sta startupp.

  Om man vill byta uppl”sning, s† se d† till att alla modulf”nster st„ngs, 
annars g†r allt †t pipan. Resultatet p† min dator blir att modulen 
forts„tter och spela, men iom att en ny PLAYER.ACC laddas, s† kommer man 
inte kunna st„nga av spelaren, inte heller kunna starta en ny modul eftersom 
interupt och DMA anv„nds 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. F”r att spela upp musiken anv„nds 
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 anv„nder basfrekvensen 16 kHz).


--------------------------------------------------------- K„nda buggar ---


  H„r f”ljer en lista ”ver k„nda buggar, om du uppt„cker en bugg och kan 
reproducera den, var god kontakta mig s† att jag kan †tg„rda den!


- I vanliga TOS h„nger sig uppdateringen av f”nstret, och kommer ig†ng 
igen s† fort som ett meddelande till programmet kommer.
+ Fixat, dock visar CPU-m„taren n†gra procent f”r mycket.

- Under Mag!X anv„nds $DF2 f”r att stoppa multitaskingen, utan att s”ka upp 
adressen p† laglig v„g (finns det n†gon?).
+ Det finns ingen, denna version fungerar endast under Mag!X 2.01

- Krashar under MTOS (samband med TOS's h„ngning av uppdateringen av 
f”nstret?).
+ Delvis fixad, verkar krasha n„r man har uppdateringen ig†ng av f”nstret av 
n†gon konstig anledning. Dessutom instabil interupt av n†gon „nnu konstigare 
anledning, vilket g”r att musiken inte l†ter s† bra under MTOS.

- Ibland meddelas att musikdmat „r upptaget fast„n det inte „r det. Om man 
v„ljer play igen s† fungerar det.


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


- Fixa till s† att jag anv„nder VDI-str„ngutskrift/boxritning ist„llet f”r 
AES uppdatering av formen.

- Ordna till paus av mus samt koll om den beh”vs ta bort f”r uppdateringen.

- Ordna 68030-kompatibilitet.

- L„gga in en DSPspelare.


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


  Detta program f†r fritt kopieras och distrubieras om ingen kostnad tas f”r 
programmet. I sj„lva programfilen f†r inga „ndringar g”ras, dock f†r 
.RSCfilen „ndras fritt, s† l„nge det framg†r att jag (Christian Dahl) 
programmerat spelaren och att M†rten R†nge programmerat UMPerna. Programmet 
anv„nds p† egen risk, och varken Christian Dahl eller M†rten R†nge kan 
st„llas ansvarig f”r f”rst”relse av n†got 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
Fr”dingsh”jd 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 M†rten R†nge;

M†rten R†nge
Mejerigatan 2/232
412 76 G™TEBORG
SVERIGE

d3marten@dtek.chalmers.se (InterNet)


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