# O Manual do &arts;

Stefan Westerfeld

    stefan@space.twc.de

Jeff Tranter

    tranter@kde.org

Marcus Gama

    marcus_gama@uol.com.br

Tradução
1999-2001 Stefan Westerfeld & Jeff Tranter
&FDLNotice;
2001-06-10
1.00.09

Este manual descreve o &arts;, sigla em inglês para Sintetizador Analógico em Tempo Real.

aRts construtor arts sintetizador multimídia estrutura música som KDE

## Introdução

### O que é o &arts;?

O Sintetizador Analógico em Tempo Real, ou &arts;, é um sistema modular para sintetização de som e música em um computador digital. Usando pequenos blocos de construção chamados módulos, o usuário pode facilmente construir complexas ferramentas de processamento de áudio. Os módulos fornecem tipicamente funções como geradores de forma de onda de som, filtros, efeitos de áudio, mixagem, e reprodução de áudio digital em diferentes formatos de arquivo.

O servidor de som &artsd; mixa áudio a partir de diversas fontes em tempo real, permitindo que múltiplos aplicativos de som compartilhem de maneira transparente o hardware de som.

Usando o &MCOP;, sigla em inglês para Protocolo de Comunicação Multimídia, aplicativos multimídia podem ser transparentes à rede, autenticados por segurança, e independentes de plataforma usando interfaces definidas de uma maneira independente de linguagem usando o &IDL;. Também é fornecido suporte para aplicativos legados não compatíveis com o &arts;. Como um componente básico do &kde;, o ambiente de trabalho K, o &arts; fornece a base para a arquitetura multimídia do &kde;, e no futuro suportará mais tipos de mídia, incluindo vídeo. Como o &kde;, o &arts; se executa em diversos sistemas operacionais, incluindo o &Linux; e variantes do BSD. Ele também pode ser usado independentemente do &kde;.

### Usando Este Manual

Esta manual pretende fornecer uma documentação acessível para usuários do &arts; de diferentes níveis de conhecimento. Dependendo se você é um usuários casual de aplicativos multimídia que utilizam o &arts;, ou se é um desenvolvedor de aplicativos multimídia, você pode querer tomar diferentes caminhos pelo manual.

É sugerido que você primeiro leia o capítulo Baixando e Construindo o &arts; se você precisa obter o &arts; inicialmente para executá-lo. Se você já possui um sistema funcionado, como o fornecido pela distribuição do seu sistema operacional, você pode escolher pular esta seção.

Você deve então ler as seções do capítulo Ferramentas do &arts;, especialmente o &artsd;, &artscontrol;, &artsshell; e &artsdsp;. Isto lhe auxiliará a fazer um uso mais efetivo do &arts;.

Se você estiver interessado em ir mais adiante com o &arts;, leia o capítulo do &arts-builder; e navegue pelo tutorial. Isto deve fornecer-lhe um panorama das poderosas capacidades do &arts; e dos módulos fornecidos que podem ser usados sem que precise ser um programador.

Se você deseja conhecer mais sobre os mecanismos internos do &arts;, seja para desenvolver aplicativos multimídia ou para extender o próprio &arts;, leia alguma coisa ou todo o capítulo &arts; em Detalhes. Isto deve dar-lhe um entendimento de todos os conceitos que são pré-requisitos para o desenvolvimento de programas baseados no &arts;.

Se você está interessado especialmente nas capacidades MIDI do &arts;, você deve ler o capítulo &MIDI;.

Se você deseja desenvolver aplicativos multimídia compatíveis com o &arts;, o capítulo Interfaces de Programação de Aplicativos do &arts; cobre as diferentes APIs em detalhes.

Se você deseja extender o &arts; criando novos módulos, leia o capítulo Módulos do &arts;.

Se você está modificando um aplicativo existente para ser executado sob o &arts; leia o capítulo Portando Aplicativos para o &arts;.

Você pode descobrir como contribuir para o projeto &arts; no capítulo Contribuindo com o &arts;, leia sobre o desenvolvimento futuro do &arts; no capítulo Trabalhos Futuros, e encontre ligações para mais informações na seção Referências.

Nós também enriquecemos o manual com algum material adicional, incluindo respostas para perguntas frequentes, um lista de contribuidores, os detalhes dos direitos autorais e licenciamento do &arts;, e algum material de suporte sobre áudio digital e &MIDI;. Um glossário de termos foi também incluído.

Este manual ainda está em constante progresso. Você é bem vindo para contribuir escrevendo partes dele, mas se você deseja fazer isso, contacte Jeff Tranter tranter@kde.org ou Stefan Westerfeld stefan@space.twc.de primeiro para evitar duplicação de esforços.

### Histórico

No final de 1997 Stefan Westerfeld começou a trabalhar em um sistema modular e em tempo real para sintetização de som. O código inicialmente foi rodado em um sistema PowerPC executando &AIX;. Esta primeira implementação foi muito simples mas suportava um sistema de fluxo completo em recursos que era capaz de fazer coisas como tocar arquivos MP3 e direcionar fluxos de áudio através de módulos de efeitos.

O próximo passo foi implementar uma &GUI; de modo que os módulos pudessem ser manipulados graficamente. Stefan havia tido uma boa impressão ao usar o &kde;, assim ele o escolheu como conjunto de ferramentas de desenvolvimento &GUI; (sabendo que seria necessário fazer uma versão GNOME/Gtk+ também) e isto mais tarde levou-o a usar o &Linux; como plataforma principal de desenvolvimento. Originalmente chamado ksynth, o projeto foi renomeado &arts; e o ritmo de desenvolvimento foi acelerado. O projeto no estágio atual está quase completo, com um protocolo baseado em CORBA, dúzias de módulos, uma ferramenta de edição de módulos gráfica, APIs C e C++, documentação, utilitários e uma lista de discussão e site wev com um pequeno grupo de desenvolvedores. O projeto percorreu um longo caminho em somente um pouco mais de uma ano de desenvolvimento.

Quando a equipe do &kde; iniciou o planejamento do &kde; 2.0, ficou claro que o &kde; precisava de uma infraestrutura mais poderosa para som e outros fluxos de mídia. Ela decidiu adaptar o &arts;, uma vez que era um bom passo nesta direção com uma arquitetura comprovada. Muito dos novos esforços de desenvolvimento foi voltado para esta nova versão do &arts;, mais notadamente a substituição do código CORBA com um sub-sistema totalmente novo, o &MCOP;, otimizado para multimídia. A versão 0.4 do &arts; foi incluída no lançamento do &kde; 2.0.

O trabalho continua procurando aumentar o desempenho do &arts; e adicionar novas funcionalidades. Deve ser observado que apesar do &arts; ser agora um componente base do &kde;, ele pode ser usado sem o &kde;, e também está sendo usado por aplicativos que vão além da multimídia tradicional. O projeto atraiu algum interesse da equipe do GNOME, abrindo a possibilidade de ele ser algum dia a arquitetura de multimídia padrão do sistemas de ambiente de trabalho &UNIX;.

&tools; &artsbuilder-doc; &detail; &arts-midi; &gui; &mcop-ref; &apis; &modules; &porting; &helping; &future; &references; &arts-faq;

## Direitos Autorais e Licenciamento do &arts;

Os direitos autorais 1998-2001 do &arts; pertencem à Stefan Westerfeld stefan@space.twc.de

Os direitos autorais 1999-2001 da documentação pertencem à Stefan Westerfeld stefan@space.twc.de e Jeff Tranter tranter@kde.org.

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underFDL;

Todas as bibliotecas que estão no &arts; são licenciadas sob os termos da licença Pública Geral Lesser GNU. A grande maioria do código do &arts; está nas bibliotecas, incluindo todo o MCOP e ArtsFlow. Isto permite que as bibliotecas sejam usados por aplicativos não-gratuitos/não-abertos se desejado.

Existem alguns poucos programas (como o artsd), que foram lançados sob os termos da Licença Pública Geral GNU. Assim como existem diferentes opiniões sobre se reunir ou não programas GPL com o &Qt; é legal, eu também adicionei uma notificação explícita que permite isto, em adição ao GPL: é também permitido ligar este programa com a biblioteca &Qt;, considerando o &Qt; como uma biblioteca que normalmente acompanha o sistema operacional do núcleo, seja ou não o caso de fato.

## Instalando o &arts;

Para usar o &arts; você obviamente precisa instalá-lo e executá-lo em seu sistema. Existem duas maneiras para fazer isto, que são descritas nas próximas seções.

### Instalando uma Versão Binária Pré-compilada

A maneira mais rápida e fácil de ter o &arts; rodando é instalar pacotes binários pré-compilados para seu sistema. As mais recentes distribuições &Linux; incluem o &kde;, e se ele for o &kde; 2.0 ou superior ele incluirá o &arts;. Se o &kde; não estiver incluído em sua mídia de instalação ele pode estar disponível para baixar pela internet a partir de fornecedor do seu sistema operacional. Alternativamente ele pode estar disponível a partir de terceiros. Certifique-se de que você usa pacotes que são compatíveis com a versão do seu sistema operacional.

Uma instalação básica do &kde; incluirá o servidor de som, permitindo que a maioria dos aplicativos executem som. Se você deseja um conjunto completo de ferramentas e aplicativos multimídia você precisará instalar pacotes adicionais opcionais.

A desvantagem do uso de binários pré-compilados é que eles podem não ser a versão mais recente do &arts;. Isto é particularmente verdade se eles forem fornecidos em um &CD-ROM;, uma vez que o ritmo de desenvolvimento do &arts; e &kde; é tal que a mídia &CD-ROM; não consegue normalmente acompanhá-lo. Você pode também descobrir que, caso você tenha uma distribuição do sistema operacional ou arquitetura menos comum, pacotes binários pré-compilados podem não estar disponíveis e você precisará usar o segundo método.

### Construindo a Partir do Código

Apesar do gasto de tempo, a maneira mais flexível de construir o &arts; é compilá-lo você mesmo a partir do código fonte. Isto garante que você tenha uma versão compilada otimizada para a configuração do seu sistema e permite que você construa a versão mais recente.

Você tem duas opções aqui -- você pode instalar a partir da versão estável mais recente incluída com o &kde;, ou pode obter a versão mais recente (mas possivelmente instável) diretamente do repositório CVS do projeto &kde;. A maioria dos usuários que não são desenvolvedores do &arts; devem usar a versão estável. Você pode baixá-la a partir do ftp://ftp.kde.org ou um dos principais sites espelho. Se você é um desenvolvedor ativo do &arts; você provavelmente desejará usar a versão do CVS. Se você deseja usar o aRts sem o KDE, você pode baixar um snapshot de desenvolvimento independente a partir de http://space.twc.de/~stefan/kde/arts-snapshot-doc.html.

Observe que se você estiver construindo a partir do CVS alguns componentes do &arts; (&ie; os componentes básicos do núcleo incluindo o servidor de som) serão encontrados no módulo kdelibs do CVS, enquanto componentes adicionais (⪚ artsbuilder) estarão incluídos nele. Isto pode mudar no futuro. Você pode também encontrar uma versão do módulo kmusic; esta é a versão antiga (pré-&kde; 2.0) que agora é obsoleta.

Os requisitos para construir o &arts; são essencialmente os mesmos para construção do &kde;. O script de configuração (configure) deve detectar a consiguração do seu sistema e indicar se algum dos componentes necessários está faltando. Certifique-se de que você possui um driver de som funcionando em seu sistema (seja o driver OSS/Livre no kernel, o driver OSS da 4Front Technologies, ou o driver ALSA com emulação OSS).

Mais informações sobre como baixar e instalar o &kde; (incluindo o &arts;) podem ser encontradas nas &FAQ; do &kde;.

&digitalaudio; &midiintro; &arts-glossary;