DOCUMENTATION/README.it

   1                             ARDOUR README.it
   2
   3         Paul Davis <paul@linuxaudiosystems.com> June 2003
   4  Italian Traslation by Vieri Verze <poe@softhome.net> August 2002
   5   Update by Filippo Pappalardo <filippo@email.it> December 2003
   6
   7 Benvenuti in Ardour.  Sebbene questo programma sia ancora in via di
   8 sviluppo, e` pronto a rendervi produttivi, permettervi di testarlo
   9 e (si spera!) risolvere i bug e aggiungere nuove caratteristiche.
  10
  11 **** SICUREZZA *******************************************************
  12
  13 Per eseguire Ardour con la latenza piu` bassa e` necessario usare il
  14 POSIX Real-Time Scheduling e disporre di tutta la memoria di cui ha
  15 bisogno sotto forma di RAM fisica.  Queste richieste possono essere
  16 soddisfatte soltanto se Ardour viene eseguito con i privilegi di root.
  17
  18 D'altra parte non tutto il male viene per nuocere.  Se non installate
  19 Ardour con setuid root (che comunque non funziona), gli altri avranno
  20 bisogno dei privilegi di root per eseguirlo.  Se li hanno Ardour e` il
  21 vostro ultimo problema.  Quindi rilassatevi. Implementeremo le
  22 capabilities non appena il kernel le supportera`, benche` questo non
  23 aiuti molto la sicurezza, dal momento che un cracker intelligente
  24 potra` comunque fare di tutto.
  25
  26 In alternativa, potete scegliere di esguire Ardour senza il RT
  27 scheduling e non avrete nessun problema.  Non sara` molto utile nelle
  28 situazioni in cui e` necessaria una bassa latenza. Praticamente nella
  29 maggior parte dei casi.  Ricordatevi che tutto questo e` irrilevante se
  30 possedete una scheda audio capace di fare "hardware monitoring".
  31 In questo caso una latenza piu` alta rendera` un po` lenti i controlli
  32 della UI di Ardour, mentre il monitoring durante la capture saranno
  33 eccellenti.
  34
  35 **** COMPATIBILITA` HARDWARE *****************************************
  36
  37 Ardour usa il server audio JACK per tutte le operazioni di I/O.  In
  38 questo modo fornisce un impareggiabile sistema di comunicazione con il
  39 substrato hardware audio e le altre applicazioni.  Non � certamente
  40 questo il luogo per discutere di JACK, ma se vi state chiedendo:
  41
  42 JACK usa le ALSA 0.9.0 API.  La particolarita` e` che le sfrutta in
  43 un modo completamente nuovo soprattutto per quanto riguarda l' uso
  44 dell' hardware.  Come risultato, benche` il totale supporto delle
  45 periferiche h/w da parte di ALSA sia un successo facilmente ottenibile,
  46 potrebbero esserci problemi concernenti la compatiblita` h/w.  Bisogna
  47 tenere presente che il mio scopo principale e` di creare con JACK un
  48 sistem audio professionale, e con Ardour un sistema professionale di
  49 HDR.  Se puo` essere utile a utenti con schede a 2/4 canali, ben venga,
  50 ma ricordate che questo non e` l' interesse primo.
  51
  52 Un altro aspetto importante e` che la vostra interfaccia audio deve
  53 supportare l' I/O in full duplex nello stesso formato sia in registrazione
  54 che suonando.  Significa, per esempio, che una Soundblaster AWE non
  55 potra` essere usata con JACK in modalita` full duplex, a meno che una
  56 delle due direzioni (registrazione o playback) e` a 8 bit e l' altra a 16.
  57 Sono poche le schede che hanno questo tipo di limitazione, e non sono
  58 generalmente adatte ad essere usate con JACK e Ardour per altri motivi.
  59
  60 Ad oggi, Ardour ha girato con:
  61
  62    RME Hammerfall (Digi9652)              (26 canali in, 26 canali out)
  63    RME Hammerfall Light (Digi9636)        (18 canali in, 18 canali out)
  64    Midiman Delta series (ice1712 chipset) (12 canali in, 10 canali out)
  65
  66    Diverse interfacce di fascia consumer, solitamente a 2 canali in,
  67    2/4 canali out, incluse:
  68
  69    Hoontech 4Dwave-NX (Trident chipset)
  70    Ensoniq 5880
  71    Soundblaster 32
  72    Soundblaster 64
  73    Creative SBLive64
  74
  75 Al momento sembra funzionare con tutte le schede supportate da ALSA,
  76 che e` l'obiettivo proposto.
  77
  78 **** SEGNALARE UN BUG ************************************************
  79
  80 I bug vanno segnalati ad http://ardour.org/mantis/ .  Dove �
  81 probabile che vengano presi in considerazione e trattati.  Prima di
  82 segnalare un bug � opportuno accertarsi che non sia gia` stato
  83 segnalato e/o eliminato in cvs.
  84
  85 **** COMPILAZIONE E INSTALLAZIONE ************************************
  86
  87 1) GNU AUTOCONF RATIONALIZATION
  88 -------------------------------
  89
  90 GNU autoconf e` un sistema intelligente, ma ha una grande lacuna.
  91 Di default, autoconf (adesso aclocal) controlla UNA sola directory
  92 alla ricerca dei file di cui ha bisogno.  Sarebbe OK se non venissero
  93 installati altri pacchetti che qualche volta mettono i loro file di
  94 autoconf in /usr/local/lib/share/aclocal e altre volte in
  95 /usr/lib/share/aclocal.
  96
  97 Succede che autoconf non riesce a trovare i file di cui ha bisogno per
  98 costruire Ardour, dal momento che molta gente ha una moltitudine di
  99 librerie installate dalla distribuzione (i file di autoconf finiscono
 100 in /usr/local/lib...) e dai pacchetti pre-costruiti (in questo caso i
 101 pacchetti finiscono solitamente in /usr/lib...).
 102
 103 Per la vostra tranquillita`, vi raccomando di eseguire i seguenti passi
 104 da root.  Controllate i contenuti di entrambe le direcroty prima di
 105 eseguire questi comandi in modo da non cancellare accidentalmente la
 106 corretta versione di un file autoconf:
 107
 108  * Se avete esntrambe le directory:
 109
 110     cd /usr/lib/share/aclocal
 111     cp *.m4 /usr/local/lib/share/aclocal
 112     cd ..
 113     rm -rf aclocal
 114     ln -s /usr/local/lib/share/aclocal .
 115
 116  * Se avete solo /usr/lib/share/aclocal
 117
 118     cd /usr/local/lib
 119     ln -s /usr/lib/share/aclocal .
 120
 121 Alcune distribuzioni hanno aclocal in altre directory.  YMMV.
 122
 123 2. COMPILARE
 124 ------------
 125
 126 Prima di compilare Ardour, accertatevi di avere installato:
 127
 128 * Strumenti:
 129
 130        gcc/g++ 2.95.3 o superiore (funziona anche gcc/g++ 3.x)
 131        autoconf 2.52 o superiore
 132        automake 1.5 o superiore
 133        libtool 1.4.2 o superiore
 134        gettext 0.11.5 o superiore
 135        pkgconfig 0.8.0 o superiore
 136                 http://www.freedesktop.org/software/pkgconfig/
 137
 138        sono necessari anche lex e yacc
 139                 andra` bene qualsiasi versione di bison >= 1.35
 140
 141 * Librerie:
 142
 143 Le versioni raccomandate, quando necessario, sono presenti sotto le
 144 versioni generiche.
 145
 146        ALSA 0.9.X (CVS o snapshot release) (http://www.alsa-project.org)
 147
 148        JACK (http://jackit.sourceforge.net)
 149
 150        libxml2 2.5.X (http://xmlsoft.org/)
 151
 152        libart_lgpl 2.3.X
 153
 154                 - available as part of gnome-libs, which you may already
 155                   have on your system.
 156
 157                 - also available via download from GNOME source FTP sites.
 158                 - see ftp://ftp.gnome.org/pub/GNOME/MIRRORS.htmland then
 159                   follow to sources/libart_lgpl
 160
 161        glib 1.2   (http://www.gtk.org)
 162         glib-1.2.8 (inclusa nella maggior parte delle distribuzioni)
 163
 164        GTK+ 1.2   (http://www.gtk.org)
 165         gtk+-1.2.8 (inclusa nella maggior parte delle distribuzioni)
 166
 167        libsndfile (http://www.zip.com.au/~erikd/libsndfile)
 168         libsndfile-0.0-28
 169
 170        libsamplerate (http://www.mega-nerd.com/SRC/)
 171         libsamplerate 0.0.13 o superiore
 172
 173        the LADSPA SDK (http://www.ladspa.org/)
 174         (Guardate sotto)
 175
 176        raptor (http://www.redland.opensource.ac.uk/raptor/)
 177
 178        lrdf  (richiede raptor) (http://plugin.org.uk/lrdf/)
 179         liblrdf 0.3.1 or higher
 180
 181 Ottenere  LADSPA
 182
 183 Nota: La Linux Audio Developers Simple Plugin API (LADSPA) consiste
 184 in realta` di un semplice file header, gi� incluso nei sorgenti di
 185 Ardour
 186
 187 Vorrete usare anche i suoi plugins, percui andate oltre e scaricate
 188 l' intero pacchetto (non e` grande), da www.ladspa.org.
 189
 190 Vi raccomando di scaricare un eccelente set di plugins per LADSPA,
 191 programmati da Steve Harris.  Il link e` http://plugin.org.uk/.
 192 Trasformeranno Ardour in una appicazione vermante utile.  Altri plugins
 193 di LADSPA sono in programmazione percui tenete d' occhio la Linux
 194 Audio Development mailing list.
 195
 196 2A) COMPILARE DA CVS
 197 ---------------------
 198
 199 Posizionatevi nel path in cui volete copiare i CVS di Ardour (la '%'
 200 e` il vostro shell prompt):
 201
 202 % cd /usr/local/src    # e` un esempio, potete scegliere un path qualsiasi
 203 % cvs -d:pserver:anoncvs@ardour.org:/cvsroot/ardour login
 204                        # (premete enter/return quando vi sara` chiesta
 205                           la password)
 206 % cvs -d:pserver:anoncvs@ardour.org:/cvsroot/ardour -z3 co ardour
 207
 208 2A.1) CHE TIPO DI COMPILAZIONE?
 209 --------------------------------
 210
 211 Il prossimo passo � quello di decidere se si vuole una installazione per
 212 sviluppatori o per semplici utenti.  Se siete sviluppatori, potrebbe essere
 213 una buona idea compilare libardour come libreria condivisa, cosi` da evitare
 214 di collegare l'eseguibile ogni volta che cambiate versione di libreria.
 215 Se siete semplici utenti, questo renderebbe solo la vita pi� difficile.
 216 In caso siate sviluppatori dunque eseguite:
 217
 218         touch ardour/libs/ardour/BUILD_FOR_DEVELOPMENT
 219
 220 Questo fara` si` che libardour sia compilata come libreria condivisa.  Dovreste
 221 conseguentemente passare il parametro --enable-development-build a configure.
 222
 223 2A.2) PREPARARE IL SISTEMA PER LA COMPILAZIONE
 224 ----------------------------------------------
 225
 226 Ora costruite i file autoconf/automake:
 227
 228 % cd ardour
 229 % sh autogen.sh
 230
 231 Andate al passo 3.
 232
 233 2B) COMPILARE DA UN TARBALL
 234 ---------------------------
 235
 236 Come al solito: prelevate e scompattate il tarball.  La directory creata,
 237 ardour-<versione>, e` chiamata piu` sotto "$AD".
 238
 239 3) COME COMPILARE
 240 -----------------
 241
 242     ./configure (con tutte i parametri che vorrete passare)
 243     make
 244     make install
 245
 246 Se siete uno sviluppatore che intende lavorare su libardour, potreste
 247 voler usare il parametro --enable-development-build, che colleghera`
 248 dinamicamente l'eseguibile a libardour, risparmiando molto tempo
 249 nell'evitare un collegamento statico da effettuare ogni volta che si
 250 operano cambiamenti su libardour.
 251
 252 Se volete compilare ardour in modo che possiate farne il `debugging`,
 253 dovreste usare anche il parametro --disable-optimize.  Senza questo
 254 Ardour viene compilato con ottimizzazioni estreme ed il risultato non
 255 pu� essere oggetto di `debugging` in modo efficace.
 256
 257 Come tutti gli script di configurazione, se non volete che
 258 l' installazione avvenga ne "solito posto", aggiungete un --prefix al
 259 comando ./configure.  Potreste anche considerare di aggiungere un
 260 parametro --sysconfdir, dal momento che `make install` tenter� di
 261 installare tutti i file di configurazione in un percorso che tiene
 262 conti di questo parametro.
 263
 264 La compilazione ci mette un po`.  Eseguendo make -j3 su un dual PII-450
 265 l'intero processo impiega circa 10-15 minuti.
 266
 267 4. ESEGUIRE ARDOUR
 268 ------------------
 269
 270 NOTA: Dovete prima di tutto eseguire il server JACK.
 271       ----------------------------------------------
 272
 273
 274 Se avete eseguito "make install", allora potete digitare "ardour" e
 275 qualcosa succedera`.  Col comando "ardour --help" otterrete una
 276 lista delle possibili opzioni.