# 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
Rui
Branco

    freedebian@netcabo.pt

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

O &kmix; é uma aplicação que permite alterar o volume da sua placa de som.

KDE
KMix
kdemultimedia
som
volume
mesa de mistura

## Introdução

O &kmix; é o programa de mesa de mistura do &kde; para a placa de som .Apesar de pequeno, possuí muitas funções. O programa deverá fornecer controlos 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 tiver tanto os controladores ALSA como os do Open Sound System instalados, o &kmix; irá usar o controlador ALSA.

## Usar o &kmix;

### Básico

O funcionamento do &kmix; é bastante claro. Todo o dispositivo da mesa de mistura que a placa de som fornece é representado por uma barra de controlo de volume. Os dispositivos mono apenas possuem 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 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 secções com controlos da placa de som diferentes: Saída, Entrada e Opções. Estas secções contêm as barras de volume, os interruptores para activar/desactivar a gravação ou reprodução e selectores de escolha múltipla.

- Saída: Esta contém os controlos que estão mais relacionados com a saída ou reprodução de som, como o controlo de volume Master (mestre).
- Entrada: Esta contém os controlos mais relacionados com a gravação, como o Capture (Captura).
- Opções: Esta 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 Seleccione o Microfone: Mic1 ou Mic2).

Para além dos controlos de volume, o &kmix; também contém LED's. 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.

### Barras de volume

Os controlos de volume na secção Saída e Entrada consistem em (de cima para baixo): Controlo do Volume (Secção Entrada) Controlo do Volume (Secção Entrada)

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

controlo de volume com Opções de Gravação (Secção Saída) Controlo de volume com Opções de Gravação (Secçã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 os Canais

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

Mudo

  Desligar e ligar o som do dispositivo

Esconder

  Se não estiver interessado em regular este dispositivo pode esconder esta opção. Se a quiser voltar a mostrar, apenas terá que a seleccionar a opção Canais (ver abaixo)

Configurar os Atalhos Globais...

  Pode controlar um dispositivo com o teclado. Use esta opção do menu para mostrar a janela do &kde; para Configurar os Atalhos. Aqui 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 secção (Saída, Entrada, Opções), que canais deseja ver.

Mostrar/Esconder o Menu

  Esta opção não é específica a qualquer dispositivo, mas afecta a janela da mesa de mistura. Pode usar esta opção para esconder ou mostrar a barra de menu. Também poderá fazer isto carregando no atalho (normalmente &Ctrl;M)

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

Os controlos da secção Opções consistem num LED e numa legenda curta que descreve a função. A secção Opções poderá também conter selectores de escolha-múltipla. Lembre-se por favor que estes controlos são normalmente muito especiais e não necessitam normalmente de ser alterados pelo utilizador médio. O menu de contexto contém os itens Canais e Mostrar/Esconder o Menu já descritos. Opções e selectores de escolha-múltipla (Secção de Opções) Opções e selectores de escolha-múltipla (secção de Opções) Lembre-se por favor: os LED's vermelhos são relacionados com a gravação e os LED's 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 = controlo especial), um LED aceso Mix (vermelho = Relacionado com gravação), um LED apagado e relacionado com a gravação, um LED de controlo especial aceso e um selector de escolha múltipla (PCM Out Path & Mute). Se não tiver a certeza do significado de um controlo, peça por favor ao seu fornecedor do controlador da placa de som (na maior parte das distribuições actuais de &Linux;, este é o ALSA).

### Barra deslizante

Com esta barra pode controlar a distribuição de volume entre a coluna esquerda e a direita. Esta barra é um regulador geral, afectando todos os dispositivos estéreo (os dispositivos mono são ignorados). A posição por omissão é a central. Arrastando a barra para a esquerda passa o volume para a coluna esquerda, e vice-versa para o direito. Obviamente, estes podem ser trocados se as suas colunas não estiverem posicionadas correctamente.

Para os Sistemas Surround, tenha em atenção que o dispositivo Master (mestre) normalmente regula apenas os altifalantes 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 controlo Wave (ou PCM).

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

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

Acoplar no painel

  Se seleccionado, o &kmix; irá ser acoplado quando carregar no botão de fechar janela. Se não estiver seleccionado, o &kmix; será encerrado quando carregar no botão de fecho de janela. Atenção: depois de encerrar não poderá controlar o volume através das teclas escolhidas por si.

Activar o controlo de volume no painel

  Se estiver activo, ao carregar com o botão esquerdo no ícone da bandeja do &kmix;, irá mostrar uma janela com um controlo de volume para o dispositivo preferido (Sugestão: de momento você não pode mudar este dispositivo - ele é seleccionado pelo &kmix; em alternativa). Se a opção estiver desactivada, a janela principal do &kmix; será mostrada por completo, quando carregar com o botão esquerdo no ícone da bandeja.

Mostrar as marcas

  Mostrar linhas para marcar posições nas barras.

Mostrar o texto

  Mostra o nome de cada um dos dispositivos de som. Quer esta função esteja seleccionada ou não, verá esta informação em texto sempre que passar com o rato por cima do ícone de cada dispositivo.

Carregar níveis de volume no arranque

  Deixa que o &kde; reponha os volumes quando você se ligar de novo. Isto repõe os seus níveis de volume pessoais, que são gravados quando você sair. Se o seu Sistema Operativo gravar os níveis de volume, poderá não necessitar desta opção (embora, num computador com vários utilizadores isto seja à mesma necessário).

Valores de Volume:

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

Orientação das Barras

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

## O 'applet' de painel do &kmix;

A 'applet' do painel do &kmix; é uma interface alternativa para o &kmix;. Poderá adicioná-la ao painel do &kde; se seleccionar Adicionar a 'Applet' ao Painel... no Menu do Painel ou no menu de contexto. Escolha a Mesa de Mistura e carregue em Adicionar ao Painel ou faça duplo-click em Mesa de Mistura.

Pode trabalhar com o 'applet' &kmix; conforme descrito em 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 lhe será possível mudar a selecção da mesa de mistura depois da selecção inicial.
- Sem ícone acoplado. Se quiser usar o ícone acoplado tem que 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 tem dimensão suficiente.
- Não está disponível o nome do dispositivo.
- A configuração é efectuada através do painel de menu - pode configurar cores e a direcção da barra aqui.
- Sem gravação automática de volume. Se quiser gravar os seus níveis de volume quando sair para serem repostos mais tarde, terá também de iniciar o &kmix; a partir do menu K.

## Funcionalidades avançadas do &kmix;

Este capítulo descreve uma funcionalidade do &kmix; destinada ao utilizador experiente. A maior parte dos utilizadores nunca necessitará da mesma, pode por isso seguramente saltar este capítulo

### A Interface de &DCOP;

Por vezes pode querer fazer algo especializado. Algo como controlar a mesa de mistura a partir de outra aplicação ou tornar mudo o dispositivo mestre todos os dias às 22 horas. O &kmix; tem uma interface &DCOP; que lhe permite alcançar muito com o mínimo esforço. Pode em modo de consola escrever 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. Pode definir níveis de volume, tornar mudo o dispositivo, alterar o balanço, obter o nome da mesa de mistura e muito mais. Escreva ``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. Pode tornar invisível ou visível a janela, mudar o seu tamanho e muito mais. Escreva ``dcop kmix kmix-mainwindow#1`` se quiser explorar todas as funcionalidades.

### Exemplos do &DCOP;

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

  Esconde a janela da &GUI;. Escreva ``dcop kmix kmix-mainwindow#1 show`` ou carregue no ícone acoplado para a mostrar novamente.

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

  Diminui o tamanho da 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 quiser desactivar o (primeiro) dispositivo principal da segunda placa de som , pode usar ``dcop kmix Mixer1 setMasterVolume 0``

Pode executar estes comandos directamente através de uma consola no &kde;. Se precisar de executar comandos dcop de outro local, por exemplo a partir de um script de 'crontab', tem que definir a variável de ambiente `DCOPSERVER` (como na primeira linha do seu ficheiro `~/.DCOPservidor_nome da máquina_:0`), por exemplo:

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

### Truques e dicas

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

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

    MultiDriver=true

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

Provavelmente irá ver todas as mesas de mistura em duplicado.

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

## Créditos e Licença

Programadores principais

- Copyright 1996-2000 Christian Esken

- Copyright 2000-2003 Christian Esken & Stefan Schimanski

- Copyright 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 - Correcções para FreeBSD

- Faraut Jean-Louis jlf@essi.fr - Correcçõ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 - *BSD Fixes

Documentação com 'copyright' 2000 de &Matt.Johnston; &Matt.Johnston.mail;

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

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

Actualizado 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 Rui Branco freedebian@netcabo.pt

&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;