annotate acconfig.h @ 474:c66080364dff

Most decoders now report total sample play time, now. Technically, this breaks binary compatibility with the 1.0 branch, since it extends the Sound_Sample struct, but most (all?) programs are just passing pointers allocated by SDL_sound around, and might be okay. Source-level compatibility is not broken...yet! :) --ryan. -------- Original Message -------- Subject: SDL_sound patch: Finding total length of time of sound file. Date: Sun, 26 Jan 2003 09:31:17 -0800 (PST) Hi Ryan, I am working with Eric Wing and helping him modify SDL_sound. AS part of our efforts in improving and enhancing SDL_sound, we like to submit this patch. We modified the codecs to find the total time of a sound file. Below is the explanation of the patch. The patch is appended as an attachment to this email. * MOTIVATION: We needed the ability to get the total play time of a sample (And we noticed that we're not the only ones). Since SDL_sound blocks direct access to the specific decoders, there is no way for a user to know this information short of decoding the whole thing. Because of this, we believe this will be a useful addition, even though the accuracy may not be perfect (subject to each decoder) or the information may not always be available. * CONTRIBUTORS: Wesley Leong (modified the majority of the codecs and verified the results) Eric Wing (showed everyone how to do modify codec, modified mikmod) Wang Lam (modified a handful of codecs, researched into specs and int overflow) Ahilan Anantha (modified a few codecs and helped with integer math) * GENERAL ISSUES: We chose the value to be milliseconds as an Sint32. Milliseconds because that's what Sound_Seek takes as a parameter and -1 to allow for instances/codecs where the value could not be determined. We are not sure if this is the final convention you want, so we are willing to work with you on this. We also expect the total_time field to be set on open and never again modified by SDL_sound. Users may access it directly much like the sample buffer and buffer_size. We thought about recomputing the time on DecodeAll, but since users may seek or decode small chunks first, not all the data may be there. So this is better done by the user. This may be good information to document. Currently, all the main codecs are implemented except for QuickTime.
author Ryan C. Gordon <icculus@icculus.org>
date Sat, 08 May 2004 08:19:50 +0000
parents 6d328f00c20d
children 1c09756bc038 d0d381a6f2bb
rev   line source
100
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
1
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
2 #undef DEBUG
105
de42ca5599ac Added DEBUG_CHATTER to the --enable-debug defines. (This will become a
Ryan C. Gordon <icculus@icculus.org>
parents: 100
diff changeset
3 #undef DEBUG_CHATTER
100
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
4 #undef NDEBUG
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
5 #undef SOUND_SUPPORTS_AIFF
216
07d0939d40e7 Support for .AU files added.
Ryan C. Gordon <icculus@icculus.org>
parents: 209
diff changeset
6 #undef SOUND_SUPPORTS_AU
209
e63b9393f6ce Added ModPlug support.
Ryan C. Gordon <icculus@icculus.org>
parents: 157
diff changeset
7 #undef SOUND_SUPPORTS_MIKMOD
e63b9393f6ce Added ModPlug support.
Ryan C. Gordon <icculus@icculus.org>
parents: 157
diff changeset
8 #undef SOUND_SUPPORTS_MODPLUG
100
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
9 #undef SOUND_SUPPORTS_OGG
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
10 #undef SOUND_SUPPORTS_RAW
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
11 #undef SOUND_SUPPORTS_SHN
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
12 #undef SOUND_SUPPORTS_VOC
6d9fdec2f708 added config.h, added --enable-debug flag, various other changes to the build system
fingolfin
parents:
diff changeset
13 #undef SOUND_SUPPORTS_WAV
110
5e5adbe0f215 Added Midi decoder.
Ryan C. Gordon <icculus@icculus.org>
parents: 105
diff changeset
14 #undef SOUND_SUPPORTS_MIDI
157
fa3e593b6a5e FLAC decoder added.
Ryan C. Gordon <icculus@icculus.org>
parents: 110
diff changeset
15 #undef SOUND_SUPPORTS_FLAC
262
6fe6de401b63 mpglib support.
Ryan C. Gordon <icculus@icculus.org>
parents: 216
diff changeset
16 #undef SOUND_SUPPORTS_SMPEG
6fe6de401b63 mpglib support.
Ryan C. Gordon <icculus@icculus.org>
parents: 216
diff changeset
17 #undef SOUND_SUPPORTS_MPGLIB
450
6d328f00c20d Added Speex decoder.
Ryan C. Gordon <icculus@icculus.org>
parents: 422
diff changeset
18 #undef SOUND_SUPPORTS_QUICKTIME
6d328f00c20d Added Speex decoder.
Ryan C. Gordon <icculus@icculus.org>
parents: 422
diff changeset
19 #undef SOUND_SUPPORTS_SPEEX
340
5a72981b8cba Added optional, experimental audio conversion routines by Frank Ranostaj.
Ryan C. Gordon <icculus@icculus.org>
parents: 314
diff changeset
20 #undef SOUND_USE_ALTCVT
5a72981b8cba Added optional, experimental audio conversion routines by Frank Ranostaj.
Ryan C. Gordon <icculus@icculus.org>
parents: 314
diff changeset
21