DISCLAIMER: The contents of the ports directory are included for convenience,

but they usually contain files contributed by various people, not the core

mpg123 team. The stuff is not tested by us. In some cases, it's even

impossible to tell what is really inside. Use at your own risk (well, like

all Free Software, actually;-).

This directory contains some (contributed) works covering usage and/or building

of mpg123/libmpg123 from different programming environments. Note that those

may be a bit outdated (especially when a file is added/removed in libmpg123

sources); as the team lacks resource to test everything. But in any case,

the ports can provide a good starting point on the respective platform, to get

it to work with minimal fuzz.

- Delphi: mpg123_.pas

  Unit for linking against libmpg123 (Win32, DLL).

  ...by Arthur Pires <arthurprs@gmail.com>

- Sony PSP: Sony_PSP/; building libmpg123 for the PSP (used for the MODO player).

  ...by Bastian Pflieger <wb@illogical.de>

- MSVC++: Microsoft Windows / Visual C++ builds

  - MSVC++/CMP3Stream:

    project for building libmpg123 with interface class.

    ...by "Gates Fan" <gatesfan@gmail.com>

  - MSVC++/mpg123.h

    A wrapper header over mpg123.h.in (yes, the template file in

    ../src/libmpg123) to use in MSVC++ projects that link to libmpg123.

  - MSVC++/YYYY contain project files for building and using libmpg123 with

    the corresponding versions of Microsoft Visual C++.

    To use it add the project to your solution. Then add a reference to

    libmpg123 from the project that wants to use it.

    Also add ports/MSVC++ and src/libmpg123 to the include path. 

	If you want to use the asm build you will need yasm (http://www.tortall.net/projects/yasm/). 

	Please put yasm.exe into a directory where MSVC++ can find it. Finally

        switch the libmpg123 project to the 

	Release_MMX_Dll (outdated! There should be Realease_X86_Dll or similar by now)

        build using the Visual Studio Configuration Manager.

  - Xcode contains the project file for building and using libmpg123 with

    Xcode for Mac and iOS (arm and simulator builds). Please add the

	ports/Xcode folder to the header search path of your project so that 

	Xcode can find the right mpg123.h and config.h. Then drag the mpg123

	Xcode project into your own project. Finally in your build target, build

	phases, add mpg123-ios or mpg123-mac to the libraries to link.