view alsoftrc.sample @ 0:f9476ff7637e

initial forking of open-al to create multiple listeners
author Robert McIntyre <rlm@mit.edu>
date Tue, 25 Oct 2011 13:02:31 -0700
parents
children
line wrap: on
line source
1 # OpenAL config file. Options that are not under a block or are under the
2 # [general] block are for general, non-backend-specific options. Blocks may
3 # appear multiple times, and duplicated options will take the last value
4 # specified.
5 # The system-wide settings can be put in /etc/openal/alsoft.conf and user-
6 # specific override settings in ~/.alsoftrc.
7 # For Windows, these settings should go into %AppData%\alsoft.ini
8 # The environment variable ALSOFT_CONF can be used to specify another config
9 # override
11 # Option and block names are case-insenstive. The supplied values are only
12 # hints and may not be honored (though generally it'll try to get as close as
13 # possible). Note: options that are left unset may default to app- or system-
14 # specified values. These are the current available settings:
16 ## format:
17 # Sets the output format. Can be one of:
18 # AL_FORMAT_MONO8 (8-bit mono)
19 # AL_FORMAT_STEREO8 (8-bit stereo)
20 # AL_FORMAT_QUAD8 (8-bit 4-channel)
21 # AL_FORMAT_51CHN8 (8-bit 5.1 output)
22 # AL_FORMAT_61CHN8 (8-bit 6.1 output)
23 # AL_FORMAT_71CHN8 (8-bit 7.1 output)
24 # AL_FORMAT_MONO16 (16-bit mono)
25 # AL_FORMAT_STEREO16 (16-bit stereo)
26 # AL_FORMAT_QUAD16 (16-bit 4-channel)
27 # AL_FORMAT_51CHN16 (16-bit 5.1 output)
28 # AL_FORMAT_61CHN16 (16-bit 6.1 output)
29 # AL_FORMAT_71CHN16 (16-bit 7.1 output)
30 # AL_FORMAT_MONO32 (32-bit float mono)
31 # AL_FORMAT_STEREO32 (32-bit float stereo)
32 # AL_FORMAT_QUAD32 (32-bit float 4-channel)
33 # AL_FORMAT_51CHN32 (32-bit float 5.1 output)
34 # AL_FORMAT_61CHN32 (32-bit float 6.1 output)
35 # AL_FORMAT_71CHN32 (32-bit float 7.1 output)
36 #format = AL_FORMAT_STEREO16
38 ## hrtf:
39 # Enables HRTF filters. These filters provide for better sound spatialization
40 # while using headphones. The filters will only work when output is 44100hz
41 # stereo. While HRTF is active, the cf_level option is disabled. Default is
42 # disabled since stereo speaker output quality may suffer.
43 #hrtf = false
45 ## cf_level:
46 # Sets the crossfeed level for stereo output. Valid values are:
47 # 0 - No crossfeed
48 # 1 - Low crossfeed
49 # 2 - Middle crossfeed
50 # 3 - High crossfeed (virtual speakers are closer to itself)
51 # 4 - Low easy crossfeed
52 # 5 - Middle easy crossfeed
53 # 6 - High easy crossfeed
54 # Users of headphones may want to try various settings. Has no effect on non-
55 # stereo modes.
56 #cf_level = 0
58 ## frequency:
59 # Sets the output frequency.
60 #frequency = 44100
62 ## resampler:
63 # Selects the resampler used when mixing sources. Valid values are:
64 # 0 - None (nearest sample, no interpolation)
65 # 1 - Linear (extrapolates samples using a linear slope between samples)
66 # 2 - Cubic (extrapolates samples using a Catmull-Rom spline)
67 # Specifying other values will result in using the default (linear).
68 #resampler = 1
70 ## rt-prio:
71 # Sets real-time priority for the mixing thread. Not all drivers may use this
72 # (eg. PortAudio) as they already control the priority of the mixing thread.
73 # 0 and negative values will disable it. Note that this may constitute a
74 # security risk since a real-time priority thread can indefinitely block
75 # normal-priority threads if it fails to wait. As such, the default is
76 # disabled.
77 #rt-prio = 0
79 ## period_size:
80 # Sets the update period size, in frames. This is the number of frames needed
81 # for each mixing update.
82 #period_size = 1024
84 ## periods:
85 # Sets the number of update periods. Higher values create a larger mix ahead,
86 # which helps protect against skips when the CPU is under load, but increases
87 # the delay between a sound getting mixed and being heard.
88 #periods = 4
90 ## sources:
91 # Sets the maximum number of allocatable sources. Lower values may help for
92 # systems with apps that try to play more sounds than the CPU can handle.
93 #sources = 256
95 ## stereodup:
96 # Sets whether to duplicate stereo sounds behind the listener for 4+ channel
97 # output. This provides a "fuller" playback quality for surround sound output
98 # modes, although each individual speaker will have a slight reduction in
99 # volume to compensate for the extra output speakers. True, yes, on, and non-0
100 # values will duplicate stereo sources. 0 and anything else will cause stereo
101 # sounds to only play in front. This only has an effect when a suitable output
102 # format is used (ie. those that contain side and/or rear speakers).
103 #stereodup = true
105 ## drivers:
106 # Sets the backend driver list order, comma-seperated. Unknown backends and
107 # duplicated names are ignored. Unlisted backends won't be considered for use
108 # unless the list is ended with a comma (eg. 'oss,' will list OSS first
109 # followed by all other available backends, while 'oss' will list OSS only).
110 # Backends prepended with - won't be available for use (eg. '-oss,' will allow
111 # all available backends except OSS). An empty list means the default.
112 #drivers = pulse,alsa,core,oss,solaris,sndio,mmdevapi,dsound,winmm,port,opensl,null,wave
114 ## excludefx:
115 # Sets which effects to exclude, preventing apps from using them. This can
116 # help for apps that try to use effects which are too CPU intensive for the
117 # system to handle. Available effects are: eaxreverb,reverb,echo,modulator,
118 # dedicated
119 #excludefx =
121 ## slots:
122 # Sets the maximum number of Auxiliary Effect Slots an app can create. A slot
123 # can use a non-negligible amount of CPU time if an effect is set on it even
124 # if no sources are feeding it, so this may help when apps use more than the
125 # system can handle.
126 #slots = 4
128 ## sends:
129 # Sets the number of auxiliary sends per source. When not specified (default),
130 # it allows the app to request how many it wants. The maximum value currently
131 # possible is 4.
132 #sends =
134 ## layout:
135 # Sets the virtual speaker layout. Values are specified in degrees, where 0 is
136 # straight in front, negative goes left, and positive goes right. Unspecified
137 # speakers will remain at their default positions (which are dependant on the
138 # output format). Available speakers are back-left(bl), side-left(sl), front-
139 # left(fl), front-center(fc), front-right(fr), side-right(sr), back-right(br),
140 # and back-center(bc).
141 #layout =
143 ## layout_*:
144 # Channel-specific layouts may be specified to override the layout option. The
145 # same speakers as the layout option are available, and the default settings
146 # are shown below.
147 #layout_STEREO = fl=-90, fr=90
148 #layout_QUAD = fl=-45, fr=45, bl=-135, br=135
149 #layout_51CHN = fl=-30, fr=30, fc=0, bl=-110, br=110
150 #layout_61CHN = fl=-30, fr=30, fc=0, sl=-90, sr=90, bc=180
151 #layout_71CHN = fl=-30, fr=30, fc=0, sl=-90, sr=90, bl=-150, br=150
153 ##
154 ## Reverb effect stuff (includes EAX reverb)
155 ##
156 [reverb]
158 ## boost:
159 # A global amplification for reverb output, expressed in decibels. The value
160 # is logarithmic, so +6 will be a scale of (approximately) 2x, +12 will be a
161 # scale of 4x, etc. Similarly, -6 will be about half, and -12 about 1/4th. A
162 # value of 0 means no change.
163 #boost = 0
165 ## emulate-eax:
166 # Allows the standard reverb effect to be used in place of EAX reverb. EAX
167 # reverb processing is a bit more CPU intensive than standard, so this option
168 # allows a simpler effect to be used at the loss of some quality.
169 #emulate-eax = false
171 ##
172 ## ALSA backend stuff
173 ##
174 [alsa]
176 ## device:
177 # Sets the device name for the default playback device.
178 #device = default
180 ## device-prefix:
181 # Sets the prefix used by the discovered (non-default) playback devices. This
182 # will be appended with "CARD=c,DEV=d", where c is the card id and d is the
183 # device index for the requested device name.
184 #device-prefix = plughw:
186 ## capture:
187 # Sets the device name for the default capture device.
188 #capture = default
190 ## capture-prefix:
191 # Sets the prefix used by the discovered (non-default) capture devices. This
192 # will be appended with "CARD=c,DEV=d", where c is the card number and d is
193 # the device number for the requested device name.
194 #capture-prefix = plughw:
196 ## mmap:
197 # Sets whether to try using mmap mode (helps reduce latencies and CPU
198 # consumption). If mmap isn't available, it will automatically fall back to
199 # non-mmap mode. True, yes, on, and non-0 values will attempt to use mmap. 0
200 # and anything else will force mmap off.
201 #mmap = true
203 ##
204 ## OSS backend stuff
205 ##
206 [oss]
208 ## device:
209 # Sets the device name for OSS output.
210 #device = /dev/dsp
212 ## capture:
213 # Sets the device name for OSS capture.
214 #capture = /dev/dsp
216 ##
217 ## Solaris backend stuff
218 ##
219 [solaris]
221 ## device:
222 # Sets the device name for Solaris output.
223 #device = /dev/audio
225 ##
226 ## MMDevApi backend stuff
227 ##
228 [mmdevapi]
230 ##
231 ## DirectSound backend stuff
232 ##
233 [dsound]
235 ##
236 ## Windows Multimedia backend stuff
237 ##
238 [winmm]
240 ##
241 ## PortAudio backend stuff
242 ##
243 [port]
245 ## device:
246 # Sets the device index for output. Negative values will use the default as
247 # given by PortAudio itself.
248 #device = -1
250 ## capture:
251 # Sets the device index for capture. Negative values will use the default as
252 # given by PortAudio itself.
253 #capture = -1
255 ##
256 ## PulseAudio backend stuff
257 ##
258 [pulse]
260 ## spawn-server:
261 # Attempts to spawn a PulseAudio server when requesting to open a PulseAudio
262 # device. Note that some apps may open and probe all enumerated devices on
263 # startup, causing a server to spawn even if a PulseAudio device is not
264 # actually selected. Setting autospawn to false in Pulse's client.conf will
265 # still prevent autospawning even if this is set to true.
266 #spawn-server = false
268 ##
269 ## Wave File Writer stuff
270 ##
271 [wave]
273 ## file:
274 # Sets the filename of the wave file to write to. An empty name prevents the
275 # backend from opening, even when explicitly requested.
276 # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
277 #file =