README
1DISCLAIMER: The contents of the ports directory are included for convenience,
2but they usually contain files contributed by various people, not the core
3mpg123 team. The stuff is not tested by us. In some cases, it's even
4impossible to tell what is really inside. Use at your own risk (well, like
5all Free Software, actually;-).
6
7This directory contains some (contributed) works covering usage and/or building
8of mpg123/libmpg123 from different programming environments. Note that those
9may be a bit outdated (especially when a file is added/removed in libmpg123
10sources); as the team lacks resource to test everything. But in any case,
11the ports can provide a good starting point on the respective platform, to get
12it to work with minimal fuzz.
13
14- Delphi: mpg123_.pas
15 Unit for linking against libmpg123 (Win32, DLL).
16 ...by Arthur Pires <arthurprs@gmail.com>
17- Sony PSP: Sony_PSP/; building libmpg123 for the PSP (used for the MODO player).
18 ...by Bastian Pflieger <wb@illogical.de>
19- MSVC++: Microsoft Windows / Visual C++ builds
20 - MSVC++/CMP3Stream:
21 project for building libmpg123 with interface class.
22 ...by "Gates Fan" <gatesfan@gmail.com>
23 - MSVC++/mpg123.h
24 A wrapper header over mpg123.h.in (yes, the template file in
25 ../src/libmpg123) to use in MSVC++ projects that link to libmpg123.
26 - MSVC++/YYYY contain project files for building and using libmpg123 with
27 the corresponding versions of Microsoft Visual C++.
28 To use it add the project to your solution. Then add a reference to
29 libmpg123 from the project that wants to use it.
30 Also add ports/MSVC++ and src/libmpg123 to the include path.
31 If you want to use the asm build you will need yasm (http://www.tortall.net/projects/yasm/).
32 Please put yasm.exe into a directory where MSVC++ can find it. Finally
33 switch the libmpg123 project to the
34 Release_MMX_Dll (outdated! There should be Realease_X86_Dll or similar by now)
35 build using the Visual Studio Configuration Manager.
36 - Xcode contains the project file for building and using libmpg123 with
37 Xcode for Mac and iOS (arm and simulator builds). Please add the
38 ports/Xcode folder to the header search path of your project so that
39 Xcode can find the right mpg123.h and config.h. Then drag the mpg123
40 Xcode project into your own project. Finally in your build target, build
41 phases, add mpg123-ios or mpg123-mac to the libraries to link.
42