~ubuntu-branches/ubuntu/jaunty/openal-soft/jaunty

« back to all changes in this revision

Viewing changes to alsoftrc.sample

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2008-06-07 17:44:48 UTC
  • Revision ID: james.westby@ubuntu.com-20080607174448-fmamd83uujnkhutw
Tags: upstream-1.3.253
ImportĀ upstreamĀ versionĀ 1.3.253

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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
 
 
8
# Option and block names are case-insenstive. The supplied values are only
 
9
# hints and may not be honored (though generally it'll try to get as close as
 
10
# possible). These are the current available settings:
 
11
 
 
12
format = AL_FORMAT_STEREO16  # Sets the output format. Can be one of:
 
13
                             # AL_FORMAT_MONO8    (8-bit mono)
 
14
                             # AL_FORMAT_STEREO8  (8-bit stereo)
 
15
                             # AL_FORMAT_QUAD8    (8-bit 4-channel)
 
16
                             # AL_FORMAT_51CHN8   (8-bit 5.1 output)
 
17
                             # AL_FORMAT_61CHN8   (8-bit 6.1 output)
 
18
                             # AL_FORMAT_71CHN8   (8-bit 7.1 output)
 
19
                             # AL_FORMAT_MONO16   (16-bit mono)
 
20
                             # AL_FORMAT_STEREO16 (16-bit stereo)
 
21
                             # AL_FORMAT_QUAD16   (16-bit 4-channel)
 
22
                             # AL_FORMAT_51CHN16  (16-bit 5.1 output)
 
23
                             # AL_FORMAT_61CHN16  (16-bit 6.1 output)
 
24
                             # AL_FORMAT_71CHN16  (16-bit 7.1 output)
 
25
                             # Default is AL_FORMAT_STEREO16
 
26
 
 
27
cf_level = 0  # Sets the crossfeed level for stereo output. Valid values are:
 
28
              # 0 - No crossfeed
 
29
              # 1 - Low crossfeed
 
30
              # 2 - Middle crossfeed
 
31
              # 3 - High crossfeed (virtual speakers are closer to itself)
 
32
              # 4 - Low easy crossfeed
 
33
              # 5 - Middle easy crossfeed
 
34
              # 6 - High easy crossfeed
 
35
              # Default is 0. Users of headphones may want to try various
 
36
              # settings. Has no effect on non-stereo modes.
 
37
 
 
38
frequency = 44100  # Sets the output frequency. Default is 44100
 
39
 
 
40
refresh = 8192  # Sets the buffer size, in frames. Default is 8192. Note that
 
41
                # the actual granularity may or may not be less than this.
 
42
 
 
43
sources = 256  # Sets the maximum number of allocatable sources. Lower values
 
44
               # may help for systems with apps that try to play more sounds
 
45
               # than the CPU can handle. Default is 256
 
46
 
 
47
stereodup =  # Sets whether to duplicate stereo sounds on the rear speakers for
 
48
             # 4+ channel output. This can make stereo sources substantially
 
49
             # louder than mono or even 4+ channel sources, but provides a
 
50
             # "fuller" playback quality. True, yes, on, and non-0 values will
 
51
             # duplicate stereo sources. 0 and anything else will cause stereo
 
52
             # sounds to only play out the front speakers.
 
53
             # Default is false
 
54
 
 
55
drivers =  # Sets the backend driver list order, comma-seperated. Unknown
 
56
           # backends and duplicated names are ignored, and unlisted backends
 
57
           # won't be considered for use. An empty list means the default.
 
58
           # Default is:
 
59
           # alsa,oss,dsound,winmm,wave
 
60
 
 
61
[alsa]  # ALSA backend stuff
 
62
device = default  # Sets the device name for the default playback device.
 
63
                  # Default is default
 
64
 
 
65
periods = 0  # Sets the number of update buffers for playback. A value of 0
 
66
             # means auto-select. Default is 0
 
67
 
 
68
capture = default  # Sets the device name for the default capture device.
 
69
                   # Default is default
 
70
 
 
71
mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
 
72
             # CPU consumption). If mmap isn't available, it will automatically
 
73
             # fall back to non-mmap mode. True, yes, on, and non-0 values will
 
74
             # attempt to use mmap. 0 and anything else will force mmap off.
 
75
             # Default is true.
 
76
 
 
77
[oss]  # OSS backend stuff
 
78
device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
 
79
 
 
80
periods = 4  # Sets the number of update buffers. Default is 4
 
81
 
 
82
capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
 
83
 
 
84
[dsound]  # DirectSound backend stuff
 
85
          # Nothing yet...
 
86
 
 
87
[winmm]  # Windows Multimedia backend stuff
 
88
         # Nothing yet...
 
89
 
 
90
[wave]  # Wave File Writer stuff
 
91
file =  # Sets the filename of the wave file to write to. An empty name
 
92
        # prevents the backend from opening, even when explicitly requested.
 
93
        # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
 
94
        # Default is empty