# Manuale di &kmix;

## Introduzione

&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.

&kmix; supporta diverse piattaforme e driver sonori:

- Il driver per le schede audio ALSA.

- Tutte le piattaforme Open Sound System. Sono state collaudate esplicitamente: &Linux;, FreeBSD, NetBSD e BSDI.

- Le macchine basate su &Solaris;.

- Le macchine basate su &IRIX;.

- Le macchine basate su &HP-UX;.

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

## Lavorare con &kmix;

### Utilizzo di base

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. La finestra principale di &kmix; La finestra principale di &kmix;

Questa finestra ha tre sezioni con i controlli della scheda audio:

- Uscite: Qui troverai i controlli che sono maggiormente correlati alla riproduzione, come il controllo del volume "Master".
- Ingressi: Qui troverai i controlli che sono maggiormente correlati alla registrazione, come "Capture".
- 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 or Mic2").

Oltre ai controlli del volume, KMix utilizza anche alcuni LED. La regola alla base dei loro colori è la seguente:

- Verde: LED che ha a che vedere con la riproduzione
- Rosso: LED che ha a che vedere con la registrazione
- Giallo: LED che ha a che vedere con particolari caratteristiche della scheda audio

### I regolatori del volume

I regolatori del volume nelle sezioni "Uscite" e "Ingressi" consistono di (dall'alto verso il basso): Regolatore del volume (Sezione "Ingressi") Regolatore del volume (Sezione "Ingressi")

- Un'icona che rappresenta la funzione del regolatore.
- 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).
- Un regolatore per il controllo del volume (Suggerimento: Puoi nascondere l'etichetta del regolatore se, ad esempio, il mixer occupa troppo spazio sullo schermo).
- 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.

Controllo del voume con il selettore di registrazione (Sezione "Uscite") Controllo del voume con il selettore di registrazione (Sezione "Uscite")

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).

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.

Dividi canali

- 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.

Muto

- Rende muto o funzionante il dispositivo

Nascondi

- 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 Canali (vedi sotto)

Configura le scorciatoie

- Puoi controllare un dispositivo tramite la tastiera. Usa questa opzione del menu per visualizzare la finestra di dialogo Configura le scorciatoie 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.

Canali

- Comparirà una finestra in cui potrai configurare, per ogni sezione (Uscite, Ingressi, Interruttori), quali canali vuoi vedere.

Mostra la barra dei menu

- 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)

### Il regolatore del bilanciamento

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.

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.

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).

### Opzioni di configurazione

Usa Barra dei menu -> Impostazioni -> Configuta KMix... per impostare le preferenze. Queste sono:

Inserisci nel pannello

- 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.

Abilita il controllo del volume dal vassoio di sistema

- 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.

Mostra scala graduata

- Mostra delle linee per segnare le posizioni sui regolatori.

Mostra etichette

- Mostra un'etichetta per ogni dispositivo sonoro. Indipendentemente da quest'opzione, trattenendo il cursore sull'icona di ogni dispositivo puoi vedere questa informazione.

Carica i volumi all'accesso

- 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).

## L'applet del pannello &kmix;

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

Puoi lavorare con l'applet &kmix; come descritto per la finestra principale - compreso il menu contestuale. A causa dello spazio limitato nel pannello ci sono alcune differenze:

- Il menu principale non è disponibile.
- Se hai più di una scheda audio non puoi cambiare il mixer selezionato dopo la selezione iniziale.
- Nessuna icona nel vassoio di sistema. Se vuoi usarla devi avviare parallelamente &kmix; dal Menu K (solitamente si trova in Menu K -> Multimedia -> Mixer audio).
- Le icone sono disponibili unicamente quando il pannello è grande a sufficienza.
- Le etichette coi nomi dei dispositivi non sono disponibili.
- La configurazione si effettua tramite il menu del Pannello - Puoi cambiare i colori e la direzione dei regolatori con esso.
- 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.

## Caratteristiche avanzate di KMix

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

### L'interfaccia DCOP

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 dcop kmix per iniziare ad esplorare l'interfaccia DCOP di &kmix;. Le interfacce specifiche di &kmix;: sono:

Mixer0

- 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 dcop kmix Mixer0 se vuoi esplorare tutte le caratteristiche. Ci sono altri elementi, come Mixer1, qualora siano installate schede audio multiple.

kmix-mainwindow#1

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

### Esempi dell'interfaccia DCOP

dcop kmix kmix-mainwindow#1 hide

- Nasconde la finestra della GUI. Usa dcop kmix kmix-mainwindow#1 show o l'icona nel vassoio di sistema per renderla nuovamente visibile.

dcop kmix kmix-mainwindow#1 resize 1 1

- 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.

dcop kmix Mixer0 mixerName

- Dà il nome del primo mixer, ad esempio Sound Fusion CS46xx

dcop kmix Mixer1 setVolume 0 10

- 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 dcop kmix Mixer1 setMasterVolume 0

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 DCOPSERVER (come puoi vedere alla prima riga del file ~/.DCOPserver_hostname_:0), ad esempio:

- #!/bin/sh
- DCOPSERVER=`cat /home/tuahome/.DCOPserver_tuohostname_:0 | grep local`
- export DCOPSERVER
- dcop kmix Mixer0 setMasterVolume 0

### Suggerimenti e trucchi

Usare i driver ALSA e OSS contemporaneamente

- 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 kmixrc nella sezione della configurazione globale.

  MultiDriver=true

  Riapri KMix. Se ora fai clic su Aiuto -> Informazioni sull'hardware dovresti vedere "Driver del suono utilizzato: ALSA0.9 + OSS" e "Modalità sperimentale a driver multiplo attivata"

  Attenzione: Probabilmente vedrai tutti i tuoi mixer duplicati

  Non c'è supporto per questo tipo di configurazione.

## Riconoscimenti e licenza

Sviluppatori principali

- Copyright 1996-2000 Christian Esken

- Copyright 2000-2003 Christian Esken e Stefan Schimanski

- Copyright 2003-2005 Christian Esken & Helio Chissini de Castro

Contributi:

- Christian Esken esken@kde.org

- Stefan Schimanski 1Stein@gmx.de

- Paul Kendall paul@orion.co.nz - Port su SGI

- Sebestyen Zoltan szoli@digo.inf.elte.hu - Ritocchi per FreeBSD

- Faraut Jean-Louis jlf@essi.fr - Ritocchi per Solaris

- Nick Lopez kimo_sabe@usa.net - Port su ALSA

- Helge Deller deller@gmx.de - Port su HP-UX

- Lennart Augustsson augustss@cs.chalmers.se - Ritocchi per *BSD

Copyright della documentazione 2000 Matt Johnston mattj@flashmail.com

Aggiornamento 2003 per adattarla a &kmix; V1.91 di Christian Esken esken@kde.org

Aggiornamento 2005 per adattarla a &kmix; V2.2 di Christian Esken esken@kde.org

Basata su documentazione di Christian Esken esken@kde.org

Traduzione della documentazione: Giorgio Moscardi enjoy.the.silence@iol.it

&underFDL; &underGPL;

## Installazione

### Come ottenere &kmix;

&install.intro.documentation;

### Requisiti

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

- Tutte le piattaforme Open Sound System. Sono state collaudate esplicitamente: &Linux;, FreeBSD, NetBSD e BSDI.

- Le macchine basate su &Solaris;.

- Le macchine basate su &IRIX;.

- Il driver per le schede audio ALSA.

- Le macchine basate su &HP-UX;.

### Compilazione ed installazione

&install.compile.documentation;