<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&arts;">
 <!ENTITY tools SYSTEM "tools.docbook">
 <!ENTITY artsbuilder-doc SYSTEM "artsbuilder.docbook"
> 
 <!ENTITY detail SYSTEM "detail.docbook">
 <!ENTITY arts-midi SYSTEM "midi.docbook">
 <!ENTITY gui SYSTEM "gui.docbook">
 <!ENTITY mcop-ref SYSTEM "mcop.docbook">
 <!ENTITY arts-mcop SYSTEM "mcop.docbook">
 <!ENTITY apis SYSTEM "apis.docbook">
 <!ENTITY modules SYSTEM "modules.docbook">
 <!ENTITY porting SYSTEM "porting.docbook">
 <!ENTITY helping SYSTEM "helping.docbook">
 <!ENTITY future SYSTEM "future.docbook">
 <!ENTITY references SYSTEM "references.docbook">
 <!ENTITY arts-faq SYSTEM "faq.docbook">
 <!ENTITY arts-glossary SYSTEM "glossary.docbook">
 <!ENTITY digitalaudio SYSTEM "digitalaudio.docbook">
 <!ENTITY midiintro SYSTEM "midiintro.docbook">
 <!ENTITY MCOP "<acronym
>MCOP</acronym
>">
 <!ENTITY DCOP "<acronym
>DCOP</acronym
>">
 <!ENTITY MIDI "<acronym
>MIDI</acronym
>">
 <!ENTITY mcopidl "<application
>mcopidl</application
>">
 <!ENTITY IDL "<acronym
>IDL</acronym
>">
 <!ENTITY % Brazilian-Portuguese "INCLUDE"
> <!-- change language only here -->
 <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do &arts;</title>
<authorgroup>

<author
><firstname
>Stefan</firstname
> <surname
>Westerfeld</surname
> <affiliation
> <address
><email
>stefan@space.twc.de</email
></address>
</affiliation>
</author>

<author
><firstname
>Jeff</firstname
> <surname
>Tranter</surname
> <affiliation
> <address
><email
>tranter@kde.org</email
></address>
</affiliation>
</author>

<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus_gama@uol.com.br</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>1999-2001</year>
<holder
>Stefan Westerfeld &amp; Jeff Tranter</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2001-06-10</date>
<releaseinfo
>1.00.09</releaseinfo>

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

</abstract>

<keywordset>
<keyword
>aRts</keyword>
<keyword
>construtor arts</keyword>
<keyword
>sintetizador</keyword>
<keyword
>multimídia</keyword>
<keyword
>estrutura</keyword>
<keyword
>música</keyword>
<keyword
>som</keyword>
<keyword
>KDE</keyword>
</keywordset>
</bookinfo>

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

<sect1 id="what-is-arts">
<title
>O que é o &arts;?</title>

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

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

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

</sect1>

<sect1 id="using-this-manual">
<title
>Usando Este Manual</title>

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

<para
>É sugerido que você primeiro leia o capítulo <link linkend="installation"
>Baixando e Construindo o &arts;</link
> 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.</para>

<para
>Você deve então ler as seções do capítulo <link linkend="arts-tools"
>Ferramentas do &arts;</link
>, especialmente o &artsd;, &artscontrol;, &artsshell; e &artsdsp;. Isto lhe auxiliará a fazer um uso mais efetivo do &arts;.</para>

<para
>Se você estiver interessado em ir mais adiante com o &arts;, leia o capítulo do <link linkend="artsbuilder"
>&arts-builder;</link
> 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.</para>

<para
>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 <link linkend="arts-in-detail"
>&arts; em Detalhes</link
>. Isto deve dar-lhe um entendimento de todos os conceitos que são pré-requisitos para o desenvolvimento de programas baseados no &arts;.</para>

<para
>Se você está interessado especialmente nas capacidades <acronym
>MIDI</acronym
> do &arts;, você deve ler o capítulo <link linkend="midi"
>&MIDI;</link
>.</para>

<!-- TODO
<para
>To learn more about the &arts; graphical elements, either as an advanced
user of artsbuilder or to create new elements, read the section on <link
linkend="gui-elements"
><acronym
>GUI</acronym
> Elements</link
>.</para>
-->

<para
>Se você deseja desenvolver aplicativos multimídia compatíveis com o &arts;, o capítulo <link linkend="arts-apis"
>Interfaces de Programação de Aplicativos do &arts;</link
> cobre as diferentes <acronym
>API</acronym
>s em detalhes.</para>

<para
>Se você deseja extender o &arts; criando novos módulos, leia o capítulo <link linkend="arts-modules"
>Módulos do &arts;</link
>.</para>

<para
>Se você está modificando um aplicativo existente para ser executado sob o &arts; leia o capítulo <link linkend="porting"
>Portando Aplicativos para o &arts;</link
>.</para>

<para
>Você pode descobrir como contribuir para o projeto &arts; no capítulo <link linkend="contributing"
>Contribuindo com o &arts;</link
>, leia sobre o desenvolvimento futuro do &arts; no capítulo <link linkend="future-work"
>Trabalhos Futuros</link
>, e encontre ligações para mais informações na seção <link linkend="references"
>Referências</link
>.</para>

<para
>Nós também enriquecemos o manual com algum material adicional, incluindo <link linkend="faq"
>respostas para perguntas frequentes</link
>, um <link linkend="contributors"
>lista de contribuidores</link
>, os detalhes dos <link linkend="copyright-and-licenses"
>direitos autorais e licenciamento</link
> do &arts;, e algum material de suporte sobre <link linkend="intro-digital-audio"
>áudio digital</link
> e <link linkend="midi-introduction"
>&MIDI;</link
>. Um <link linkend="glossary"
>glossário</link
> de termos foi também incluído.</para>

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

</sect1>

<sect1 id="history">
<title
>Histórico</title>

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


<para
>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 <application
>ksynth</application
>, 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 <acronym
>CORBA</acronym
>, dúzias de módulos, uma ferramenta de edição de módulos gráfica, <acronym
>API</acronym
>s 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.</para>

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

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

</sect1>

</chapter>

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

<chapter id="copyright-and-licenses">

<title
>Direitos Autorais e Licenciamento do &arts;</title>

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

<para
><anchor id="contributors"/> Os direitos autorais 1999-2001 da documentação pertencem à Stefan Westerfeld <email
>stefan@space.twc.de</email
> e Jeff Tranter <email
>tranter@kde.org</email
>. </para>
<para
>Tradução de Marcus Gama<email
>marcus_gama@uol.com.br</email
></para
> 
&underFDL; <para
>Todas as bibliotecas que estão no &arts; são licenciadas sob os termos da licença Pública Geral Lesser <acronym
>GNU</acronym
>. A grande maioria do código do &arts; está nas bibliotecas, incluindo todo o <acronym
>MCOP</acronym
> e ArtsFlow. Isto permite que as bibliotecas sejam usados por aplicativos não-gratuitos/não-abertos se desejado. </para>

<para
>Existem alguns poucos programas (como o <application
>artsd</application
>), que foram lançados sob os termos da Licença Pública Geral <acronym
>GNU</acronym
>. Assim como existem diferentes opiniões sobre se reunir ou não programas <acronym
>GPL</acronym
> com o &Qt; é legal, eu também adicionei uma notificação explícita que permite isto, em adição ao <acronym
>GPL</acronym
>: é 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.</para>

</chapter>

<appendix id="installation">
<title
>Instalando o &arts;</title>

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

<sect1 id="binary-install">
<title
>Instalando uma Versão Binária Pré-compilada</title>

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

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

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

</sect1>

<sect1 id="source-install">
<title
>Construindo a Partir do Código</title>

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

<para
>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 <acronym
>CVS</acronym
> 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 <ulink url="ftp://ftp.kde.org"
>ftp://ftp.kde.org</ulink
> ou um dos principais sites espelho. Se você é um desenvolvedor ativo do &arts; você provavelmente desejará usar a versão do <acronym
>CVS</acronym
>. Se você deseja usar o aRts sem o KDE, você pode baixar um snapshot de desenvolvimento independente a partir de <ulink url="http://space.twc.de/~stefan/kde/arts-snapshot-doc.html"
>http://space.twc.de/~stefan/kde/arts-snapshot-doc.html</ulink
>. </para>

<para
>Observe que se você estiver construindo a partir do <acronym
>CVS</acronym
> 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 <acronym
>CVS</acronym
>, enquanto componentes adicionais (&eg; <application
>artsbuilder</application
>) 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. </para>

<para
>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 <acronym
>OSS</acronym
>/Livre no kernel, o driver <acronym
>OSS</acronym
> da 4Front Technologies, ou o driver <acronym
>ALSA</acronym
> com emulação <acronym
>OSS</acronym
>). </para>

<para
>Mais informações sobre como baixar e instalar o &kde; (incluindo o &arts;) podem ser encontradas nas <ulink url="http://www.kde.org/documentation/faq/index.html"
>&FAQ; do &kde;</ulink
>.</para>

</sect1>

</appendix>

&digitalaudio;
&midiintro;
&arts-glossary;

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
