• Home
  • History
  • Annotate
  • current directory
Name Date Size #Lines LOC

..16-Aug-2019-

build-aux/H25-Sep-2012-

doc/H16-Aug-2019-

gtkdoc/H16-Aug-2019-

m4/H25-Sep-2012-

src/H16-Aug-2019-

vala/H25-Sep-2012-

LGPLH A D10-Jun-200825.9 KiB511422

Makefile.amH A D15-May-20121.9 KiB7238

Makefile.inH A D16-Aug-201932.5 KiB1,009891

READMEH A D25-Sep-201210.3 KiB293208

acinclude.m4H A D10-Jun-200813.7 KiB389347

aclocal.m4H A D25-Sep-201247.1 KiB1,3581,225

autogen.shH A D15-May-20121.9 KiB6135

config.h.inH A D25-Sep-20126.2 KiB263185

configureH A D16-Aug-2019688.2 KiB23,37119,661

configure.acH A D25-Sep-201221.7 KiB854712

libcanberra-gtk.pc.inH A D25-Sep-2012291 1210

libcanberra-gtk3.pc.inH A D25-Sep-2012294 1210

libcanberra.pc.inH A D23-Feb-2011244 1210

README

1                                libcanberra 0.30
2
3   Copyright 2008-2012 Lennart Poettering <mzyvopnaoreen (at) 0pointer
4   (dot) de>
5     * [1]License
6     * [2]News
7     * [3]Overview
8     * [4]Current Status
9     * [5]Documentation
10     * [6]Requirements
11     * [7]Installation
12     * [8]Acknowledgements
13     * [9]Download
14
15License
16
17   This program is free software; you can redistribute it and/or modify it
18   under the terms of the GNU Lesser General Public License as published
19   by the Free Software Foundation, either version 2.1 of the License, or
20   (at your option) any later version.
21
22   This program is distributed in the hope that it will be useful, but
23   WITHOUT ANY WARRANTY; without even the implied warranty of
24   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
25   General Public License for more details.
26
27News
28
29   Tue 25 Sep 2012:
30
31   [10]Version 0.30 released; Port to GStreamer 1.0.
32
33   Tue 15 May 2012:
34
35   [11]Version 0.29 released; A couple of bugfixes, drop GConf usage.
36
37   Thu 24 Feb 2011:
38
39   [12]Version 0.28 released; Hook properly into GNOME 3.0 sessions; this
40   drops support for GNOME 2.0 sessions, but not applications.
41
42   Fri 18 Feb 2011:
43
44   [13]Version 0.27 released; Gtk+ 3.x fixes; add new tool to implement
45   boot-up sounds when used with systemd; other fixes
46
47   Mon 4 Oct 2010:
48
49   [14]Version 0.26 released; Gtk+ 3.x fixes.
50
51   Sun 13 Jun 2010:
52
53   [15]Version 0.25 released; Optionally build with Gtk+ 3.x in addition
54   to Gtk+ 2.x.
55
56   Mon 19 Apr 2010:
57
58   [16]Version 0.24 released; GTK code is now fine with GSEAL. Minor fixes
59   in the PulseAudio backend, other fixes.
60
61   Sat 20 Feb 2010:
62
63   [17]Version 0.23 released; various minor fixes in the pulse and
64   gstreamer backends as well in the Vala API. Support for the recently
65   standardized Vorbis 6.1/7.1 multichannel modes.
66
67   Tue 20 Oct 2009:
68
69   [18]Version 0.22 released; small fix to make sure we don't dereference
70   a null pointer.
71
72   Fri 16 Oct 2009:
73
74   [19]Version 0.21 released; suppress casting warning
75
76   Thu 15 Oct 2009:
77
78   [20]Version 0.20 released; minor casting fix
79
80   Wed 14 Oct 2009:
81
82   [21]Version 0.19 released; some important fixes for the Gtk support
83
84   Sun 20 Sep 2009:
85
86   [22]Version 0.18 released; numerous updates for the Gtk support
87
88   Fri 12 Sep 2009:
89
90   [23]Version 0.17 released; add vala vapi file; numerous updates to Gtk
91   support
92
93   Thu 27 Aug 2009:
94
95   [24]Version 0.16 released; add new ca_context_playing() call
96
97   Wed 5 Aug 2009:
98
99   [25]Version 0.15 released; bug fixes
100
101   Thu 2 Jul 2009:
102
103   [26]Version 0.14 released; bug fixes
104
105   Tue 23 Jun 2009:
106
107   [27]Version 0.13 released; multichannel support; gtk multihead support;
108   bug fixes
109
110   Mon 13 Apr 2009:
111
112   [28]Version 0.12 released; changes include: various fixes and updates
113   for the PulseAudio backend; detect forks and return an error for all
114   functions in that case
115
116   Wed 21 Jan 2009:
117
118   [29]Version 0.11 released; changes include: major GStreamer backend
119   fixes; update to libtool 2.2; a few other fixes
120
121   Mon 6 Oct 2008:
122
123   [30]Version 0.10 released; changes include: install Gtk+ module using
124   GConf; a few other fixes
125
126   Tue 9 Sep 2008:
127
128   [31]Version 0.9 released; changes include: GStreamer fixes, include
129   (optional) libtdb based lookup cache.
130
131   Thu 28 Aug 2008:
132
133   [32]Version 0.8 released; changes include: new OSS and GStreamer
134   backend; portability fixes for FreeBSD/Solaris; the multi backend works
135   now
136
137   Thu 14 Aug 2008:
138
139   [33]Version 0.7 released; changes include: documentation updates;
140   various bug fixes; add this web site/README; allow playback of event
141   sounds with only a sound file path specified; other changes
142
143Overview
144
145   libcanberra is an implementation of the [34]XDG Sound Theme and Name
146   Specifications, for generating event sounds on free desktops, such as
147   [35]GNOME. It comes with several backends ([36]ALSA, [37]PulseAudio,
148   OSS, [38]GStreamer, null) and is designed to be portable. It consists
149   of the following parts:
150    1. libcanberra: the main library
151    2. libcanberra-gtk: some glue code to make it easier to use
152       libcanberra from Gtk+ applications
153    3. libcanberra-gtk-module: a Gtk+ module that uses libcanberra-gtk to
154       trigger input feedback event sounds
155
156   For more information see [39]the original announcement.
157
158Current Status
159
160   libcanberra is mostly feature complete. For now however it includes
161   backends only for ALSA, PulseAudio, OSS and GStreamer.
162
163   libcanberra has been declared [40]a blessed GNOME dependency.
164
165   The OSS driver is incomplete: only sound files that are in a format
166   natively understood by the sound card are supported. If the sample
167   type, channel map or sampling rate of the sound file are not supported
168   by the sound card no automatic conversion will take place and the file
169   will not be played. Also note that the OSS backend is most likely
170   incompatible with OSS4, due to subtle incompatibilities between OSS4
171   and the OSS 3.x.
172
173   It is recommended to always take the "shortest" path from libcanberra
174   to the audio device. I.e. don't use the GStreamer plugin if libcanberra
175   supports the final output target natively. Besides being more
176   resource-friendly and less error-prone, some advanced functionality
177   might get lost with each layer you add to your stack. For example:
178   while you could use libcanberra's Gstreamer backend to output to a
179   PulseAudio server this will not be able to make use of sample cacheing
180   or will be able to attach additional meta data to the sounds played,
181   which might be necessary for effects like positional event sounds.
182
183Documentation
184
185   You may browse the [41]gtkdoc generated [42]programing documentation of
186   the API.
187
188Requirements
189
190   Currently, libcanberra is tested on Linux only.
191
192   libcanberra was developed and tested on Fedora Rawhide from August
193   2008, it should work on most other Linux distributions (and maybe Unix
194   versions) since it uses GNU autoconf and GNU libtool for source code
195   configuration and shared library management.
196
197   libcanberra has no dependencies besides the OGG Vorbis development
198   headers and whatever the selected backends require. Gtk+ support is
199   optional. An optional lookup cache can be used if Samba's tdb trivial
200   database is available.
201
202Installation
203
204   As this package is made with the GNU autotools you should run
205   ./configure inside the distribution directory for configuring the
206   source tree. After that you should run make for compilation and make
207   install (as root) for installation of libcanberra.
208
209Acknowledgements
210
211   Marc-André Lureau and Brian Cameron for the GStreamer backend.
212
213   Joe Marcus Clarke for the OSS backend.
214
215   Diego Elio Pettenò for various build system fixes.
216
217Download
218
219   The newest release is always available from
220   [43]http://0pointer.de/lennart/projects/libcanberra/
221
222   The current release is [44]0.30
223
224   Get libcanberra's development sources from the [45]GIT [46]repository
225   ([47]gitweb):
226git clone git://git.0pointer.de/libcanberra
227
228   If you want to report bugs, have questions or want to be notified about
229   new releases, please join the [48]libcanberra-discuss mailing list.
230
231   If you want to be notified about new git commits, please join the
232   [49]libcanberra-commits mailing list.
233
234   libcanberra's bugs are tracked at [50]bugs.freedesktop.org.
235     __________________________________________________________________
236
237
238    Lennart Poettering <mzyvopnaoreen (at) 0pointer (dot) de>, September
239    2012
240
241References
242
243   1. README#license
244   2. README#news
245   3. README#overview
246   4. README#status
247   5. README#documentation
248   6. README#requirements
249   7. README#installation
250   8. README#acks
251   9. README#download
252  10. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.30.tar.xz
253  11. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.29.tar.xz
254  12. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.28.tar.gz
255  13. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.27.tar.gz
256  14. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.26.tar.gz
257  15. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.25.tar.gz
258  16. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.24.tar.gz
259  17. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.23.tar.gz
260  18. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.22.tar.gz
261  19. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.21.tar.gz
262  20. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.20.tar.gz
263  21. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.19.tar.gz
264  22. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.18.tar.gz
265  23. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.17.tar.gz
266  24. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.16.tar.gz
267  25. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.15.tar.gz
268  26. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.14.tar.gz
269  27. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.13.tar.gz
270  28. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.12.tar.gz
271  29. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.11.tar.gz
272  30. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.10.tar.gz
273  31. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.9.tar.gz
274  32. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.8.tar.gz
275  33. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.7.tar.gz
276  34. http://freedesktop.org/wiki/Specifications/sound-theme-spec
277  35. http://www.gnome.org/
278  36. http://alsa-project.org/
279  37. http://pulseaudio.org/
280  38. http://gstreamer.org/
281  39. http://0pointer.de/blog/projects/sixfold-announcement.html
282  40. http://mail.gnome.org/archives/devel-announce-list/2008-August/msg00001.html
283  41. http://www.gtk.org/gtk-doc/
284  42. http://0pointer.de/lennart/projects/libcanberra/gtkdoc/
285  43. http://0pointer.de/lennart/projects/libcanberra/
286  44. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.30.tar.xz
287  45. http://git-scm.com/
288  46. git://git.0pointer.de/libcanberra
289  47. http://git.0pointer.de/?p=libcanberra.git
290  48. https://tango.0pointer.de/mailman/listinfo/libcanberra-discuss/
291  49. https://tango.0pointer.de/mailman/listinfo/libcanberra-commits/
292  50. http://bugs.freedesktop.org/buglist.cgi?bug_status=__open__&product=libcanberra
293