# Manual do &kmix;

## 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. A versão 1.91 funciona com:

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

- Máquinas baseadas no &Solaris;.

- Máquinas baseadas no &IRIX;.

- O controlador de som ALSA.

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

## Usar o &kmix;

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. Dispositivos mono apenas possuem uma barra, dispositivos stereo podem ter uma ou duas, dependendo da sua escolha. Adicionalmente existe barra deslizante no fundo da janela do &kmix;. Se possuí várias placas de som, cada uma delas terá a sua página.

### Barras de volume

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 stereo. 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 Mostar Todos (ver abaixo)

Definir Teclas

- Pode controlar um dispositivo com o teclado. Use esta opção do menu para mostrar o dialogo do &kde; Configurar teclas de atalho . 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.

Mostrar Todos

- Se tiver dispositivos escondidos através da opção Esconder (ver abaixo), poderá voltar a mostrá-los novamente com esta opção.

Mostrar a Barra de Menu

- Esta opção nao é específica de nenhum 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)

### Barra deslizante

Com esta barra pode controlar a distribuição de volume entre o altifalante esquerdo e direito. Esta barra é um regulador geral, afectando todos os dispositivos stereo (dispositivos mono são ignorados). A posição por omissão é a central. Arrastando a barra para a esquerda diminui o volume no altifalante esquerdo, e vice versa para o direito. Obviamente, estes podem ser trocados se os seus altifalantes não estiverem posicionados correctamente.

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

Se o &kmix; estiver acoplado no painel de sistema, pode através do botão direito do rato escolher as preferências. As opções são:

Acoplar no painel

- minimizar para um ícone no painel de sistema

Activar o controlo de volume no painel de sistema

- 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 carrgar 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.

Mostrar marcas de selecção

- Mostrar linhas para marcar posições nas barras.

Mostrar texto

- Apresenta texto para 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.

## O painel 'applet' do &kmix;

O painel 'applet' do &kmix;é uma alternativa ao interface do &kmix;. Pode adicioná-lo ao painel do KDE através do painel de menu (Panel Menu -> Add -> Applet -> KMix Applet).

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 do menu K (normalmente em Menu-K -> Multimedia -> Mesa de Mistura de Som).
- 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.

## Configurações do &kcontrol;

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

No item Mesa de mistura, em Som no &kcontrol; pode definir várias opções para o &kmix;:

Gravar os níveis de volume actuais

- Gravar as configurações de som para as carregar mais tarde.

Carregar níveis de volume

- Carregar configurações de som previamente gravadas.

Carregar níveis de volume ao autenticar-se

- Carregar automaticamente configurações anteriores quando inicia o &kde;.

Número máximo de mesas de mistura detectadas

- Quantas placas de som diferentes devem ser procuradas pelo &kmix; quando iniciado. Definir prioridade baixa a esta função para acelerar a velocidade de arranque do &kmix;.

Número máximo de dispositivos a detectar por mesa de mistura

- Quantos dispositivos deverão ser procurados por placa de som. Novamente definir para prioridade baixa para acelerar o &kmix;.

## 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 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 10pm. &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:

Mesa de mistura0

- 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

- O estilo gráfico da janela pode ser controlado com este comando. Pode tornar invisível ou visível a janela, redimensioná-la 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 gráfica. Escreva dcop kmix kmix-mainwindow#1 show ou clique no ícone acoplado para a mostrar novamente.

dcop kmix kmix-mainwindow#1 resize 1 1

- Redimensiona a janela gráfica para a menor dimensão possível. Esta dimensão 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 ~/.DCOPservidor_nome da máquina_:0 file), por exemplo:

- #!/bin/sh
- DCOPSERVER=`cat /home/yourhome/.DCOPservidor_nome da 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 seguinta linha no seu ficheiro kmixrc na secção de configuração global.

  MultiDriver=true

  Inicie novamente o KMix. Se clicar em Ajuda->Informação de Hardware deverá ver "controladores de Som utilizados: ALSA0.9 + OSS" e "modo experimental de controlador-múltiplo activado"

  Aviso: 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 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 copyright 2000 Matt Johnston mattj@flashmail.com

Actualizado em 2003 para corresponder ao &kmix; V1.91 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 and 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;