<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&krec;">
  <!ENTITY package "kdemultimedia">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Italian "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title
>Manuale di &krec;</title>

<authorgroup>
<author
><firstname
>Arnold</firstname
> <surname
>Krille</surname
> <affiliation
> <address
><email
>arnold@arnoldarts.de</email
></address>
</affiliation>
</author>
</authorgroup>

<othercredit role="translator"
><firstname
>Giorgio</firstname
><surname
>Moscardi</surname
><affiliation
><address
><email
>enjoy.the.silence@iol.it</email
></address
></affiliation
><contrib
>Traduzione italiana</contrib
></othercredit
> 

<copyright>
<year
>2002</year>
<holder
>Arnold Krille</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-08-20</date>
<releaseinfo
>0.01.00</releaseinfo>

<abstract>
<para
>&krec; fornisce un'interfaccia di registrazione ad &arts;. Può essere usato per registrare file singoli o intere sessioni di registrazione. Alcuni effetti dinamici sono implementati, così come la possibilità di riprodurre quello che stai registrando (a meno che tu non stia registrando quel che stai sentendo). </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>KRec</keyword>
<keyword
>aRts</keyword>
<keyword
>registrazione</keyword>
<keyword
>interfaccia</keyword>
</keywordset>

</bookinfo>
 
<chapter id="introduction">
<title
>Introduzione</title>

<sect1 id="why-krec">
<title
>Perché ho scritto &krec;</title>

<para
>Dopo avere lavorato un po' con &arts;, mi sono accorto che non possedeva nessuna interfaccia di registrazione, fatta eccezione per il programma a linea di comando artsrec. Dovevo registrare un programma radiofonico per alcuni miei amici, ed essi volevano anche che lo mixassi e ne facessi un master, ed io volevo utilizzare &Linux; per la registrazione. Così ho incominciato a scrivere &krec;. </para>
</sect1>

<sect1 id="what-krec-does">
<title
>Quel che fa &krec;</title>

<para
>La funzione di &krec; è abbastanza semplice. Esso si collega al server &arts; e registra quel che gli viene passato su di un file. </para>
<para
>Al momento esso scrive solo file grezzi che sono identici ai normali file Wave, ma senza l'intestazione wav (Puoi usare <application
>sox</application
>, ad esempio, per aggiungere questa intestazione). </para>
</sect1>

</chapter>

<chapter id="using-krec">
<title
>Utilizzo di &krec;</title>

<para
>Questo capitolo descrive l'utilizzo di &krec;. Ci sono diversi modi di utilizzare &krec; quindi ho creato alcune sezioni simili ad <quote
>HOWTO</quote
>, che descrivono queste possibilità di utilizzo. Leggi solo il primo paragrafo di ciascuna di esse e stabilisci cosa hai bisogno di leggere. Altrimenti leggi tutto ed impara le fantastiche possibilità di &krec;.</para>

<screenshot>
<screeninfo
>Ecco un'immagine di &krec;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="krec-hicolor.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Ecco un'immagine di &krec; subito dopo che è stato avviato.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect1 id="simple-usage">
<title
>Registrazione di un semplice file</title>

<para
>Se senti qualcosa per radio che vuoi registrare (e la radio è connessa alla scheda audio) c'è un modo (relativamente) veloce di registrare. </para>

<orderedlist>
<listitem>
<para
>Prima di tutto devi selezionare la sorgente di registrazione nella tua scheda audio. Avrai bisogno del tuo mixer preferito (&kmix;), nel quale dovrai selezionare la sorgente di cui hai bisogno per registrare. Devi anche configurare il server &arts; in modalità full-duplex (e anche la tua scheda audio ed i driver dovrebbero supportare questa modalità). Se dovrai riavviare &arts; dovresti riavviare anche &krec; </para>
</listitem>
<listitem>
<para
>Poi devi aprire lo Strumento di controllo di &arts; ed il suo gestore audio. Questo mostrerà due nuovi elementi: &krec;::In e &krec;::Out. Il secondo viene utilizzato per la riproduzione (anche durante la registrazione se hai attivato <quote
>Riproduci mentre registri</quote
>) e possiamo ignorarlo al momento. Il primo, invece, sarà il centro della nostra attenzione; dovrebbe essere collegato al bus <emphasis
>in_soundcard</emphasis
>. Se non puoi selezionarlo, probabilmente hai sbagliato a configurare qualcosa (come il full-duplex o qualcosa di correlato).</para>
</listitem>
<listitem>
<para
>Se tutto è andato a buon fine, ora dovresti vedere qualcosa che si muove all'interno di &krec; &mdash; Il VU-Meter che ti mostra quanto è alto il volume della tua registrazione. Per ottenere buone registrazioni senza tagli, dovrebbe essere tra il giallo e l'arancione, ma non rosso. Il regolatore a destra del VU-Meter controlla il volume.</para>
</listitem>
<listitem>
<para
>Ora hai bisogno di un file in cui registrare. Usa <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Nuovo file</guimenuitem
></menuchoice
> o l'icona sulla barra degli strumenti per crearlo. Successivamente devi dire a &krec; di registrare in questo file. Puoi fare questo nel menu contestuale del file.</para>
</listitem>
<listitem>
<para
>Ora sei in grado di iniziare a registrare. Usa il pulsante grande rosso nella barra degli strumenti, o <guimenu
>Riproduci</guimenu
> <guimenuitem
>Registra</guimenuitem
>, o premi semplicemente <keycap
>R</keycap
>. Per fermare la regitrazione usa il pulsante di interruzione o la voce nel menu <guimenu
>Riproduci</guimenu
> (o il tasto <keycap
>S</keycap
>).</para>
</listitem>
</orderedlist>

<para
>OK, non è così veloce come premere il tasto di registrazione sul tuo stereo, ma &krec; ha alcune funzioni in più del tuo stereo, credimi!</para>

<tip>
<para
>Potresti voler registrare altre cose. Per fare delle prove puoi prendere il segnale di uscita di &noatun;: Imposta &krec;::In al bus <emphasis
>out_soundcard</emphasis
> (o a qualsiasi altro bus nel quale fai riprodurre &noatun;). Questo funziona anche se il tuo &arts; non è in grado di effettuare il full-duplex.</para>
</tip>
</sect1>

<sect1 id="advanced-usage">
<title
>Registrazione di file multipli</title>

<para
>Per questa sezione supponiamo che tu voglia registrare parecchi pezzi corti o piuttosto lunghi in file multipli. Ad esempio, vuoi registrare degli spezzoni per un programma radiofonico o qualcosa di simile (Ecco il motivo per cui ho scritto &krec;). </para>

<para
>Presumo che tu abbia lavorato con &arts; prima e sappia qualcosa di <quote
>Registrazione audio</quote
>. Il tuo microfono, o qualsiasi cosa da cui tu voglia registrare, deve essere collegato al computer. e dovresti sapere cosa configurare (fuori da &krec;) per far sì che il segnale in ingresso venga registrato. </para>

<para
>Questa <quote
>guida</quote
> utilizza un programma radiofonico come esempio. Dobbiamo decidere se vogliamo che tutte le nostre registrazioni abbiano un nome diverso o sempre lo stesso, con solo un numero che le distingue. Nel primo caso, segui le istruzioni in <xref linkend="simple-usage"/> e tieni a mente che puoi aprire parecchi file nello stesso momento e poi scegliere quello su cui registrare. Il secondo caso è descritto qua... </para>

<orderedlist>
<listitem
><para
>Prima di iniziare, assicurati di avere configurato tutto correttamente, in modo particolare assicurati di stare veramente registrando quello che vuoi. Puoi essere sicuro che è tutto a posto se il VU-Meter di &krec; si muove. Se non stai registrando da <emphasis
>out_soundcard</emphasis
> puoi selezionare <guimenu
>Riproduci</guimenu
> <guimenuitem
>Riproduci mentre registri</guimenuitem
> per sentire il segnale registrato attraverso l'uscita della scheda audio, cosa che farei io, piuttosto che ascoltarlo attraverso il mixer della scheda audio, perché in questo modo puoi sentire se è troppo alto o troppo basso.</para
></listitem>
<listitem
><para
>Per più file con lo stesso nome hai bisogno di una sessine. <guimenu
>File</guimenu
> <guimenuitem
>Nuova sessione</guimenuitem
> dovrebbe fare al caso tuo. Seleziona il percorso ed inserisci un nome file, che viene espanso con il numero e la versione della registrazione.</para
></listitem>
<listitem
><para
>Hai ancora bisogno dei file in cui registrare, ma questa volta li puoi creare selezionando <guimenuitem
>Nuovo file</guimenuitem
> dal menu contestuale. Puoi creare tanti file quanti ne vuoi o quanti te ne servono.</para
></listitem>
<listitem
><para
>Il resto è semplice: seleziona il file in cui vuoi registrare e registra...</para
></listitem>
</orderedlist>

<note
><para
>Una sessione non è un nuovo tipo MIME, e nemmeno un file. È semplicemente una struttura interna per organizzare la numerazione. Di conseguenza non puoi riaprire una sessione più tardi e continuare a registrare in nuovi file... </para
></note>
</sect1>

<sect1 id="more-usage">
<title
>Altri consigli e commenti sull'utilizzo</title>

<para
>Ci sono ancora alcune cose da dire ed alcuni importanti elementi da spiegare.</para>

<sect2 id="usage-play-through">
<title
>Utilizzo di "Riproduci mentre registri"</title>

<para
>Per coloro che vogliono sentire ciò che stanno registrando, c'è l'utilissima opzione <quote
>Riproduci mentre registri</quote
>. Essa si trova nel menu <guimenu
>Riproduci</guimenu
>. Consiglio di utilizzarla il più possibile, specialmente se fai altre cose, come utilizzare anche il compressore o altri effetti. Vedi <xref linkend="internals"/> per i dettagli sulle connessioni.</para>

<caution>
<para
>Assicurati di non creare un ciclo di retroazione mentre registri da <emphasis
>out_soundcard</emphasis
> utilizzando <quote
>Riproduci mentre registri</quote
>. Un ciclo del genere è troppo per il povero &arts; e rallenta molto, moltissimo il tuo sistema! Potresti dover terminare &arts;...</para>
</caution>

</sect2>

<sect2 id="using-compressor">
<title
>Utilizzo del compressore</title>

<para
>Se stai registrando con un microfono, potresti accorgerti che il livello a volte è quasi distorto e altre volte molto basso, specialmente quando registri del parlato. Per correggere questo fenomeno puoi utilizzare il compressore. Esso riduce semplicemente tutto il suono che è al di sopra della soglia impostata del fattore impostato come rapporto. Dato che questo riduce il volume c'è un potenziometro dell'uscita per espandere (o ridurre) il suono. Attacco e rilascio ti permettono di controllare il tempo dopo il quale il compressore reagisce (il tempo che trascorre dopo che l'ingresso supera per la prima volta la soglia) ed il tempo per cui il compressore continua a reagire dopo che il suono è tornato sotto alla soglia. </para>
<tip
><para
>Provalo mentre parli nel microfono con <quote
>Riproduci mentre registri</quote
> abilitato e sentirai la differenza.</para
></tip>
</sect2>

<sect2 id="usage-switching-file">
<title
>Cambiare tra parecchi file</title>

<para
>Così come puoi aprire parecchi file per registrare, puoi anche cambiare tra di essi. Questo si può fare non solo dopo che hai fermato la registrazione, ma anche mentre stai registrando. Nota che alcuni pacchetti di dati possono andare persi quando fai questo. Quanta informazione sonora sia dipende dalla dimensione del tuo Buffer audio configurato nel &kcontrol; per &arts;. Non dovrebbe essere più di tanto, ma se riproduci i file direttamente uno dopo l'altro (ad esempio con <command
>artscat file*.raw</command
>) potresti sentire qualche piccolo <quote
>salto</quote
>.</para>
</sect2>

</sect1>
 
<sect1 id="internals">
<title
>Funzionamento interno</title>

<para
>Permetti che ti dica qualcosa sulle connessioni sonore in &krec;. </para>
<para
>Per registrare con &arts; servono necessariamente alcuni elementi: un synth_AMAN_RECORD, un convertitore AudioToByteStream ed un ByteStreamReceiver. I primi due sono già costruiti all'interno del server &arts;. L'ultimo invece si trova all'interno dell'applicazione. Ma questo è proprio il minimo indispensabile. Se vuoi ascoltare i files, hai bisogno di un ByteStreamSender all'interno della tua applicazione, e di un convertitore ByteStreamToAudio e di un synth_AMAN_PLAY all'interno del server. </para>
<para
>E gli effetti? Tra AMAN_RECORD e AudioToByteStream io ho collegato uno StereoEffectStack, nel quale ho inserito il compressore (synth_STEREO_COMPRESSOR) ed un controllo del volume (StereoVolumeControl). </para>
<para
>Se attivi <quote
>Riproduci mentre registri</quote
>, la pila degli effetti viene connessa anche con AMAN_PLAY. Quindi tutto questo è all'interno del server &arts;... </para>
</sect1>

</chapter>

<chapter id="commands">
<title
>Riferimenti per i comandi</title>

<sect1 id="krec-mainwindow">
<title
>La finestra principale di &krec;</title>

<sect2>
<title
>Il menu <guimenu
>File</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Nuovo file</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crea un nuovo file singolo per registrare in un file</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Nuova sessione</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Crea una nuova sessione per registrazioni multiple</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esci</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Esce</action
> da &krec;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2>
<title
>Il menu <guimenu
>Riproduci</guimenu
> </title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Riproduci</guimenu
> <guimenuitem
>Riproduci</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Riproduce il file selezionato.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Riproduci</guimenu
> <guimenuitem
>Registra</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Inizia a registrare nel file selezionato.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Riproduci</guimenu
> <guimenuitem
>Interrompi</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Interrompe la registrazione.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Riproduci</guimenu
> <guimenuitem
>Riproduci mentre registri</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Connette l'ingresso con l'uscita permettendoti di sentire quello che stai registrando.</action
> (&krec;::In e &krec;::Out nel Gestore audio dello Strumento di controllo di &arts;)</para>
<caution
><para
>Non usare mai questa funzione mentre stai registrando quello che stai sentendo (da out_soundcard insomma). Questo genera una retroazione che &arts; non è in grado di gestire (Non fischia perché &arts; è più veloce del ritorno dal tuo computer al microfono).</para
></caution>
</listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
>Il menu <guimenu
>Impostazioni</guimenu
></title>

<para>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra finestra di avvio</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o meno la finestra della guida veloce all'avvio.</action
></para
></listitem>
</varlistentry>

</variablelist>
</para>
</sect2>

<sect2>
<title
>Il menu <guimenu
>Aiuto</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="startupwindow">
<title
>La finestra di avvio</title>

<para
>Questa finestra di avvio è quasi identica alla finestra di &ktip;. </para>
</sect1>

</chapter>

<chapter id="faq">
<title
>Domande e risposte</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>Ho registrato alcuni file con &krec;, ma non riesco a riprodurre i file con il mio programma preferito!</para>
</question>
<answer>
<para
>&krec; (per ora) registra solo file grezzi, non veri file wav. Per effettuare la conversione puoi utilizzare sox, ad esempio:</para>
<example id="converting-with-sox">
<title
>Convertire file grazzi in veri file Wav con sox</title>
<para
>Per convertire un file grezzo registrato con &krec; usa il seguente comando in una console (&konsole;), assumendo che <command
>sox</command
> sia installato. Nell'esempio, il file si chiama test.raw e deve essere convertito in test.wav. Usa i nomi dei tuoi file al posto di questi. </para>
<para
><screen
><prompt
>&percnt;</prompt
><command
>sox -r 44100 -c 2 -s -w test.raw 
test.wav</command
>
</screen
></para>
<para
>Le opzioni <option
>-r 44100 -c 2 -s -w</option
> dicono a <command
>sox</command
> che hai registrato con una frequenza di campionamento di 44100 Hz, 2 canali (stereo), codificato linearmente e con parole di 16 bit. Potresti dover utilizzare altre opzioni per la tua configurazione - controlla la pagina di manuale di <command
>sox</command
>. </para>
</example>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">
<title
>Riconoscimenti e licenza</title>

<para
>&krec; </para>
<para
>Copyright sul programma 2002 Arnold Krille<email
>arnold@arnoldarts.de</email
> </para>


<para
>Copyright sulla documentazione 2002 Arnold Krille <email
>arnold@arnoldarts.de</email
> </para>

<para
>Traduzione italiana: Giorgio Moscardi <email
>enjoy.the.silence@iol.it</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>

<sect1 id="getting-krec">
<title
>Come ottenere &krec;</title>
&install.intro.documentation; </sect1>

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

<para
>Per utilizzare &krec; hai bisogno di &kde; 3.1. </para>

<para
>&krec; dovrebbe trovarsi all'interno del tuo pacchetto kdemultimedia. Dato che questo pacchetto necessita di &kde; e &arts; in esecuzione tutto dovrebbe essere a posto. </para>


</sect1>

<sect1 id="compilation">
<title
>Compilazione ed installazione</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
End:
-->
