Add reverb parameters
[openal-soft.git] / openalrc.sample
blob0e33e64818f35739cc31c75cbc0714428d05dc47
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. The system-wide settings can be put in /etc/openal/config and
5 # user-specific override settings in ~/.openalrc
7 # Option and block names are case-insenstive. The supplied values are only
8 # hints and may not be honored (though generally it'll try to get as close as
9 # possible). These are the current available settings:
11 format = AL_FORMAT_STEREO16  # Sets the output format. Can be one of:
12                              # AL_FORMAT_MONO8    (8-bit mono)
13                              # AL_FORMAT_STEREO8  (8-bit stereo)
14                              # AL_FORMAT_QUAD8    (8-bit 4-channel)
15                              # AL_FORMAT_51CHN8   (8-bit 5.1 output)
16                              # AL_FORMAT_61CHN8   (8-bit 6.1 output)
17                              # AL_FORMAT_71CHN8   (8-bit 7.1 output)
18                              # AL_FORMAT_MONO16   (16-bit mono)
19                              # AL_FORMAT_STEREO16 (16-bit stereo)
20                              # AL_FORMAT_QUAD16   (16-bit 4-channel)
21                              # AL_FORMAT_51CHN16  (16-bit 5.1 output)
22                              # AL_FORMAT_61CHN16  (16-bit 6.1 output)
23                              # AL_FORMAT_71CHN16  (16-bit 7.1 output)
24                              # Default is AL_FORMAT_STEREO16
26 cf_level = 0  # Sets the crossfeed level for stereo output. Valid values are:
27               # 0 - No crossfeed
28               # 1 - Low crossfeed
29               # 2 - Middle crossfeed
30               # 3 - High crossfeed (virtual speakers are closer to itself)
31               # 4 - Low easy crossfeed
32               # 5 - Middle easy crossfeed
33               # 6 - High easy crossfeed
34               # Default is 0. Users of headphones may want to try various
35               # settings. Has no effect on non-stereo modes.
37 frequency = 44100  # Sets the output frequency. Default is 44100
39 refresh = 0  # Sets the number of frames-per-update. Default is calculated as
40              # 8192*frequency/22050. Note that the actual granularity may or
41              # may not be less than this.
43 drivers =  # Sets the backend driver list order, comma-seperated. Unknown
44            # backends and duplicated names are ignored, and unlisted backends
45            # won't be considered for use. An empty list means the default.
46            # Default is:
47            # alsa,oss,dsound,winmm,wave
49 [alsa]  # ALSA backend stuff
50 device = default  # Sets the device name for the default playback device.
51                   # Default is default
53 periods = 4  # Sets the number of update buffers. Default is 4
55 capture = default  # Sets the device name for the default capture device.
56                    # Default is default
58 mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
59              # CPU consumption). If mmap isn't available, it will automatically
60              # fall back to non-mmap mode. True, yes, on, and non-0 values will
61              # attempt to use mmap. 0 and anything else will force mmap off.
62              # Default is true.
64 [oss]  # OSS backend stuff
65 device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
67 periods = 4  # Sets the number of update buffers. Default is 4
69 capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
71 [dsound]  # DirectSound backend stuff
72           # Nothing yet...
74 [winmm]  # Windows Multimedia backend stuff
75          # Nothing yet...
77 [wave]  # Wave File Writer stuff
78 file =  # Sets the filename of the wave file to write to. An empty name
79         # prevents the backend from opening, even when explicitly requested.
80         # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
81         # Default is empty