Csound - Cabel Cabel 1 Cabel caratteristiche generali Cabel è un interfaccia grafica che permette di comporre strumenti Csound utilizzando dei semplici moduli (opcodes) collegati tra loro per mezzo di connessioni, e di riprodurli in tempo reale. Cabel è un software freeware realizzato da Matthias Thar e Sebastian Gutsfeld nel 2005 e distribuito secondo i termini della licenza GNU General Public License. E in fase di continuo sviluppo. La pagina ufficiale: http://cabel.sourceforge.net/index.html 2 1
Cabel caratteristiche generali Cabel è scritto in Python (un potente linguaggio di programmazione freeware e multipiattaforma). I moduli (gli opcodes) sono scritti in XML (il linguaggio di marcatura universale ). E possibile salvare il risultato in formato.cw (proprietario di Cabel). E possibile esportare il risultato in formato csd (importabile in Lettuce). 3 Cabel installazione Per installare Cabel è necessario: Utilizzare una versione di Csound uguale o superiore alla 5.0 Installare Python (meglio dalla versione 2.4.x in poi) e, successivamente, le estensioni Python per Windows le estensioni wxpython (necessarie per la creazione dell interfaccia) Installare (finalmente) Cabel (al momento la versione aggiornata è la 0.85) 4 2
Cabel installazione Installazione di Python Per scaricare Python riferirsi al sito ufficiale www.python.org 5 Cabel installazione Installazione di Python Scaricare l ultima versione Esempio per Windows (32 bit): www.python.org/ftp/python/2.4.3/python-2.4.3.msi 6 3
Cabel installazione Installazione di Python Eseguire il file python-2.4.3.msi e procedere all installazione scegliendo opportunamente una directory di destinazione. Ad installazione avvenuta è necessario aggiornare le variabili d ambiente: PATH = aggiungere, dopo un ; il percorso alla cartella di Python Esempio: Creare una Nuova Variabile: Nome variabile: PYTHONPATH Valore variabile: D:\Programmi\Python24;D:\Programmi\Python24\DLLs;D:\Programmi\Python2 4\Lib;D:\Programmi\Python\Lib\lib-tk;D:\Programmi\Csound5\bin Chiaramente bisogna indicare gli esatti percorsi in funzione di dove si sono installati i programmi sul proprio pc. 7 Cabel installazione Installazione di Python Estensioni Python per Windows Ad installazione eseguita di Python scaricare e installare le estensioni Python per Windows (pywin32-208.1.win32-py2.5.exe) dall indirizzo: http://sourceforge.net/projects/pywin32 L installazione è semplice e viene, in automatico, effettuata all interno della cartella di Python. 8 4
Cabel installazione Installazione di Python Estensioni wxpython Scaricare le estensioni wxpython (necessarie per la creazione dell interfaccia) dall indirizzo: www.wxpython.org 9 Cabel installazione Installazione di Python Estensioni wxpython Scaricare e installare l ultima versione per Python 2.4: wxpython2.6-win32-unicode-2.6.3.2-py24.exe / L installazione è semplice e viene, in automatico, effettuata all interno della cartella di Python. 10 5
Cabel installazione Installazione di Cabel Scaricare e installare l ultima versione di Cabel (0.85) dall indirizzo http://cabel.sourceforge.net 11 Cabel installazione Installazione di Cabel Inserire nella variabile PYTHONPATH il percorso della cartella di Cabel Esempio: 12 6
Cabel esecuzione Per lanciare Cabel: dalla linea di comando Dos (Start > Esegui: cmd), portarsi nella cartella di Cabel e digitare python cabel.py Per comodità si può creare un file batch che, eseguito direttamente in Windows, lancia Cabel: Creare un file di testo (con Notepad) e scrivere: cd D:\Programmi\cabel-0.85 (scrivere l esatto percorso) python cabel.py Salvarlo (dove è più comodo) come cabel.bat 13 Cabel interfaccia L interfaccia di Cabel si presenta divisa in due parti: Lo spazio per l inserimento e la gestione dei moduli Un box con due pannelli (Python Shell e Messages) disattivabile con Options > Show Bottom Pane 14 7
Cabel setting Attraverso Options > Preferences si accede ai pannelli di setting. Nel pannello Csound sono presenti: i campi relativi all intestazione del file orchestra; una text-area per l inserimento della partitura (score); un campo per l inserimento del percorso dell eseguibile di Csound; un campo per l inserimento dei flag; un campo per l inserimento del tempo (in millisecondi) di feedback nelle riproduzioni in real-time Autoplay: selezionato abilita le modifiche real-time. 15 Cabel setting Nel pannello User Interface è possibile definire alcune preferenze (colori, zoom, ecc.) relative all interfaccia di Cabel 16 8
Cabel setting Nel pannello Preferences si inseriscono: Il percorso della cartella modules dove sono presenti i vari moduli di Cabel; Il percorso del file di log di Cabel; Il percorso dell Editor di testo da utilizzare. 17 Cabel Attraverso Modules si possono scegliere e inserire nello stage i moduli già disponibili di Csound. La stessa operazione è possibile farla cliccando con il tasto dx del mouse su un punto qualsiasi dello stage. 18 9
Cabel Attraverso l uso di un convertitore XML scritto in Python (modulor.py) Andrea Valle ha tradotto le pagine HTML del Manuale di Csound relative agli opcodes in singoli moduli Cabel. Al momento ne sono disponibili 561. L intero archivio xbasic è disponibile all indirizzo: www.semiotiche.it/andrea/sw/modulor/xbasic.zip Scompattando l archivio e inserendolo nella cartella modules di Cabel è possibile, così, avere a disposizione un sostanzioso archivio di moduli già pronti per l uso. 19 Cabel Un semplice oscillatore Dopo aver impostato Intestazione d orchestra e Score in Options > Preferences si può procedere a creare lo strumento. Da Modules si sceglie l opcode (oscil_ar) e il tipo di out (Out). Si collega (cliccando e trascinando) l uscita dell oscillatore con l ingresso di Out. Con un doppio clic sul modulo se ne possono modificare i parametri Cliccando il pulsante Play (in basso a destra) si manda in esecuzione lo strumento. In fase di riproduzione si possono modificare i parametri (autoplay deve essere selezionato) 20 10
Cabel Cliccando con il tasto destro su un modulo si può: Eliminarlo Mostrare il sorgente XML del modulo stesso Il nome del modulo è seguito da un numero progressivo. Posizionandosi con il mouse su un modulo è possibile leggere nella barra di stato (in basso) il suo nome, una sua breve descrizione e il numero di strumento (se i moduli non sono collegati acquisiscono automaticamente un numero di strumento progressivo) Sempre nella barra di stato è possibile variare la dimensione di visualizzazione dello stage. 21 11