mirror of
https://bitbucket.org/smil3y/kde-extraapps.git
synced 2025-02-24 10:52:53 +00:00
77 lines
3.5 KiB
XML
77 lines
3.5 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
|
|
<soundcard driver="ALSA"
|
|
version="*:*"
|
|
name="*"
|
|
type="*"
|
|
generation="2"
|
|
id="default"
|
|
>
|
|
<!-- Example from above:
|
|
Driver : ALSA, Versions 1.2.5 and newer.
|
|
name : Card name, e.g. with the Hercules 7.1 card the name is "Sound Fusion CS46xx"
|
|
type : Chip type. ALSA says: "Cirrus Logic CS4294 rev 5,Cirrus Logic CS4294 rev 5,Cirrus Logic CS4294 rev 5"
|
|
generation : The "version" of this XML file. If you create an updated version of this XML file,
|
|
"generation" must be incremented.
|
|
-->
|
|
|
|
<!-- The products below are for letting the user select the correct product name.
|
|
It could be implemented like this:
|
|
If a new GUIProfile gets selected (either implictly on the first run or a Profile update, or
|
|
explicitly by the user), prompt the user for the card name.
|
|
Hint: The product stuff is only used in the GUI. It is NOT refeferenced otherwise in the code,
|
|
and especially nothing of it is used as primary key.
|
|
-->
|
|
<product vendor="Any Vendor" name="Generic Soundcard" />
|
|
|
|
<!--
|
|
Control definitions:
|
|
********************
|
|
|
|
- 'id' is the controls' primary key as defined by the KMix driver backend.
|
|
This can either be a name or an id, complemeted by an optional index.
|
|
(this is "control_name:index" or "control_id:index" or "control_id")
|
|
- 'name' defines what name is shown to the user. (DEFAULT: Name as returned by the driver backend).
|
|
If defined at all, you should use english text, to allow i18n(). i18n() will be introduced
|
|
in later versions of KMix, and the translations should then
|
|
be "outsourced", as every driver tends to have a limited (and well defined) set of
|
|
control names. This is also true for ALSA, but there we must ALWAYS be prepared for
|
|
new control names.
|
|
- 'controls' is an enumeration of the (sub)controls of this control, e.g "playvol:1" or
|
|
"recvol:1-2,4-6" or "2:*,playswitch,recswitch" or ...
|
|
DEFAULT: "*,switches" (* = recvol:* playvol:* switches=playswitch recswitch genericswitch
|
|
- 'show' defines, on which GUI types the control will be shown.
|
|
simple = Show on the simple GUI (typically only 1 Tab: Master, PCM, CDROM, Microphone)
|
|
extended = Show on the mildly more complex GUI (all "simple" controls plus Recording & Surround stuff).
|
|
full = Show (only) on the full GUI (all controls)
|
|
default is "full"
|
|
- 'mandatory' If set to "true", this entry will be included in all normal copies (useful for catch-all controls like "^.*$").
|
|
-->
|
|
|
|
|
|
<!-- Please note that when an ALSA is labeled as "Master", it is actually "Front".
|
|
In rare cases ALSA has a real device that is called "Front" (like on HDA_Nvidia)
|
|
Thus we use both here. -->
|
|
<control id="^Master:0$" show="simple" />
|
|
<control id="^Front:0$" show="simple" />
|
|
<control id="^Surround:0$" show="simple"/>
|
|
<control id="^Center:0$" show="simple"/>
|
|
<control id="^LFE:0$" show="simple"/>
|
|
<control id="^PCM:0$" show="simple"/>
|
|
<control id="^CD:0$" show="simple"/>
|
|
<control id="^Headphone:0$" show="simple"/>
|
|
<control id="^Mic.*:0$" show="simple"/>
|
|
<!-- We show ADC and DAC, as they control the actual "output sockets" -->
|
|
<control id="^DAC:0$" show="simple"/>
|
|
<control id="^ADC:0$" show="simple"/>
|
|
|
|
<!-- This is an example how to rename controls
|
|
<control id="^Master:0$" tab="Base" name="Front" show="simple" />
|
|
-->
|
|
|
|
<control id="^.*$" tab="Base" show="extended" mandatory="true" />
|
|
|
|
|
|
</soundcard>
|
|
|
|
|