El elemento central de Csound es un motor de audio para el lenguaje de Csound. Éste no tiene una interfaz gráfica y está diseñado para tomar archivos de texto de Csound (llamados archivos ".csd") y producir audio, ya sea en tiempo real, o escribiendo a un archivo. Todavía se puede utilizar de esta manera, pero actualmente la mayoría de los usuarios prefieren utilizar Csound a través de una interfaz. Una interfaz es una aplicación que le ayuda a escribir código y a correr Csound. Más allá de las funciones de un simple editor de texto, una interfaz lo ayudará resaltando con colores el código de palabras claves propias del lenguaje y mediante un rápido acceso a un sistema de ayuda integrado. Una interfaz también puede ampliar las posibilidades proporcionando herramientas para construir interfaces interactivas (Widgets GUI) como también herramientas de composición avanzadas.
En 2009, los desarrolladores de Csound eligieron a CsoundQt como la interfaz estándar incluida en la distribución de CSound. Esto quiere decir que Ud. contará con esta interfaz por defecto si ha instalado cualquiera de las versiones pre-compiladas de Csound. Por el contrario, si se instala una interfaz de un tercero por lo general se requiere de una instalación independiente de Csound para que ésta funcione. Si tiene algún problema con CsoundQt, o simplemente prefiere otro diseño de interfaz, le sugerimos otras alternativas como Cabbage, WinXound o Blue. La Sección 10 de este manual proporciona más información acerca de las interfaces.
Para obtener Csound primero deberá descargar el paquete adecuado para su sistema desde el sitio de SourceForge: http://sourceforge.net/projects/csound/files/csound6
Existen muchos archivos allí. Le proponemos algunas guías para ayudarlo a escoger la versión correcta (la sección de descargas de la página principal de Csound también puede servirle).
Los instaladores para Windows poseen la extensión .exe. Busque la última versión de Csound y elija el archivo cuyo nombre debería verse algo así: Setup_Csound6_6.07.0beta.exe.
Después de haber descargado el instalador simplemente haga doble clic sobre él para iniciar el proceso de instalación. Esto involucrará 8 sencillos pasos:
Después de leer y aceptar el contrato de licencia, haga clic en Siguiente.
Seleccione el destino de los archivos del programa Csound. El valor predeterminado es C:/ Archivos de programa (x86)/Csound6.
Elija los componentes que se van a instalar. Actualmente (ver 6.07) sólo hay 3 elementos: Core Csound es obligatorio. Las opciones de Python son opcionales pero se requerirán si piensa usar CsoundQt como frontend para Csound. También necesitará instalar Python 2.7. El objeto Csound~ de Pure Data le permitirá ejecutar Csound desde Pure Data. Para ello, será necesario instalar Pure Data.
Seleccionar la carpeta del Menú de inicio le permite definir un nombre de carpeta distinto al predeterminado para Csound 6 para la carpeta que contiene los distintos componentes de Csound. Alternativamente, puede optar por no crear una carpeta de menú de inicio.
A continuación hay una opción para agregar el directorio de la aplicación Csound a la variable PATH. Agregar esto le permitirá ejecutar Csound desde la línea de comandos desde cualquier ubicación de directorio.
A continuación, una ventana le recuerda lo que se instalará y los cambios que se harán en su sistema.
Al hacer clic en instalar la instalación comenzará.
Este instalador también instalará automáticamente CsoundQt, que se puede utilizar como una interfaz para su trabajo con Csound (Csound no se ejecuta haciendo doble clic en Csound.exe).
Puede crear accesos directos adicionales al archivo ejecutable de CsoundQt buscándolo en su ubicación predeterminada, C:/Archivos de programa (x86)/Csound6/bin y haciendo clic con el botón derecho sobre él y seleccionando Pin to Start o Pin to Taskbar según lo que desee. También puede crear un acceso directo en el escritorio haciendo clic con el botón derecho del ratón y arrastrando el ejecutable de CsoundQt hacia el escritorio y seleccionando Crear acceso directo aquí.
Otras interfaces para Csound, como Cabbage y WinXound necesitan ser descargadass e instaladas por separado.
Los instaladores de Mac OS X son los archivos que terminan en .dmg. Busque la última versión de Csound para su sistema en particular, por ejemplo un binario universal para 10.9 se llamará algo así como: csound6.06-OSX-universal.dmg. Cuando haga doble clic en el archivo descargado, tendrá una imagen de disco en su escritorio que tendrá adentro el instalador de Csound, CsoundQt y un archivo Léame. Haga doble clic en el instalador y siga las instrucciones. Csound y las utilidades básicas de Csound se instalarán. Para instalar el frontend CsoundQt, sólo tiene que moverlo a su carpeta de aplicaciones.
Csound está disponible en los repositorios de paquetes oficiales para muchas distribuciones como OpenSuse, Debian, Ubuntu, Fedora, Archlinux y Gentoo. Si no hay paquetes binarios para su plataforma, o necesita una versión más reciente, puede obtener el código fuente en la página de Github y compilar Csound manualmente. Encontrará las instrucciones de compilación más recientes en el archivo Build.md en el código fuente de Csound o en la Github Csound Wiki.
Si desea ejecutar Csound en su iPad, hay una aplicación para iOS llamada CsoundPad: http://itunes.apple.com/app/csoundpad/id861008380?mt=8#
Si usted es un desarrollador, Csound se puede ejecutar dentro de la aplicación iOS que esté programando incluyendo los archivos Csound-for-iOS en su proyecto Xcode. El archivo zip para estos archivos se incluye en el mismo directorio en el que las otras versiones están disponibles, por ejemplo, para la versión 6.05 de Csound, los archivos están aquí:
http://sourceforge.net/projects/csound/files/csound6/Csound6.05/
El archivo csound-iOS-6.05.0.zip contiene un archivo de un proyecto de ejemplo y un manual en formato PDF.
Algunos proyectos de ejemplo:
Los archivos de Android para Csound se pueden encontrar en la página de descarga de Csound en github: http://csound.github.io/download.html.
Dos archivos guardan interés aquí (en la carpeta Csound6). Uno de ellos es un reproductor CSD que ejecuta archivos Csound en un dispositivo Android (la aplicación del reproductor CSD se llama Csound6.apk). Esta aplicación también incluye ejemplos.
También puede instalar Csound6.apk desde la Google Play Store.
Si desea utilizar Csound6 en Android, eche un vistazo al capítulo 12F de este manual, que describe esta situación en detalle.
En Googles Play Store hay algunas aplicaciones que utilizan Csound. A continuación se presenta una pequeña muestra de estas aplicaciones:
Si por cualquier motivo no puede encontrar la interfaz CsoundQt en su sistema después de la instalación, o si desea instalar la versión más reciente de CsoundQt, o si prefiere otra interfaz: consulte la sección INTERFACES DE CSOUND de este manual para obtener más información. Si tiene algún problema con la instalación, considere unirse a la lista de correo de Csound (Csound Mailing List) para informar de sus problemas o escriba un correo a uno de los responsables del programa (consulte ACERCA DE ESTA VERSIÓN).
El Csound Reference Manual es un complemento indispensable para Csound. Está disponible en varios formatos en el mismo lugar en donde están los instaladores de Csound, y se instala automáticamente con los paquetes para OS X y Windows. También se puede consultar en línea en http://csound.github.io/docs/manual/index.html. Muchas interfaces le proporcionarán un acceso directo y fácil al mismo.
Usando CsoundQt
Inicie CsoundQt. Vaya al menú de CsoundQt y elija: Examples->Getting started...-> Basics-> HelloWorld
Verá un archivo de Csound muy básico (.csd) con muchos comentarios en verde.
Haga clic en el icono RUN en la barra de control de CsoundQt para iniciar el motor de Csound en tiempo real. Debería oír una onda senoidal de 440 Hz.
También puede ejecutar el motor de Csound en la terminal desde dentro de CsoundQt. Simplemente haga clic en Run in Term. Aparecerá una consola y Csound se ejecutará como un proceso independiente. El resultado debe ser el mismo: el pitido de 440 Hz.
Usando la Terminal / Consola
1. Guarde el código siguiente en cualquier editor de texto sin formato bajo el nombre HelloWorld.csd.
EXAMPLE 02A01_HelloWorld.csd
<CsoundSynthesizer>
<CsOptions>
-odac
</CsOptions>
<CsInstruments>
;Example by Alex Hofmann
instr 1
aSin poscil 0dbfs/4, 440
out aSin
endin
</CsInstruments>
<CsScore>
i 1 0 1
</CsScore>
</CsoundSynthesizer>
2. Abra la Terminal / Símbolo de Sistema / Consola
3. Escriba: csound /ruta/completa/HelloWorld.csd
en donde /ruta/completa/HelloWorld.csd es la ruta completa a su archivo. También podrá ejecutar este archivo simplemente escribiendo csound y arrastrando el archivo a la ventana del terminal y luego pulsando enter.
Debería escuchar un tono de 440 Hz.
Cabbage es una interfaz alternativa para trabajar con Csound. Es similar a CsoundQt, pero sus principales diferencias con este último son que la interfaz gráfica de usuario (GUI) se puede crear, ya sea dibujando (clic y arrastre) o escribiendo código. En CsoundQt el código GUI nos está oculto en el editor para que sólo creemos la GUI usando el ratón. Cabbage también puede exportar instrumentos y efectos como plugins VST y AU, e incluso incluye su propio host, Cabbage Studio, para conectar gráficamente múltiples instrumentos y efectos de una manera similar a Pure Data. Cabbage es un frontend menos completo que CsoundQt pero algunos usuarios prefieren esta simplicidad. [INCORRECTO]
Para empezar con Cabbage, primero debe descargarlo. Cabbage vendrá con su propia versión de Csound incluida y no requerirá de una instalación separada de Csound. Todas las versiones instaladas de Csound serán ignoradas por Cabbage. [INCORRECTO]
Una vez instalado, ejecute Cabbage y luego seleccione Options->New Cabbage ...->Instrument para crear un nuevo patch (llamado patche de Cabbage). Cabbage le dara la bienvenida con un instrumento funcional simple que incluye un teclado virtual, pero usted puede también utilizar el instrumento de abajo que ofrece un teclado virtual y un control de volumen. Para abrir el editor de código integrado de Cabbage, vaya a Options->View Source Editor. Luego puede pegar el código que se muestra a continuación o simplemente hacer modificaciones en el código del instrumento predeterminado. Si desea realizar cambios en los dispositivos de hardware externos que utiliza Cabbage, como el hardware de audio y MIDI, vaya a Options->Audio Settings.... Las opciones disponibles variarán en función de su sistema específico, por lo que las pasaremos por alto en este capítulo.
Al crear un instrumento en tiempo real, no hay necesidad de incluir ningún evento al Score de Csound (o cualquier etiqueta <score>). Con versiones anteriores de Csound era necesario incluir un evento 'falso' en el score para mantener el funcionamiento en tiempo real, pero con versiones más recientes de Csound ya no es necesario.
El elemento clave que diferencia a Cabbage de Csound estándar es la inclusión de código específico de Cabbage, utilizado principalmente para crear la interfaz gráfica de usuario, que se mantiene dentro de las etiquetas <Cabbage> y </Cabbage>. La comunicación de la GUI de Cabbage a Csound es transparente, como en el caso del widget de teclado, o vía canales con nombre y el opcode chnget en la orquesta de Csound cuando se usa la mayoría de los otros widgets de Cabbage como el rslider (un slider rotativo). Para obtener información adicional sobre Cabbage, consulte el capítulo sobre Cabbage.
EXAMPLE 02A02_HelloCabbage.csd
<Cabbage>
form size(420,100)
keyboard bounds(10,10,300,80)
rslider bounds(325,15,80,80), channel("level"), text("Level"), range(0,1,0.3)
</Cabbage>
<CsoundSynthesizer>
<CsOptions>
-dm0 -n -+rtmidi=null -M0
</CsOptions>
<CsInstruments>
sr = 44100
ksmps = 32
nchnls = 2
0dbfs = 1
instr 1
icps cpsmidi
klev chnget "level"
a1 poscil klev*0.2,icps
outs a1,a1
endin
</CsInstruments>
</CsoundSynthesizer>
There has been error in communication with Booktype server. Not sure right now where is the problem.
You should refresh this page.