# Podręcznik programu &kmix;

Matt
Johnston

    &Matt.Johnston.mail;

Christian
Esken

    esken@kde.org

Programista
Helio
Chissini de Castro

    helio@kde.org

Programista
Stefan
Schimanski

    1Stein@gmx.de

Programista
Lauri
Watts

    &Lauri.Watts.mail;

Recenzent
Krzysztof
Woźniak

    wozniakk@ceti.pl

Polskie tłumaczenie
1996
2005
Christian Esken & &Matt.Johnston;
&FDLNotice;
2007-01-05
2.6.1

Program &kmix; pozwala na regulację głośności karty dźwiękowej komputera.

KDE
KMix
kdemultimedia
dźwięk
głośność
mikser

## Wprowadzenie

Program &kmix; jest mikserem dźwięku dla środowiska &kde;. Mimo swoich niewielkich rozmiarów, posiada jednak pełen zestaw funkcji charakterystycznych dla tego typu programów. Pozwala on na sterowanie wszystkimi zainstalowanymi w systemie kartami dźwiękowymi.

Program &kmix; działa na wielu platformach sprzętowych i obsługuje kilka rodzajów sterowników:

- Sterowniki systemu obsługi dźwięku ALSA.

- Wszystkie platformy zgodne z systemem OSS (Open Sound System). W szczególności zaś systemy: &Linux;, FreeBSD, NetBSD oraz BSDI.

- Komputery dla systemu &Solaris;.

- Komputery dla systemu &IRIX;.

- Komputery dla systemu &HP-UX;.

W przypadku gdy w systemie dostępne są zarówno sterowniki ALSA, jak i OSS, program &kmix; będzie korzystał ze sterownika ALSA.

## Korzystanie z programu &kmix;

### Podstawy

Korzystanie z programu &kmix; jest bardzo proste. Wszystkie urządzenia/miksery karty dźwiękowej są przedstawione w oknie programu jako suwaki. Urządzenia monofoniczne reprezentuje pojedynczy suwak, zaś stereofoniczne mogą być przedstawione za pomocą jednego wspólnego suwaka lub za pomocą dwóch suwaków po jednym dla każdego kanału. W dolnej części okna &kmix; widoczny jest suwak balansu. Jeżeli w systemie zainstalowane są dwie lub więcej kart dźwiękowych, to wszystkie widoczne są w polu listy w górnej części okna, gdzie użytkownik może wybrać właściwą kartę. Główne okno programu &kmix; Główne okno programu &kmix;

Okno może zawierać maksymalnie trzy sekcje, kontrolujące różne opcje karty dźwiękowej: Wyjście, Wejście i Przełączniki. Sekcje te zawierają suwaki głośności, przełączniki włączające/wyłączające nagrywanie lub odtwarzanie dźwięku, a także pola wielokrotnego wyboru.

- Wyjście: karta zawiera opcje sterujące związane z odtwarzaniem dźwięku, np. główny suwak głośności (Master).
- Wejście: ta kara zawiera opcje związane z nagrywaniem dźwięku, np. poziom nagrywania (Capture).
- Przełączniki: zawiera wszystkie opcje, które związane są z włączaniem i wyłączaniem pewnych specjalnych możliwości karty dźwiękowej (np. "Mic Boost (+20dB)"), oraz pozwalających wybrać jedną opcję z listy (np. Mic Select: Mic1 or Mic2).

Oprócz opcji sterujących poziomem dźwięku, w programie &kmix; widoczne są również sygnalizatory LED. Ich kolory mają następujące znaczenie:

- Zielony: Sygnalizator związany z odtwarzaniem
- Czerwony: Sygnalizator związany z nagrywaniem
- Żółty: Sygnalizator związany z dodatkowymi funkcjami karty dźwiękowej

Te 3 kolory tworzą dwie kombinacje: zaświecony sygnalizator oznacza, że funkcja jest włączona, natomiast zgaszony - że jest ona wyłączona.

### Suwaki głośności

W kartach Wyjście oraz Wejścia znajdują się następujące elementy do sterowania głośnością (od góry do dołu): Suwaki głośności (Karta Wejście) Suwaki głośności (Karta Wejście)

- Ikona symbolizująca funkcję suwaka.
- Wskaźnik głośności (opcjonalny).
- Zielona dioda LED wyciszenia, pozwala na wyciszenie danego kanału (dioda zgaszona) lub włączenie dźwięku (dioda zapalona).
- Suwak sterowania poziomem głośności. Podpowiedź: jeżeli suwaków jest tak dużo, że mikser zajmuje za dużo miejsca, to można wyłączyć wyświetlanie etykiet dla zaoszczędzenia miejsca.
- Jeżeli dane urządzenie pozwala na nagrywanie dźwięku, to przy nim będzie widoczna czerwona dioda LED. Jeżeli jest zapalona - to oznacza iż urządzenie to jest wybrane jako źródło nagrywania. Jeżeli jest zgaszona, to urządzenie NIE JEST wybrane jako źródło nagrywania.

Suwaki głośności z przełącznikiem nagrywania (Karta Wyjście) Suwaki głośności z przełącznikiem nagrywania (Karta Wyjście)

Suwaki głośności posiadają własne menu kontekstowe, wyświetlane po naciśnięciu prawego klawisza myszki na suwaku lub na ikonie (widocznej nad suwakiem). Dostępnych jest w nim kilka pozycji, z których najważniejsze opisano poniżej.

Rozdziel kanały

  Wyświetla jeden lub dwa suwaki dla kanału. Opcja dotyczy jedynie urządzeń obsługujących sygnał stereofoniczny. Prawy suwak kontroluje poziom dla prawego kanału dźwięku, lewy suwak dla lewego kanału.

Wycisz

  Wycisza lub wyłącza wyciszenie urządzenia.

Ukryj

  Jeżeli użytkownik nie chce ustawiać poziomów danego urządzenia, to może go ukryć za pomocą tej opcji. Ponowne wyświetlenie suwaka urządzenia jest możliwe jedynie po wybraniu z menu pozycji Kanały (patrz poniżej).

Konfiguracja skrótów globalnych...

  Istnieje możliwość sterowania urządzeniem z klawiatury. To polecenie powoduje wyświetlenie standardowego okna dialogowego środowiska &kde; Konfiguracja skrótów. Można w nim zdefiniować kombinacje klawiszy dla zwiększania i zmniejszania natężenia dźwięku oraz wyciszania urządzenia. Definicje klawiszy mają znaczenie globalne i działają również wtedy, gdy program &kmix; zostanie zminimalizowany lub zadokowany na tacce systemowej.

Kanały

  Wyświetlone zostanie okno dialogowe, w którym można ustawić widoczność poszczególnych kanałów w każdej z sekcji (Wyjście, Wejście, Przełączniki).

Pokaż/Ukryj pasek menu

  Opcja ta nie dotyczy urządzenia dźwiękowego, a jedynie okna programu &kmix;. Dzięki niej można ukryć pasek menu. Można tego dokonać również za pomocą klawiatury (zwykle za pomocą &Ctrl;M)

### Przełączniki i pola wielokrotnego wyboru

Opcje w sekcji Przełączniki składają się z sygnalizatora LED i krótkiej etykietki opisującej funkcję. Sekcja ta może również zawierać pola wielokrotnego wyboru. Opcje te są często bardzo specjalistyczne i zazwyczaj nie należy ich zmieniać. Menu kontekstowe zawiera wpisy Kanały i Pokaż/Ukryj pasek menu, które już zostały opisane. Przełączniki i pola wielokrotnego wyboru (sekcja Przełączniki) Przełączniki i pola wielokrotnego wyboru (sekcja Przełączniki) Czerwone sygnalizatory LED powiązane są z nagrywaniem dźwięku, żółte kontrolują specjalne możliwości karty dźwiękowej. Powyższy zrzut ekranu przedstawia od lewej do prawej zgaszony sygnalizator LED IEC958 Output (żółty = specjalna opcja), zapalony sygnalizator led Mix (czerwony = związany z nagrywaniem), zgaszony sygnalizator LED związany z nagrywaniem, zapaloną specjalną opcję i jedno pole wielokrotnego wyboru (PCM Out Path & Mute). Jeśli nie masz pewności co do znaczenia opcji, zapytaj autora sterownika Twojej karty dźwiękowej (dla większości obecnych dystrybucji &Linux-dopelniacz; jest to ALSA).

### Suwak balansu

Za pomocą tego suwaka, można określać balans dźwięku pomiędzy prawym i lewym kanałem. Suwak ma działanie ogólne i dotyczy głównego kanału (Master). Pozycja środkowa jest ustawieniem domyślnym. Przesuwanie suwaka w lewo zmniejsza natężenie dźwięku w prawym głośniku i vice versa. Działanie może być odwrócone, jeżeli głośniki nie są poprawnie ustawione.

W systemach dźwięku przestrzennego, urządzenie Master często powoduje ustawienie głośności jedynie dla przednich głośników (Front). Jest to ograniczenie sterownika karty dźwiękowej.

Jeżeli karta dźwiękowa nie udostępnia urządzenia Master, program &kmix; może wybrać inne urządzenie do ustawienia głównego poziomu głośności. W większości przypadków są to urządzenia Wave lub PCM.

### Opcje konfiguracji

Ustawienie parametrów programu odbywa się w menu Ustawienia Konfiguracja: &kmix;.... Dostępne są następujące opcje:

Dokowanie

  Zaznaczenie tej opcji spowoduje, iż &kmix; będzie dokował w tacce systemowej po naciśnięciu przycisku zamknięcia okna. Jeżeli opcja jest wyłączona, to po naciśnięciu przycisku zamknięcia okna, program zostanie zakończony. Uwaga: po zakończeniu działania programu nie będzie możliwe sterowanie natężeniem dźwięku za pomocą zdefiniowanych skrótów klawiszowych.

Włącz sterowanie głośnością z tacki systemowej

  Włączenie tej opcji, spowoduje iż kliknięcie lewym przyciskiem myszki na ikonie programu na tacce systemowej, wyświetli małe okno z suwakiem głośności dla preferowanego urządzenia (uwaga: w chwili obecnej nie jest możliwe określenie tego urządzenia - jest ono wybierane automatycznie przez program &kmix;). Jeżeli opcja jest wyłączona, to kliknięcie na ikonie programu wyświetli główne okno programu.

Pokaż skalę

  Wyświetla kreski oznaczające pozycję na suwakach.

Pokaż etykiety

  Wyświetla etykiety dla każdego urządzenia dźwiękowego. Niezależnie od tego czy opcja jest zaznaczona, czy też nie, to ustawienie kursora myszki nad suwakiem każdego urządzenia wyświetli informację o jego nazwie.

Przywróć ustawienia głośności po zalogowaniu

  Powoduje, iż środowisko &kde; będzie przywracać ustawienia głośności po powtórnym zalogowaniu. Ustawienia te są zapisywane w katalogu użytkownika podczas kończenia pracy z systemem. Jeżeli system operacyjny zapisuje ustawienia głośności, to opcja ta nie musi być stosowana (jeżeli jednak z komputera korzysta wielu użytkowników, to może się przydać).

Wartości głośności:

  Wybierz, czy i jak wartości głośności powinny być wyświetlane: Brak, Bezwzględnie lub Względnie.

Orientacja suwaków

  Ta opcja pomaga obrócić zawartość głównego okna &kmix; o 90 stopni. Suwaki, tekst i wszystkie pozostałe elementy (jeśli to możliwe) zostaną obrócone. Są jednak wyjątki od tej zasady, jak na przykład pasek menu, wybór miksera (jeśli widoczny), suwak balansu i pola wielokrotnego wyboru.

## Aplet &kmix;

Aplet panelu &kmix; stanowi alternatywny interfejs oferowany przez program. Dodanie apletu do panelu odbywa się za pomocą Dodaj aplet do panelu... w Menu panelu lub za pomocą menu kontekstowego. Wybierz Mikser dźwięku i kliknij Dodaj do panelu lub kliknij dwukrotnie Mikser dźwięku.

Praca z apletem "Mikser dźwięku" jest analogiczna jak opisano dla głównego okna programu - włączając w to menu kontekstowe. Jednak z powodu ograniczeń miejsca, korzystanie z apletu ma następujące ograniczenia:

- Niedostępne jest główne menu programu.
- W przypadku posiadania wielu kart dźwiękowych, nie można zmienić wybranego miksera po początkowym wyborze.
- Brak ikony w tacce systemowej. Jeżeli użytkownik chce wyświetlić ikonę na tacce systemowej, to musi dodatkowo uruchomić &kmix; z Menu K Multimedia Mikser dźwięku &kmix;.
- Ikony są widoczne tylko gdy szerokość panelu jest wystarczająco duża.
- Nie są dostępne etykiety nazw urządzeń.
- Konfiguracja dokonywana jest poprzez menu panelu i pozwala na ustawienie kolorów i kierunku suwaków.
- Niedostępne jest automatyczne zapisywanie poziomu głośności. Jeżeli użytkownik chce zapisać poziom głośności przed wylogowaniem, to musi uruchomić &kmix; z Menu K.

## Zaawansowane funkcje programu &kmix;

Ten rozdział opisuje funkcje programu &kmix; przydatne dla zaawansowanych użytkowników. Zwykli użytkownicy nigdy nie będą jej wykorzystywać, tak więc można bezpiecznie pominąć czytanie tego rozdziału.

### Mechanizm sterowania &DCOP;

Nieraz użytkownik chce zrealizować zadania takie jak np.: sterowanie mikserem z innej aplikacji lub wyciszanie urządzenia codziennie o godzinie 10 po południu. Program &kmix; udostępnia mechanizm &DCOP;, pozwalający na osiągnięciu wielu efektów minimalnym nakładem pracy. Aby poznać możliwości oferowane przez interfejs DCOP w programie &kmix; należy w terminalu wpisać polecenie ``dcop kmix``. Funkcje specyficzne dla &kmix; są następujące:

``Mixer0``

  Pozwala na sterowanie pierwszym mikserem dźwięku. Można określać poziomy dźwięku, wyciszać urządzenie, zmieniać balans, odczytywać nazwę miksera i wiele innych. Wpisanie w wierszu poleceń ``dcop kmix Mixer0`` wyświetli wszystkie realizowane funkcje. W przypadku posiadania większej liczby kart dźwiękowych, widoczne będą też wpisy takie jak ``Mixer1``, itd.

``kmix-mainwindow#1``

  Polecenie steruje wyglądem okna programu. Możliwe jest chowanie i pokazywanie okna, zmiana rozmiaru i wiele innych funkcji. Wykonanie polecenia ``dcop kmix kmix-mainwindow#1`` wyświetli wszystkie dostępne możliwości.

### Przykłady zastosowania mechanizmu &DCOP;

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

  Ukrywa główne okno programu. Ponowne wyświetlenie okna możliwe jest za pomocą polecenia ``dcop kmix kmix-mainwindow#1 show`` lub poprzez kliknięcie na ikonę na tacce systemowej.

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

  Zmienia rozmiar okna programu na najmniejszy możliwy. Jest to rozmiar, w którym wszystkie suwaki (oraz inne elementy interfejsu użytkownika) mieszczą się w oknie.

``dcop kmix Mixer0 mixerName``

  Wyświetla nazwę pierwszego urządzenia-miksera, na przykład: `Sound Fusion CS46xx`

``dcop kmix Mixer1 setVolume 0 10``

  Ustawia głośność na drugim mikserze, na urządzeniu 0, do wartości 10%. Urządzenie 0 jest najczęściej urządzeniem Master, jednak nie zawsze. Jeżeli chcesz wyciszyć urządzenie główne (Master) na drugiej karcie dźwiękowej, to wpisz: ``dcop kmix Mixer1 setMasterVolume 0``

Polecenia mogą być uruchamiane bezpośrednio w oknie terminala uruchomionym w środowisku &kde;. Jeżeli polecenie dcop ma być uruchamiane z innego miejsca (np. ze skryptu crontab) to niezbędne jest zdefiniowanie zmiennej środowiskowej `DCOPSERVER` (na wartość taką samą jak widoczna w pliku: `~/.DCOPserver_nazwa_komputera_:0`), na przykład:

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

### Przydatne sztuczki

#### Jednoczesne korzystanie ze sterowników ALSA i OSS

Program &kmix; w systemie &Linux; może korzystać zarówno ze sterowników ALSA jak i OSS. Jeżeli użytkownik naprawdę chce wykorzystywać oba sterowniki jednocześnie (co zdarza się niezmiernie rzadko) może to zrobić poprzez dodanie następującego wiersza w pliku konfiguracyjnym kmixrc.

    MultiDriver=true

Następnie należy ponownie uruchomić program. Po wybraniu z menu pozycji Pomoc Informacje o sprzęcie powinna się pojawić informacja: Używane sterowniki dźwięku: ALSA0.9 + OSS oraz Experimental multiple-Driver mode activated.

Prawdopodobnie wszystkie urządzenia-miksery będą zdublowane.

Taka konfiguracja nie jest wspierana przez twórców programu.

## Zasługi i licencje

Główni programiści

- Prawa autorskie (c) 1996-2000 Christian Esken

- Prawa autorskie (c) 2000-2003 Christian Esken; Stefan Schimanski

- Prawa autorskie (c) 2003-2005 Christian Esken; Helio Chissini de Castro

Współtwórcy:

- Christian Esken esken@kde.org

- Stefan Schimanski 1Stein@gmx.de

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

- Sebestyen Zoltan szoli@digo.inf.elte.hu - Poprawki dla FreeBSD

- Faraut Jean-Louis jlf@essi.fr - Poprawki dla Solarisa

- Nick Lopez kimo_sabe@usa.net - Obsługa systemu ALSA

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

- Lennart Augustsson augustss@cs.chalmers.se - Poprawki dla systemów *BSD

Prawa autorskie dokumentacji 2000 &Matt.Johnston; &Matt.Johnston.mail;

Aktualizacja do wersji &kmix; V1.91 (c) 2003 przez Christian Esken esken@kde.org

Aktualizacja do wersji &kmix; V2.2 (c) 2005 przez Christian Esken esken@kde.org

Aktualizacja 7/2005 do wersji &kmix; V2.6 przez Christian Esken esken@kde.org

Dokumentacja niniejsza jest oparta na oryginale autorstwa Christian'a Esken'a esken@kde.org

Polskie tłumaczenie: wozniakk@ceti.pl

&underFDL; &underGPL;

## Instalacja

### Jak zdobyć program &kmix;

&install.intro.documentation;

### Wymagania

Oczywiście korzystanie z programu &kmix; nie ma sensu, jeżeli nie zainstalowano wcześniej karty dźwiękowej. Obsługiwane są następujące platformy sprzętowe i sterowniki dźwięku:

- Wszystkie platformy zgodne z systemem OSS (Open Sound System). W szczególności zaś systemy: &Linux;, FreeBSD, NetBSD oraz BSDI.

- Komputery dla systemu &Solaris;.

- Komputery dla systemu &IRIX;.

- Sterowniki systemu obsługi dźwięku ALSA.

- Komputery dla systemu &HP-UX;.

### Kompilacja i instalacja

&install.compile.documentation;