<?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
>2003</year>
<holder
>Christian Esken e Matt Johnston</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-04-24</date>
<releaseinfo
>1.91.00</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. La versione 1.91 funziona con:</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>

</chapter>

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

<para
>L'uso 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, ognuna di esse avrà la sua linguetta.</para>

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

<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
>Mostra tutti</guilabel
> (vedi sotto)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Definisci tasti</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
>Mostra tutti</guilabel
></term>
<listitem
><para
>Se hai nascosto dei dispositivi attraverso l'opzione <guilabel
>Nascondi</guilabel
> (vedi sopra), puoi visualizzarli nuovamente tutti con questa opzione.</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 agisce su tutti i dispositivi stereo (i dispositivi mono sono ignorati). 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
> 

</sect1>

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

<para
>Se l'icona di &kmix; si trova nel vassoio di sistema, puoi fare clic su di essa col tasto destro per accedere alle preferenze. Esse sono:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Inserisci nel pannello</guilabel
></term>
<listitem
><para
>Fa sì che il programma si riduca ad un'icona nel vassoio di sistema</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Abilita il controllo del volume dal vassoio di sistema</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
>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>
</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>
</simplelist>

</para>
</chapter>

<chapter id="control-panel">
<title
>Opzioni di &kcontrol;</title>

<sect1 id="config-opt">
<title
>Opzioni di configurazione</title>

<para
>Nella linguetta <guimenuitem
>Mixer</guimenuitem
>, sotto <guimenu
>Sistema sonoro</guimenu
> in &kcontrol;, puoi regolare varie impostazioni di &kmix;:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Salva i volumi correnti</guilabel
></term>
<listitem
><para
>Salva le impostazioni correnti del suono per caricarle in un secondo momento.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Carica volumi</guilabel
></term>
<listitem
><para
>Carica le impostazioni del suono salvate precendentemente.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Carica i volumi all'avvio di KDE</guilabel
></term>
<listitem
><para
>Carica automaticamente le impostazioni precedenti quando avvii &kde;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Numero massimo di mixer provati</guilabel
></term>
<listitem
><para
>Il numero delle diverse schede audio che &kmix; cerca all'avvio.Imposta questo parametro ad un valore basso per diminuire il tempo di avvio di &kmix;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Numero massimo di dispositivi provati per mixer</guilabel
></term>
<listitem
><para
>Quanti dispositivi cercare per ogni scheda audio. Come sopra, imposta questo parametro ad un valore basso per rendere &kmix; più veloce all'avvio.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>
</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 Christian Esken e 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
>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:
-->

