Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/timothygu/libdca

Mirror of svn://svn.videolan.org/libdca/trunk
https://github.com/timothygu/libdca

Last synced: 4 days ago
JSON representation

Mirror of svn://svn.videolan.org/libdca/trunk

Awesome Lists containing this project

README 

        
About libdca

------------



libdca is a free library for decoding DTS Coherent Acoustics streams. It is

released under the terms of the GPL license. The DTS Coherent Acoustics

standard is used in a variety of applications, including DVD, DTS audio CD and

radio broadcasting.



The main goals in libdts development are:



      *	Portability - currently all of the code is written in C, and

	when we write platform-specific optimizations we will always

	keep a generic C routine to fall back on.



      *	Reuseability - we do not want libdts to include any

	project-specific code, but it should still include enough

	features to be used by very diverse projects.



      *	Precision - we do not yet fully support all the core specification of

        the DTS Coherent Acoustics standard (see TODO) so do not expect too

        much of this library for now.



      *	Speed - current code is not optimised at all.



The project homepage is at http://www.videolan.org/developers/libdca.html



dcadec

------



dcadec is a test program for libdca. It decodes DTS Coherent Acoustics streams,

and also includes a demultiplexer for mpeg-1 and mpeg-2 program streams.



The libdca source code is always distributed in the dcadec package, to

make sure it easier for people to test it.



The basic usage is to just type "dcadec file" where file is a DTS Coherent

Acoustics file.



The "-s" option must be used for multiplexed (audio and video) mpeg-2

files. These files are usualy found on the internet or on unencrypted

DVDs.



The "-o" option is used to select a given output layer. By default

dcadec does a stereo downmix and outputs to your speakers, but you can

try other choices using this option. This is also used for performance

testing and conformance testing.



The "-r" option is used to disable the dynamic range compression.



Other projects using libdts

---------------------------



right now libdts is only being used by VLC media player

(http://www.videolan.org/) a cross-platform video player and streaming

solution.



If you use libdts in another project, let us know !



Tasks

-----



There are several places where we could easily use some help:



      *	Testing: If you find any stream that does not decode right

	with libdts, let us know ! The best thing would be to mail to

	the libdts-devel mailing list. Also if you have access to

	encoders, we'd love to get test streams that would be free of

	rights - so that we can put them on this server.



      *	Coding: you can have a look in the TODO file first ! The most

	important items are probably to finish implementing the full

        specification and to make sure of the accuracy of the audio output.



      *	Porting: If you're porting to a new architecture, you might

	want to experiment with the compile flags defined in

	configure.in . When you figure out whats fastest on your

	platform, send us a patch !



References

----------



The DTS Coherent Acoustics standard (ETSI 102 114 v1.2.1), as published by the

ETSI, is available at http://pda.etsi.org/pda/queryform.asp (look for DTS

Coherent Acoustics)



SVN repository

--------------



The latest libdca and dcadec source code can always be found by anonymous

SVN repository:



# svn co svn://svn.videolan.org/libdca/trunk libdca-trunk



If you build libdts from SVN you'll have to run ./bootstrap first.



Support / mailing-lists

-----------------------



See the support information at http://www.videolan.org/support/



libdts-devel



This is the main mailing list for technical discussion about

libdts. Anyone wanting to work on libdts, or maybe just stay informed

about the development process, should probably subscribe to this list.



Unix build instructions

-----------------------



./configure

make

make install



Building for win32

------------------



There are at least three ways to do it:



- natively on Windows using Microsoft VC++ and the vc++ project

  included in this distribution.



- natively on Windows using MSYS + MINGW (www.mingw.org) (MSYS is a

  minimal build environnement to compile unixish projects under

  windows. It provides all the common unix tools like sh, gmake...)



- or on Linux, using the mingw32 cross-compiler



Building using MSYS + MINGW on windows

--------------------------------------



First you will need to download and install the latest MSYS (version

1.0.7 as of now) and MINGW. The installation is really easy. Begin

with the MSYS auto-installer and once this is done, extract MINGW into

c:\msys\1.0\mingw. You also have to remember to remove the make

utility included with MINGW as it conflicts with the one from MSYS

(just rename or remove c:\msys\1.0\mingw\bin\make.exe).



http://prdownloads.sourceforge.net/mingw/MSYS-1.0.7-i686-2002.04.24-1.exe

http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz



Then you can build the package using:

# ./configure

# make



Building using the mingw32 cross-compiler

-----------------------------------------



You need to install mingw32 first. For Debian GNU/Linux users, there

is a mingw32 package. Otherwise you might get it from the mingw site

at http://www.mingw.org/download.shtml.



The videolan project also keeps precompiled mingw32 binaries at

http://www.videolan.org/vlc/windows.html . If you install these,

you'll have to set your PATH accordingly to include

/usr/local/cross-tools/bin too.



The build should then proceed using something like:

# CC=i586-mingw32msvc-gcc ./configure --host=i586-mingw32msvc

# make