README
1This distribution of libdca is not original work.
2All code had been made reentrant to fit deadbeef player needs.
3
4=== Original libdca README starts here ===
5
6About libdca
7------------
8
9libdca is a free library for decoding DTS Coherent Acoustics streams. It is
10released under the terms of the GPL license. The DTS Coherent Acoustics
11standard is used in a variety of applications, including DVD, DTS audio CD and
12radio broadcasting.
13
14The main goals in libdts development are:
15
16 * Portability - currently all of the code is written in C, and
17 when we write platform-specific optimizations we will always
18 keep a generic C routine to fall back on.
19
20 * Reuseability - we do not want libdts to include any
21 project-specific code, but it should still include enough
22 features to be used by very diverse projects.
23
24 * Precision - we do not yet fully support all the core specification of
25 the DTS Coherent Acoustics standard (see TODO) so do not expect too
26 much of this library for now.
27
28 * Speed - current code is not optimised at all.
29
30The project homepage is at http://www.videolan.org/developers/libdca.html
31
32
33dcadec
34------
35
36dcadec is a test program for libdca. It decodes DTS Coherent Acoustics streams,
37and also includes a demultiplexer for mpeg-1 and mpeg-2 program streams.
38
39The libdca source code is always distributed in the dcadec package, to
40make sure it easier for people to test it.
41
42The basic usage is to just type "dcadec file" where file is a DTS Coherent
43Acoustics file.
44
45The "-s" option must be used for multiplexed (audio and video) mpeg-2
46files. These files are usualy found on the internet or on unencrypted
47DVDs.
48
49The "-o" option is used to select a given output layer. By default
50dcadec does a stereo downmix and outputs to your speakers, but you can
51try other choices using this option. This is also used for performance
52testing and conformance testing.
53
54The "-r" option is used to disable the dynamic range compression.
55
56
57Other projects using libdts
58---------------------------
59
60right now libdts is only being used by VLC media player
61(http://www.videolan.org/) a cross-platform video player and streaming
62solution.
63
64If you use libdts in another project, let us know !
65
66
67Tasks
68-----
69
70There are several places where we could easily use some help:
71
72 * Testing: If you find any stream that does not decode right
73 with libdts, let us know ! The best thing would be to mail to
74 the libdts-devel mailing list. Also if you have access to
75 encoders, we'd love to get test streams that would be free of
76 rights - so that we can put them on this server.
77
78 * Coding: you can have a look in the TODO file first ! The most
79 important items are probably to finish implementing the full
80 specification and to make sure of the accuracy of the audio output.
81
82 * Porting: If you're porting to a new architecture, you might
83 want to experiment with the compile flags defined in
84 configure.in . When you figure out whats fastest on your
85 platform, send us a patch !
86
87
88References
89----------
90
91The DTS Coherent Acoustics standard (ETSI 102 114 v1.2.1), as published by the
92ETSI, is available at http://pda.etsi.org/pda/queryform.asp (look for DTS
93Coherent Acoustics)
94
95
96SVN repository
97--------------
98
99The latest libdca and dcadec source code can always be found by anonymous
100SVN repository:
101
102# svn co svn://svn.videolan.org/libdca/trunk libdca-trunk
103
104If you build libdts from SVN you'll have to run ./bootstrap first.
105
106
107Support / mailing-lists
108-----------------------
109
110See the support information at http://www.videolan.org/support/
111
112libdts-devel
113
114This is the main mailing list for technical discussion about
115libdts. Anyone wanting to work on libdts, or maybe just stay informed
116about the development process, should probably subscribe to this list.
117
118
119Unix build instructions
120-----------------------
121
122./configure
123make
124make install
125
126
127Building for win32
128------------------
129
130There are at least three ways to do it:
131
132- natively on Windows using Microsoft VC++ and the vc++ project
133 included in this distribution.
134
135- natively on Windows using MSYS + MINGW (www.mingw.org) (MSYS is a
136 minimal build environnement to compile unixish projects under
137 windows. It provides all the common unix tools like sh, gmake...)
138
139- or on Linux, using the mingw32 cross-compiler
140
141
142Building using MSYS + MINGW on windows
143--------------------------------------
144
145First you will need to download and install the latest MSYS (version
1461.0.7 as of now) and MINGW. The installation is really easy. Begin
147with the MSYS auto-installer and once this is done, extract MINGW into
148c:\msys\1.0\mingw. You also have to remember to remove the make
149utility included with MINGW as it conflicts with the one from MSYS
150(just rename or remove c:\msys\1.0\mingw\bin\make.exe).
151
152http://prdownloads.sourceforge.net/mingw/MSYS-1.0.7-i686-2002.04.24-1.exe
153http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz
154
155Then you can build the package using:
156# ./configure
157# make
158
159
160Building using the mingw32 cross-compiler
161-----------------------------------------
162
163You need to install mingw32 first. For Debian GNU/Linux users, there
164is a mingw32 package. Otherwise you might get it from the mingw site
165at http://www.mingw.org/download.shtml.
166
167The videolan project also keeps precompiled mingw32 binaries at
168http://www.videolan.org/vlc/windows.html . If you install these,
169you'll have to set your PATH accordingly to include
170/usr/local/cross-tools/bin too.
171
172The build should then proceed using something like:
173# CC=i586-mingw32msvc-gcc ./configure --host=i586-mingw32msvc
174# make
175
176