<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kmidi "<application>kmidi</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="it">
<bookinfo>
<title>Guida a KMidi</title>
<authorgroup>
<author>
<firstname>Bernd Johannes</firstname>
<surname>Wuebben</surname>
<affiliation>
<address><email><ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></email></address>
</affiliation>
</author>
<author>
<firstname>Greg</firstname>
<surname>Lee</surname>
<affiliation>
<address><email><ulink url="mailto:lee@hawaii.edu">lee@hawaii.edu</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<releaseinfo>Versione 1.1</releaseinfo>
<date>17 Giugno 1998</date>
<abstract>
<para>Questa guida descrive KMidi Versione 1.1</para>
</abstract>
<keywordset>
<keyword>MIDI</keyword>
<keyword>KDE</keyword>
<keyword>KMIDI</keyword>
<keyword>MID</keyword>
</keywordset>
</bookinfo>

<chapter id="introduzione">
<title>Introduzione</title>

<para>KMidi e' un lettore di file midi ed un convertitore da midi a wav.</para>

<para>Se hai ascoltato file midi su Linux/Unix allora provalo!
Senza un eccessivo hardware come una Gravis Ultrasound oppure un Sound
Blaster AWE64, ascolterai un suono fantastico, paragonabile a quello
che avresti avuto con le schede menzionate qui sopra. Gratis!</para>

<para>In breve:</para>

<para><itemizedlist>
<listitem>
<para> KMidi usera' la CPU, di solito per il 10-30&percnt; a 32000 Hz sul mio
Pentium 120. Se hai una macchina lenta, puoi utilizzare le opzioni da linea
di comando per ridurre la frequenza di campionamento.
Dovresti essere in grado di raggiungere un suono decente su un 486 senza sforzare la CPU.
</para>
</listitem>
<listitem>
<para>Occorrono pero' i patches sonori. Il set completo general midi e'
reperibile in qualunque archivio Ultrasound. Dovrebbere occupare circa 10MB.
</para>
</listitem>
</itemizedlist>
</para>

<para>Credimi, per il risultato che otterrai, e' un piccolo prezzo da pagare!</para>

<para>KMidi supporta per ora (Versione 1.1) le seguenti piattaforme:</para>

<para><itemizedlist>
<listitem>
<para>Linux</para>
</listitem>
<listitem>
<para>FreeBSD</para>
</listitem>
<listitem>
<para>DEC OSF/1</para>
</listitem>
<listitem>
<para>HP UX</para>
</listitem>
<listitem>
<para>SUN</para>
</listitem>
<listitem>
<para>SUN SOLARIS</para>
</listitem>
</itemizedlist>
</para>

<para>Le versioni non-KDe di TiMidity, dovrebbero funzionare su tutte queste
piattaforme, ma questa versione e' stata testata soltanto su Linux.</para>

<para>Il porting su altre piattaforme dovrebbe essere semplice. Contattami
nel caso in cui tu abbia fatto il porting di kmidi per un'altra piattaforma.</para>

<para>KMidi si basa sul motore di TiMidity 0.2i di Tuukka Toivonen 
Copyright (C) 1995 <ulink url="mailto:toivonen@clinet.fi">Tukka Toivonen</ulink>.
In effetti nella distribuzione di KMidi e' inclusa una versione evoluta del
programma originale con cinque diverse interfacce.
(Guarda sotto per le informazioni sulla compilazione di TiMidity.)
KMidi e TiMidity, con le estensioni AWE SoundFont fornite da
<ulink url="mailto:iwai@dragon.mm.t.u-tokyo.ac.jp">Takashi Iwai</ulink>
e le estensioni AMD InterWave fornite da
<ulink url="mailto:lee@hawaii.edu">Greg Lee</ulink>,
ti permette di utilizzare i SoundFonts (.sbk/.sf2) e i patchset IW (.fff/.dat files) 
in aggiunta agli strumenti Gravis/Forte (.pat).</para>

<para>Per i dettagli non forniti in questo manuale, consulta la man page di timidity.</para>

<para>Non penso che questa sia una versione molto robusta, non e' molto difficile
infatti che KMidi si blocchi. Comunque e' abbastanza stabile per darti tante
ore di divetimento. Ricorda che i file midi occupano circa 50k o meno e si
scaricano facilmente dalla rete.
Divertiti con KMidi!</para>

<para><literal remap="tt">Bernd Johannes Wuebben</literal>,
<ulink url="mailto:wuebben@kde.org">wuebben@kde.org</ulink></para>
</chapter>

<chapter id="installazione">
<title>Installazione</title>

<sect1 id="come-ottenere-kmidi">
<title>Come ottenere KMidi</title>

<para>KMidi fa parte del progetto KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>.
Puoi trovarlo su <ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, il sito ftp principale
del progetto KDE. Il sito ufficiale e'
<ulink url="http://math.cornell.edu/~wuebben/kde.html">http://math.cornell.edu/~wuebben/kde.html</ulink></para>
</sect1>

<sect1 id="requisiti">
<title>Requisiti</title>

<para>Per compilare con buon esito KMidi, hai bisogno dell'ultima versione di <literal remap="tt"> libkdecore</literal>
e <literal remap="tt"> libkdeui</literal>. Tutte le librerie che ti servono come KMidi le trovi qui
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. </para>

<para>Per compilare l'interfaccia "dumb" da linea di comando di TiMidity dovrebbero
andar bene tutti i sistemi stile Unix e anche Win95.</para>

<para>Le altre interfacce hanno bisogno di requisiti speciali (vedi i vari README nella distribuzione).
L'interfaccia Motif funziona piuttosto bene anche con Lesstif.</para>
</sect1>

<sect1 id="compilazione-ed-installazione">
<title>Compilazione ed installazione</title>

<para>Se avevi gia' installato in precedenza KMidi, conviene fare un backup dei precedenti
file di configurazione (di solito stanno in $KDEDIR/share/apps/kmidi/config/) prima di
installare questa versione, perche' altrimenti verrebbero sovrascritti.
Allo stesso modo, prima di installare la versione non-KDE di TiMidity, conserva in files
che stanno in /usr/local/lib/timidity/.
Se non vuoi mantenere i precedenti settaggi e' meglio eliminare tutti i file contenuti in
queste directory, perche' i vecchi file potrebbero non essere rimpiazzati dalle nuove versioni.</para>

<para>Se hai l'intera distribuzione di kdemultimedia, vai nella directory di kdemultimedia e</para>

<para><screen>% ./configure
</screen>
</para>

<para>Quindi, per compilare tutti i programmi del pacchetto multimedia, rimani nella stessa
directory oppure se ti serve solo KMidi vai nella directory kmidi</para>

<para><screen>% make
% make install
</screen>
</para>

<para>Per le versioni non-KDE di TiMidity, edita il file Makefile.tim come richiesto, a seconda
dell'interfaccia che vuoi compilare, poi</para>

<para><screen>% make clean
% make -f Makefile.tim
% make -f Makefile.tim install.bin
% make -f Makefile.tim install.lib
% make -f Makefile.tim install.man
</screen>
</para>

<para>Se dovessi avere dei problemi, contattami.</para>
</sect1>

<sect1 id="patches">
<title>Dove posso trovare un set completo di strumenti? </title>

<para>Ci sono tre tipi di strumenti che KMidi/TiMidity puo' usare: i patches GUS,  IW <literal remap="tt">fonts</literal>,
e i  SoundFonts AWE32.  I set di campioni e i parametri per i singoli strumenti, un "patch",
stanno in un file separato per i patches GUS, mentre gli IW fonts hanno tutti i campioni dei
relativi set in un file <literal remap="tt">.dat</literal> file e tutti i parametri raccolti in un file <literal remap="tt">.fff</literal>.
Gli AWE SoundFonts raccolgono tutto in un solo file <literal remap="tt">.sf2</literal> (o <literal remap="tt">.sbk</literal>). 
Questi sono dei siti dove puoi scaricare dei set di strumenti GUS:</para>

<para><ulink url="mailto:goemon@anime.net">Dan Hollis</ulink> ha raccolto i patches GUS in un set.
La sua pagina e':
<ulink url="http://www.anime.net/~goemon/timidity/">http://www.anime.net/~goemon/timidity</ulink>
e aiutalo affinche' lui possa fare il piu' bel set disponibile.</para>

<para><emphasis remap="bf">Novita':</emphasis> Ho messo su ftp.kde.org questo patchset. Per ora sta in
<literal remap="tt">ftp://fiwi02.wiwi.uni-tuebingen.de/pub/kde/stable/Beta2/apps/multimedia/sound/</literal>
ma mi aspetto che verra' sistemato un po' in giro finche' non sara' trovata una posizione
ideale. Quindi se non lo trovi facilmente prova al sito ufficiale.</para>

<para>I set di strumenti sono reperibili anche in pacchetti deb o rpm nell'archivio del Sunsite:</para>

<para><itemizedlist>
<listitem>
<para> Debian: <ulink url="ftp://sunsite.unc.edu/pub/Linux/./distributions/debian/bo/source/sound/timidity-patches_0.1.tar.gz">timidity-patches_0.1.tar.gz</ulink>
</para>
</listitem>
<listitem>
<para> RPM:
<ulink url="ftp://sunsite.unc.edu/pub/Linux/distributions/redhat/contrib/oldrpms/contrib-2.0.x/RPMS/timidity-patches-1-1.i386.rpm">timidity-patches-1-1.i386.rpm</ulink></para>
</listitem>
<listitem>
<para> RPM:
<ulink url="ftp://sunsite.unc.edu/pub/Linux/distributions/redhat/contrib/oldrpms/contrib-2.0.x/SRPMS/timidity-patches-1-1.src.rpm-try2">timidity-patches-1-1.src.rpm-try2</ulink>
</para>
</listitem>
</itemizedlist>
</para>

<para>Non li ho ancora provati e personalmente utilizzo il patch set Midia con altri patches e drum
set da me aggiunti.</para>

<para>Il patch set  Midia puoi trovarlo qui:
<ulink url="ftp://archive.cs.umbc.edu/pub/midia/">ftp://archive.cs.umbc.edu/pub/midia/</ulink></para>

<para>Per strumenti e drum sets aggiuntivi: (prendi gsdrum e wow patches)
<ulink url="ftp://ftp.cdrom.com/pub/gus/sound/patches/files/">ftp://ftp.cdrom.com/pub/gus/sound/patches/files/</ulink></para>

<para>Vincent Pagel ha messo insieme una collezione di patches. Questo link
funziona soltanto durante le ore notturne (orario di Parigi).
<ulink url="ftp://sig.enst.fr/pub/midi/instruments/">ftp://sig.enst.fr/pub/midi/instruments/</ulink></para>

<para>Il file di configurazione per questi paches lo trovi qui:
<ulink url="ftp://sig.enst.fr/pub/midi/timidity_pagel.cfg">ftp://sig.enst.fr/pub/midi/timidity_pagel.cfg</ulink></para>

<para>Fai un giro anche sulla TimidityPage:
<ulink url="http://www.clinet.fi/~toivonen/timidity/">http://www.clinet.fi/~toivonen/timidity/</ulink></para>

<para>e la Home Page di Takashi:
<ulink url="http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/midi.html#TiMidity">http://bahamut.mm.t.u-tokyo.ac.jp/~iwai/midi.html#TiMidity</ulink></para>

<para>La Home Page di Takashi raccomanda il SoundFont AWE32 da 8 mega <literal remap="tt">chaos8m.sf2</literal> 
e quello da 12 mega <literal remap="tt">chaos12m.sf2</literal> 
disponibili su <ulink url="http://soback.kornet.nm.kr/~chaos/sbawe32/sbawe32.htm">http://soback.kornet.nm.kr/~chaos/sbawe32/sbawe32.htm</ulink>,
che sono molto carini.  (Sono degli archivi <literal remap="tt">.exe</literal> autoscompattanti.)</para>

<para>Ci sono un sacco di IW fonts free su:
<ulink url="ftp://sdc.wtm.tudelft.nl/pub/music/soundbank/">ftp://sdc.wtm.tudelft.nl/pub/music/soundbank/</ulink>.
Che io sappia l'unico font IW con campioni stereo (che KMidi/TiMidity puo' suonare)
costa 33$ su un cd; lo trovi su:
<ulink url="http://sdc.wtm.tudelft.nl/utopia/">http://sdc.wtm.tudelft.nl/utopia/</ulink>.</para>

<sect2 id="installazione-degli-strumenti">
<title>Installazione degli strumenti</title>

<para>Ognuno dei set mensionati (te ne serve soltanto uno) dovrebbe comprendere
un file .cfg di configurazione simile ai .cfg del KMidi e si trova in
<literal remap="tt">KDEDIR/share/apps/kmidi/config</literal>  </para>

<para>KMidi ha gia' dei file di configurazione fatti per un buon numero di patch set,
come il patch set Media.</para>

<para>Per completare l'installazione di un set di strumenti, edita il file timidity.cfg e includi
gli appropriati file di configurazione per i patch set che hai scaricato.</para>

<para>E' tutto. Ora puoi divertirti a suonare tutti i midi della distribuzione (ed anche altri).</para>
</sect2>

<sect2 id="varie">
<title>Varie</title>

<para>Occasionalmente vedrai che KMidi non puo' trovare un patch per un particolare
strumento (Per vedere queste informazioni devi aprire la Info Window).
In questo caso devi installare a mano il patch e modificare il file .cfg in modo
da far capire a KMidi che c'e' un nuovo patch.</para>

<para>Qualche volta un particolare strumento non suona come dovrebbe.
Procurati un patch differente per quello strumento dall'archivio Ultrasound
e rimpiazza quello precedente.</para>
</sect2>
</sect1>
</chapter>

<chapter id="utilizzo-">
<title>Utilizzo </title>

<sect1 id="utilizzo-generale">
<title>Utilizzo generale</title>

<para>Clicca sul pulsante "eject" per aprire il playlist manager. Scegli un file midi
facendo un doppio click su di esso. Per convenienza ho incluso nella distribuzione
qualche file midi. Per un utilizzo reale hai bisogno di un set completo general midi
di strumenti.</para>
</sect1>

<sect1 id="nomi-per-i-file-midi">
<title>Nomi per i file midi</title>

<para>KMidi rimpiazzera ogni '&lowbar;' nel nome del file midi con uno spazio e togliera il .mid o .MID se
presenti.</para>
</sect1>

<sect1 id="opzioni-da-linea-di-comando">
<title>Opzioni da linea di comando</title>

<para><screen>wuebben: ./kmidi -h
 KMidi version 0.3  MIDI to WAVE player/converter
 Copyright (C) 1995 Bernd Johannes Wuebben &lt;wuebben@math.cornell.edu&gt;

 KMidi is free software and comes with ABSOLUTELY NO WARRANTY.

Usage:
  kmidi [options] filename [...]

Options:
  -o file Output to another file (or device) (Use "-" for stdout)
  -O mode Select output mode and format (see below for list)
  -s f    Set sampling frequency to f (Hz or kHz)
  -a      Enable the antialiasing filter
  -f      Disable fast decay mode
  -p n    Allow n-voice polyphony
  -A n    Amplify volume by n percent (may cause clipping)
  -C n    Set ratio of sampling and control frequencies

  -L dir  Append dir to search path
  -c file Read extra configuration file       
  -I n    Use program n as the default
  -P file Use patch file for all programs
  -D n    Play drums on channel n
  -Q n    Ignore channel n
  -F      Enable fast panning
  -U      Unload instruments from memory between MIDI files

  -i mode Select user interface (see below for list)
  -B n    Set number of buffer fragments
  -h      Display this help message

Available output modes (-O option):

  -Od     Linux dsp device
  -Ow     RIFF WAVE file
  -Or     raw waveform data

Output format options (append to -O? option):

   `8'    8-bit sample width                 
   `1'    16-bit sample width
   `U'    uLaw encoding
   `l'    linear encoding
   `M'    monophonic
   `S'    stereo
   `s'    signed output
   `u'    unsigned output
   `x'    byte-swapped output

Available interfaces (-i option):

  -iq     kmidi qt  interface
  -id     dumb interface

Interface options (append to -i? option):

   `v'    more verbose (cumulative)
   `q'    quieter (cumulative)
   `t'    trace playing                   

</screen>
</para>
</sect1>
</chapter>

<chapter id="domande-e-risposte">
<title>Domande e risposte</title>

<sect1 id="dove-posso-reperire-un-set-completo-di-strum">
<title>Dove posso reperire un set completo di strumenti?</title>

<para>Controlla nella corrispondente <link linkend="patches">sezione</link> 
nel capitolo riguardante l'installazione.</para>
</sect1>
</chapter>

<chapter id="copyright">
<title>Copyright</title>

<para><screen>
KMidi Copyright 1997 Bernd Johannes Wuebben &lt;wuebben@math.cornell.edu&gt;

KMidi utilizza il motore di timidity 0.2i di Tuukka Toivonen's,
Copyright (C) 1995 Tukka Toivonen &lt;toivonen@clinet.fi&gt;

Takashi Iwai &lt;iwai@dragon.mm.t.u-tokyo.ac.jp&gt;

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

</screen>
</para>

<para>La traduzione e' stata curata da:</para>

<para>Gianluigi Tiesi (<ulink url="mailto:tiesi@cli.di.unipi.it">tiesi@cli.di.unipi.it</ulink>)</para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
