Updated openal-soft to version 1.15.1

2026-08-19 12:14:49 +02:00 · 2014-01-30 10:19:28 +01:00
parent 33d979caf6
commit f0fa37f4ad
164 changed files with 38848 additions and 21244 deletions
@@ -5,35 +5,36 @@
 # The system-wide settings can be put in /etc/openal/alsoft.conf and user-
 # specific override settings in ~/.alsoftrc.
 # For Windows, these settings should go into %AppData%\alsoft.ini
-# The environment variable ALSOFT_CONF can be used to specify another config
-# override

 # Option and block names are case-insenstive. The supplied values are only
 # hints and may not be honored (though generally it'll try to get as close as
 # possible). Note: options that are left unset may default to app- or system-
 # specified values. These are the current available settings:

-## format:
-#  Sets the output format. Can be one of:
-#  AL_FORMAT_MONO8    (8-bit mono)
-#  AL_FORMAT_STEREO8  (8-bit stereo)
-#  AL_FORMAT_QUAD8    (8-bit 4-channel)
-#  AL_FORMAT_51CHN8   (8-bit 5.1 output)
-#  AL_FORMAT_61CHN8   (8-bit 6.1 output)
-#  AL_FORMAT_71CHN8   (8-bit 7.1 output)
-#  AL_FORMAT_MONO16   (16-bit mono)
-#  AL_FORMAT_STEREO16 (16-bit stereo)
-#  AL_FORMAT_QUAD16   (16-bit 4-channel)
-#  AL_FORMAT_51CHN16  (16-bit 5.1 output)
-#  AL_FORMAT_61CHN16  (16-bit 6.1 output)
-#  AL_FORMAT_71CHN16  (16-bit 7.1 output)
-#  AL_FORMAT_MONO32   (32-bit float mono)
-#  AL_FORMAT_STEREO32 (32-bit float stereo)
-#  AL_FORMAT_QUAD32   (32-bit float 4-channel)
-#  AL_FORMAT_51CHN32  (32-bit float 5.1 output)
-#  AL_FORMAT_61CHN32  (32-bit float 6.1 output)
-#  AL_FORMAT_71CHN32  (32-bit float 7.1 output)
-#format = AL_FORMAT_STEREO16
+## disable-cpu-exts:
+#  Disables use of the listed CPU extensions. Certain methods may utilize CPU
+#  extensions when detected, and this option is useful for preventing those
+#  extensions from being used. The available extensions are: sse, sse2, neon.
+#  Specifying 'all' disables use of all extensions.
+#disable-cpu-exts =
+
+## channels:
+#  Sets the output channel configuration. If left unspecified, one will try to
+#  be detected from the system, and defaulting to stereo. The available values
+#  are: mono, stereo, quad, surround51, surround61, surround71
+#channels = stereo
+
+## sample-type:
+#  Sets the output sample type. Currently, all mixing is done with 32-bit float
+#  and converted to the output sample type as needed. Available values are:
+#  int8    - signed 8-bit int
+#  uint8   - unsigned 8-bit int
+#  int16   - signed 16-bit int
+#  uint16  - unsigned 16-bit int
+#  int32   - signed 32-bit int
+#  uint32  - unsigned 32-bit int
+#  float32 - 32-bit float
+#sample-type = float32

 ## hrtf:
 #  Enables HRTF filters. These filters provide for better sound spatialization
@@ -42,6 +43,18 @@
 #  Default is disabled since stereo speaker output quality may suffer.
 #hrtf = false

+## hrtf_tables
+#  Specifies a comma-separated list of files containing HRTF data sets. The
+#  listed data sets can be used in place of or in addiiton to the the built-in
+#  set. The format of the files are described in hrtf.txt. The filenames may
+#  contain these markers, which will be replaced as needed:
+#  %r - Device sampling rate
+#  %% - Percent sign (%)
+#  So if this is set to "kemar-%r-diffuse.mhr", it will try to open
+#  "kemar-44100-diffuse.mhr" if the device is using 44100hz output, or
+#  "kemar-48000-diffuse.mhr" if the device is using 48000hz output, etc.
+#hrtf_tables =
+
 ## cf_level:
 #  Sets the crossfeed level for stereo output. Valid values are:
 #  0 - No crossfeed
@@ -55,17 +68,25 @@
 #  stereo modes.
 #cf_level = 0

+## wide-stereo:
+#  Specifies that stereo sources are given a width of about 120 degrees on each
+#  channel, centering on -90 (left) and +90 (right), as opposed to being points
+#  placed at -30 (left) and +30 (right). This can be useful for surround-sound
+#  to give stereo sources a more encompassing sound. Note that the sound's
+#  overall volume will be slightly reduced to account for the extra output.
+#wide-stereo = false
+
 ## frequency:
 #  Sets the output frequency.
 #frequency = 44100

 ## resampler:
 #  Selects the resampler used when mixing sources. Valid values are:
-#  0 - None (nearest sample, no interpolation)
-#  1 - Linear (extrapolates samples using a linear slope between samples)
-#  2 - Cubic (extrapolates samples using a Catmull-Rom spline)
+#  point - nearest sample, no interpolation
+#  linear - extrapolates samples using a linear slope between samples
+#  cubic - extrapolates samples using a Catmull-Rom spline
 #  Specifying other values will result in using the default (linear).
-#resampler = 1
+#resampler = linear

 ## rt-prio:
 #  Sets real-time priority for the mixing thread. Not all drivers may use this
@@ -78,13 +99,14 @@

 ## period_size:
 #  Sets the update period size, in frames. This is the number of frames needed
-#  for each mixing update.
+#  for each mixing update. Acceptable values range between 64 and 8192.
 #period_size = 1024

 ## periods:
 #  Sets the number of update periods. Higher values create a larger mix ahead,
 #  which helps protect against skips when the CPU is under load, but increases
-#  the delay between a sound getting mixed and being heard.
+#  the delay between a sound getting mixed and being heard. Acceptable values
+#  range between 2 and 16.
 #periods = 4

 ## sources:
@@ -92,16 +114,6 @@
 #  systems with apps that try to play more sounds than the CPU can handle.
 #sources = 256

-## stereodup:
-#  Sets whether to duplicate stereo sounds behind the listener for 4+ channel
-#  output. This provides a "fuller" playback quality for surround sound output
-#  modes, although each individual speaker will have a slight reduction in
-#  volume to compensate for the extra output speakers. True, yes, on, and non-0
-#  values will duplicate stereo sources. 0 and anything else will cause stereo
-#  sounds to only play in front. This only has an effect when a suitable output
-#  format is used (ie. those that contain side and/or rear speakers).
-#stereodup = true
-
 ## drivers:
 #  Sets the backend driver list order, comma-seperated. Unknown backends and
 #  duplicated names are ignored. Unlisted backends won't be considered for use
@@ -109,13 +121,13 @@
 #  followed by all other available backends, while 'oss' will list OSS only).
 #  Backends prepended with - won't be available for use (eg. '-oss,' will allow
 #  all available backends except OSS). An empty list means the default.
-#drivers = pulse,alsa,core,oss,solaris,sndio,mmdevapi,dsound,winmm,port,opensl,null,wave
+#drivers = pulse,alsa,core,oss,solaris,sndio,qsa,mmdevapi,dsound,winmm,port,opensl,null,wave

 ## excludefx:
 #  Sets which effects to exclude, preventing apps from using them. This can
 #  help for apps that try to use effects which are too CPU intensive for the
-#  system to handle. Available effects are: eaxreverb,reverb,echo,modulator,
-#  dedicated
+#  system to handle. Available effects are: eaxreverb,reverb,autowah,chorus,
+#  compressor,distortion,echo,equalizer,flanger,modulator,dedicated
 #excludefx =

 ## slots:
@@ -144,28 +156,50 @@
 #  Channel-specific layouts may be specified to override the layout option. The
 #  same speakers as the layout option are available, and the default settings
 #  are shown below.
-#layout_STEREO = fl=-90, fr=90
-#layout_QUAD   = fl=-45, fr=45, bl=-135, br=135
-#layout_51CHN  = fl=-30, fr=30, fc=0, bl=-110, br=110
-#layout_61CHN  = fl=-30, fr=30, fc=0, sl=-90, sr=90, bc=180
-#layout_71CHN  = fl=-30, fr=30, fc=0, sl=-90, sr=90, bl=-150, br=150
+#layout_stereo     = fl=-90, fr=90
+#layout_quad       = fl=-45, fr=45, bl=-135, br=135
+#layout_surround51 = fl=-30, fr=30, fc=0, bl=-110, br=110
+#layout_surround61 = fl=-30, fr=30, fc=0, sl=-90, sr=90, bc=180
+#layout_surround71 = fl=-30, fr=30, fc=0, sl=-90, sr=90, bl=-150, br=150
+
+## default-reverb:
+#  A reverb preset that applies by default to all sources on send 0
+#  (applications that set their own slots on send 0 will override this).
+#  Available presets are: None, Generic, PaddedCell, Room, Bathroom,
+#  Livingroom, Stoneroom, Auditorium, ConcertHall, Cave, Arena, Hangar,
+#  CarpetedHallway, Hallway, StoneCorridor, Alley, Forest, City, Moutains,
+#  Quarry, Plain, ParkingLot, SewerPipe, Underwater, Drugged, Dizzy, Psychotic.
+#default-reverb =

 ## trap-alc-error:
 #  Generates a SIGTRAP signal when an ALC device error is generated, on systems
 #  that support it. This helps when debugging, while trying to find the cause
 #  of a device error. On Windows, a breakpoint exception is generated.
-#  Optionally, the __ALSOFT_TRAP_ALC_ERROR env var may be set before running
-#  the app instead.
 #trap-alc-error = false

 ## trap-al-error:
 #  Generates a SIGTRAP signal when an AL context error is generated, on systems
 #  that support it. This helps when debugging, while trying to find the cause
 #  of a context error. On Windows, a breakpoint exception is generated.
-#  Optionally, the __ALSOFT_TRAP_AL_ERROR env var may be set before running the
-#  app instead.
 #trap-al-error = false

+##
+## MIDI stuff (EXPERIMENTAL)
+##
+[midi]
+
+## soundfont:
+#  A default soundfont (sf2 format). Used when an app requests the system
+#  default.
+#soundfont =
+
+## volume:
+#  Additional attenuation applied to MIDI output, expressed in decibels. This
+#  is used to help keep the mix from clipping, and so must be 0 or less. The
+#  value is logarithmic, so -6 will be about half amplitude, and -12 about
+#  1/4th. The default is roughly -13.9794 (0.2, or 1/5th).
+#volume =
+
 ##
 ## Reverb effect stuff (includes EAX reverb)
 ##
@@ -184,6 +218,24 @@
 #  allows a simpler effect to be used at the loss of some quality.
 #emulate-eax = false

+##
+## PulseAudio backend stuff
+##
+[pulse]
+
+## spawn-server:
+#  Attempts to autospawn a PulseAudio server whenever needed (initializing the
+#  backend, enumerating devices, etc). Setting autospawn to false in Pulse's
+#  client.conf will still prevent autospawning even if this is set to true.
+#spawn-server = true
+
+## allow-moves:
+#  Allows PulseAudio to move active streams to different devices. Note that the
+#  device specifier (seen by applications) will not be updated when this
+#  occurs, and neither will the AL device configuration (sample rate, format,
+#  etc).
+#allow-moves = false
+
 ##
 ## ALSA backend stuff
 ##
@@ -199,16 +251,30 @@
 #  device index for the requested device name.
 #device-prefix = plughw:

+## device-prefix-*:
+#  Card- and device-specific prefixes may be used to override the device-prefix
+#  option. The option may specify the card id (eg, device-prefix-NVidia), or
+#  the card id and device index (eg, device-prefix-NVidia-0). The card id is
+#  case-sensitive.
+#device-prefix- =
+
 ## capture:
 #  Sets the device name for the default capture device.
 #capture = default

 ## capture-prefix:
 #  Sets the prefix used by the discovered (non-default) capture devices. This
-#  will be appended with "CARD=c,DEV=d", where c is the card number and d is
-#  the device number for the requested device name.
+#  will be appended with "CARD=c,DEV=d", where c is the card id and d is the
+#  device number for the requested device name.
 #capture-prefix = plughw:

+## capture-prefix-*:
+#  Card- and device-specific prefixes may be used to override the
+#  capture-prefix option. The option may specify the card id (eg,
+#  capture-prefix-NVidia), or the card id and device index (eg,
+#  capture-prefix-NVidia-0). The card id is case-sensitive.
+#capture-prefix- =
+
 ## mmap:
 #  Sets whether to try using mmap mode (helps reduce latencies and CPU
 #  consumption). If mmap isn't available, it will automatically fall back to
@@ -238,6 +304,19 @@
 #  Sets the device name for Solaris output.
 #device = /dev/audio

+##
+## QSA backend stuff
+##
+[qsa]
+
+## device:
+#  Sets the device name for the default playback device.
+#device = default
+
+## capture:
+#  Sets the device name for the default capture device.
+#capture = default
+
 ##
 ## MMDevApi backend stuff
 ##
@@ -268,19 +347,6 @@
 #  given by PortAudio itself.
 #capture = -1

-##
-## PulseAudio backend stuff
-##
-[pulse]
-
-## spawn-server:
-#  Attempts to spawn a PulseAudio server when requesting to open a PulseAudio
-#  device. Note that some apps may open and probe all enumerated devices on
-#  startup, causing a server to spawn even if a PulseAudio device is not
-#  actually selected. Setting autospawn to false in Pulse's client.conf will
-#  still prevent autospawning even if this is set to true.
-#spawn-server = false
-
 ##
 ## Wave File Writer stuff
 ##