@database "ACDPlay AmigaGuide dokumentasjon" @$VER: ACDPlay 1.0 AmigaGuide dokumentasjon @node "main" "ACDPlay dokumentasjon" @{b}ACDPlay Versjon 1.0 =====================@{ub} © 1996 Marc Altmann og Martin Kresse ACDPlay bruker cdplay.library av Patrick Hess Oversatt av Eivind Olsen Korrekturlest av Kjell Irgens @{" Introduksjon " link "introduksjon" 0} - hvorfor enda en cd-spiller? @{" Finesser " link "finesser" 0} - hvorfor ACDPlay? @{" Systemkrav " link "systemkrav" 0} - systemkrav, programbibliotek osv. @{" Opphavsrett " link "opphavsrett" 0} - juridisk status @{" Installering " link "installering" 0} - hva installeringsskriptet gjør @{" Bruk " link "bruk" 0} - forklaring av bruk @{" Innstillinger " link "innstillinger" 0} - innstillinger via ikonargumenter @{" ARexx port " link "arexx" 0} - ARexx kommandoer @{" Filformater " link "filformater" 0} - CD- og program-filenes struktur @{" Kjente feil " link "kjentefeil" 0} - feil som ikke er fikset enda @{" FAQ " link "faq" 0} - vanlige spørsmål @{" Endringer " link "endringer" 0} - ACDPlay's utvikling @{" Fremtid " link "fremtid" 0} - hva som kommer senere @{" Utgiverne " link "utgiverne" 0} - adresser og annen informasjon @{" Takk til... " link "takker" 0} - andre som har vært involvert @endnode @node "introduksjon" "Introduksjon" Vi har ofte blitt spurt @{b}hvorfor vi lager en cd-spiller@{ub}, sannsynligvis fordi det er mange viktigere ting å lage. La oss si to ting om det: 1. Dette prosjektet ble startet våren 1996 men ble liggende brakk til september. På det tidspunktet var det ikke like mange cd-spillere som det er i dag. 2. Det er unødvendig å rettferdiggjøre et program som man ikke er tvunget til å bruke og som i tillegg er gratis å bruke. (derfor frafalles punkt 1) @{b}ACDPlay@{ub} ACDPlay's hovedidé er hurtighet og et kompromiss mellom komfort og å unngå unødig programkode. ACDPlay's hovedkarakteristikker er asynkron vindus- håndtering og et brukergrensesnitt som ikke er basert på MUI (dette kan være både en fordel og en ulempe). Videre er ACDPlay basert på cdplay.library (av Patrick Hess), som virkelig hjalp oss mye og også oppmuntret oss til å starte ACDPlay. Det er mulig vi kommer til å bruke våre egne SCSI-rutiner i senere versjoner. Vi vil uansett på en eller annen måte forbedre oppdaterings- funksjonen og gjøre den hurtigere. @endnode @node "finesser" "Finesser" @{b}ACDPlay...@{ub} - er epost-vare - bruker cdplay.library av Patrick Hess - tilbyr et lite, fontsensitivt, kompakt brukergrensesnitt med muligheten til å slå av/på deler (hovedvinduet) - tilbyr både standard og MagicWB grafikk - kommer med full asynkron vinduhåndtering - har en såkalt "sporglider" for enkel posisjonering i sporene - fungerer som en @{b}commodity@{ub} - støtter locale.library (OS 2.1) - støtter screennotify.library - kommer med en (enkel) ARexx port i den første utgaven - er delvis skrevet i assembler - kan åpnes på enhver offentlig skjerm; en liste over offentlige skjermer kan åpnes for å velge skjerm umiddelbart - lar deg lagre vindusposisjonene - lar deg selvsagt lagre CD titlene og programmer - har et ekstra vindu for å lage programmer - støtter tilfeldig spilling såvel som flere gjenta-modi - konfigureres via ikon-argumenter for å holde programmet lite @endnode @node "systemkrav" "Systemkrav" @{b}ACDPlay krever@{ub} den følgende maskinvare/programvare: - en Amiga - OS 2.04 (V37) - en SCSI CD-ROM enhet - cdplay.library av Patrick Hess (inkludert) I tillegg kan ACDPlay nyttegjøre seg av følgende @{b}valgfri programvare@{ub}: - OS2.1 eller nyere - ACDPlay bruker locale.library - screennotify.library av Stefan Becker - Hvis Workbench skjermen må lukkes for å foreta endringer vil ACDPlay lukke sine vinduer midlertidig. - ARexx - Hvis RexxMast er startet kan ACDPlay kontrolleres ved bruk av @{"ARexx kommandoer" link "arexx" 0}. @endnode @node "opphavsrett" "Opphavsrett" @{b}Ansvarsfraskrivelse@{ub} Utgiverne kan ikke holdes ansvarlig for skade eller tap som er påført direkte eller indirekte av dette produktet. @{b}Opphavsrett@{ub} Innehaverne av opphavsretten til dette produktet er utgiverne Marc Altmann og Martin Kresse. Dette produktet kan bare videreformidles i sin originale form. Dette produktet er epost-vare. Det kan fritt distribueres, men brukerne oppfordres til å sende en epost til ihvertfall en av utgiverne, såfremt man har muligheten til å sende epost. Disse vilkårene kan endres av utgiverne. @endnode @node "installering" "Installering" Vanligvis installeres ACDPlay ved å bruke det inkluderte Installer- skriptet. ACDPlay kan allikevel installeres manuelt om man følger instruksjonene som følger: @{b}Manuell installering@{ub} 1. Opprett en katalog kalt "ACDPlay" på en eller annen partisjon. 2. Opprett tre nye kataloger inni denne: "ARexx", "catalogs", "Disks" 3. Kopier hovedprogrammet "ACDPlay" fra arkivets ACDPlay-katalog og den tilhørende Amigaguide-filen fra Docs-katalogen og til den nylig opprettete ACDPlay-katalogen. 4-fargers ikoner ligger i Icons-katalogen. 4. Kopier innholdet i ARexx-katalogen til den nye ARexx-katalogen. 5. Kopier den tilhørende katalogen sammen med #?.catalog filen fra Catalogs-katalogen til den nye Catalogs-katalogen. 6. Du kan om du ønsker kopiere eksempel tittel-filene fra Disks/ til Disks/. 7. Hvis det ikke allerede ligger der kopierer du cdplay.library fra libs- katalogen til LIBS: 8. Juster DEVICE- og UNIT-ikonargumentene i hovedprogrammets ikonfil slik at disse svarer med SCSI-enhetens navn og CD-ROM enhetens nummer. @endnode @node "bruk" "Bruk" @{b}Bruk - overblikk@{ub} Selv om bruken av en cd-spiller er nokså selvforklarende så kan det være nyttig å vite hva ACDPlay gjør i en bestemt situasjon (dessverre kan jeg ikke komme på noen eksempler :-) @{" Menyer " link "bruk_menyer" 0} - ACDPlay's menystruktur @{" Hovedvindu " link "bruk_vin_hoved" 0} - forklaring av alle kontrollene @{" Tittelvalgvindu " link "bruk_vin_tittel" 0} - tittelvalg vinduet @{" Programmeringsvindu " link "bruk_vin_prog" 0} - programmeing av cd-spilleren @{" Tittelredigeringsvindu " link "bruk_vin_titred" 0} - redigering av navnene på cd'er og spor @{" Offentlig skjerm-vindu " link "bruk_vin_offentlig" 0} - velger en annen offentlig skjerm @{" CD info-vindu " link "bruk_vin_cdinfo" 0} - informasjon om CD'en @{" Enhetsinformasjonsvindu " link "bruk_vin_enhetsinfo" 0} - informasjon om SCSI enheten @endnode @node "bruk_menyer" "Menyer" @{b}ACDPlay's menyer@{ub} @{u}@{b}Prosjekt:@{ub}@{uu} @{u}Informasjon:@{uu} Åpner det respektive informasjonsvinduet: @{"CD-Info" link "bruk_vin_cdinfo" 0} or @{"Enhetsinformasjon" link "bruk_vin_enhetsinfo" 0}. @{u}Om ACDPlay...:@{uu} Åpner et informasjonsvindu som inneholder versjonsnummer samt en notis om opphavsrett. @{u}Gjem:@{uu} Lukker alle vinduene til ACDPlay og frigjør noe minne. Vinduene kan gjenåpnes via Commodity håndtereren Exchange, eller via en hurtigtast. @{u}Avslutt:@{uu} Avslutter ACDPlay. Hverken titler eller programmer vil bli lagret. @{u}@{b}Grensesnitt:@{ub}@{uu} @{u}Vinduer:@{uu} Åpner de respektive vinduene: @{"Tittelvalgvindu" link "bruk_vin_tittel" 0}, @{"Programmeringsvindu" link "bruk_vin_prog" 0} eller @{"Tittelredigering" link "bruk_vin_titreg" 0}. @{u}GUI elementer:@{uu} Du kan slå på eller av flere elementer i hovedvinduet. Grunnet flervalg med venstre musknapp er det enkelt å få det ønskete brukergrensesnittet med kun et menykall. Disse elementene er som følger: - Direktevalg 1-10 : de 10 første direktevalg-knappene - Direktevalg 10-20 : den andre raden med direktevalg - Tittel : en tekstknapp som inneholder navnet på det nåværende sporet - Spor/Indeks/Tid : to tallknapper som viser nåværende spor og indeks samt en (klikkbar) knapp som viser tiden - Spillemodus/Gjenta : To rulleknapper for å velge og vise den nåværende spille- og gjenta-modusen - Panel : cd-spiller knapper som "Pause" og "Stopp" - Spor-glider : en glideknapp for å enkelt velge posisjon i det nåværende sporet @{u}Magic-WB:@{uu} Slår av eller på MagicWB 8-fargers knapper (skjermen må ha minst 8 farger!) @{u}Offentlig skjerm...:@{uu} Åpner @{"Offentlig skjerm-vindu" link "bruk_vin_offentlig" 0}. @{u}Lagre:@{uu} Lagrer de nåværende vindusposisjonene og størrelsene på @{u}alle@{uu} vinduene, samt om det enkelte vindu skal åpnes når ACDPlay startes. @endnode @node "bruk_vin_hoved" "Hovedvindu" @{b}Hovedvinduet@{ub} @{u}Vinduets tittellinje:@{uu} Vinduets tittellinje viser CD-ROMens nåværende status; "Ingen CD i enhet", "CD satt i", "Spiller CD" eller "Pause". Hvis ikonargumentet USEWINDOWBAR er satt til YES vil også CDens navn vises istedenfor artistens navn. @{u}Direktevalg-knapper:@{uu} Når man spiller CDer kan man hoppe direkte til et spor ved å klikke på en slik knapp. Du kan også bruke nummertastene på tastaturet, selv om det er en liten @{"feil" link "kjentefeil" 0} når man bruker det numeriske tastaturet. @{u}Tittelvalg:@{uu} Viser navnet på det valgte sporet. @{u}Spor, indeks og tid@{uu} Det valgte sporet, indeksnummer samt tiden vises. Du kan klikke på tiden for å bla gjennom forskjellige modus. 1. tid passert (spor) / total tid (spor) 2. tid igjen (spor) / total tid (spor) 3. tid passert (CD) / total tid (CD) 4. tid igjen (CD) / total tid (CD) @{u}Spillemodus rulleknapp:@{uu} Endrer spillemodus. Hvis ACDPlay allerede spiller noe vil det bli spilt igjen i det nye spillemoduset. 1. CD: CD'en vil bli spilt uten at ACDPlay har direkte kontroll over den. Direkte valg av spor via direktevalg-knappene er kun mulig i dette modus. 2. Tilfeldig CD: Hvert spor vil bli spilt i tilfeldig rekkefølge. For sammenhengende spilling må du velge "Gjenta alt". 3. Program: Det valgte programmet vil bli spilt. Hvis et program ble ble lagret til harddisk vil ACDPlay automatisk laste det inn når CD'en settes i eller når ACDPlay startes. 4. Tilfeldig program: Hver post i programmet vil bli spilt i tilfeldig rekkefølge. På denne måten er det mulig å unngå at enkelte spor blir spilt i tilfeldig-modus, eller for å øke sjansene for at enkelte spor blir spilt. @{u}Gjenta-modus rulleknapp@{uu} Endrer gjenta-karakteristikken. 1. Ikke gjenta: ACDPlay vil på et tidspunkt stoppe å spille; når hver tittel eller hver post i et program er spilt (CD eller programmerings-modus). 2. Gjenta spor: Det nåværende sporet vil bli gjentatt helt til et annet spor er valgt eller gjenta-modus endres. 3. Gjenta alt: ACDPlay vil begynne helt fra begynnelsen når hele CD'en eller hele programmet er ferdig. @{u}Panel:@{uu} Dette er knappene de fleste kjenner igjen fra vanlige CD-spillere. Forklaringer (fra venstre): 1. Tar ut CD'en. Tittel og programdata vil gå tapt om du ikke lagret disse på forhånd. 2. Hopper frem og spiller et spor eller en post i programmet. I tilfeldig-modus vil et tilfeldig spor bli spilt. 3. Hopper tilbake og spiller et spor eller en post i programmet. I tilfeldig-modus vil et tilfeldig spor bli spilt. 4. Hopper flere sekunder bakover i sporet (kan bestemmes via et @{"ikonargument" link "innstillinger" 0}). Hvis den nye posisjonen ikke er i det nåværende sporet vil ingenting skje. 5. Hopper flere sekunder fremover i sporet (kan bestemmes via et @{"ikonargument" link "innstillinger" 0}). Hvis den nye posisjonen ikke er i det nåværende sporet vil ingenting skje. 6. Stopper spilling. 7. Slår av eller på pausen. I pause-modus stopper spillingen, men den nåværende posisjonen i sporet beholdes. Man kan også for eksempel hoppe til en bestemt posisjon i sporet eller starte fra et annet spor for så å spille dette - med å presse pause eller "spill" knappen. 8. Vanligvis vil ACDPlay begynne å spille CD'en eller det valgte programmet. Hvis pause-modus er på vil ACDPlay fortsette å spille. Hvis ACDPlay allerede spiller et spor vil dette sporet spilles omigjen fra begynnelsen. @{u}Spor-glider:@{uu} Ved å bruke spor-glideren kan man enkelt velge en posisjon i et spor da man kjapt og greit kan dra glideren til den ønskete posisjonen. Presisjonen avhenger av sporets lengde (1%). @endnode @node "bruk_vin_tittel" "Tittelvalg-vindu" @{b}Tittelvalg-vinduet@{ub} Tittelvalg-vinduet viser hele tiden navnet på sporene på CD'en. Denne listen blir selvsagt konstant oppdatert. Et dobbelklikk på listen har samme funksjon som å klikke på en av direkte- valg knappene. Se også @{"Hovedvindu" link "bruk_vin_hoved" 0}. @endnode @node "bruk_vin_prog" "Programmeringsvindu" @{b}Programmerings-vinduet (program-redigering)@{ub} Innholdsfortegnelsen på CD'en vises i den venstre listen, programmet vises i den høyre listen. Programmet kan redigeres mens CD'en spiller, med unntak av når hele programmet eller det nåværende sporet blir slettet fra listen. I det tilfellet vil ACDPlay stoppe spillingen. @{u}Å legge til titler:@{uu} For å legge til en bestemt tittel til programmet kan du dobbelklikke på den ønskede tittelen i den venstre listen. Trykk på knappen 'Kopier alt' for å lage et program som er en kopi av alt innholdet på CD'en. @{u}Sletting av titler:@{uu} Dobbelklikk på en post i den høyre listen for å slette den fra programmet. For å slette hele programmet kan du trykke på knappen merket 'Slett program'. @{u}Henting og lagring:@{uu} Du kan lagre (eller hente inn) et program for hver CD. Selv om et tilgjengelig program blir hentet inn når du setter i CD'en eller når ACDPlay startes, så kan du også hente inn et program med å trykke på knappen merket 'Åpne'. Hvis det forrige programmet holdt på å spille, så vil ACDPlay nå begynne å spille det nye programmet. Ved å trykke på knappen merket 'Lagre' vil et eventuelt eksisterende program for denne CD'en bli overskrevet av det nye. Hvis du skal lagre et tomt program så vil program-filen bare bli slettet (såfremt det er mulig). @endnode @node "bruk_vin_titreg" "Tittelredigering-vindu" @{b}Tittelredigering-vinduet (tittel-redigering)@{ub} Ved hjelp av de to tekststreng-knappene kan du nå skrive inn CD'ens og artistens navn. Navnene på sporene vises i listen under, de kan endres ved hjelp av tekststreng-knappen som hører til listen. Det er anbefalt å aktivere det første sporet og avslutte skrivingen av navnet der med å trykke på 'Retur'-knappen. I dette tilfellet vil da ACDPlay automatisk aktivere det neste sporet. Merk: Kun når du trykker 'Lagre' vil tittel-dataene bli lagret til harddisken! @endnode @node "bruk_vin_offentlig" "Offentlig skjerm-vindu" @{b}Offentlig skjerm-vinduet@{ub} Når dette vinduet åpnes vil det vise en liste over alle de offentlige skjermene som er åpne for øyeblikket. Dobbelklikk på listen for å få ACDPlay til å åpne brukergrensesnittet sitt på den valgte skjermen. For å oppdatere listen over offentlige skjermer må vinduet lukkes og åpnes igjen. @endnode @node "bruk_vin_cdinfo" "CD info-vindu" @{b}CD informasjon@{ub} Dette vinduet viser navnet på CD'en og artisten samt antallet spor og den totale spille-tiden. @endnode @node "bruk_vin_enhetsinfo" "Enhetsinformasjon-vindu" @{b}Enhetsinformasjon@{ub} Dette vinduet viser SCSI-enhetens navn og nummer. I tillegg vil også produsentens navn (f.eks "TOSHIBA"), det nøyaktige navnet på produktet (f.eks "CD-ROM XM-5201TA" og en produsent-avhengig tekst bli vist. @endnode @node "innstillinger" "Innstillinger" @{b}Innstillinger v.h.a. ikonargumenter@{ub} ACDPlay konfigureres v.h.a. såkalte ikonargumenter. Disse ikonargumentene ligger lagret i programmets ikon, og kan endres med å velge menyvalget "Ikon->Informasjon..." fra Workbench-menyene. @{u}Ikonargumenter:@{uu} CX_POPUP: bestemmer om ACDPlay skal åpne sitt brukergrensesnitt når programmet blir startet første gangen. (Standard: YES) CX_POPKEY: bestemmer hurtigtastene for ACDPlay. "rawkey" må også spesifiseres. (Standard: rawkey lshift alt F1) CX_PRIORITY: Prioriteten til ACDPlay som et commodity-program (Standard: 0) DEVICE: SCSI-driverens navn (Standard: "1230scsi.device") UNIT: Enhetsnummeret til CD-ROM'en (Standard: 0) PUBSCREEN: Bestemmer hvilken offentlig skjerm ACDPlay skal åpne på HOTKEYCAUSES: Bestemmer hva ACDPlay skal gjøre når hurtigtastene blir trykket ned og ACDPlay sitt brukergrensesnitt allerede er åpnet: FRONTMOST: ACDPlay prøver å åpne GUI'et sitt på den fremste skjermen HIDE: ACDPlay vil lukke/gjemme GUI'et sitt (Standard) SCREENTOFRONT: Skjermen ACDPlay er på vil bli lagt fremst USEWINDOWBAR: Skal ACDPlay bruke hovedvinduets tittel-linje til å vise navnet på CD'en? (Standard: YES) USESCREENBAR: Skal ACDPlay bruke skjermens tittel-linje til å vise CD'ens og artistens navn? (Standard: NO) DISKPATH: Katalogen som inneholder alle tittel- og program-filene. (Standard: Disks/) MAGICWB: Bestemmer om ACDPlay skal bruke MagicWB grafikk. (Standard: NO) @endnode @node "arexx" "ARexx port" @{b}Fjern-kontroll via ARexx porten@{ub} Med hjelp av en ARexx port kan brukeren få ACDPlay til å utføre mange av sine funksjoner "fra utsiden". For tiden er det kun et meget enkelt kommandosett, men vi ser frem til å utvide antallet kommandoer i en av de neste versjonene. Portens navn er: @{b}ACDPLAY@{ub} @{u}ARexx kommandoer:@{uu} PLAY: samme som '>' knappen STOP: samme som '#' knappen EJECT: tar ut CD'en NEXTSONG: samme som '>|' knappen PREVSONG: samme som '|<' knappen SHOW: åpner ACDPlay's brukergrensesnitt HIDE: lukker alle åpne vinduer QUIT: ikke bruk ;-) @endnode @node "filformater" "Filformater" @{b}Tittel-filenes format@{ub} @{u}Filnavn:@{uu} "ID" (2 tegn) + antall spor (2 tegn, desimal) + tredje sporets start-adresse (6 tegn, hexadesimal) + siste sporets start-adresse (6 tegn, hexadesimal) @{u}Format:@{uu} artistens navn + linjeskift CD'ens navn + linjeskift første sporets navn + linjeskift ... siste sporets navn + linjeskift ACDPlay leser maksimalt 128 tegn pr. navn, de etterfølgende tegnene vil bli hoppet over. (Dette filformatet kan også leses av mange andre CD-spiller programmer, samt det er en stor samling med CD-titler på Aminet (omtrent 2600 titler): disk/cdrom/CDIDCollection.lha) @{b}Program-filenes format@{ub} @{u}Filnavn:@{uu} "PR" (2 tegn) + antall spor (2 tegn, desimal) + tredje sporets start-adresse (6 tegn, hexadesimal) + siste sporets start-adresse (6 tegn, hexadesimal) @{u}Format:@{uu} første sporets nummer (1 Byte) andre sporets nummer (1 Byte) ... @endnode @node "kjentefeil" "Kjente feil" @{b}ACDPlay's feil@{ub} - ACDPlay sluker mye CPU-tid. Dette skyldes cdplay.library sine oppdaterings-rutiner. Vi jobber allikevel med saken... - Hvis det numeriske tastaturet brukes for å velge spor vil oppdateringen stoppe inntil man f.eks trykker på en av de vanlige nummer-tastene. - ACDPlay kan krasje med enkelte CD-ROM enheter hvis (maskinvare) @{i}eject@{ui} knappen blir trykket inn mens CD'en spiller. @endnode @node "faq" "FAQ" @{b}Ofte stilte spørsmål (Frequently Asked Questions - FAQ)@{ub} @{fg fill}Q: Av og til kan ikke ACDPlay åpne SCSI-enheten.@{fg text} A: Med enkelte CD-ROM enheter kan bare ACDPlay startes når du har en CD i. Denne feilen vil også rettes opp snarest... @{fg fill}Q: Det er kun noen få tittel-filer i arkivet. Hvor kan jeg finne flere?@{fg text} A: Det er en enorm samling CD-titler i Aminet (omkring 2600 titler): disk/cdrom/CDIDCollection.lha @endnode @node "endringer" "Endringer" @{b}ACDPlay's utvikling{ub} 24 Des 1996 - Første offentlige utgave @endnode @node "fremtid" "Fremtid" @{b}Hva kommer i fremtiden@{ub} - CPU-forbruket vil gå ned, sannsynligvis ved å bruke egne SCSI-rutiner - A-B-Gjenta - Et volum-vindu - Bruk av en tittel-database istedenfor en fil pr. CD. - Utvidelser i ARexx porten (programmering osv.) - Feilfjerning :-) @{b}Hva som fremdeles er et stykke unna i tid@{ub} - Audiolagring @endnode @node "utgiverne" "Utgiverne" @{b}Programmererne@{ub} ACDPlay ble programmert (med høy innsats) av de følgende personene (i alfabetisk rekkefølge): Marc Altmann mcthree@berlin.snafu.de Martin Kresse mak@ATP.dame.de For rykende fersk informasjon, oppdateringer eller nye språkfiler, ARexx skriptfiler osv. kan du besøke ACDPlay hjemmesiden: @{b}http://www.snafu.de/~mcthree/acdplay@{ub} @endnode @node "takker" "Takk til..." @{b}Vi retter vår takk til...@{ub} Patrick Hess (poseidon@newswire.de) - for hans cdplay.library som gjorde det mulig for oss å lage ACDPlay. Eivind Olsen (eivindo@bgnett.no) - for å oversette alle tekstene til norsk Kjell Irgens (kjelli@stud.cs.uit.no) - for å korrekturlese de norske tekstene @endnode