# &kscd; käsiraamat

## Sissejuhatus

&kscd; on kiire, CDDB-võimalusega &CD;-mängija paljudele &UNIX; platvormidele. &kscd; tähendab 'KDE projekti väike/lihtne &CD;-mängija' (inglise keeles The KDE Project's small/simple &CD; player).

Uus: Perli skript `workman2cddb.pl`, mis lubab märksa valutumalt üle tulla ka workmani kasutajatel.

Loodetavasti meeldib see &CD;-mängija sulle väga.

Bernd Johannes Wuebben

wuebben@kde.org

### Toetatud platvormid

&kscd; toetab otseselt järgmisi platvorme:

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- &Solaris; (sealhulgas cdda tugi)

- &HP-UX;

- &SGI; Irix (sealhulgas cdda tugi)

- Sony NEWS

- OSF/1

- Ultrix

ja peaks kompileeruma veel paljudel platvormidel, nõudes vahest vaid väikesi muudatusi.

## Kasutamise põhitõed

### Peategevus

&kscd; liides &kscd; liides

See on &kscd; peaaken, millist sa näed &kscd; käivitamisel. Mida miski selles aknas teeb, selgitame allpool.

#### Juhtimispaneel

Juhtimispaneel Juhtimispaneel

See on &kscd; juhtimispaneel. Siinolevate nuppude tähendus peaks olema selge kõigile, kes üldse kunagi on mõne &CD;-mängijaga kokku puutunud.

Ülemine nupp siinsel pildil lülitab &CD; esitamist ja pausi. Vasakpoolne nupp teises reas peatab &CD; esitamise. Teise rea parempoolne nupp lükkab &CD; välja. Kolmanda rea kaks nuppu hüppavad edasi (parempoolne) või tagasi (vasakpoolne) järgmise või eelmise pala algusse. Alumise rea vasakpoolne nupp lülitab kordust, mis juhul, kui see on sees, alustab &CD; esitamist uuesti, kui kõlanud on viimase pala viimased helid.

#### Olekuvaade

Olekuvaade Olekuvaade

See näitab olekut. Ülalt alates paremalt vasakule on siin näha aeg (allpool tuleb lähemalt juttu aja erinevatest esitamisvõimalustest), &CD-ROM; seadme olek, audio &CD; koguaeg, parajasti kehtiv helitugevus ning praegune raja number ja radade arv kokku. Alumised kaks tekstirida näitavad esitajat ja &CD; nime ning raja nime - eeldusel, et sellised kirjed on ikka kohalikus või võrgus asuvas CDDB-s (&CD; andmebaas) olemas.

Erinevate aja esitamisviiside valimiseks klõpsa ajakirjel. Vaikimisi näitab &kscd; antud raja esitamiseks juba kulunud aega, kui käib &CD; esitus, või ––:–– või 00:00, kui &CD; esitust ei käi. Vaatel klõpsates saab valida allesjäänud rajaaja, kokku esitamisele kulunud aja ja kokku allesjäänud aja vahel.

#### Seadistamisnupp

Lisade nupp Lisade nupp

Sellele nupule klõpsates avaneb menüü mitme valikuga. Sul on võimalik avada &kscd; seadistustedialoog või seadistada kiirklahve. Nii saad häälestada &kscd; just enda maitsele sobivaks. &kscd; seadistamisest kõneleb lähemalt &kscd; seadistamise osa.

Menüü pakub mitu võimalust hankida esitaja kohta infot internetist. Sa võid leida esinemisaegu, helikandjate ostmisvõimalusi ja muud infot, kui klõpsad sellele nupule ja valid ilmuvast hüpikmenüüst vajaliku kirje.

Menüüst saab avada ka käesoleva käsiraamatu, anda teada vigadest, saada infot &kscd; ja &kde; kohta või &kscd; töö lõpetada.

#### CDDB nupp

CDDB nupp CDDB nupp

Sellele nupule klõpsates avatakse CDDB (CD andmebaas, inglise keeles Compact Disc Data Base) kirje redaktor.

CDDB võib tuvastada sinu &CD; ning enamasti laadida alla selle &CD; radade loendi või laadida selle failisüsteemist. Täpsemat infot selle kohta annab &CD; andmebaasi redaktorist pajatav osa.

#### Helitugevuse nupp

Helitugevuse nupp Helitugevuse liugur

Sellele nupule klõpsates ilmub liugur, millega saab määrata &CD; esitamise helitugevust. Liugurit paremale nihutades heli valjeneb, vasakule nihutades nõrgeneb. Kui kasutad &CD; esitamisel helikaarti, mõjutab helitugevust ka helikaardi mikser.

#### Rajavalija

Rajavalija Rajavalija

See liitkast näitab parajasti esitatavat rada ning võimaldab valida esitamiseks millise tahes raja.

## &kscd; seadistamine

### Peamine seadistamisaken

&kscd; peamine seadistamisaken kujutab endast kaartidega dialoogi, millel on kolm suuremat osa.

- CD-mängija

- Freedb otsing

- Freedb postitus

### CD-mängija kaart

CD-mängija kaart KSCD seadistamise kaart

Väljad LCD värv ja Taustavärv näitavad vstavalt olekuvaate esiplaani ja tausta värvi. Värviribale klõpsates saab neid muuta.

Ikooni näidatakse süsteemses dokis: selle sisselülitamisel näidatakse &kscd; ikooni &kicker;i paneelil.

Hüppe intervall võimaldab määrata, mitu sekundit liigutakse edasi või tagasi, kui juhtimispaneelil klõpsata nuppu hüppa edasi või hüppa tagasi.

Automaatne esitus CD sisestamisel alustab &CD; mängimist kohe, kui oled selle masinasse pannud ja salv on sulgunud. Nii ei ole vaja isegi nupule Esitus klõpsata.

Lugude lõppemisel väljastatakse CD-plaat valimine sunnib &CD; väljastama pärast esituse lõppemist.

Väljumisel peatatakse CD esitus valimisel lõpetatakse &CD; esitus, kui lõpetad &kscd; töö.

Väljal CD-ROM seade seisab selle &CD-ROM; seadme nimi, mida kasutad audio &CD;-de mängimiseks. Vaikimisi on selleks `/dev/cdrom`. Antud seadmele määratud õigused peavad lubama seadet ainult lugemiseks avada. Seadme õiguste muutmine nõuab peaaegu kindlasti administraatori kätt ning seda on võimalik teha nii käsurealt kui ka &konqueror; administraatori õigustes käivitades.

Nupp Abi avab &kscd; käsiraamatu. Nupp OK salvestab kehtivad seadistused ja väljub dialoogist. Nupp Rakenda salvestab kehtivad seadistused, kuid ei sulge dialoogi. Nupp Loobu sulgeb dialoogi ilma midagi salvestamata.

### Freedb otsingu kaart

Seadistustedialoogi Freedb otsingu kaart Seadistustedialoogi Freedb otsingu kaart

Kaardil Freedb otsing saab määrata kindlaks &kscd; CDDB võimalused.

Valikuga Režiim saab määrata, kuidas CDDB otsing sooritada. Ainult puhver tähendab, et kasutatakse ainult infot, mis on juba sinu arvutis. Puhver ja kaugpäring otsib infot, mida sul veel ei leidu, Ainult kaugserverist aga otsib alati infot internetist. Määrata saab ka aja, mille ületamisel loetakse päring ebaõnnestunuks.

Loendikast CDDB server: võimaldab määrata kindlaks Freedb-serveri. Kirjuta siia serveri aadress ja pordinumber. Vali kirje loendist ning see ilmub tekstiväljale valikukasti kohal. Määrata saab ka ühendusviisi (CDDB või HTTP - tõenäoliselt oleks mõttekas jätta kehtima vaikimisi määratud valik). Tekstiväljal Puhverkataloogid saab valida kataloogid, kuhu soovid oma arvutis CDDB kirjed salvestada.

### Freedb postitamise kaart

Freedb postitamise kaart

Freedb postitamise kaart võimaldab määrata ühenduse meiliserveriga, mille vahendusel saata uusi CDDB kirjeid. See on kasulik juhul, kui sa ei ole oma süsteemi serverina seadistanud. Selle kasutamiseks märgi ära võimalus SMTP kaudu postitamine lubatud.

Soovi korral võid klõpsata kirjele Kasutatakse juhtimiskeskuses kirjeldatud meiliaadressi. Kui soovid avada &kcontrol;e mooduli antud aadressi seadistamiseks, klõpsa tekstikirjele Ava meiliaadressi seadistamise dialoog. Aadressi muutmine selles muudab sinu e-posti vaikeaadressi kõigi &kde; rakenduste, mitte ainult &kscd; jaoks, mistõttu pruugi seda võimalust ettevaatlikult.

Teine võimalus on anda eelistatud e-posti profiil kastis Kasutatakse neid meiliaadresse. Kirjuta siia oma e-posti aadress, soovi korral ka aadress, kuhu saadetakse vastused, ning SMTP-serveri aadress väljale Server:t. Samuti võib anda autentimiseks kasutajanime ja pordinumbri (tavaliselt `25`) väljal Port:.

Nupp Abi avab &kscd; käsiraamatu. Nupp OK salvestab kehtivad seadistused ja väljub dialoogist. Nupp Rakenda salvestab kehtivad seadistused, kuid ei sulge dialoogi. Nupp Loobu sulgeb dialoogi ilma midagi salvestamata.

## CD andmebaasi redaktor

CD andmebaasi redaktor CD andmebaasi redaktor

&CD; andmebaasi redaktor võimaldab muuta, alla laadida, salvestada, annoteerida ja üles laadida CDDB (CD andmebaasi) kirjeid.

Kui sinu kohalikus CDDB puus (vaata seadistamispeatüki CDDB lõiku) on olemas kirje &CD-ROM; seadmes oleva &CD; kohta või kui plaadi andmed leiti Freedb-s, näed &CD; nime ja selle esitaja nime väljadel Esitaja: ja Pealkiri: ning radade loendit valikukastis Rajad. Vastasel juhul näed radade loendit ja nende kestust, kuid mitte pealkirju.

Terve plaadi võid annoteerida nupule Kommenteeri (välja Pealkiri all) klõpsates. Kui soovid annoteerida konkreetset rada, vali see valikukastis Rajad ning klõpsa kasti all asuvale nupule Kommenteeri. Kui valid raja kastis Rajad, on selle pealkiri, kui see on teada, näha alloleval väljal Pealkiri. Võid kirjutada kasti raja pealkirja või muuta kirjet nii, nagu parajasti vaja. Vajuta klahvile Return ning muudetud teksti ilmub kastis vastaval real nähtavale.

Kui oled andnud kõigile radadele pealkirja ning täitnud väljad Esitaja: ning Pealkiri, võid oma panuse saatmiseks e-postiga Freedb-le klõpsata nupule Saada.

Sul palutakse ka valida postituse kategooria. Sektsioon Plaadi ID on näha 32-bitine ID kood, mida Freedb kasutab CD tuvastamiseks. ID koodi kohal on freedb kategooria kirje. Need kategooriad vastavad alamkataloogidele kataloogis, mis on valitud &kscd; seadistustedialoogi freedb kaardil valikuga Freedb baaskataloog.

Koguaeg näitab &CD; palade koguesitamisaega.

CDDB andmete allalaadimiseks klõpsa nupule Laadi info. Muudatuste salvestamiseks ainult enda arvutis klõpsa nupule OK. Nupule Loobu klõpsates suletakse &CD; andmebaasi redaktor muudatusi salvestamata.

## &kscd; kasutamine &kde; paneelil

&kscd; kasutamine &kde; paneelil &kscd; kasutamine &kde; paneelil

Kui on märgitud kast Ikooni näidatakse süsteemses dokis, ilmub &kscd; väike aplett KDE paneelile. Erinevalt &kscd; peaaknast leidub see aplett igal töölaual. Apletil hiire parema nupuga klõpsates avaneb hüpikmenüü, millega saab juhtida &CD; mängimist. Klõps hiire vasaku nupuga apletil peidab &kscd; peaakna. Kui see on peidetud, siis uus klõps hiire vasaku nupuga toob selle taas nähtavale.

Kui täpne olla, näidatakse apletti paneeli süsteemses salves. Kui apletti &kscd; minimeerimise ajal ei ilmu, oled vahesti salve eemaldanud. Selle lisamiseks tee hiire parema nupuga klõps paneeli tühjal alal ja vali menüükäsk Lisa Aplett Süsteemne salv .

## CDDB tugi

Freedb on interneti vahendusel kättesaadav jagatud andmebaaside võrk, mis sisaldab infot enamiku &CD;-de kohta. Kui sul on internetiühendus, ei pruugi sa tõenäoliselt kunagi käsitsi sisestada oma &CD; radade infot, kui oled süsteemi korralikult seadistanud. Vaata seadistamise kohta lähemalt &kscd; seadistamisest kõneleva peatüki Freedb kaardi osa, samuti osa CD andmebaasi redaktori kohta, mis annab teada, kuidas redigeerida CDDB kirjeid.

CDDB kasutamine on vaba. Kõik kasutajad on oodatud andma ka oma panust selle täiendamisse.

CDDB kirjete loomisel pea palun silmas järgmisi asju:

- Kasuta kirjetes standardseid ladina tähti. Mõned eritähed on küll lubatud, aga näiteks kirillitsas või kreeka tähestikus postitusi ei võeta lihtsalt vastu.

- Kasuta &CD; andmebaasi redaktoris väljal Plaadi esitaja / Pealkiri ainult üht sümbolit /.

  Klassikalise muusika &CD;-de puhul on heaks tavaks anda helilooja nimi esitajana (enne kaldkriipsu) ja ettekandja nimi pealkirjana (pärast kaldkriipsu).

- Kui saadad kirje, mis on juba andmebaasis olemas, lisatakse olemasolevale kirjele kogu see info, mida sa pakud ja mida varem olemas ei olnud.

Vaikimisi paigaldab &kscd; standardsed CDDB kategooriad kataloogi `$KDEDIR/share/apps/kscd/cddb`. Sa võid luua nii palju kategooria alamkatalooge, kui soovid. Saatmisel näidatakse siiski ainult ametlikke CDDB kategooriaid. Saatmise vaikeaadress on freedb-submit@freedb.org. Rohkem infot Freedb kohta annab Freedb kodulehekülg.

Kohalik CDDB kirje konkreetse &CD; kohta salvestatakse CDDB baaskataloogis faili ``kategooria nimi``plaadi ID``. Neid faile võib redigeerida suvalise tekstiredaktoriga, kui sul oma vaba ajaga tõesti midagi paremat ei ole ette võtta.

## Küsimused ja vastused

Ma näen &kscd; käivitamisel sellist dialoogi. Mis viga?

Veadialoog Veadialoog

See tähendab, et &kscd; ei suuda avada sinu &CD-ROM; seadet. Seadme nimi KsCD seadistamise dialoogi väljal &CD-ROM; seade peab vastama sinu &CD-ROM; seadmega tegelikult seostatud blokkseadmele. See on enamasti püsiviit sobivale IDE (`/dev/hdx`) või SCSI (`/dev/sdx`) seadmele.

Seadmefail kuulub tavaliselt kasutajale root grupis root, mistõttu tavalisel kasutajal ei ole õigust seda vahetult lugeda, kirjutada ega käivitada. Sellel pole mitte midagi pistmist SUID (Set Used ID programmid kasutavad standardse Un*x teegi funktsiooni `setuid()` muu kasutaja identiteedi võtmiseks) `mount` käsuga, millel õigustega probleeme ei teki. &kscd; peab suutma hankida ainult lugemisõigusega &CD;-seadmele viitava failideskriptori, et juhtida &CD-ROM; seadet ning lugeda plaadilt toorandmed.

Kui sa tead administraatori parooli, saad asja kiiresti ja hõlpsalt korda ajada. Võta endale administraatori õigused ja anna käsk ``chmod` `a+r` ``/dev/cdrom```, mis lubab igal sinu süsteemi kasutajal lugeda seadet `/dev/cdrom`. Kui sinu &CD-ROM; seade kannab mingit muud nime, siis muuda täpselt samamoodi tolle seadme õigusi. Kui sa ei tea administraatori parooli, palu oma süsteemiadministraatorit hästi viisakalt anda endale &CD-ROM; seadme lugemisõigus.

Vaata ka KsCD seadistamisest kõnelevat peatükki.

CDDB töölepanemine kohe kuidagi ei õnnestu. Kuidas saada mingitki põhjalikumat infot, mis võib olla valesti?

Kui sul tekib probleeme CDDB-ga, püüa &kscd; käivitada käsurealt võtmega `-d` ja vaata, mida silumisväljund ütleb.

## Autorid ja litsents

&kscd; autoriõigus 1997, 1998: Bernd Johannes Wuebben wuebben@kde.orgwuebben >

&kscd; sisaldab koodi rakendusest:

- workman 1.4 beeta 3 autoriõigus (c): Steven Grimm koreth@hyperion.com

Eriline tänu kuulub CDDB andmebaasi põhimõtte leiutajatele Ti Kanile ja Steve Scherfile. Rohkem infot CDDB kohta leiab aadressilt http://www.cddb.com.

Väga eriline tänu kuulub aga David White'ile, kes kirjutas algupärase &kscd; käsiraamatu. Suurepärane, David!

Dokumentatsiooni uuendamine KDE 2.0 tarbeks ja autoriõigus: Jonathan Singer jsinger@leeta.net.

Tõlge eesti keelde: Marek Laane bald@online.ee

&underFDL; &underGPL;

## Paigaldamine

### &kscd; hankimine

&install.intro.documentation;

### Nõuded

&kscd; edukaks kompileerimiseks on vajalik KDE teekide ning &Qt; C++ teegi uusimad versioonid. Kõik vajalikud teegid ning &kscd; enda leiab &kde; &FTP;-saidilt ftp://ftp.kde.org/pub/kde/.

### Kompileerimine ja paigaldamine

&install.compile.documentation;

Palun anna praegusele hooldajale Dirk Försterlingile milliByte@gmlx.net teada kõigist muudatustest, mida pidid ette võtma &kscd; kompileerimiseks enda platvromil.

&documentation.index;