<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kmix;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % Portuguese "INCLUDE"
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>
<title
>Manual do &kmix;</title>

<authorgroup>
<author
><firstname
>Matt</firstname
> <surname
>Johnston</surname
> <affiliation
> <address
><email
>mattj@flashmail.com</email
></address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>Christian</firstname
> <surname
>Esken</surname
> <affiliation
><address
><email
>esken@kde.org</email
></address
></affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Helio</firstname
> <surname
>Chissini de Castro</surname
> <affiliation
><address
><email
>helio@kde.org</email
></address
></affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>


<othercredit role="developer"
><firstname
>Stefan</firstname
> <surname
>Schimanski</surname
> <affiliation
><address
><email
>1Stein@gmx.de</email
></address
></affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
<contrib
>Revisão</contrib>
</othercredit>
<othercredit role="translator"
><firstname
>Rui</firstname
><surname
>Branco</surname
><affiliation
><address
><email
>freedebian@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>1996</year
><year
>2003</year>
<holder
>Christian Esken &amp; Matt Johnston</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-04-24</date>
<releaseinfo
>1.91.00</releaseinfo>

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

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KMix</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>som</keyword>
<keyword
>volume</keyword>
<keyword
>mesa de mistura</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>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.</para>

<para
>O &kmix; suporta várias plataformas e controladores de som. A versão 1.91 funciona com:</para>

<itemizedlist>
<listitem
><para
>Todas as plataformas Open Sound System. Foi explicitamente testado em &Linux; FreeBSD, NetBSD and BSDI.</para
></listitem>
<listitem
><para
>Máquinas baseadas no &Solaris;.</para
></listitem>
<listitem
><para
>Máquinas baseadas no &IRIX;.</para
></listitem>
<listitem
><para
>O controlador de som ALSA.</para
></listitem>
<listitem
><para
>Máquinas baseadas no &HP-UX;.</para
></listitem>
</itemizedlist>

</chapter>

<chapter id="working-with-kmix">
<title
>Usar o &kmix;</title>

<para
>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.</para>

<sect1 id="volume-sliders">
<title
>Barras de volume</title>

<para
>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.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Separar os canais</guilabel
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mudo</guilabel
></term>
<listitem
><para
>Desligar e ligar o som do dispositivo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Esconder</guilabel
></term>
<listitem
><para
>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 <guilabel
>Mostar Todos</guilabel
> (ver abaixo)</para
></listitem>
</varlistentry>

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

<varlistentry>
<term
><guilabel
>Mostrar Todos</guilabel
></term>
<listitem
><para
>Se tiver dispositivos escondidos através da opção <guilabel
>Esconder</guilabel
> (ver abaixo), poderá voltar a mostrá-los novamente com esta opção.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mostrar a Barra de Menu</guilabel
></term>
<listitem
><para
>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)</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="panning-slider">
<title
>Barra deslizante</title>

<para
>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.</para
> 

</sect1>

<sect1 id="configuration-options">
<title
>Opções de configuração</title>

<para
>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:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Acoplar no painel</guilabel
></term>
<listitem
><para
>minimizar para um ícone no painel de sistema</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Activar o controlo de volume no painel de sistema</guilabel
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Mostrar marcas de selecção</guilabel
></term>
<listitem
><para
>Mostrar linhas para marcar posições nas barras.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Mostrar texto</guilabel
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>


</chapter>


<chapter id="working-with-kmixapplet">
<title
>O painel 'applet' do &kmix;</title>

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

<para
>Pode trabalhar com o 'applet' &kmix; conforme descrito em <link linkend="working-with-kmix"
>janela principal</link
> incluindo o menu de contexto. Devido ao espaço limitado do painel, existem algumas diferenças: <simplelist>
<member
>Menu principal não disponível.</member>
<member
>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.</member>
<member
>Sem ícone acoplado. Se quiser usar o ícone acoplado tem que adicionalmente iniciar o &kmix;através do menu K (normalmente em <guilabel
>Menu-K</guilabel
> -> <guilabel
>Multimedia</guilabel
> -> <guilabel
>Mesa de Mistura de Som</guilabel
>).</member>
<member
>Os ícones só estão disponíveis quando o painel tem dimensão suficiente.</member>
<member
>Não está disponível o nome do dispositivo.</member>
<member
>A configuração é efectuada através do painel de menu - pode configurar cores e a direcção da barra aqui.</member>
</simplelist>

</para>
</chapter>

<chapter id="control-panel">
<title
>Configurações do &kcontrol;</title>

<sect1 id="config-opt">
<title
>Opções de configuração</title>

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

<variablelist>
<varlistentry>
<term
><guilabel
>Gravar os níveis de volume actuais</guilabel
></term>
<listitem
><para
>Gravar as configurações de som para as carregar mais tarde.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Carregar níveis de volume</guilabel
></term>
<listitem
><para
>Carregar configurações de som previamente gravadas.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Carregar níveis de volume ao autenticar-se</guilabel
></term>
<listitem
><para
>Carregar automaticamente configurações anteriores quando inicia o &kde;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Número máximo de mesas de mistura detectadas</guilabel
></term>
<listitem
><para
>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;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Número máximo de dispositivos a detectar por mesa de mistura</guilabel
></term>
<listitem
><para
>Quantos dispositivos deverão ser procurados por placa de som. Novamente definir para prioridade baixa para acelerar o &kmix;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>



<chapter id="advanced-kmix">
<title
>Funcionalidades avançadas do KMix</title>



<warning
><para
>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</para
></warning>


<sect1 id="dcop-overview">
<title
>A Interface DCOP</title>

<para
>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 <guilabel
>dcop kmix</guilabel
> para explorar a interface DCOP do &kmix;. As interfaces específicas do &kmix; são:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Mesa de mistura0</guilabel
></term>
<listitem
><para
>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 <guilabel
>dcop kmix Mixer0</guilabel
> se quiser explorar todas as funcionalidades. Existem mais entradas como <guilabel
>Mixer1</guilabel
> para o caso ter instaladas várias placas de som.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>kmix-mainwindow#1</guilabel
></term>
<listitem
><para
>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 <guilabel
>dcop kmix kmix-mainwindow#1</guilabel
> se quiser explorar todas as funcionalidades.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>





<sect1 id="dcop-examples">
<title
>Exemplos do DCOP</title>

<variablelist>
<varlistentry>
<term
><guilabel
>dcop kmix kmix-mainwindow#1 hide</guilabel
></term>
<listitem
><para
>Esconde a janela gráfica. Escreva <guilabel
>dcop kmix kmix-mainwindow#1 show</guilabel
> ou clique no ícone acoplado para a mostrar novamente.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix kmix-mainwindow#1 resize 1 1</guilabel
></term>
<listitem
><para
>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.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix Mixer0 mixerName</guilabel
></term>
<listitem
><para
>Retorna o nome da primeira mesa de mistura, por exemplo <guilabel
>Sound Fusion CS46xx</guilabel
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix Mixer1 setVolume 0 10</guilabel
></term>
<listitem
><para
>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 <guilabel
>dcop kmix Mixer1 setMasterVolume 0</guilabel
></para
></listitem>
</varlistentry>
</variablelist>

<para
>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 <guilabel
>DCOPSERVER</guilabel
> (como na primeira linha do seu ~/.DCOPservidor_nome da máquina_:0 file), por exemplo: </para>
                                                                         <!-- Don't know a better way to format code - esken -->
<simplelist>
<member
>#!/bin/sh</member>
<member
>DCOPSERVER=`cat /home/yourhome/.DCOPservidor_nome da máquina_:0 | grep local`</member>
<member
>export DCOPSERVER</member>
<member
>dcop kmix Mixer0 setMasterVolume 0</member>
</simplelist>

</sect1>

<sect1 id="tips-and-tricks">
<title
>Truques e dicas</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Usar os controladores ALSA e OSS ao mesmo tempo
></guilabel
></term>
<listitem>
<para
>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 <guilabel
>kmixrc</guilabel
> na secção de configuração global.</para>
<para
><guilabel
>MultiDriver=true</guilabel
></para>
<para
>Inicie novamente o KMix. Se clicar em <guilabel
>Ajuda->Informação de Hardware</guilabel
> deverá ver "<guilabel
>controladores de Som utilizados: ALSA0.9 + OSS</guilabel
>" e "<guilabel
>modo experimental de controlador-múltiplo activado</guilabel
>"</para>
<warning
><para
>Aviso: Provavelmente irá ver todas as mesas de mistura em duplicado.</para
><para
>Não existe suporte para esta configuração.</para
></warning>
</listitem>
</varlistentry>
</variablelist>

</sect1>

</chapter>

<chapter id="credits">
<title
>Créditos e Licença</title>

<para
>Programadores principais</para>

<itemizedlist>
<listitem
><para
>Copyright 1996-2000 Christian Esken</para
></listitem>
<listitem
><para
>Copyright 2000-2003 Christian Esken &amp; Stefan Schimanski</para
></listitem>
<listitem
><para
>Copyright 2003 Christian Esken &amp; Helio Chissini de Castro</para
></listitem>
</itemizedlist>

<para
>Contribuições:</para>

<itemizedlist>
<listitem
><para
>Christian Esken <email
>esken@kde.org</email
></para
></listitem>
<listitem
><para
>Stefan Schimanski <email
>1Stein@gmx.de</email
></para
></listitem>
<listitem
><para
>Paul Kendall <email
>paul@orion.co.nz</email
> - Porte para SGI</para
></listitem>
<listitem
><para
>Sebestyen Zoltan <email
>szoli@digo.inf.elte.hu</email
> - Correcções para FreeBSD</para
></listitem>
<listitem
><para
>Faraut Jean-Louis <email
>jlf@essi.fr</email
> - Correcções para Solaris</para
></listitem>
<listitem
><para
>Nick Lopez <email
>kimo_sabe@usa.net</email
> - Porte para ALSA</para
></listitem>
<listitem
><para
>Helge Deller <email
>deller@gmx.de</email
> - Porte para HP-UX</para
></listitem>
<listitem
><para
>Lennart Augustsson <email
>augustss@cs.chalmers.se</email
> - *BSD Fixes</para
></listitem>
</itemizedlist>

<para
>Documentação copyright 2000 Matt Johnston <email
>mattj@flashmail.com</email
></para>

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

<para
>Baseado na documentação de Christian Esken <email
>esken@kde.org</email
></para>
<para
>Tradução de Rui Branco <email
>freedebian@netcabo.pt</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-kmix">
<title
>Como obter o &kmix;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Requisitos</title>

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

<itemizedlist>
<listitem
><para
>Todas as plataformas Open Sound System. Foi explicitamente testado em &Linux; FreeBSD, NetBSD and BSDI.</para
></listitem>
<listitem
><para
>Máquinas baseadas no &Solaris;.</para
></listitem>
<listitem
><para
>Máquinas baseadas no &IRIX;.</para
></listitem>
<listitem
><para
>O controlador de som ALSA.</para
></listitem>
<listitem
><para
>Máquinas baseadas no &HP-UX;.</para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="compilation">
<title
>Compilação e Instalação</title>
&install.compile.documentation; </sect1>

</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

