133
146
>Introdução</title>
136
>&kmix; is &kde;'s soundcard mixer program. Though small, it is
137
full-featured. The program should give controls for each of your
142
>O &kmix; suporta várias plataformas e controladores de som.</para>
147
> The ALSA soundcard driver.</para
151
> All Open Sound System platforms. Explicitly tested are &Linux;, FreeBSD, NetBSD and BSDI.</para
155
> &Solaris; based machines.</para
159
> &IRIX; based machines.</para
163
> &HP-UX; based machines.</para
149
>Warning: This handbook contains the documentation for an older version of &kmix;, namely the version that ships with &kde; 3.5. </para>
152
>&kmix; is &kde;'s soundcard mixer program. Though small, it is full-featured. The program should give controls for each of your soundcards.</para>
155
>&kmix; supports several platforms and sound drivers:</para>
160
>The ALSA soundcard driver.</para
164
>All Open Sound System platforms. Explicitly tested are &Linux;, FreeBSD, NetBSD and BSDI.</para
168
>&Solaris; based machines.</para
172
>&IRIX; based machines.</para
176
>&HP-UX; based machines.</para
169
181
>Se você tiver tanto os controladores ALSA quanto os do Open Sound System instalados, o &kmix; usará o controlador ALSA.</para>
174
>Captura de tela do &kmix;</screeninfo>
177
<imagedata fileref="kmix.png" format="PNG"/>
181
>Captura de tela do &kmix;</phrase>
191
<chapter id="Main_Window">
193
>Janela principal</title>
196
>Visão geral da janela principal do &kmix;</para>
199
>Captura de tela do &kmix;</screeninfo>
202
<imagedata fileref="kmix.png" format="PNG"/>
206
>Captura de tela do &kmix;</phrase>
211
<sect1 id='File_Options'>
213
>Opções de arquivo</title>
216
>Opções de arquivo do &kmix;</screeninfo>
219
<imagedata fileref="kmix-file.png" format="PNG"/>
223
>Opções de arquivo do &kmix;</phrase>
233
> <keycombo action="simul"
239
>Ocultar janela do mixer</guimenuitem
245
>Ocultar janela do mixer</action
252
<sect1 id='Settings'>
254
>Configurações</title>
258
>Configurações do &kmix;</screeninfo>
261
<imagedata fileref="kmix-options.png" format="PNG"/>
265
>Configurações do &kmix;</phrase>
275
>Configurações</guimenu
277
>Configurar canais...</guimenuitem
283
>Configurar canais de áudio</action
290
<sect2 id='Channels'>
292
>Configurar os canais do &kmix;</title>
295
>Canais do &kmix;</screeninfo>
298
<imagedata fileref="kmix-channels.png" format="PNG"/>
302
>Canais do &kmix;</phrase>
307
>Selecione os canais do &kmix; que deseja usar como informação para a entrada e saída de áudio.</para>
310
<sect2 id='Master_Channels'>
312
>Selecionar os canais principais</title>
315
>Canal principal do &kmix;</screeninfo>
318
<imagedata fileref="kmix-master.png" format="PNG"/>
322
>Canal principal do &kmix;</phrase>
327
>Selecione o seu canal principal do &kmix;.</para>
330
<sect2 id='Configure'>
332
>Configurar &kmix;</title>
335
>Configurar &kmix;</screeninfo>
338
<imagedata fileref="kmix-configure.png" format="PNG"/>
342
>Configurar &kmix;</phrase>
347
>Configure vários parâmetros do &kmix;.</para>
354
>Comportamento</guimenu
356
>Embutir na área de notificação</guimenuitem
362
>Assinale esta opção para embutir o &kmix; na área de notificação.</action
371
>Comportamento</guimenu
373
>Ativar controle de volume na área de notificação</guimenuitem
379
>Assinale esta opção para ativar o controle do volume na área de notificação.</action
388
>Comportamento</guimenu
390
>Restaurar volumes na inicialização</guimenuitem
396
>Assinale esta opção para ativar a restauração dos níveis de volume no início da sessão.</action
407
>Mostrar graduações</guimenuitem
413
>Assinale esta opção para mostrar as graduações nos controles.</action
424
>Mostrar rótulos</guimenuitem
430
>Assinale esta opção para mostrar os rótulos nos controles.</action
439
>Orientação da barra</guimenu
441
>Horizontal</guimenuitem
447
>Selecione esta opção exclusiva para orientar as barras de controle na horizontal.</action
456
>Orientação da barra</guimenu
458
>Vertical</guimenuitem
464
>Selecione esta opção exclusiva para orientar as barras de controle na vertical.</action
185
<chapter id="working-with-kmix">
187
>Working with &kmix;</title>
189
<sect1 id="basic-usage">
194
>&kmix; usage is straightforward. Every mixer control that your soundcard provides is represented by a volume slider. Mono controls have a single slider, stereo controls can have either one or two sliders, depending on your choice. Additionally there is a panning slider at the bottom of the &kmix; window. If you have more than one soundcard, a list will be displayed on the top of the window, where you can choose between your soundcards. <screenshot>
196
>The &kmix; Main Window</screeninfo>
199
<imagedata fileref="kmix-window.png" format="PNG"/></imageobject>
202
>The &kmix; Main Window</phrase
211
>The Window can have up to three sections with different soundcard controls: <guilabel
217
>. Those sections contain volume sliders, switches for enabling/disabling record or playback, and multiple-choice selectors. <simplelist>
221
>: This holds the controls that are most likely playback related, like the <guilabel
223
> volume control.</member>
227
>: This holds all controls that are most likely record related, like <guilabel
233
>: This holds all controls, that allows only to switch some functionality ON or OFF (like "Mic Boost (+20dB)"), and multiple-choice controls (like <guilabel
234
>Mic Select</guilabel
244
>Besides volumes controls, &kmix; also features LED's. The general coloring rule is:</para>
247
>Green: A LED dealing with playback</member>
249
>Red: A LED dealing with recording</member>
251
>Yellow: A LED dealing with special soundcard capabilities</member>
254
>These 3 colors come in two flavours: A lit LED means ON, a non-lit LED means OFF.</para>
257
<sect1 id="volume-sliders">
259
>Volume controls</title>
262
>The volume controls in section <guilabel
266
> consist of (top to bottom): <screenshot>
268
>Volume control (<guilabel
270
> Section)</screeninfo>
273
<imagedata fileref="kmix-channel-playback.png" format="PNG"/></imageobject>
276
>Volume control (<guilabel
285
>An icon, representing the function of the control.</member>
287
>A volume value indicator (optional).</member>
289
>A Green Mute LED, that allows you to mute a control (light goes off/gets dark) or unmute it again (light goes on/gets bright).</member>
291
>A slider, for volume control (Hint: You can hide the label on the slider, for example if the mixer takes too much of your screen space).</member>
293
>If a control supports recording, there will be a red Record LED. If the LED is lit (bright red), the control is selected for recording. If it is not lit (dark red), the control is NOT selected for recording.</member>
298
>Volume control with Recording Switch (<guilabel
300
> Section)</screeninfo>
303
<imagedata fileref="kmix-channel-record.png" format="PNG"/></imageobject>
306
>Volume control with Recording Switch (<guilabel
317
>Most of these controls have a context menu, accessible by right clicking on the control or device icon. Several entries are possible in the context menu, but only those applicable are shown. </para>
323
>Split Channels</guimenuitem
327
>Show either one or two sliders. This is only applicable to stereo devices. The right slider controls right side volume, and the left controls left side volume.</para
338
>Mute or unmute the device</para
349
>If you are not interested in regulating this device you can hide it with this option. If you want to show it again, you can only do this by selecting the <guimenuitem
350
>Channels</guimenuitem
351
> option (see below)</para
358
>Configure Global Shortcuts...</guimenuitem
362
>You can control a device with your keyboard. Use this menu option to show the &kde; <guilabel
363
>Configure Shortcuts</guilabel
364
> dialog. Here you can define keys for increasing and decreasing volume and for muting the device. The keys are global and operate also when &kmix; is iconified or docked.</para
371
>Channels</guimenuitem
375
>You will get a dialog box where you can configure per section (<guilabel
381
>), which channels you want to see.</para
388
>Show/Hide Menubar</guimenuitem
392
>This option is not device specific, but affects the mixer window. You can hide and show the menubar with this option. You can also do this by pressing the shortcut (usually <keycombo action="simul"
403
<sect1 id="switches">
405
>Switches and Multiple-Choice selectors</title>
408
>The controls in the section <guilabel
410
> consist of a LED and a short label describing the function. The <guilabel
412
> section can also contain Multiple-Choice selectors. Please note that these controls are often very special and usually don't need to be changed by the average user. The context menu contains the <guimenuitem
413
>Channels</guimenuitem
415
>Show/Hide Menubar</guimenuitem
416
> entries already described. <screenshot
418
>Switches and Multiple-Choice selectors (<guilabel
420
> Section)</screeninfo
423
> <imagedata fileref="kmix-channel-switches.png" format="PNG"/></imageobject
426
>Switches and Multiple-Choice selectors (<guilabel
432
> Please remember, red LED's are recording related, yellow LED's control special soundcard capabilities. The screenshot above shows from left to right an unlit <guilabel
433
>IEC958 Output</guilabel
434
> LED (yellow = special control), a lit <guilabel
436
> LED (red = Recording related), an unlit recording related LED, a lit special control and one multiple-choice selector (<guilabel
437
>PCM Out Path & Mute</guilabel
438
>). If you are uncertain about the meaning of a control, please ask your soundcard driver supplier (for most current &Linux; distributions this is <ulink url="http://www.alsa-project.org"
444
<sect1 id="panning-slider">
446
>Panning slider</title>
449
>With this slider you can control the volume distribution between left and right speaker. This slider is an overall regulator, which affects the Master Volume. The middle position is the default. Dragging the slider to the left lowers the volume of the right speaker, dragging it to the right vice versa. Of course, these might be swapped if your speakers aren't positioned correctly.</para>
451
>For Surround Systems please be aware that the <guilabel
453
> device often regulates only the Front Speakers. This is a limitation of your Soundcard driver.</para
456
>If your soundcard has no <guilabel
458
> device, some other device might get picked by &kmix; - for most people this is the <guilabel
466
<sect1 id="configuration-options">
468
>Configuration options</title>
475
>Configure &kmix;...</guimenuitem
477
> from the menubar to choose preferences. These items are:</para>
483
>Dock into panel</guilabel
487
>If checked, &kmix; will dock in the systray when pressing the window close button. If not checked, &kmix; will quit on pressing the window close button. Attention: After quitting you will not be able to control the volume if you have assigned keys for this.</para
493
>Enable system tray volume control</guilabel
497
>If enabled, a left-clicking the &kmix; dock icon will show a popup window with a volume control for the preferred device (Hint: currently you cannot change this device - it is selected by &kmix; instead). If the option is disabled, the &kmix; Main Window will be shown on a left-click on the &kmix; dock icon.</para
503
>Show tickmarks</guilabel
507
>Show lines to mark positions on the sliders.</para
513
>Show labels</guilabel
517
>Display labels for each of the sound devices. Wether this item is checked or not, by holding the mouse over the icon for each device, you can see this information.</para
523
>Restore volumes on login</guilabel
527
>Let &kde; restore the volumes when you Login: This restores your personal volume levels, stored when you last logged out. If your Operating System saves the volume levels, you might not need this option (but on a computer with multiple users it is still needed).</para
533
>Volume Values:</guilabel
537
>Select if and how volume values are displayed: <guilabel
549
>Slider Orientation</guilabel
553
>With this option you can turn the &kmix; main window content by 90 degrees. Sliders, texts and everything else (if applicable) is rotated. There are some exclusions to this rule, most notably the menubar, the mixer selector (if shown at all), the panning slider and the multiple-choice selectors.</para
564
<chapter id="working-with-kmixapplet">
566
>The &kmix; panel applet</title>
569
>The &kmix; panel applet is an alternative interface to &kmix;. You can add it to the &kde; panel by selecting <guimenuitem
570
>Add Applet to Panel...</guimenuitem
573
> or context menu. Choose <guilabel
574
>Sound Mixer</guilabel
575
> and click the <guibutton
576
>Add to Panel</guibutton
577
> or double click <guilabel
578
>Sound Mixer</guilabel
582
>You can work with the &kmix; applet as described for the <link linkend="working-with-kmix"
584
> - including the context menu. Due to the limited space in the panel there are differences: <simplelist>
586
>No main menu available.</member>
588
>If you have multiple soundcards, you cannot change the selected mixer after the initial selection.</member>
590
>No dock icon. If you want to use the dock item you must additionally start &kmix; with <menuchoice
594
>Multimedia</guisubmenu
596
>&kmix; Sound Mixer</guimenuitem
600
>Icons only available when panel is big enough.</member>
602
>No device name labels available.</member>
604
>Configuration is done via panel menu - you can configure colors and slider direction there.</member>
606
>No automatic volume saving. If you want your volumes saved when you logout for later restauration, you must also start &kmix; from the K-Menu.</member>
613
<chapter id="advanced-kmix">
615
>Advanced &kmix; features</title>
619
>This chapter describes &kmix; functionality that is targeted at the experienced user. Most users will never have a need for this functionality, so you can safely skip this chapter</para
622
<sect1 id="dcop-overview">
624
>The &DCOP; Interface</title>
627
>Sometimes you want to do specialized things. Things like controlling the mixer from another application or muting the master device every day at 10pm. &kmix; has a &DCOP; interface that allows you to achieve much with minimal work. You can start a shell and type <userinput
631
> to start exploring the &kmix; &DCOP; interface. The &kmix; specific interfaces are:</para>
643
>Allows manipulating the first mixer. You can set volume levels, mute the device, change balance, retrieve the mixer name and much more. Type <userinput
645
>dcop kmix Mixer0</command
647
> if you want to explore all the features. There are more entries like <userinput
651
> in case multiple soundcards are installed.</para
659
>kmix-mainwindow#1</command
664
>The &GUI; window can be controlled with this command. You can hide and show the window, resize it and much more. Type <userinput
666
>dcop kmix kmix-mainwindow#1</command
668
> if you want to explore all the features.</para
676
<sect1 id="dcop-examples">
678
>&DCOP; Examples</title>
685
>dcop kmix kmix-mainwindow#1 hide</command
690
>Hides the &GUI; window. Use <userinput
692
>dcop kmix kmix-mainwindow#1 show</command
694
> or the dock icon to show it again.</para
702
>dcop kmix kmix-mainwindow#1 resize 1 1</command
707
>Resizes the &GUI; window to the smallest size possible. This is the size so that all sliders (and other &GUI; elements) will fit into the window.</para
715
>dcop kmix Mixer0 mixerName</command
720
>Tells the name of the first Mixer, for example <computeroutput
721
>Sound Fusion CS46xx</computeroutput
730
>dcop kmix Mixer1 setVolume 0 10</command
735
>Sets the volume on the second mixer, device 0 to 10 percent. Device 0 is often the master device, but not always. If you want to quiet down the (first) master device on your second soundcard, you can use <userinput
737
>dcop kmix Mixer1 setMasterVolume 0</command
745
>You can directly execute these commands from a shell that you started from inside &kde;. If you need to execute dcop commands from somewhere else, for example from a crontab script, you need to define the <envar
747
> environment variable (as seen in the first line of your <filename
748
>~/.DCOPserver_hostname_:0</filename
749
> file), for example:</para>
753
DCOPSERVER=`cat /home/yourhome/.DCOPserver_yourhostname_:0 | grep local`
755
dcop kmix Mixer0 setMasterVolume 0
759
<sect1 id="tips-and-tricks">
761
>Tips and Tricks</title>
764
>Using ALSA and OSS driver at the same time</title>
766
>&kmix; on &Linux; can use either the ALSA driver or the OSS driver, not both. If you really need to use both drivers at the same time (a very rare situation), you can do it as follows: Quit &kmix; and add the following line to your <filename
768
> file in the global configuration section.</para>
770
>MultiDriver=true</programlisting>
772
>Start &kmix; again. If you click <menuchoice
776
>Hardware Information</guimenuitem
778
> you should see <guilabel
779
>Sound drivers used: ALSA0.9 + OSS</guilabel
781
>Experimental multiple-Driver mode activated</guilabel
786
>You will probably see all of your mixers doubled.</para>
788
>There is no support for this kind of configuration.</para
474
796
<chapter id="credits">