# &kmix;i käsiraamat

## Sissejuhatus

&kmix; on &kde; helikaardi mikserirakendus. Ehkki väike, on see väga võimas. See tagab kontrolli kõigi sinu helikaartide üle.

&kmix; toetab mitmeid platvorme ja helidraivereid:

- ALSA helikaardidraiver.

- Kõik OSS (Open Sound System) platvormid. Konkreetselt on testitud: &Linux;, FreeBSD, NetBSD ja BSDI.

- &Solaris; masinad.

- &IRIX; masinad.

- &HP-UX; masinad.

Kui sul on paigaldatud nii ALSA kui ka Open Sound Systemi draiverid, kasutab &kmix; ALSA draiverit.

## &kmix;i kasutamine

### Põhiasjad

&kmix;i kasutamine on üsna lihtne ja selge. Iga mikseriseade, mida sinu helikaart pakub, on esindatud helitugevuse liuguriga. Monoseadmetel on liugureid üks, stereoseadmetel sõltuvalt sinu valikust kas üks või kaks. Lisaks on &kmix;i akna allservas veel üks pikk liugur. Kui sul on mitu helikaarti, on akna ülaosas nende nimekiri, kust saad valida vajaliku. &kmix;i peaaken &kmix;i peaaken

Aknal võib olla kuni kolm sektsiooni erinevate helikaardi juhtimivalikute jaoks: Väljund, Sisend ja Lülitid. Neis sektsioonides asuvad helitugevuse liugurid, lülitid salvestamise või taasesitamise sisse/väljalülitamiseks ning mitme valikuga selektorid.

- Väljund: siin on juhtelemendid, mis tegelevad peamiselt taasesitusega, näiteks peamise helikanali Master helitugevuse liugur.
- Sisend: siin on juhtelemendid, mis tegelevad peamiselt salvestamisega, näiteks videohõive liugur Capture.
- Lülitid: siin on juhtelemendid, mille puhul saab teatud funktsioone ainult sisse või välja lülitada (näiteks kõik "Mic Boost (+20dB)"), ning mitme valikuga juhtelemendid (näiteks Mikrofoni valik: Mic1 või Mic2).

Lisaks helitugevuse liuguritele näeb &kmix;is ka tulukesi (LED). Üldiselt tähendavad nende värvid järgmist:

- Roheline: taasesitusse puutuv LED
- Punane: salvestamisse puutuv LED
- Kollane: helikaardi eriomadustega tegelev LED

Kõik kolm värvi võivad olla kahes olekus: ere LED tähendab sisselülitatust, tuhm LED väljalülitatust.

### Helitugevuse juhtimine

Helitugevuse juhtelemendid sektsioonides Väljund ja Sisend koosnevad järgmistest osadest (ülalt alla): Helitugevuse juhtelement (sektsioon Sisend) Helitugevuse juhtelement (sektsioon Sisend)

- Juhtelemendi funktsiooni näitav ikoon.
- Helitugevuse väärtuse indikaator (lisavõimalus).
- Roheline LED, mis lubab juhtelemendi tummaks muuta või taas kõlama panna (tuluke muutub vastavalt tuhmiks või eredaks).
- Liugur helitugevuse juhtimiseks (vihje: liuguri pealdise võib ka peita, kui mikser peaks sinu ekraanil muidu liiga palju ruumi võtma).
- Kui juhtelement toetab salvestamist, on näha punane salvestamise LED. Kui see on erepunane, on seade valitud salvestamiseks, kui aga tumepunane, siis see EI OLE mõeldud salvestamiseks.

Helitugevuse juhtelement salvestamise tulukesega (sektsioon Väljund) Helitugevuse juhtelement salvestamise tulukesega (sektsioon Väljund)

Enamikul juhtelementidele on ka kontekstimenüü, mille saab avada hiire parema nupu klõpsuga elemendil või seadme ikoonil. Kontekstimenüüs võib olla hulk kirjeid, aga iga elemendi korral näed ainult neid, mida saab antud juhul kasutada.

Jaga kanalid

- Võimaldab näidata üht või kaht liugurit. See käib ainult stereoseadmete kohta. Parempoolne liugur kontrollib parempoolse kanali helitugevust, vasakpoolne vasakpoolse.

Summutatud

- Summutab seadme või lülitab selle taas sisse

Peida

- Kui sa ei tunne antud seadme vastu huvi, võid selle peita. Kui soovid seda uuesti näha, saad seda teha ainult valikuga Kanalid (vaata allpool).

Kiirklahvide seadistamine...

- Seadmeid saab juhtida ka klaviatuurilt. See menüükäsk avab &kde; dialoogi Kiirklahvide seadistamine, kus saad määrata kiirklahvid helitugevuse suurendamiseks ja vähendamiseks ning seadme summutamiseks. Kiirklahvid on globaalsed ja toimivad ka siis, kui &kmix; on paneelile minimeeritud või süsteemsesse salve dokitud.

Kanalid

- See käsk avab dialoogi, kus saab määrata, milliseid kanaleid vastavas sektsioonis (Väljund, Sisend, Lülitid) näidatakse.

Menüüriba näitamine/peitmine

- See menüükäsk ei puuduta seadmeid, vaid mikseriakent. Sellega saab menüüriba peita või nähtavale tuua. Sama saab teha ka vastava kiirklahviga (tavaliselt &Ctrl;M).

### Lülitid ja mitme valikuga selektorid

Juhtelemendid sektsioonis Lülitid koosnevad LED-ist ja funktsiooni lühidalt kirjeldavast pealdisest. Sektsioonis Lülitid võib olla ka mitme valikuga selektoreid. Pane tähele, et need juhtelemendid on üldjuhul väga spetsiifilised ning tavaline kasutaja ei peaks neid üldjuhul muutma. Kontekstimenüüst leiab kirjed Kanalid ja Menüüriba näitamine/peitmine, mida on juba kirjeldatud. Lülitid ja mitme valikuga selektorid (sektsioon Lülitud) Lülitud ja mitme valikuga selektorid (sektsioon Lülitid) Pane tähele, et punased LED-id on seotud salvestamisega, kollased LED-id aga helikaardi erivõimalustega. Ülaltoodud pildil näeb vasakult paremale tuhmi IEC958 väljundi LED-i (kollane = erijuhtelement), heledat Mix LED-i (punane = seotud salvestamisega), tuhmi salvestamisega seotud LED-i, heledat erijuhtelementi ja üht mitme valikuga selektorit (PCM Out asukoht & tumm). Kui sa ei saa juhtelemendi tähendusest aru, küsi selle kohta oma helikaardi draiveri pakkujalt (enamiku tänapäevaste &Linux; distributsioonide korral on selleks ALSA).

### Pikk liugur

Selle liuguriga saab kontrollida helitugevuse jagunemist vasak- ja parempoolse valjuhääldi vahel. See on üldine regulaator, mis mõjutab peamist helitugevust. Vaikimisi paikneb liugur keskel. Seda vasakule liigutades jääb helitugevus parempoolses kõlaris nõrgemaks, paremale liigutades vastupidi. Tegelikult võib muidugi asi ka vastupidi olla, kui su kõlarid on valetpidi asetatud.

Surround-süsteemi korral tasuks tähele panna, et peamine helitugevus (Master) mõjutab enamasti ainult esikõlareid. See on helikaardi draiveri piirang.

Kui sinu helikaardil ei ole Master-seadet, võib &kmix; selleks määrata midagi muud - enamasti peaks sobima Wave või PCM.

### Seadistamisvalikud

Seadistamiseks vali Seadistused&kmix;i seadistamine... Dialoogis on järgmised valikud:

Dokitakse paneelile

- Märkimisel dokitakse &kmix; süsteemsesse salve, kui vajutad akna sulgemise nuppu. Kui see pole märgitud, pannakse &kmix; sellisel juhul kinni. Tähelepanu: pärast väljumist ei saa enam helitugevust kiirklahvidega kontrollida, kui sa oled vastavad kiirklahvid omistanud.

Helitugevuse regulaatori lubamine doki ikoonil

- Märkimisel saab hiire vasaku nupu klõpsuga &kmix;i doki ikoonile avada hüpikakna, mis võimaldab määrata eelistatud seadme helitugevuse. (Vihje: praegu ei ole võimalik seadet muuta - see tuleb valida &kmix;is.) Kui see ei ole märgitud, avatakse &kmix;i doki ikoonile hiire vasaku nupuga klõpsates &kmix;i peaaken.

Liuguritel näidatakse positsioonimärke

- Võimaldab näha liuguritel asukohatähiseid.

Pealdiste näitamine

- Lisab igale heliseadmele nimetuse. Sõltumata sellest, kas see valik on sisse lülitatud või mitte, näeb seda infot ka siis, kui jätad hiirekursori hetkeks seadme ikooni kohale seisma.

Helitugevused taastatakse sisselogimisel

- Sellega saab lubada &kde;-l taastada siselogimisel helitugevused. Taastatakse sinu isiklikud helitugevuse tasemed, mis salvestati välja logides. Kui sinu operatsioonisüsteem salvestab helitugevuse tasemed, ei ole selle sisselülitamisel erilist mõtet (ehkki seda võib vaja minna, kui arvutil on mitmeid kasutajaid).

Helitugevuse väärtused:

- Siin saab valida, kas ja kuidas helitugevuse väärtusi esitada: Puudub, Absoluutne või Suhteline.

Liuguri suund

- Selle valikuga saab &kmix;i peaakna sisu pöörata 90 kraadi. Pööratakse liugureid, teksti ja kõike muud (kui see on võimalik). Reeglil on mõned erandid, näiteks menüüriba, mikseri valija (kui seda üldse näidatakse), pikk liugur ja mitme valikuga selektorid.

## &kmix;i paneeliaplett

&kmix;i paneeliaplett on &kmix;i nii-öelda teine pale. Selle saab &kde; paneelile lisada paneeli menüüst käsuga Lisa aplett paneelile... või kontekstimenüüst. Vali Helimikser ja klõpsa Lisa paneelile või tee topeltklõps kirjel Helimikser.

&kmix;i paneeliapleti kasutamine käib põhimõtteliselt samamoodi nagu peaaknas, kaasa arvatud kontekstimenüü. Paneeli piiratud ruumi tõttu on siiski teatud erinevused:

- Peamenüü puudub.
- Mitme helikaardi korral ei saa valitud mikserit muuta pärast esialgset valikut.
- Doki ikoon puudub. Kui soovid kasutada ka dokki, pead lisaks käivitama &kmix;i K-menüüst: K-menüü Multimeedia&kmix; helimikser.
- Ikoone kasutatakse ainult siis, kui paneelil on ruumi.
- Seadmete nimesid ei näidata.
- Seadistamine käib paneelimenüü kaudu - seal saab määrata värve ja liugurite suunda.
- Helitugevusi ei salvestata automaatselt. Kui soovid, et helitugevused salvestataks väljalogimisel ja uuel sisselogimisel taastataks, tuleb &kmix; käivitada K-menüüst.

## &kmix;i omadustest põhjalikumalt

Käesolevas osas kirjeldame &kmix;i selliseid omadusi, mis on mõeldud ennekõike kogenud kasutajatele. Enamik kasutajaid ei vaja seda kunagi, nii et soovi korral võid selle osa vahele jätta.

### &DCOP;-liides

Vahel võib tekkida vajadus teha midagi spetsiaalset, näiteks juhtida mikserit mõnest teisest rakendusest või summutada peamise helitugevuse seade igal õhtul kell 10. &kmix; pakub &DCOP;-liidest, mis lubab väga vähese vaevaga väga palju ära teha. Selleks anna konsoolis käsk ``dcop kmix`` ja uuri &kmix;i &DCOP;-liidese võimalusi. &kmix;i spetsiifilised liidesed on järgmised:

``Mixer0``

- See võimaldab juhtida esimest mikserit. Saab määrata helitugevuse, seadme summutada, balanssi muuta, hankida mikseri nime ja nii edasi. Kui soovid kõigi võimalustega tutvuda, anna käsk ``dcop kmix Mixer0``. Kui sul on paigaldatud mitu helikaarti, siis nende puhul tuleb kasutada ``Mixer1`` ja nii edasi.

``kmix-mainwindow#1``

- Selle käsuga saab juhtida graafilise kasutajaliidese akent. Seda saab peita ja lasta näidata, suurust muuta ja nii edasi. Kui soovid kõigi võimalustega tutvuda, anna käsk ``dcop kmix kmix-mainwindow#1``.

### &DCOP;-i näited

``dcop kmix kmix-mainwindow#1 hide``

- Peidab graafilise kasutajaliidese akna. Selle taasnägemiseks anna käsk ``dcop kmix kmix-mainwindow#1 show`` või kasuta doki ikooni.

``dcop kmix kmix-mainwindow#1 resize 1 1``

- Annab GUI aknale väikseima võimaliku suuruse. See on suurus, mille korral kõik liugurid (ja muud kasutajaliidese elemendid) veel aknasse ära mahuvad.

``dcop kmix Mixer0 mixerName``

- Annab teada esimese mikseri nime, näiteks `Sound Fusion CS46xx`.

``dcop kmix Mixer1 setVolume 0 10``

- Määrab helitugevuse teises mikseris seadmes 0 10 protsendi peale. Seade 0 on sageli peamise helitugevuse seade (Master), aga mitte alati. Kui soovid summutada (esimese) peamise helitugevuse seadme oma teisel helikaardil, anna käsk ``dcop kmix Mixer1 setMasterVolume 0``.

Neid käske võib anda otse &kde;-s käivitatud käsurealt. Kui tahad DCOP-käske anda kuskilt mujalt, näiteks crontab-skriptiga, pead määrama keskkonnamuutuja `DCOPSERVER` (nagu seda näitab sinu faili `~/.DCOPserver_hostname_:0` esimene rida). Näide:

    #!/bin/sh
    DCOPSERVER=`cat /home/yourhome/.DCOPserver_yourhostname_:0 | grep local`
    export DCOPSERVER
    dcop kmix Mixer0 setMasterVolume 0

### Nipid ja nõuanded

#### ALSA ja OSS-i draiveri kasutamine korraga

&kmix; võib &Linux; korral kasutada kas ALSA draiverit või OSS-i draiverit, aga mitte mõlemat. Kui sul peaks tõesti vaja minema mõlemat draiverit korraga (see on küll üsna haruldane juhus), siis talita nii: välju &kmix;ist ja lisa selline rida faili `kmixrc` globaalse seadistuse sektsiooni:

    MultiDriver=true

Käivita &kmix; uuesti. Kui valid Abi Riistvara info, peaksid nägema Kasutatud helidraiverid: ALSA0.9 + OSS ja Experimental multiple-Driver mode activated.

Tõenäoliselt näed kõiki oma miksereid kahekordselt.

Selline seadistus ei ole õieti toetatud.

## Autorid ja litsents

Põhiarendajad

- Autoriõigus 1996-2000: Christian Esken

- Autoriõigus 2000-2003: Christian Esken & Stefan Schimanski

- Autoriõigus 2003-2005: Christian Esken & Helio Chissini de Castro

Kaasautorid:

- Christian Esken esken@kde.org

- Stefan Schimanski 1Stein@gmx.de

- Paul Kendall paul@orion.co.nz - &SGI; port

- Sebestyen Zoltan szoli@digo.inf.elte.hu - FreeBSD parandused

- Faraut Jean-Louis jlf@essi.fr - &Solaris; parandused

- HNick Lopez kimo_sabe@usa.net - ALSA port

- Helge Deller deller@gmx.de - &HP;-UX port

- Lennart Augustsson augustss@cs.chalmers.se - *BSD parandused

Dokumentatsiooni autoriõigus 2000: &Matt.Johnston; &Matt.Johnston.mail;

Uuendas 2003 &kmix; v1.91 jaoks: Christian Esken esken@kde.org

UUuendas 2005 &kmix; v2.2 jaoks: Christian Esken esken@kde.org

Uuendas juulis 2005 &kmix; v2.6 jaoks: Christian Esken esken@kde.org

Aluseks olev dokumentatsioon: Christian Esken esken@kde.org

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

&underFDL; &underGPL;

## Paigaldamine

### &kmix;i hankimine

&install.intro.documentation;

### Nõuded

Ilmselgelt on &kmix;il mõtet ainult siis, kui sul on helikaart. &kmix; toetab mitmeid platvorme ja helidraivereid:

- Kõik OSS (Open Sound System) platvormid. Konkreetselt on testitud: &Linux;, FreeBSD, NetBSD ja BSDI.

- &Solaris; masinad.

- &IRIX; masinad.

- ALSA helikaardidraiver.

- &HP-UX; masinad.

### Kompileerimine ja paigaldamine

&install.compile.documentation;