# Manual do &noatun;

## Introdução

&noatun; plug-in completo baseado num leitor multimédia para KDE;.

### Características

&noatun; é um elaborado interface visual para o sintetizador analógico em tempo real &arts;. Para adicionar objectos adicionais, vá a http://noatun.kde.org/plugins.phtml, ou a http://mpeglib.sf.net. Por omissão o &arts; suporta os formatos MP3 e MPEG-1. O formato Vorbis é igualmente suportado se as livrarias do Vorbis tiverem sido disponibilizadas durante a compilação do &kde;.

## Utilizar o &noatun;

&noatun;, por omissão é iniciado com um excelente 'plugin' de interface para o utilizador. Este 'plugin' foi escolhido pelo facto de ser similar a maior parte das outras aplicações do KDE.

&noatun; é único por não existirem duas instalações iguais e por não ter um interface standard, no entanto existe um por omissão. Terá a liberdade de juntar e ajustar a sua selecção de 'plugins' e personalizar o &noatun; até que se torne no seu leitor de multimédia ideal!

### Formato do Título

A janela de preferências do &noatun; possuí uma caixa de texto Formato do Título estranha. Poderá introduzir um formato de cadeia de texto para personalizar a forma como o formato aparece.

- Qualquer texto aparece de um modo normal, a não ser que esteja entre `$( )`.

- O texto entre `$( )` irá utilizar a propriedade do &noatun; para esse mesmo item, e irá substituí-lo pelo texto dado.

- Se entre `$( )` existem aspas, esse texto será apresentado normalmente, mas apenas se a propriedade desse nome existir.

- As aspas podem estar no início do `$( )`, no final, ou em ambos em simultâneo.

Por exemplo, `$(bitrate)` é substituído pelo bitrate do ficheiro, tal como o 'plugin' Metatag o carrega. No entanto, se inserir aspas naquele campo, o texto entre aspas, será mostrado: `$(bitrate"kbps")` dará informação sobre o bitrate, do ficheiro, seguido pelos caracteres `"kbps"` , por exemplo. Não será mostrado no entanto se a propriedade bitrate não existir.

## manual do &noatun; 'Plugins'

Poderá seleccionar diferentes 'plugins' indo ao menu Configuração, e seleccionando Configurar &noatun;.... Vá á página Plugins através da selecção do item adequado da lista. Então poderá activar os 'plugins' seleccionando a caixa correspondente ao seu nome. &noatun; requer pelo menos um 'plugin' de interface do utilizador, e um 'plugin' de lista de média.

### Leite com Chocolate

Milk Chocolate é uma interface para o utilizador simples e pequena. Os botões comportam-se como um leitor de CD, onde o botão de ejectar abre a lista de média. A página com cruz remove a lista de média actual, mas não apaga o ficheiro do disco, e o botão de seta activa o modo de repetição. Um menu está disponível através do &RMB; clicando em qualquer parte da janela.

### Young Hickory

Young Hickory é um 'plugin' para a Bandeja do Sistema do &kde;, a área junto ao relógio, por omissão.

Ao clicar no ícone &RMB; é mostrado um pequeno menu, e ao clicar em &LMB; dará visibilidade à sua janela de interface de utilizador &noatun;. Note que as listas de média por exemplo, não são consideradas como interfaces de utilizador.

### HTML Exportar Lista de Média

Este 'plugin' colocará a lista de média numa elegante tabela HTML. A página de preferências dá a possibilidade de selecção de cores, imagem de fundo, e activa o modo 'Hover', para mudança de cores quando o cursor esta sobre um 'link'.

Depois de escolher as opções, o menu Acções, Exportar Lista de Reprodução... abrirá um diálogo de ficheiro para que seleccione o destino de gravação do ficheiro de saída.

### K-Jöfol 'Skins'

O carregador de estilo K-Jöfol do &noatun;, é uma reimplementação de um programa do Windows com o mesmo nome.

A implementação do &noatun; tem infelizmente algumas limitações. Por exemplo os estilos tem que ser previamente descomprimidos para o disco para que sejam carregados.

Para instalar um estilo (formato ZIP, no &Windows;) poderá usar o carregador de estilos que se encontra na caixa de diálogo das preferências do &noatun;.

Pelo facto de alguns estilos não estarem devidamente empacotados e do carregador de estilos não adivinhar tudo, poderá ainda seguir os seguintes comandos se uma determinada instalação de um estilo falhar:

    % cd $TDEHOME/share/apps/noatun
    % mkdir kjskins (se necessário)
    % cd kjskins
    % mkdir nova estilo ; cd novo estilo
    % unzip /caminho/para/novo_estilo.zip

Pode também criar os seus próprios estilos com a ajuda do tutorial http://www.angelfire.com/mo/nequiem/tutorial.html.

### A Split Playlist (Lista Dividida)

A Split Playlist possui um design simples e clássico. Um duplo clique em qualquer entrada da lista irá accioná-la (do mesmo modo seleccionando-a e premindo Enter). Poderá arrastar ficheiros bem como &URL;s.

Tal como o &kde; 3.0, o Split Playlist (SPL) guarda a informação em formato &XML;, importante automaticamente a lista m3u se o ficheiro &XML; não existir. Isto significa que poderá modificar o ficheiro m3u, e apagar o ficheiro &XML; para automaticamente gerar listas de média.

O nome Split Playlist é um pouco enganador, na medida em que a lista não está realmente dividida. Este nome resulta do seu design original (remontando aos primeiros dias do &noatun;) onde estava realmente dividida.

### Estilos do Winamp

Se estiver a usar o estilo Winamp, por certo já deverá ter reparado que lhe é familiar. Clicando no contador horário seleccionará o modo de contagem crescente ou decrescente. Ao clicar a área do gráfico irá activar ou desactivar o mesmo. Poderá também fazer um duplo clique na barra de título para activar o modo de sombra do Windows. Com o botão direito (ou clicando no ícone superior esquerdo irá ser mostrada a barra de ferramentas standard do &noatun;.

Poderá instalar novos estilos em `$TDEHOME/share/apps/noatun/skins/winamp`, criando uma directoria para as guardar, e extraindo o estilo de seguida para a mesma directoria. Os ficheiros de estilo Winamp com a extensão `.wsz` podem ser tratados como ficheiros zip normais. Poderá no entanto ter que os renomear primeiro para que os possa descomprimir.

### Metatag

Metatag é um 'plugin' que carrega a informação respectiva a um ficheiro através do KDE, o mesmo mecanismo é usado no &konqueror; quando passa com o rato por cima de um qualquer ficheiro. Além de carregar informação, também suporta edição através de Acções menu subitem Editor de Marcas. Suporta edição de tags ID3, bem como de tags OggVorbis. Lê também a taxa de bits dos ficheiros.

### Keyz

Carsten Pfeiffer decidiu quebrar com a longa tradição do &noatun; de criação de nomes o mais incorrectos possíveis 'plugins', como ficou provado tanto pelos 'plugins' Milk-Chocolate, Young Hickory, e muitos mais outros. Do que vale apenas convergir do S para um Z? Parece algo que os falantes de Inglês-Americano fariam!

Contudo, apenas pelo facto de o nome não ser original não significa que é um fraco 'plugin'. Pleo contrário, este permite a atribuição de teclas de atalho para algumas acções do &noatun;. A verdadeira beleza nestas teclas de atalho, é que funcionam de qualquer lado, e não apenas dentro do &noatun;. Assim pode finalmente valer a pena os Teclados Multimédia.

### Controlo por Infravermelhos

Se tiver um controlo por Infravermelhos no seu computador (tais como os da televisão com sintonizadores Brooktree), e o seu controlo for suportado por LIRC, então deverá funcionar. Tal como Keyz, o nome é muito insípido, mas o 'plugin' permite-lhe atribuir acções a cliques de botões.

Para atribuir acções a um botão, carregue o 'plugin', vá á página de Controle do controlo por Infravermelhos na janela de configuração do &noatun;. Seleccione o botão da lista e escolha a acção a associar da 'combo box' abaixo. Se numa acção como por exemplo o controle de volume, quiser efectuar a acção repetidamente, active a caixa e seleccione o intervalo entre acções.

Se tiver uma placa TV, um truque conveniente é atribuir o botão Mudo à acção Pausa, permitindo assim tirar o som ao painel da sua aplicação de TV, enquanto pausa o &noatun;, e vice-versa, isto é particularmente útil no caso de anúncios publicitários.

## Perguntas, Respostas e Dicas

## Perguntas mais frequentes

A música tem muitas falhas quando se movimenta janelas.

Você pode ter aumentar o 'buffer' do &arts; do seguinte modo:

- Inicie o &kcontrol;

- Vá ao grupo Som

- Vá à secção Servidor de Som

- Aumente o tempo de resposta —, 384ms é normalmente suficiente para a maioria dos computadores.

Poderá também considerar correr o servidor de som em prioridade de tempo real se o tempo de resposta não ajudar. Tenha atenção que isto pode provocar um bloqueio no sistema.

Não posso remover a lista de média ou a interface de utilizador da lista de 'plugins'.

Já que o &noatun;necessita de pelo menos uma interface para o utilizador carregada e uma lista de média, você terá que adicionar um 'plugin' de interface antes de remover o antigo. Adicionar uma nova lista de média removerá automaticamente a antiga.

Onde posso obter mais 'plugins' ?

Os programadores de programas de terceiros podem submeter os seus 'plugins' em &noatun; web-site, local onde podem ser descarregados por você, utilizador.

Como posso construir um 'plugin' para o &noatun;?

A documentação , em modo API, e exemplo de código fonte estão disponíveis no site &noatun;. Do mesmo modo, e no espírito do software de código aberto o código fonte do &noatun; e todos os 'plugins' de defeito estão disponíveis.

## Créditos e Licenças

Direitos do programa 2000-2002 Charles Samuels charles@kde.org

Direitos da documentação 2002 Charles Samuels charles@kde.org

O &noatun; foi trazido a você pelas seguintes pessoas:

- Charles Samuels charles@kde.org

- Neil Stevens multivac@fcmail.com

- Stefan Westerfeld stefan@space.twc.de

- Martin Vogt mvogt@rhrk.uni-kl.de

- Malte Starostik malte.starostik@t-online.de

- Nikolas Zimmermann wildfox@kde.org

- Stefan Schimanski 1Stein@gmx.de

Tradução de Rui Branco freedebian@netcabo.pt

&underFDL; &underBSDLicense;

## Instalação

### Como obter o &noatun;

&install.intro.documentation;

### Requisitos

&noatun; requer no mínimo um Pentium 200 com &Linux;, um PowerPC com &Linux; 2.4.1 ou superior, ou outras plataformas. Suporte para mais plataformas será disponibilizado em breve.

Para que uma plataforma seja facilmente suportada, terá que ter suporte 'pthread', e o sistema de saída de som OSS, no entanto o sistema ALSA é suportado no &Linux;.

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

&install.compile.documentation;

Se se deparar com algum problema, por favor reporte ao autor em charles@kde.org.

Se tem esta documentação, provavelmente já terá compilado o &noatun;

## Glossário

Milk Chocolate

Milk Chocolate é um 'plugin' de interface de utilizador simples e minimalista

&arts;

&arts; é um sintetizador analógico em tempo real. Uma estrutura de média poderosa utilizada pelo &noatun;

K-Jöfol

Este 'plugin' carrega estilos originalmente usadas num leitor de média do &Windows; com o mesmo nome.

Keyz

Keyz permite-lhe atribuir teclas a acções no &noatun;

Young Hickory

Young Hickory é um 'plugin' da barra de sistema.

Noatun

Kaiman é um 'plugin' que carrega estilos do leitor de média GQMPEG. Kaiman é um predecessor do &noatun;, foi distribuído com o &kde; para o &kde; 2.0. Quando o &noatun; foi introduzido no &kde; 2.1, o carregador de estilos Kaiman tornou-se num 'plugin' do &noatun;.

&documentation.index;