annotate VisualC/README.txt @ 562:7e08477b0fc1

MP3 decoder upgrade work. Ripped out SMPEG and mpglib support, replaced it with "mpg123.c" and libmpg123. libmpg123 is a much better version of mpglib, so it should solve all the problems about MP3's not seeking, or most modern MP3's not playing at all, etc. Since you no longer have to make a tradeoff with SMPEG for features, and SMPEG is basically rotting, I removed it from the project. There is still work to be done with libmpg123...there are MMX, 3DNow, SSE, Altivec, etc decoders which we don't have enabled at the moment, and the build system could use some work to make this compile more cleanly, etc. Still: huge win.
author Ryan C. Gordon <icculus@icculus.org>
date Fri, 30 Jan 2009 02:44:47 -0500
parents 72ccb2916418
children
rev   line source
438
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
1 README
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
2 2002/12/23
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
3
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
4 This directory contains a Project Workspace for Visual Studio 6.
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
5 It is based off the code in the CVS after the 1.0.0 release (1.0.1?).
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
6
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
7
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
8 This project has options to build a DLL or static library and
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
9 build playsound (dynamic or static). This project mimics the
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
10 original pre-1.0.0 version which no longer works with the current
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
11 code.
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
12
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
13 Unlike the former package, this one contains no binaries. This
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
14 will allow this project to be included in the main SDL_sound
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
15 source code. You will be responsible for finding the binaries
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
16 you need for each decoder. We have attempted to provide a
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
17 Support pack which contains the binaries built and tested with.
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
18 However, many of the binaries become quickly outdated so
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
19 you may not want to depend too heavily on the Support pack.
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
20
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
21 If you need the binaries, you should either copy the files to your
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
22 default VisualC++ directories (both headers and libraries), or add
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
23 them to your search paths, either through the Project Settings for
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
24 Include and Link paths or through the global settings
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
25 (Tools->Options->Directories in VC6). You need to do it both for the
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
26 header files (includes) and library files. To run your final
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
27 executables, you will need the DLL files in the local path
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
28 or one of your Windows main DLL search paths.
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
29
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
30
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
31 Issues:
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
32
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
33 The static playsound really isn't static. You still need the
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
34 dlls for each of the codecs. You will have to tweak the project to
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
35 build a true static binary and will probably require you to have
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
36 static versions of all the decoder libraries.
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
37
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
38
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
39
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
40
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
41 Eric Wing <ewing2121@yahoo.com>
72ccb2916418 Initial add.
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
42 Joshua Quick <jquick@golighthouse.com>