# 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;

La finestra può avere fino a tre sezioni con diversi controlli della scheda sonora: Uscite, Ingressi e Interruttori. Le sezioni contengono controlli a slitta per il volume, interruttori per abilitare e disabilitare la registrazione o la riproduzione e selettori a scelta multipla.

- 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 Mic Select: Mic1 o 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

Questi tre colori sono in due sfumature: un LED acceso indica ON e uno spento indica OFF.

### 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 indicatore di volume (opzionale).
- 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 volume con il selettore di registrazione (Sezione Uscite) Controllo del volume con il selettore di registrazione (Sezione Uscite)

I regolatori del volume hanno un menu contestuale, accessibile facendo clic col tasto destro sul regolatore o sull'icona del dispositivo. 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 scorciatoie globali...

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

### Interruttori e selettori a scelta multipla

I controlli della sezione Interruttori consistono di LED e brevi didascalie con le descrizioni delle funzioni. Possono esserci anche selettori a scelta multipla. Nota che la maggior parte di questi controlli hanno spesso un uso molto particolare e un utente normale normalmente non ha necessità di toccarli. Nel menu contestuale ci sono le voci Canali e Mostra/Nascondi la barra dei menu che sono già state descritte. Interruttori e selettori a scelta multipla (sezione Interruttori) Interruttori e selettori a scelta multipla (sezione Interruttori) Ricordati che i LED rossi sono collegati alla registrazione e quelli gialli controllano capacità speciali della scheda sonora. La schermata qui sopra mostra da sinistra a destra un LED Uscita IEC958 (è giallo, quindi è un controllo speciale) un led Mix illuminato (rosso, quindi collegato alla registrazione) un LED non illuminato collegato alla registrazione, un controllo speciale illuminato e un selettore a scelte multiple (PCM Out Path & Mute). Se non sei sicuro sul significato di un controllo, chiedi al fornitore del driver della scheda (per quasi tutte le distribuzioni &Linux; attuali, ALSA).

### 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 Impostazioni Configura &kmix;... dalla barra dei menu 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).

Valori volume:

- Seleziona se e come debbano essere mostrati i valori del volume: Nessuno, Assoluto o Relativo.

Orientazione barre

- Con questa opzione puoi ruotare il contenuto della finestra principale di &kmix; di 90 gradi. I controlli a slitta, il testo e tutto il resto viene ruotato. Ci sono alcuni elementi esclusi da questa regola, in particolare, la barra dei menu, il selettore dei mixer (se è mostrato) il controllo del panning ed i selettori a scelte multiple.

## L'applet del pannello &kmix;

L'applet del pannello &kmix; è un'interfaccia alternativa per &kmix;. Puoi aggiungerla al pannello di &kde; usando Aggiungi un'applet al pannello... nel menu del pannello o nel menu contestuale. Scegli Mixer sonoro e fai clic su Aggiungi al pannello o fai doppio clic sulla voce Mixer sonoro.

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; con Menu K Multimedia Mixer sonoro &kmix;.
- 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 ripristinati 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 possono essere altri elementi, come ``Mixer1``, se sono installate più schede audio.

``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/yourhome/.DCOPserver_yourhostname_: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

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

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 per &HP;-UX

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

Copyright della documentazione 2000 &Matt.Johnston; &Matt.Johnston.mail;

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

Aggiornamento nel 7/2005 per adattarla a &kmix; V2.6 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;