# O Manual do &arts;

## Introdução

### O que é o &arts;?

O Sintetizador de Tempo-Real Analógico, ou &arts;, é um sistema modular para sintetizar o som e a música num computador digital. Usando blocos de construção pequenos chamados módulos, o utilizador poderá criar facilmente ferramentas de processamento de áudio complexas. Os módulos oferecem tipicamente funções como geradores de formas de onda, filtros, efeitos de áudio, mistura de som, reprodução de áudio digital em vários formatos de ficheiros diferentes.

O servidor de som &artsd; mistura o áudio de várias fontes em tempo-real, permitindo a várias aplicações de som partilharem transparentemente o acesso ao 'hardware' de som.

Usando o &MCOP; (Multimedia Communication Protocol), as aplicações multimédia poderão ser transparentes na rede, autenticadas do ponto de vista da segurança, e multiplataforma, recorrendo à utilização de interfaces definidas de forma independente da linguagem com o &IDL;. O suporte também é fornecido para as aplicações legadas que não saibam do &arts;. Como componente de base para o ambiente de trabalho do &kde; 2, o &arts; fornece a base da arquitectura multimédia do &kde; e irá no futuro suportar outros tipos multimédia, incluindo o vídeo. Tal como o &kde;, o &arts; corre numa variedade de sistemas operativos, incluindo o &Linux; e as variantes do BSD. Pode ser usado independentemente do &kde;.

### Usar Este Manual

Este manual pretende oferecer uma documentação compreensiva sobre o &arts; aos utilizadores com diferentes níveis de aptidões. Dependendo se você é um utilizador normal de aplicações multimédia que tiram partido do &arts; ou um programador de aplicações multimédia, você poderá querer seguir caminhos diferentes ao longo do manual.

Sugere-se que você leia primeiro o capítulo de Transferir e Compilar o &arts; se precisar de ter o &arts; instalado inicialmente e em funcionamento. Se você já tiver um sistema funcional, provavelmente incluído na distribuição do seu sistema operativo, você poderá optar por ignorar esta secção.

Você deverá então ler as secções no capítulo das Ferramentas do &arts;, especialmente o do &artsd;, do 'artscontrol';, do '&artsshell;', e do '&artsdsp;'. Isto ajudá-lo-á a tirar o partido mais efectivo do &arts;.

Se você estiver interessado em ir mais além com o &arts;, leia o capítulo sobre o &arts-builder; e siga ao longo do tutorial. Isto deverá dar-lhe uma apreciação global das capacidades poderosas do &arts; e dos módulos fornecidos que poderão ser usados sem haver necessidade de ser um programador.

Se você quiser saber mais sobre os detalhes do &arts;, quer para desenvolver aplicações multimédia quer para extender o próprio &arts;, leia uma parte ou todo o capítulo O &arts; em Detalhe. Isto deverá permitir-lhe compreender todos os conceitos considerados como pré-requisitos da programação de 'software' com o &arts;.

Se você estiver interessado especificamente nas capacidades de MIDI do &arts;, deverá ler o capítulo sobre o &MIDI;.

Se quiser desenvolver aplicações multimédia que suportem o &arts;, o capítulo das Interfaces de Programação de Aplicações do &arts; cobrem as diferentes APIs em detalhe.

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

Se estiver a modificar uma aplicação existente para correr sob o &arts;, leia o capítulo sobre Transformar Aplicações para o &arts;.

Você poderá saber como ajudar a contribuir para o projecto do &arts; no capítulo Contribuir para o &arts;, ler sobre os próximos desenvolvimentos no capítulo sobre o Trabalho Futuro, e obter referências para mais informações na secção de Referências.

Foi dada uma volta ao manual com algum material adicional, incluindo as respostas às perguntas mais frequentes, uma lista das contribuições, os detalhes sobre o &arts; o 'copyright' e as licenças, bem como algum material de fundo sobre o áudio digital e o &MIDI;. Está também incluído um glossário de termos.

Este manual ainda tem muito trabalho por fazer. Você é bem-vindo para contribuir na escrita de partes dele, mas se o quiser fazer, contacte o Jeff Tranter tranter@kde.org ou o Stefan Westerfeld stefan@space.twc.de para evitar a duplicação de esforço.

### Histórico

No fim de 1997, o Stefan Westerfeld começou a trabalhar num sistema modular em tempo-real para a síntese de som. O código corria inicialmente num sistema PowerPC que funcionava em &AIX;. Essa implementação era muito simples, mas suportava um sistema de fluxo completo que era capaz de fazer coisas como tocar ficheiros MP3 e encaminhar os canais de áudio por módulos de efeitos.

O próximo passo foi implementar uma &GUI; de modo a que os módulos pudessem ser manipulados graficamente. O Stefan tem tido algumas experiências boas com o &kde;, de modo que foi escolhido como a plataforma &GUI;, (sabendo que poderá ser necessário fazer também uma versão para GNOME/Gtk+) e isto levou posteriormente a usar o &Linux; como plataforma principal de desenvolvimento. Chamado anteriormente de ksynth, o projecto mudou de nome para &arts; e a rapidez de desenvolvimento acelerou. O projecto nesta fase estava muito completo, com um protocolo baseado em CORBA, com dezenas de módulos, uma ferramenta gráfica de edição de módulos, APIs em C e C++, documentação, utilitários, páginas Web e listas de correio com um pequeno grupo de programadores. O projecto avançou bastante com pouco mais do que um ano de desenvolvimento.

Assim que a equipa do &kde; começou a planear o &kde; 2.0, tornou-se óbvio que o &kde; necessitava de uma infra-estrutura mais poderosa para o som e para os conteúdos multimédia. Optou-se por adaptar o &arts;, dado que era um bom passo nesta direcção com uma arquitectura estável. Muito do esforço de desenvolvimento foi aplicado nesta nova versão do &arts;, sendo o mais notável a substituição do código em CORBA por um sub-sistema completamente novo, o &MCOP;, optimizado para o multimédia. A versão 0.4 do &arts; foi incluída na versão 2.0 do &kde;.

O trabalho continua no &arts;, melhorando a performance e adicionando novas funcionalidades. Deverá ser visto que até mesmo o &arts; é agora um componente de base do &kde;, embora possa ser usado sem o &kde;, e também é usado por aplicações que vão mais além do multimédia tradicional. O projecto atraiu algum interessa da equipa do GNOME, abrindo a possibilidade a que alguma vez se torne a arquitectura-padrão do multimédia nos ambientes de trabalho do &UNIX;.

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

## 'Copyright' e Licenças do &arts;

'Software' do &arts; copyright 1998-2001 Stefan Westerfeld stefan@space.twc.de

Documentação copyright 1999-2001 Stefan Westerfeld stefan@space.twc.de e Jeff Tranter tranter@kde.org.

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL;

Todas as bibliotecas que existem no &arts; estão licenciadas segundo os termos da licença GNU Lesser General Public. A grande maioria do código do &arts; está nas bibliotecas, incluindo todo o MCOP e o ArtsFlow. Isto permite às bibliotecas serem usadas para aplicações não-livres e não-gratuitas, se o desejar.

Existem alguns programas (como o artsd), que são lançados segundo os termos da General Public License da GNU. Dado que têm havido algumas opiniões diferentes sobre se é legal compilar programas GPL com o &Qt;, foi adicionada também uma nota explícita que o permite, para além da GPL: a permissão está também concedida para poder compilar este programa com a biblioteca do &Qt;, tratando o &Qt; como uma biblioteca que acompanha normalmente o 'kernel' do sistema operativo, embora seja ou não esse o caso.

## Instalar o &arts;

Para poder usar o &arts; você precisa obviamente de o ter instalado e a funcionar no seu sistema. Existem duas aproximações para o fazer, as quais estão descritas nas próximas secções.

### Instalar uma Versão Binária Pré-Compilada

A forma mais rápida e simples de ter o &arts; a funcionar é instalando os pacotes binários pré-compilados para o seu sistema. A maioria das distribuições recentes do &Linux; incluem o &kde;, e se for o &kde; 2.0 ou posterior, irá incluir o &arts;. Se o &kde; não estiver incluído na sua instalação, poderá estar disponível para transferência a partir do fabricante do seu sistema operativo. Em alternativa, poderá está disponível a partir de terceiros. Certifique-se que você usa os pacotes que são compatíveis com a versão do seu sistema operativo.

Uma instalação básica do &kde; irá incluir o servidor de som, o que permitirá à maioria das aplicações tocarem som. Se quiser o conjunto completo de ferramentas e aplicações multimédia, você irá provavelmente necessitar de instalar os pacotes opcionais adicionais.

A desvantagem da utilização dos binários pré-compilados é que poderão não ser a versão mais recente do &arts;. Isto provavelmente será o caso se eles forem fornecidos num &CD-ROM;, dado que a rapidez do desenvolvimento do &arts; e do &kde; é tal que a disponibilização em &CD-ROM; não costuma acompanhar esse ritmo. Você poderá concluir também que, se tiver uma arquitectura ou uma distribuição menos comum, os pacotes binários pré-compilados poderão não estar disponíveis e, aí, você terá de usar o segundo método.

### Compilar o Código

Embora ocupe algum tempo, a forma mais flexível de criar o &arts; é compilar você próprio o código-fonte. Isto garante-lhe que tem uma versão compilada de forma óptima para a sua configuração do sistema e permite-lhe ter a versão mais recente.

Você tem aqui duas opções -- tanto poderá instalar a versão estável mais recente que vem incluída com o &kde; ou poderá obter directamente a versão mais recente (mas possivelmente instável) a partir do repositório de CVS do &kde;. A maioria dos utilizadores que não estejam a programar para o &arts; deverão usar a versão estável. Você poderá obtê-la em ftp://ftp.kde.org ou numa das suas réplicas. Se você estiver a programar activamente para o &arts; você irá querer usar provavelmente a versão no CVS. Se quiser usar o aRts sem o KDE, você poderá obter uma versão autónoma de desenvolvimento em http://space.twc.de/~stefan/kde/arts-snapshot-doc.html.

Tenha em atenção que, se tiver a compilar a partir do CVS, algumas das componentes do &arts; (&ie; as componentes de base que incluem o servidor de som) estão no módulo do CVS 'kdelibs', enquanto que os componentes adicionais (⪚ o artsbuilder) estão incluídos no 'kdemultimedia'. Isto poderá mudar no futuro. Você poderá também encontrar uma versão no módulo 'kmusic'; esta é a versão antiga (antes do &kde; 2.0) e que está agora obsoleta.

Os requisitos para compilar o &arts; são basicamente os mesmos que para compilar o &kde;. Os programas do 'configure' deverão detectar a configuração do seu sistema e indicar se estão a faltar alguns componentes obrigatórios. Certifique-se que tem um controlador de som a funcionar no seu sistema (seja ele o OSS/Free que vem com o 'kernel', o controlador OSS da 4Front Technologies, ou o ALSA com a emulação do OSS).

Poderá obter mais informações sobre como obter e instalar o &kde; (incluindo o &arts;) na &FAQ; do &kde;.

&digitalaudio; &midiintro; &arts-glossary;