# Manual do &kmix;

Matt
Johnston

    &Matt.Johnston.mail;

Christian
Esken

    esken@kde.org

Desenvolvimento
Helio
Chissini de Castro

    helio@kde.org

Desenvolvimento
Stefan
Schimanski

    1Stein@gmx.de

Desenvolvimento
Lauri
Watts

    &Lauri.Watts.mail;

Revisão
Marcus
Gama

    marcus.gama@gmail.com

Tradução
1996
2005
Christian Esken & &Matt.Johnston;
&FDLNotice;
2007-01-05
2.6.1

O &kmix; é um aplicativo que permite alterar o volume da sua placa de som.

Atenção: Este manual contém a documentação de uma versão antiga do &kmix;, aquela que vem com o &kde; 3.5.

KDE
KMix
kdemultimedia
som
volume
mixador

## Introdução

Atenção: Este manual contém a documentação de uma versão antiga do &kmix;, aquela que vem com o &kde; 3.5.

O &kmix; é o programa mixador do &kde; para a placa de som. Apesar de pequeno, possuí muitas funções. O programa deverá fornecer controles para cada uma das suas placas de som.

O &kmix; suporta várias plataformas e controladores de som:

- O controlador de som ALSA.

- Todas as plataformas Open Sound System. Foi explicitamente testado em &Linux; FreeBSD, NetBSD e BSDI.

- Máquinas baseadas no &Solaris;.

- Máquinas baseadas no &IRIX;.

- Máquinas baseadas no &HP-UX;.

Se você tiver tanto os controladores ALSA quanto os do Open Sound System instalados, o &kmix; usará o controlador ALSA.

## Trabalhando com o &kmix;

### Fundamentos

O funcionamento do &kmix; é bastante claro. Todo o dispositivo da mesa de mistura que a placa de som fornece é representado por uma barra de controle de volume. Os dispositivos mono possuem apenas uma barra, enquanto os dispositivos estéreo podem ter uma ou duas, dependendo da sua escolha. Adicionalmente existe uma barra deslizante no fundo da janela do &kmix;. Se você possui várias placas de som, aparecerá uma lista no topo da janela, onde poderá escolher a sua placa de som. A Janela Principal do &kmix; A Janela Principal do &kmix;

A janela poderá ter até três seções com controles da placa de som diferentes: Saída, Entrada e Opções. Estas seções contém as barras de volume, os interruptores para ativar/desativar a gravação ou reprodução e seletores de escolha múltipla.

- Saída: Contém os controles que estão mais relacionados com a saída ou reprodução de som, como o controle de volume Master (mestre).
- Entrada: Contém os controles mais relacionados com a gravação, como o Capture (Captura).
- Opções: Contém todas as opções que permitem apenas LIGAR ou DESLIGAR alguma funcionalidade (como o "Mic Boost (+20dB)") e as opções de escolha-múltipla como o Selecione o Microfone: Mic1 ou Mic2).

Além dos controles de volume, o &kmix; também contém LEDs. A regra geral das cores é:

- Verde: Um LED que lida com a reprodução
- Vermelho: Um LED que lida com a gravação
- Amarelo: Um LED que lida com as capacidades especiais da placa de som

Estas 3 cores vêm com duas variantes: Um LED aceso significa ligado, enquanto um LED apagado significa desligado.

### Controles de volume

Os controles de volume na seção Saída e Entrada consistem em (de cima para baixo): Controle do Volume (Seção Entrada) Controle do Volume (Seção Entrada)

- Um ícone, representando a função do controle.
- Um indicador do valor do volume (opcional).
- Um LED Verde de Mudo, que permite desligar um controle (A luz apaga/fica mais escura) ou voltar a ligá-lo (a luz liga/fica brilhante).
- Uma barra para controle de volume (Sugestão: Você poderá ocultar a legenda da barra, por exemplo, se a mesa de mistura ocupar muito espaço da sua tela).
- Se um controle suportar a gravação, irá existir um LED vermelho de Gravação. Se o LED estiver aceso (vermelho claro), o controle está selecionado para gravação. Se não estiver aceso (vermelho escuro), o controle NÃO está selecionado para gravação.

Controle de volume com Opções de Gravação (Seção Saída) Controle de volume com Opções de Gravação (Seção Saída)

As barras de volume possuem um menu de contexto, acessível através de um clique no botão direito na barra ou no ícone do dispositivo (no topo). Algumas entradas são possíveis, mas apenas as aplicáveis são mostradas.

Separar Canais

  Mostra uma ou duas barras de volume. Isto aplica-se apenas a dispositivos estéreo. A barra de controle direita controla o volume do lado direito, e a esquerda controla o volume do lado esquerdo.

Mudo

  Desliga ou liga o som do dispositivo

Ocultar

  Se você não estiver interessado em regular este dispositivo pode ocultar esta opção. Se desejar mostrá-la novamente, você apenas terá que selecionar a opção Canais (veja abaixo)

Configurar os Atalhos Globais...

  Você pode controlar um dispositivo com o teclado. Use esta opção do menu para mostrar a janela do &kde; para Configurar os Atalhos. Aqui você pode definir as teclas para aumentar e diminuir o volume, bem como para tirar o som ao dispositivo. As teclas são globais e funcionam mesmo quando o &kmix; está em ícone ou acoplado.

Canais

  Você irá obter uma janela onde poderá configurar, por seção (Saída, Entrada, Opções), que canais deseja ver.

Mostrar/Ocultar o Menu

  Esta opção não é específica de qualquer dispositivo, mas afeta a janela da mesa de mistura. Você pode usar esta opção para ocultar ou mostrar a barra de menu. Também poderá fazer isto pressionando o atalho (normalmente &Ctrl;M)

### Opções e Seletores de Escolha Múltipla

Os controles da seção Opções consistem num LED e numa legenda curta que descreve a função. A seção Opções poderá também conter seletores de escolha-múltipla. Lembre-se por favor que estes controles são normalmente muito especiais e não necessitam normalmente de ser alterados pelo usuário comum. O menu de contexto contém os itens Canais e Mostrar/Ocultar o Menu já descritos. Opções e seletores de escolha-múltipla (Seção de Opções) Opções e seletores de escolha-múltipla (seção de Opções) Lembre-se por favor: os LEDs vermelhos são relacionados com a gravação e os LEDs amarelos dizem respeito às capacidades especiais da placa de som. A imagem acima mostra, da esquerda para a direita, um LED apagado IEC958 Output (amarelo = controle especial), um LED aceso Mix (vermelho = Relacionado com gravação), um LED apagado e relacionado com a gravação, um LED de controle especial aceso e um selector de escolha múltipla (PCM Out Path & Mute). Se não tiver certeza do significado de um controle, peça por favor informações ao seu fornecedor do controlador da placa de som (na maior parte das distribuições atuais de &Linux;, é o ALSA).

### Barra deslizante

Com esta barra você pode controlar a distribuição de volume entre a caixa de som esquerda e direita. Esta barra é um regulador geral, afetando todos os Volumes Mestres. A posição central é a padrão. Arrastando a barra para a esquerda diminui o volume na caixa de som direita, e vice versa para a direita. Obviamente, isto pode estar trocado se suas caixas de som não estiverem posicionadas corretamente.

Para os Sistemas Surround, note que o dispositivo Master (mestre) normalmente regula apenas os altofalantes frontais. Esta é uma limitação da sua placa de som.

Se a sua placa de som não tiver um dispositivo Master, algum outro dispositivo poderá ser obtido pelo &kmix; - para a maioria das pessoas este é o controle Wave (ou PCM).

### Opções de configuração

Use o Configurações Configurar o &kmix;... para escolher as opções. Estes itens são:

Embutir no painel

  Se selecionado, o &kmix; irá ser embutido quando clicar no botão de fechar janela. Se não estiver selecionado, o &kmix; será encerrado quando clicar no botão de fechar janela. Atenção: após encerrar você não poderá controlar o volume através das teclas escolhidas por você.

Habilitar o controle de volume no painel de sistema

  Se estiver ativo, clicar com o botão esquerdo no ícone da área de notificação do &kmix;, irá mostrar uma janela com um controle de volume para o dispositivo preferido (Sugestão: atualmente você não pode mudar este dispositivo - ele é selecionado pelo &kmix; em alternativa). Se a opção estiver desativada, a janela principal do &kmix; será mostrada por completo, quando clicar com o botão esquerdo no ícone da área de notificação.

Mostrar graduação

  Mostrar linhas para as graduações nas barras.

Mostrar rótulos

  Exibe rótulos para cada um dos dispositivos de som. Quer esta função esteja selecionada ou não, você verá esta informação em texto, sempre que passar com o mouse por cima do ícone de cada dispositivo.

Restaurar volumes no login

  Faz com que o &kde; restaure os volumes quando você se logar de novo. Isto restaura os seus níveis de volume pessoais, que são gravados quando você sair. Se o seu Sistema Operacional gravar os níveis de volume, poderá não necessitar desta opção (embora, num computador com vários usuários isto seja ainda necessário).

Valores de Volume:

  Selecione se deseja mostrar os valores do volume e como: Nenhum, Absoluto ou Relativo.

Orientação das Barras

  Com esta opção, você poderá rodar o conteúdo da janela principal do &kmix; em 90 graus. As barras deslizantes, o texto e todo o resto (se aplicável) é rodado. Existem algumas exceções a esta regra, sendo a mais notória o menu, o seletor de mistura (se for mostrado), a barra de deslocamento e os seletores de escolha múltipla.

## O painel do miniaplicativo do &kmix;

O painel do miniaplicativo do &kmix;é uma interface alternativa do &kmix;. Você pode adicioná-lo ao painel do KDE através do menu do painel (Menu do Painel -> Adicionar -> Miniaplicativo -> Miniaplicativo KMix).

Você pode trabalhar com o miniaplicativo &kmix; conforme descrito na janela principal incluindo o menu de contexto. Devido ao espaço limitado do painel, existem algumas diferenças:

- Menu principal não disponível.
- Se tiver várias placas de som, não será possível mudar a seleção do mixador depois da seleção inicial.
- Sem ícone acoplado. Se quiser usar o ícone acoplado você deve adicionalmente iniciar o &kmix; através de Menu-K Multimídia Mesa de Mistura &kmix;.
- Os ícones só estão disponíveis quando o painel possuir dimensão suficiente.
- Não estão disponíveis os rótulos do dispositivo.
- A configuração é efetuada através do menu do painel - você pode configurar cores e a direção da barra aqui.
- Sem gravação automática de volume. Se você quiser gravar os seus níveis de volume quando sair para serem restaurados mais tarde, terá também que iniciar o &kmix; a partir do menu K.

## Funcionalidades avançadas do &kmix;

Este capítulo descreve uma funcionalidade do &kmix; destinada aos usuários experientes. A maior parte dos usuários nunca necessitará dela, assim você pode seguramente pular este capítulo

### A Interface de &DCOP;

Às vezes você pode querer fazer algo especializado. Algo como controlar a mesa de mistura a partir de outro aplicativo ou tornar mudo o dispositivo mestre todos os dias às 22 horas. O &kmix; possui uma interface &DCOP; que lhe permite alcançar muito com o mínimo esforço. Você pode em um console digitar dcop kmix para explorar a interface &DCOP; do &kmix;. As interfaces específicas do &kmix; são:

``Mixer0``

  Permite controlar a primeira mesa de mistura. Você pode definir níveis de volume, tornar mudo o dispositivo, alterar o balanço, obter o nome da mesa de mistura e muito mais. Digite ``dcop kmix Mixer0`` se quiser explorar todas as funcionalidades. Existem mais entradas como ``Mixer1`` para o caso ter instaladas várias placas de som.

``kmix-mainwindow#1``

  A janela da &GUI; pode ser controlada com este comando. Você pode tornar invisível ou visível a janela, mudar o seu tamanho e muito mais. Digite ``dcop kmix kmix-mainwindow#1`` se quiser explorar todas as funcionalidades.

### Exemplos do &DCOP;

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

  Oculta a janela da &GUI;. Digite ``dcop kmix kmix-mainwindow#1 show`` ou clique no ícone acoplado para exibí-la novamente.

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

  Redimensiona a janela da &GUI; para a menor dimensão possível. Esta é a dimensão que permite que todas as barras (e outros elementos gráficos) se enquadrem na janela.

``dcop kmix Mixer0 mixerName``

  Retorna o nome da primeira mesa de mistura, por exemplo `Sound Fusion CS46xx`.

``dcop kmix Mixer1 setVolume 0 10``

  Define o nível de volume da segunda mesa de mistura, dispositivo em percentagem de 0 a 10. Dispositivo 0 normalmente o dispositivo mestre, embora nem sempre. Se você quiser desativar o (primeiro) dispositivo principal da segunda placa de som , pode usar ``dcop kmix Mixer1 setMasterVolume 0``

Você pode executar estes comandos diretamente através de um console no &kde;. Se você precisar executar comandos dcop de outro local, por exemplo a partir de um script de 'crontab', você deve definir a variável de ambiente `DCOPSERVER` (como na primeira linha do seu arquivo `~/.DCOPservidor_nome da máquina_:0`), por exemplo:

    #!/bin/sh
    DCOPSERVER=`cat /home/usuário/.DCOPserver_a_sua_máquina_:0 | grep local`
    export DCOPSERVER
    dcop kmix Mixer0 setMasterVolume 0

### Dicas e Truques

#### Usando os controladores ALSA e OSS ao mesmo tempo

O &kmix; no &Linux; pode usar quer o controlador ALSA quer o controlador OSS. Se você necessitar utilizar os dois controladores ao mesmo (situação rara), pode fazer o seguinte: Sair do &kmix; e adicionar a seguinte linha no seu arquivo `kmixrc` na seção de configuração global.

    MultiDriver=true

Inicie novamente o &kmix;. Se você clicar em Ajuda Informação do 'Hardware' deverá ver controladores de Som utilizados: ALSA0.9 + OSS e modo experimental de controlador-múltiplo ativado.

Você provavelmente irá ver todas as mesas de mistura em dobro.

Não existe suporte para esta configuração.

## Créditos e Licença

Desenvolvedores principais

- Direitos Autorais de 1996-2000 Christian Esken

- Direitos Autorais de 2000-2003 Christian Esken & Stefan Schimanski

- Direitos Autorais de 2003-2005 Christian Esken & Helio Chissini de Castro

Contribuições:

- Christian Esken esken@kde.org

- Stefan Schimanski 1Stein@gmx.de

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

- Sebestyen Zoltan szoli@digo.inf.elte.hu - Correções para FreeBSD

- Faraut Jean-Louis jlf@essi.fr - Correções para &Solaris;

- Nick Lopez kimo_sabe@usa.net - Porte para ALSA

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

- Lennart Augustsson augustss@cs.chalmers.se - Correções para o *BSD

Direitos autorais da documentação de 2000 para Matt Johnstonmattj@flashmail.com

Atualizado em 2003 para corresponder ao &kmix; V1.91 por Christian Esken esken@kde.org

Atualizado em 2005 para corresponder ao &kmix; V2.2 por Christian Esken esken@kde.org

Atualizado em 07/2005 para corresponder ao &kmix; V2.6 por Christian Esken esken@kde.org

Baseado na documentação de Christian Esken esken@kde.org

Tradução de Marcus Gamamarcus.gama@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &kmix;

&install.intro.documentation;

### Requisitos

Obviamente, o &kmix; só é útil se você tiver uma placa de som. O &kmix; suporta várias plataformas e controladores de som:

- Todas as plataformas Open Sound System. Foi explicitamente testado em &Linux; FreeBSD, NetBSD e BSDI.

- Máquinas baseadas no &Solaris;.

- Máquinas baseadas no &IRIX;.

- O controlador de som ALSA.

- Máquinas baseadas no &HP-UX;.

### Compilação e Instalação

&install.compile.documentation;