libZPlay documentation (Win32)
IndexReferenceHome
PreviousUpNext
About libZPlay library

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:

 

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

 

 

Copyright (c) 2010. Zoran Cindori - All rights reserved.

Web: http://libzplay.sourceforge.net/

Email: zcindori@inet.hr