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

<book lang="&language;">

<bookinfo>
<title
>Manuale di &kmix;</title>

<authorgroup>
<author
><firstname
>Matt</firstname
> <surname
>Johnston</surname
> <affiliation
> <address
><email
>mattj@flashmail.com</email
></address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>Christian</firstname
> <surname
>Esken</surname
> <affiliation
><address
><email
>esken@kde.org</email
></address
></affiliation>
<contrib
>Sviluppatore</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Helio</firstname
> <surname
>Chissini de Castro</surname
> <affiliation
><address
><email
>helio@kde.org</email
></address
></affiliation>
<contrib
>Sviluppatore</contrib>
</othercredit>


<othercredit role="developer"
><firstname
>Stefan</firstname
> <surname
>Schimanski</surname
> <affiliation
><address
><email
>1Stein@gmx.de</email
></address
></affiliation>
<contrib
>Sviluppatore</contrib>
</othercredit>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
<contrib
>Revisore</contrib>
</othercredit>
<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
> 
</authorgroup>

<copyright>
<year
>1996</year
><year
>2005</year>
<holder
>Christian Esken e Matt Johnston</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-02-08</date>
<releaseinfo
>2.2</releaseinfo>

<abstract
><para
>&kmix; è un'applicazione che ti permette di cambiare il volume della tua scheda audio.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KMix</keyword>
<keyword
>kdemultimedia</keyword>
<keyword
>suono</keyword>
<keyword
>volume</keyword>
<keyword
>mixer</keyword>
</keywordset>

</bookinfo>

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

<para
>&kmix; è il programma che fa da mixer per la scheda audio di &kde;. Sebbene sia piccolo, esso è dotato di tutte le caratteristiche necessarie. Il programma dovrebbe darti dei controlli per ognuna delle tue schede audio.</para>

<para
>&kmix; supporta diverse piattaforme e driver sonori:</para>

<itemizedlist>
<listitem
><para
>Il driver per le schede audio ALSA.</para
></listitem>
<listitem
><para
>Tutte le piattaforme Open Sound System. Sono state collaudate esplicitamente: &Linux;, FreeBSD, NetBSD e BSDI.</para
></listitem>
<listitem
><para
>Le macchine basate su &Solaris;.</para
></listitem>
<listitem
><para
>Le macchine basate su &IRIX;.</para
></listitem>
<listitem
><para
>Le macchine basate su &HP-UX;.</para
></listitem>
</itemizedlist>

<para
>Se hai sia i driver ALSA che quelli Open Sound System installati, KMix utilizzerà i driver ALSA.</para>

</chapter>

<chapter id="working-with-kmix">
<title
>Lavorare con &kmix;</title>

<sect1 id="basic-usage">
<title
>Utilizzo di base</title>

<para
>L'utilizzo di &kmix; è immediato. Ogni dispositivo mixer che la tua scheda audio fornisce è rappresentato da un regolatore del volume. I dispositivi mono hanno un regolatore solo, mentre i dispositivi stereo possono avere uno o due regolatori, a seconda delle tue preferenze. Inoltre c'è anche un regolatore del bilanciamento nella parte inferiore della finestra di &kmix;. Se hai più di una scheda audio, apparirà una lista nella parte superiore della finestra, con la quale potrai scegliere tra le tue schede audio. <screenshot>
<screeninfo
>La finestra principale di &kmix;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kmix-window.png" format="PNG"/></imageobject>
<textobject
><phrase
>La finestra principale di &kmix;</phrase
></textobject>
</mediaobject>
</screenshot>

</para>


<para
>Questa finestra ha tre sezioni con i controlli della scheda audio: <simplelist>
<member
>Uscite: Qui troverai i controlli che sono maggiormente correlati alla riproduzione, come il controllo del volume "Master".</member>
<member
>Ingressi: Qui troverai i controlli che sono maggiormente correlati alla registrazione, come "Capture".</member>
<member
>Interruttori: Qui troverai i controlli che permettono solo di abilitare o disabilitare una specifica funzione (come il "Mic Boost (+20dB)"), e i controlli a scelta multipla (come "Microphone Select: Mic1 o Mic2").</member>
</simplelist>
</para>

<para
>Oltre ai controlli del volume, KMix utilizza anche alcuni LED. La regola alla base dei loro colori è la seguente:</para>
<simplelist>
<member
>Verde: LED che ha a che vedere con la riproduzione</member>
<member
>Rosso: LED che ha a che vedere con la registrazione</member>
<member
>Giallo: LED che ha a che vedere con particolari caratteristiche della scheda audio</member>
</simplelist>
</sect1>

<sect1 id="volume-sliders">
<title
>I regolatori del volume</title>

<para
>I regolatori del volume nelle sezioni "Uscite" e "Ingressi" consistono di (dall'alto verso il basso): <screenshot>
<screeninfo
>Regolatore del volume (Sezione "Ingressi")</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kmix-channel-playback.png" format="PNG"/></imageobject>
<textobject
><phrase
>Regolatore del volume (Sezione "Ingressi")</phrase
></textobject>
</mediaobject>
</screenshot>

<simplelist>
<member
>Un'icona che rappresenta la funzione del regolatore.</member>
<member
>Un LED verde per il mute, che ti permette di rendere muto un controllo (la luce si spegne o diventa scura) o di renderlo di nuovo attivo (la luce si accende o diventa luminosa).</member>
<member
>Un regolatore per il controllo del volume (Suggerimento: Puoi nascondere l'etichetta del regolatore se, ad esempio, il mixer occupa troppo spazio sullo schermo).</member>
<member
>Se un controllo supporta la registrazione, ci sarà un LED rosso per la registrazione. Se il LED è acceso (rosso chiaro), il controllo è selezionato per la registrazione. Se non è acceso (rosso scuro), il controllo NON è selezionato per la registrazione.</member>
</simplelist>

<screenshot>
<screeninfo
>Controllo del volume con il selettore di registrazione (Sezione "Uscite")</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kmix-channel-record.png" format="PNG"/></imageobject>
<textobject
><phrase
>Controllo del volume con il selettore di registrazione (Sezione "Uscite")</phrase
></textobject>
</mediaobject>
</screenshot>


</para>

<para
>I controlli nella sezione "Interruttori" consistono di un LED ed una breve etichetta che ne descrive la funzione. Cerca di ricordare che i LED rossi sono per la registrazione, mentre quelli gialli sono per le caratteristiche speciali della tua scheda audio. Se non sei sicuro sul significato di un controllo, per favore chiedi informazioni al produttore dei driver della tua scheda audio (per la maggior parte delle distribuzioni Linux attuali questo è ALSA, http://www.alsa-project.org).</para>

<para
>I regolatori del volume hanno un menu contestuale, accessibile facendo clic col tasto destro sul regolatore o sull'icona del dispositivo (in alto). Diverse operazioni sono possibili, ma solo quelle applicabili sono mostrate.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Dividi canali</guilabel
></term>
<listitem
><para
>Mostra uno o due regolatori. Questa opzione è unicamente applicabile ai dispositivi stereo. Il regolatore di destra controlla il volume del lato destro, mentre quello di sinistra controlla il volume del lato sinistro.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Muto</guilabel
></term>
<listitem
><para
>Rende muto o funzionante il dispositivo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nascondi</guilabel
></term>
<listitem
><para
>Se non sei interessato a regolare questo dispositivo, lo puoi nascondere con questa opzione. Se vuoi renderlo nuovamente visibile, puoi farlo unicamente selezionando l'opzione <guilabel
>Canali</guilabel
> (vedi sotto)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Configura le scorciatoie</guilabel
></term>
<listitem
><para
>Puoi controllare un dispositivo tramite la tastiera. Usa questa opzione del menu per visualizzare la finestra di dialogo <guilabel
>Configura le scorciatoie</guilabel
> di KDE. Qui puoi definire i tasti per aumentare e diminuire il volume e per rendere muto il dispositivo. I tasti sono globali e funzionano anche quando &kmix; è minimizzato o nel vassoio di sistema.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Canali</guilabel
></term>
<listitem
><para
>Comparirà una finestra in cui potrai configurare, per ogni sezione (Uscite, Ingressi, Interruttori), quali canali vuoi vedere.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mostra la barra dei menu</guilabel
></term>
<listitem
><para
>Questa opzione non è specifica per un dispositivo, bensì agisce sulla finestra del mixer. Puoi nascondere e visualizzare nuovamente la barra dei menu con questa opzione. Puoi anche farlo premendo la scorciatoia (solitamente CTRL-m)</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="panning-slider">
<title
>Il regolatore del bilanciamento</title>

<para
>Con questo regolatore puoi controllare la distribuzione del volume tra l'altoparlante destro e quello sinistro. Questo regolatore è un regolatore generale, che influisce direttamente sul volume Master. La posizione centrale è quella predefinita. Trascinando il regolatore a sinistra diminuisci il volume dell'altoparlante destro e viceversa. Ovviamente queste posizioni possono essere invertite se i tuoi altoparlanti non sono posizionati correttamente.</para>
<para
>Per quanto riguarda i sistemi Surround, tieni presente che spesso il dispositivo Master regola solo gli altoparlanti frontali. Questa è una limitazione del driver della tua scheda audio. </para
> 
<para
>Se la tua scheda audio non ha un dispositivo Master, KMix sceglierà qualche altro dispositivo - per la maggior parte degli utenti questo sarà il controllo Wave (o PCM).</para>

</sect1>

<sect1 id="configuration-options">
<title
>Opzioni di configurazione</title>

<para
>Usa <guilabel
>Barra dei menu -> Impostazioni -> Configura KMix...</guilabel
> per impostare le preferenze. Queste sono:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Inserisci nel pannello</guilabel
></term>
<listitem
><para
>Se selezionato, &kmix; si posizionerà nel vassoio di sistema quando premi il pulsante di chiusura della finestra. Se non selezionato, &kmix; terminerà quando premi il pulsante di chiusura della finestra. Attenzione: Dopo l'uscita non sarai più in grado di controllare il volume se hai assegnato dei tasti a questa operazione.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Abilita il controllo del volume dal vassoio di sistema</guilabel
></term>
<listitem
><para
>Se abilitato, un clic con il tasto sinistro sull'icona di KMix nel vassoio di sistema mostrerà una finestra popup con un regolatore del volume per il dispositivo preferito (Suggerimento: al momento non puoi cambiare questo dispositivo, verrà scelto automaticamente da KMix). Se l'opzione è disabilitata, un clic sull'icona farà apparire la finestra principale di KMix.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Mostra scala graduata</guilabel
></term>
<listitem
><para
>Mostra delle linee per segnare le posizioni sui regolatori.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Mostra etichette</guilabel
></term>
<listitem
><para
>Mostra un'etichetta per ogni dispositivo sonoro. Indipendentemente da quest'opzione, trattenendo il cursore sull'icona di ogni dispositivo puoi vedere questa informazione.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Carica i volumi all'accesso</guilabel
></term>
<listitem
><para
>Fa sì che KDE ripristini i volumi quando accedi: questo ripristina i tuoi livelli di volume personali, salvati l'ultima volta che hai terminato la sessione. Se il tuo sistema operativo salva già i livelli di volume potresti non avere bisogno di quest'opzione (ma su un computer con più di un utente è sempre necessaria).</para
></listitem>
</varlistentry>
</variablelist>

</sect1>


</chapter>


<chapter id="working-with-kmixapplet">
<title
>L'applet del pannello &kmix;</title>

<para
>L'applet del pannello &kmix; è un'interfaccia alternativa per &kmix;. Puoi aggiungerla al pannello di KDE usando il menu del pannello (<guilabel
>Menu del pannello</guilabel
> -> <guilabel
>Aggiungi</guilabel
> -> <guilabel
>Applet</guilabel
> -> <guilabel
>Applet KMix</guilabel
>). </para>

<para
>Puoi lavorare con l'applet &kmix; come descritto per la <link linkend="working-with-kmix"
>finestra principale</link
> - compreso il menu contestuale. A causa dello spazio limitato nel pannello ci sono alcune differenze: <simplelist>
<member
>Il menu principale non è disponibile.</member>
<member
>Se hai più di una scheda audio non puoi cambiare il mixer selezionato dopo la selezione iniziale.</member>
<member
>Nessuna icona nel vassoio di sistema. Se vuoi usarla devi avviare parallelamente &kmix; dal Menu K (solitamente si trova in <guilabel
>Menu K</guilabel
> -> <guilabel
>Multimedia</guilabel
> -> <guilabel
>Mixer audio</guilabel
>).</member>
<member
>Le icone sono disponibili unicamente quando il pannello è grande a sufficienza.</member>
<member
>Le etichette coi nomi dei dispositivi non sono disponibili.</member>
<member
>La configurazione si effettua tramite il menu del Pannello - Puoi cambiare i colori e la direzione dei regolatori con esso.</member>
<member
>Nessun salvataggio automatico dei volumi. Se vuoi che i tuoi volumi siano salvati quando termini la sessione per essere riprisinati al prossimo accesso devi anche avviare KMix dal menu K.</member>
</simplelist>

</para>
</chapter>


<chapter id="advanced-kmix">
<title
>Caratteristiche avanzate di KMix</title>



<warning
><para
>Questo capitolo descrive funzionalità di &kmix; pensate per l'utente esperto. La maggior parte degli utenti non avrà mai bisogno di tali funzionalità, quindi puoi tranquillamente saltare questo capitolo</para
></warning>


<sect1 id="dcop-overview">
<title
>L'interfaccia DCOP</title>

<para
>A volte vuoi fare delle cose particolari. Cose come controllare il mixer da un'altra applicazione o rendere muto il dispositivo principale ogni giorno alle 22. &kmix; possiede un'interfaccia DCOP che ti permette di fare molto con poco lavoro. Puoi aprire una shell e scrivere <guilabel
>dcop kmix</guilabel
> per iniziare ad esplorare l'interfaccia DCOP di &kmix;. Le interfacce specifiche di &kmix;: sono:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Mixer0</guilabel
></term>
<listitem
><para
>Permette di manipolare il primo mixer. Puoi impostare i livelli di volume, rendere muto il dispositivo, cambiare il bilanciamento, ottenere il nome del mixer e molto altro. Scrivi <guilabel
>dcop kmix Mixer0</guilabel
> se vuoi esplorare tutte le caratteristiche. Ci sono altri elementi, come <guilabel
>Mixer1</guilabel
>, qualora siano installate schede audio multiple.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>kmix-mainwindow#1</guilabel
></term>
<listitem
><para
>La finestra della GUI può essere controllata con questo comando. Puoi nascondere e mostrare la finestra, ridimensionarla e molto di più. Scrivi <guilabel
>dcop mix kmix-mainwindow#1</guilabel
> se vuoi esplorare tutte le caratteristiche.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>





<sect1 id="dcop-examples">
<title
>Esempi dell'interfaccia DCOP</title>

<variablelist>
<varlistentry>
<term
><guilabel
>dcop kmix kmix-mainwindow#1 hide</guilabel
></term>
<listitem
><para
>Nasconde la finestra della GUI. Usa <guilabel
>dcop kmix kmix-mainwindow#1 show</guilabel
> o l'icona nel vassoio di sistema per renderla nuovamente visibile.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix kmix-mainwindow#1 resize 1 1</guilabel
></term>
<listitem
><para
>Ridimensiona la finestra della GUI alla più piccola dimensione possibile, vale a dire la dimensione tale che tutti i regolatori (e gli altri elementi della GUI) rientrino interamente nella finestra.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix Mixer0 mixerName</guilabel
></term>
<listitem
><para
>Dà il nome del primo mixer, ad esempio <guilabel
>Sound Fusion CS46xx</guilabel
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>dcop kmix Mixer1 setVolume 0 10</guilabel
></term>
<listitem
><para
>Imposta il volume sul secondo mixer, dispositivo 0 al 10%. Il dispositivo 0 spesso è il dispositivo principale, ma non sempre. Se vuoi abbassare il (primo) dispositivo principale della tua seconda scheda audio, puoi usare <guilabel
>dcop kmix Mixer1 setMasterVolume 0</guilabel
></para
></listitem>
</varlistentry>
</variablelist>

<para
>Puoi eseguire questi comandi direttamente da una shell che hai avviato all'interno di KDE. Se hai la necessità di eseguire comandi DCOP da qualche altra parte, ad esempio da uno script di crontab, devi definire la variabile di ambiente <guilabel
>DCOPSERVER</guilabel
> (come puoi vedere alla prima riga del file ~/.DCOPserver_hostname_:0), ad esempio: </para>
                                                                         <!-- Don't know a better way to format code - esken -->
<simplelist>
<member
>#!/bin/sh</member>
<member
>DCOPSERVER=`cat /home/tuahome/.DCOPserver_tuohostname_:0 | grep local`</member>
<member
>export DCOPSERVER</member>
<member
>dcop kmix Mixer0 setMasterVolume 0</member>
</simplelist>

</sect1>

<sect1 id="tips-and-tricks">
<title
>Suggerimenti e trucchi</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Usare i driver ALSA e OSS contemporaneamente</guilabel
></term>
<listitem>
<para
>KMix su Linux può usare o i driver ALSA o i driver OSS, non entrambi. Se hai veramente bisogno di utilizzare entrambi i driver contemporaneamente (una situazione molto rara), puoi fare così: Esci da KMix ed aggiungi la linea seguente al tuo file <guilabel
>kmixrc</guilabel
> nella sezione della configurazione globale.</para>
<para
><guilabel
>MultiDriver=true</guilabel
></para>
<para
>Riapri KMix. Se ora fai clic su <guilabel
>Aiuto -> Informazioni sull'hardware</guilabel
> dovresti vedere "<guilabel
>Driver del suono utilizzato: ALSA0.9 + OSS</guilabel
>" e "<guilabel
>Modalità sperimentale a driver multiplo attivata</guilabel
>"</para>
<warning
><para
>Attenzione: Probabilmente vedrai tutti i tuoi mixer duplicati</para
><para
>Non c'è supporto per questo tipo di configurazione.</para
></warning>
</listitem>
</varlistentry>
</variablelist>

</sect1>

</chapter>

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

<para
>Sviluppatori principali</para>

<itemizedlist>
<listitem
><para
>Copyright 1996-2000 Christian Esken</para
></listitem>
<listitem
><para
>Copyright 2000-2003 Christian Esken e Stefan Schimanski</para
></listitem>
<listitem
><para
>Copyright 2003-2005 Christian Esken &amp; Helio Chissini de Castro</para
></listitem>
</itemizedlist>

<para
>Contributi:</para>

<itemizedlist>
<listitem
><para
>Christian Esken <email
>esken@kde.org</email
></para
></listitem>
<listitem
><para
>Stefan Schimanski <email
>1Stein@gmx.de</email
></para
></listitem>
<listitem
><para
>Paul Kendall <email
>paul@orion.co.nz</email
> - Port su SGI</para
></listitem>
<listitem
><para
>Sebestyen Zoltan <email
>szoli@digo.inf.elte.hu</email
> - Ritocchi per FreeBSD</para
></listitem>
<listitem
><para
>Faraut Jean-Louis <email
>jlf@essi.fr</email
> - Ritocchi per Solaris</para
></listitem>
<listitem
><para
>Nick Lopez <email
>kimo_sabe@usa.net</email
> - Port su ALSA</para
></listitem>
<listitem
><para
>Helge Deller <email
>deller@gmx.de</email
> - Port su HP-UX</para
></listitem>
<listitem
><para
>Lennart Augustsson <email
>augustss@cs.chalmers.se</email
> - Ritocchi per *BSD</para
></listitem>
</itemizedlist>

<para
>Copyright della documentazione 2000 Matt Johnston <email
>mattj@flashmail.com</email
></para>

<para
>Aggiornamento 2003 per adattarla a &kmix; V1.91 di Christian Esken <email
>esken@kde.org</email
></para>

<para
>Aggiornamento 2005 per adattarla a &kmix; V2.2 di Christian Esken <email
>esken@kde.org</email
></para>


<para
>Basata su documentazione di Christian Esken <email
>esken@kde.org</email
></para>
<para
>Traduzione della documentazione: Giorgio Moscardi <email
>enjoy.the.silence@iol.it</email
></para
> 
&underFDL; &underGPL; </chapter>

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

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

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

<para
>Ovviamente, &kmix; è utile solo se hai una scheda audio. &kmix; supporta diverse piattaforme e driver sonori:</para>

<itemizedlist>
<listitem
><para
>Tutte le piattaforme Open Sound System. Sono state collaudate esplicitamente: &Linux;, FreeBSD, NetBSD e BSDI.</para
></listitem>
<listitem
><para
>Le macchine basate su &Solaris;.</para
></listitem>
<listitem
><para
>Le macchine basate su &IRIX;.</para
></listitem>
<listitem
><para
>Il driver per le schede audio ALSA.</para
></listitem>
<listitem
><para
>Le macchine basate su &HP-UX;.</para
></listitem>
</itemizedlist>

</sect1>

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

</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

