# El manual de &arts;

Stefan Westerfeld

    stefan@space.twc.de

Jeff Tranter

    tranter@kde.org

Salvador Gimeno Zanón

    salgiza@jazzfree.com

Traductor
Miguel Revilla Rodríguez

    yo@miguelrevilla.com

Traductor
Alejandro Exojo Piqueras

    suy@badopi.org

Traductor
1999-2001 Stefan Westerfeld y Jeff Tranter
&FDLNotice;
2001-06-10
1.00.09

Este manual describe &arts;, el Sintetizador Analógico en Tiempo Real.

aRts artsbuilder sintetizador multimedia estructura música sonido KDE

## Introducción

### ¿Qué es &arts;?

El sintetizador analógico en tiempo real, o &arts; (Analog Real-Time Synthesizer), es un sistema modular para sintetizar audio y música en ordenadores digitales. Utilizando unos pequeños bloques de construcción, llamados módulos, el usuario puede construir fácilmente complejas herramientas de procesado de audio. Los módulos proporcionan normalmente funciones tales como la generación de formas de onda de sonido, filtros, efectos de audio, mezclas, y la reproducción de audio digital en distintos formatos de archivo.

El servidor de sonido &artsd; mezcla el audio de distintas fuentes en tiempo real, permitiendo que múltiples aplicaciones de sonido compartan el acceso al hardware de audio de forma transparente.

Al utilizar &MCOP;, el Protocolo de Comunicaciones Multimedia, las aplicaciones multimedia pueden ser transparentes a la red, se pueden autentificar por seguridad, y pueden ser multiplataforma al utilizar interfaces definidos de forma independiente del lenguaje mediante el uso de &IDL;. También se provee de soporte para aplicaciones antiguas que no utilicen &arts;. Al ser uno de los componentes centrales del entorno de escritorio &kde; 2, &arts; ofrece las bases de la arquitectura multimedia de &kde; y en el futuro soportará más tipos de medios, incluyendo vídeo. Como &kde;, &arts; funciona sobre distintos sistemas operativos, incluyendo &Linux; y variantes de BSD. También puede utilizarse sin &kde;.

### Uso de este manual

Este manual pretende ofrecer una documentación comprensible sobre &arts; para usuarios con distintos niveles de conocimiento. Dependiendo de si usted es alguien que utiliza aplicaciones multimedia basadas en &arts; de vez en cuando, o de si es un desarrollador de aplicaciones multimedia, es posible que desee seguir caminos distintos a lo largo del manual.

Le recomendamos que primero lea el capitulo Descargando y construyendo &arts; si necesita instalar y ejecutar &arts; por primera vez. Si ya tiene un sistema en funcionamiento, probablemente incluido con la distribución de su sistema operativo, puede optar por saltar esta sección.

Después debería leer las secciones del capítulo Herramientas &arts;, en especial &artsd;, &artscontrol;, &artsshell; y &artsdsp;. Esto le permitirá sacar el máximo provecho de &arts;.

Si está interesado en llegar más lejos con &arts;, lea el capítulo sobre &arts-builder; y realice el tutorial. Esto le mostrará las grandes capacidades de &arts; y de los módulos incluídos que pueden ser utilizados sin ser un programador.

Si desea saber más sobre las interioridades de &arts;, bien para desarrollar aplicaciones multimedia, bien para mejorar el propio &arts;, lea todo o parte del capítulo &arts; al detalle. Le permitirá entender todos los conceptos que son necesarios para el desarrollo de software con &arts;.

Si está específicamente interesado en las capacidades MIDI de &arts;, debería leer el capítulo sobre &MIDI;.

Si desea desarrollar aplicaciones multimedia que aprovechen &arts;, el capítulo API de &arts; trata en detalle las distintas APIs.

Si desea ampliar &arts; desarrollando nuevos módulos, lea el capítulo Módulos &arts;.

Si está modificando una aplicación existente para que funcione con &arts;, lea el capítulo Portando aplicaciones a &arts;.

Puede descubrir como colaborar con el proyecto &arts; en el capítulo Contribuyendo con &arts;, lea sobre el futuro desarrollo de &arts; en el capítulo Trabajo futuro, y encuentre enlaces a más información en la sección Referencias.

Hemos acabado de redondear el manual con algo de información adicional, incluyendo respuestas a preguntas frecuentes, una lista con los colaboradores, los detalles del derechos de autor y la licencia de &arts;, y algo de información de referencia sobre audio digital y &MIDI;. También se ha incluído un glosario.

Este manual aun es un trabajo sin finalizar. Le invitamos a que colabore escribiendo parte de él, aunque si desea hacerlo, contacte primero con Jeff Tranter tranter@kde.org o Stefan Westerfeld stefan@space.twc.de para evitar la duplicidad de esfuerzos.

### Historia

A finales de 1997 Stefan Westerfeld empezó a trabajar en un sistema modular, en tiempo real, para la síntesis de sonido. El código funcionaba inicialmente en un sistema PowerPC que ejecutaba &AIX;. Esta primera implementación era bastante simple, pero soportaba un sistema de flujo completo que era capaz, entre otras cosas, de reproducir archivos MP3 y transmisión de audio a través de módulos de efectos.

El siguiente paso fue implementar una interfaz de usuario (&GUI;) para que los módulos pudieran manipularse de forma gráfica. Stefan tenía algo de experiencia en el uso de &kde;, por lo que fue elegido como la herramienta para la &GUI;, (sabiendo que podría ser también necesario hacer una versión Gnome/Gtk+) y esto llevó a que posteriormente se utilizara &Linux; como principal plataforma de desarrollo. Inicialmente llamado ksynth, el proyecto se renombró como &arts; y el ritmo de desarrollo aumentó. En esos momentos el proyecto estaba bastante completo, con un protocolo basado en CORBA, docenas de módulos, un editor gráfico de módulos, APIs para C y C++, documentación, utilidades, una lista de distribución y una página web con un pequeño grupo de desarrolladores. El proyecto había recorrido un largo camino en poco más de un año de desarrollo.

Mientras el equipo de &kde; empezaba a planear &kde; 2.0, se hizo claro que &kde; necesitaba una infraestructura más potente de sonido y de medios en tiempo real. Se decidió adaptar &arts;, puesto que era un buen paso en esta dirección con una arquitectura probada. Un nuevo y mayor esfuerzo de desarrollo fue empleado en esta nueva versión de &arts;, siendo destacable el reemplazo del código CORBA con un nuevo subsistema, &MCOP;, optimizado para multimedia. La versión 0.4 de &arts; fue incluída en la versión 2.0 de &kde;.

El trabajo en &arts; continúa, mejorando el rendimiento y añadiendo nuevas funcionalidades. Es de destacar que aunque ahora &arts; es parte central de &kde;, puede utilizarse sin &kde;, y también es utilizado por aplicaciones que van más allá de la multimedia tradicional. El proyecto ha atraído algo de interés por parte del equipo de GNOME, abriendo la posibilidad de que tal vez algún día se convierta en la arquitectura multimedia estándar de los sistemas de escritorio &UNIX;.

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

## Derechos de autor y licencia de &arts;

Derechos de autor del software &arts;. 1998-2001. Stefan Westerfeld stefan@space.twc.de.

Derechos de autor de la documentación. 1999-2001. Stefan Westerfeld stefan@space.twc.de y Jeff Tranter tranter@kde.org.

Traducido por Salvador Gimeno Zanón salgiza@jazzfree.com, Miguel Revilla Rodríguez yo@miguelrevilla.com y Santiago Fernández Sancho santi@kde-es.org.

&underFDL;

Todas las bibliotecas incluídas con &arts; tienen una licencia bajo los términos de la GNU Lesser General Public license. La mayor parte del código de &arts; se encuentra en las bibliotecas, incluyendo todo el MCOP y ArtsFlow. Esto permite que las bibliotecas sean utilizadas con aplicaciones que no sean gratuitas/libres si así se desea.

Hay algunos programas (como por ejemplo artsd), que son entregados bajo los términos de la GNU General Public License. Como hay diferentes opiniones sobre si enlazar programas GPL con &Qt; es legal, también se ha añadido una nota explicita que indica que, además de la GPL: también se da permiso para enlazar el programa con la biblioteca &Qt;, tratando &Qt; como una biblioteca que normalmente acompaña al núcleo del sistema, sea o no sea ese el caso.

## Instalando &arts;

Para utilizar &arts; necesitará, obviamente, tenerlo instalado y en ejecución en su sistema. Hay dos formas de conseguir esto, que se describen en las siguientes secciones.

### Instalando una distribución binaria precompilada

La forma más rápida y fácil de conseguir que &arts; se instale y funcione es instalar paquetes binarios precompilados para su sistema. La mayoría de distribuciones de &Linux; modernas incluyen &kde;, y si es &kde; 2.0 o superior incluirá &arts;. Si &kde; no va incluído con los discos de instalación puede que esté disponible para descargar desde el vendedor de su sistema operativo. También puede que esté disponible desde terceros. Asegúrese de utilizar paquetes que coincidan con la versión de su sistema operativo.

Una instalación básica de &kde; incluirá el servidor de sonido, permitiendo que la mayoría de aplicaciones reproduzcan audio. Si desea tener el conjunto completo de aplicaciones y herramientas multimedia, lo más probable es que necesite instalar más paquetes opcionales.

La desventaja de utilizar binarios precompilados es que puede que no sean de la versión más moderna de &arts;. Esto es particularmente probable si se incluyen en &CD-ROM;, ya que el ritmo de desarrollo de &arts; y &kde; es tan rápido que normalmente los medios en &CD-ROM; no son capaces de seguir el ritmo. También puede encontrarse con que, si tiene una de las arquitecturas o sistemas operativos menos comunes, no existan binarios precompilados y necesite utilizar el segundo método.

### Construyendo desde los fuentes

Aunque necesite más tiempo, la forma más flexible de construir &arts; es compilarlo uno mismo desde los fuentes. Ésto le asegura que tiene una versión optimizada para la configuración de su sistema y le permite tener la versión más reciente.

Tiene dos opciones, puede instalar la versión estable más reciente incluída con &kde; o puede obtener la versión más reciente (pero posiblemente inestable) directamente desde el repositorio de CVS del proyecto &kde;. La mayoría de usuarios que no estén desarrollando para &arts; deberían utilizar la versión estable. Puede descargarla desde ftp://ftp.kde.org o desde uno de los múltiples espejos del servidor. Si está colaborando en el desarrollo de &arts; lo más probable es que desee utilizar la versión del CVS. Si desea utilizar aRts sin KDE, puede descargar una captura de la versión de desarrollo sin KDE desde http://space.twc.de/~stefan/kde/arts-snapshot-doc.html.

Recuerde que si está compilando desde el CVS, algunos de los componentes de &arts; (por ⪚ los componentes básicos del núcleo, incluyendo el servidor de sonido) se encuentran en el módulo tdelibs del CVS, mientras que otros componentes adicionales (como por ⪚ artsbuilder) se incluyen en tdemultimedia. Esto puede cambiar en el futuro. También puede encontrar una versión en el módulo kmusic. Es una versión antigua (anterior a &kde; 2.0) que se ha quedado obsoleta.

Los requerimientos para construir &arts; son esencialmente los mismos que para construir &kde;. Los archivos configure se encargarán de detectar la configuración de su sistema y le informarán de si falta algún componente. Asegúrese de tener un controlador de sonido que funcione en su sistema (ya sea el controlador del núcleo OSS/Free, el controlador OSS de 4Front Technologies, o el controlador ALSA con emulación OSS).

Puede encontrar más información sobre descargar e instalar &kde; (incluyendo &arts;) en las &FAQ; de &kde;.

&digitalaudio; &midiintro; &arts-glossary;