Mercurial > SDL_sound_CoreAudio
annotate decoders/timidity/README @ 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 | 2d887640d300 |
children |
rev | line source |
---|---|
199 | 1 [This version of timidity has been stripped for simplicity in porting to SDL, |
2 and then even further for SDL_sound] | |
3 ---------------------------------*-text-*--------------------------------- | |
4 | |
5 From http://www.cgs.fi/~tt/discontinued.html : | |
6 | |
7 If you'd like to continue hacking on TiMidity, feel free. I'm | |
8 hereby extending the TiMidity license agreement: you can now | |
9 select the most convenient license for your needs from (1) the | |
10 GNU GPL, (2) the GNU LGPL, or (3) the Perl Artistic License. | |
11 | |
12 -------------------------------------------------------------------------- | |
13 | |
14 This is the README file for TiMidity v0.2i | |
15 | |
16 TiMidity is a MIDI to WAVE converter that uses Gravis | |
17 Ultrasound(*)-compatible patch files to generate digital audio data | |
18 from General MIDI files. The audio data can be played through any | |
19 sound device or stored on disk. On a fast machine, music can be | |
20 played in real time. TiMidity runs under Linux, FreeBSD, HP-UX, SunOS, and | |
21 Win32, and porting to other systems with gcc should be easy. | |
22 | |
23 TiMidity Features: | |
24 | |
25 * 32 or more dynamically allocated fully independent voices | |
26 * Compatibility with GUS patch files | |
27 * Output to 16- or 8-bit PCM or uLaw audio device, file, or | |
28 stdout at any sampling rate | |
29 * Optional interactive mode with real-time status display | |
30 under ncurses and SLang terminal control libraries. Also | |
31 a user friendly motif interface since version 0.2h | |
32 * Support for transparent loading of compressed MIDI files and | |
33 patch files | |
34 | |
35 * Support for the following MIDI events: | |
36 - Program change | |
37 - Key pressure | |
38 - Channel main volume | |
39 - Tempo | |
40 - Panning | |
41 - Damper pedal (Sustain) | |
42 - Pitch wheel | |
43 - Pitch wheel sensitivity | |
44 - Change drum set | |
45 | |
46 * The GNU General Public License can, as always, be found in the file | |
47 "../COPYING". | |
48 | |
49 * TiMidity requires sampled instruments (patches) to play MIDI files. You | |
50 should get the file "timidity-lib-0.1.tar.gz" and unpack it in the same | |
51 directory where you unpacked the source code archive. You'll want more | |
52 patches later -- read the file "FAQ" for pointers. | |
53 | |
54 * Timidity is no longer supported, but can be found by searching the web. | |
55 | |
56 | |
57 Tuukka Toivonen <toivonen@clinet.fi> | |
58 | |
59 [(*) Any Registered Trademarks used anywhere in the documentation or | |
60 source code for TiMidity are acknowledged as belonging to their | |
61 respective owners.] |