libZPlay (Win32) 

Version 2.02 

06. May, 2010. 

This is multimedia library for playing mp3, mp2, mp1, ogg, flac, ac3, aac, oga, wav and pcm files and streams. 

New: version 2.02 can also record sound from soundcard and encode into disk file with mp3, ogg, flac, aac or wav encoder.

Read recording and encoding for more information. 

This library integrate all decoders and encoders for supported formats. You don't need additional libraries. Library is using native WINAPI functions. There is no need for MFC or .NET support. Just pure WINAPI. So, this library must work on all Windows systems. 

Library will play music directly to soundcard. Simple and easy. No need for additional programming. You can play music using only 3 lines of code (create class, open file and start playing). 

You can also record music from your soundcard (microphone, line-in, CD, ...) and save into disk file using supported encoders. 

Simple, simple, simple ... 3 lines of code to play or record music in your application. 

Note:

libZPlay library is combination of multiple decoding/encoding libraries. Read here for more informations.

 

LICENSE NOTE:

libZPlay is released in 2 versions:  full version: supports all specified formats, including MP3 and AAC. MP3 and AAC formats are closed formats and protected by patents. PF (patent free) version: MP3 and AAC are NOT supported. You can use this version without any restrictions. Version identification: even version number of binary file libzplay.dll identifies full version (like: 1.12 ) odd version number of binary file libzplay.dll identifies PF (patent free) version (like: 1.11 ) Check version of dll file. If version is even, file is full version library. If version is odd, file is PF (patent free) version library. The same rule applies to version number retrieved from library interface.

 

MP3 and AAC LICENSE:

For information regarding patent licensing for AAC, please see Via Licensing's website: http://www.vialicensing.com/  For information regarding patent licensing for MP3, please see Mp3Licensing's website: http://mp3licensing.com/

 

Supported formats:  

Format	Play	Record/Encode	File extension	Description
MP3			mp3, mp2, mp1	MPEG-1, MPEG-2, MPEG 2.5 - Layer I, II, III. Not supported in PF version.
OGG			ogg	VORBIS OGG
FLAC			flac, oga	Native FLAC and OGG flac
AC-3			ac3	AC-3 aka ATSC A/52 streams
AAC			aac	AAC ADTS stream. Not supported in PF version.
WAVE			wav	PCM WAVE with RIFF header, uncompressed, 8, 16 bit per sample
PCM			any file	Raw PCM audio format, uncomressed, 8 16 bit per sample

Supported languages:

• Standard C/C++ (native, direct access to libZPlay library)
• Visual C++ .NET (VC.NET wrapper class for libZPlay library)
• Visual Basic .NET (VB.NET wrapper class for libZPlay library)
• C# .NET (C#.NET wrapper class for libZPlay library)
• Delphi (Delphi wrapper class for libZPlay library)
• and any other language capable to use exported __stdcall functions from dll library

Note:

libZPlay library is written in C++ and C++ interface is native interface for this library. But there are wrapper classes for Visual C++ .NET, Visual Basic .NET, C# .NET and Delphi.

 

Features:

• supports playing mp3, ogg, AAC, AC-3, flac, wav, pcm
• supports recording mp3, ogg, AAC, flac, wav, pcm
• UNICODE support for functions using strings ( filename, error messages, ID3 info, ... )
• read info tags from file ( ID3v1, ID3v2, VORBIS comment, wave RIFF list, FLAC VORBIS comment )
• support for attached image in ID3v2 and VORBIS comment.
• REVERSE PLAYING (you can play song backward in real time, "real" backward playing without predecoding in PCM)
• built in equaliter, user can specify own subbands, add subbands, ...
• built in echo and reverb sound processor
• pitch/rate/tempo change
• stereo cut effect
• detect beat-per-minute using 2 methods ( peak detection and autocorrelation)
• loop playing (you can play just one portion of file, repeat this portion ... )
• channel mixer (you can mix left and right chanel, convert stereo to mono ... )
• volume slide control (fade-in and fade-out)
• internal volume control (without affecting wave out device volume)
• pulling VU meter data (you can simply create VU meter)
• pulling FFT data (you can simply build FFT spectrum analyzer)
• built in FFT spectrum graph, library will draw complete spectrum graph on your window
• callback mechanism (class will inform you about events like play, stop, fade, ...)
• access to decoded PCM data throug callback message
• play data from disk files, UNICODE SUPPORT
• play data from allocated memory
• play dynamic streams (push small memory chunks into stream while song is playing, for download streams)
• selecting wave output (for multiple waveout devices)
• easy play, pause, seek ...
• Class interface for Visual C++ .NET, Visual Basic .NET, C# .NET and Delphi.

With this library you can easy play mp3, ogg, flac, ac3, aac, wave files with VB.NET, C#, Delphi, C/C++ and any other language capable to call exported functions from Dynamic Link Libraries ( Dll ) with __stdcall calling convention. 

Warning:

Documentation for VB.NET, Delphi and C# was generated from C++ documentation. Function declarations are tested and there is all OK. But comments, examples and parametes explanations can contain C++ syntax code or some other strange expressions because I didn't read all this. I just adapted function declarations.

 

This library is tested on: 

• Visual C++ 6.0 Standard Edition
• C++BUILDER COMMAND LINE TOOLS 5.5
• MinGW compiler
• Dev-C++
• Microsoft Visual Basic 2008 Express Edition
• Microsoft Visual C# 2008 Express Edition
• Microsoft Visual C++ 2008 Express Edition
• Delphi 7.0

DISCLAIMER:

This library is distributed as freeware. This software is provided "as is", without any guarantee made as to its suitability or fitness for any particular use. It may contain bugs, so use of this tool is at your own risk. Author takes no responsibility for any damage that may unintentionally be caused through its use.  Please note that the use of this software may require the payment of patent royalties for MP3 and AAC format. You need to consider this issue before you start building derivative works. We are not warranting or indemnifying you in any way for patent royalities! YOU ARE SOLELY RESPONSIBLE FOR YOUR OWN ACTIONS!  For information regarding patent licensing for AAC, please see Via Licensing's website: http://www.vialicensing.com/  For information regarding patent licensing for MP3, please see Mp3Licensing's website: http://mp3licensing.com/  If you don't need MP3 and AAC support use PF (patent free) version of libZPlay library.

 

LICENSE:

libZPlay is released under GNU GPL license. Read more...

 

AUTHOR:

Zoran Cindori  Web: http://libzplay.sourceforge.net/  Email: zcindori@inet.hr