home *** CD-ROM | disk | FTP | other *** search
/ PC World 2007 March / PCWorld_2007-03_cd.bin / audio-video / autogk / AutoGordianKnot.2.40.Setup.exe / tools / dtsdec.txt < prev    next >
Text File  |  2004-11-15  |  7KB  |  206 lines
  1. Authors:
  2. ---------
  3. Gildas Bazin <gbazin@videolan.org> implementation of the
  4. DTS Coherent Acoustics decoder and current maintainer of libdts.
  5.  
  6. Other libdts contributors include:
  7.         Sam Hocevar <sam@zoy.org> - build system improvements and debian package
  8.  
  9. While the libdts part of the source code was mostly written from scratch, this
  10. project was started from the a52dec code base so the original credits for
  11. a52dec are preserved:
  12.  
  13. Aaron Holtzman <aholtzma@ess.engr.uvic.ca> started the project and
  14. made the initial working implementation.
  15.  
  16. Michel Lespinasse <walken@zoy.org> did major changes for speed and
  17. conformance and is the current maintainer.
  18.  
  19. Other contributors include:
  20.     Gildas Bazin <gbazin@netcourrier.com> - mingw32 port
  21.     Billy Biggs <vektor@div8.net> - most of liba52.txt
  22.     Jeroen Dobbelaere <jeroen.dobbelaere@acunia.com> - fixed point version
  23.     Eduard Hasenleithner <eduardh@aon.at> - gcc 3.0 fixes
  24.     Hσkan Hjort <d95hjort@dtek.chalmers.se> - Solaris output, mlib code
  25.     Charles M. Hannum <root@ihack.net> - fixes
  26.     Chris Hodges <hodges@stradis.com> - made the library reentrant
  27.     Michael Holzt <kju@flummi.de> - OSS output.c and misc errata
  28.     Angelos Keromytis <angelos@dsl.cis.upenn.edu> - OpenBSD fixes
  29.     David I. Lehn <dlehn@vt.edu> - API cleanup suggestion
  30.     Don Mahurin <dmahurin@dma.org> - stdin support for extract_a52
  31.     Jim Miller <jmiller@heli.engr.sgi.com> - IRIX output.c
  32.     Takefumi Sayo <stake@niagara.shiojiri.ne.jp> - FreeBSD tweak
  33.     Shoji Tokunaga <toku@mac.com> - aif file output
  34.  
  35. ==============
  36. About libdts
  37. ------------
  38.  
  39. libdts is a free library for decoding DTS Coherent Acoustics streams. It is
  40. released under the terms of the GPL license. The DTS Coherent Acoustics
  41. standard is used in a variety of applications, including DVD, DTS audio CD and
  42. radio broadcasting.
  43.  
  44. The main goals in libdts development are:
  45.  
  46.       *    Portability - currently all of the code is written in C, and
  47.     when we write platform-specific optimizations we will always
  48.     keep a generic C routine to fall back on.
  49.  
  50.       *    Reuseability - we do not want libdts to include any
  51.     project-specific code, but it should still include enough
  52.     features to be used by very diverse projects.
  53.  
  54.       *    Precision - we do not yet fully support all the core specification of
  55.         the DTS Coherent Acoustics standard (see TODO) so do not expect too
  56.         much of this library for now.
  57.  
  58.       *    Speed - current code is not optimised at all.
  59.  
  60. The project homepage is at http://www.videolan.org/dtsdec.html
  61.  
  62.  
  63. dtsdec
  64. ------
  65.  
  66. dtsdec is a test program for libdts. It decodes DTS Coherent Acoustics streams,
  67. and also includes a demultiplexer for mpeg-1 and mpeg-2 program streams.
  68.  
  69. The libdts source code is always distributed in the dtsdec package, to
  70. make sure it easier for people to test it.
  71.  
  72. The basic usage is to just type "dtsdec file" where file is a DTS Coherent
  73. Acoustics file.
  74.  
  75. The "-s" option must be used for multiplexed (audio and video) mpeg-2
  76. files. These files are usualy found on the internet or on unencrypted
  77. DVDs.
  78.  
  79. The "-o" option is used to select a given output layer. By default
  80. dtsdec does a stereo downmix and outputs to your speakers, but you can
  81. try other choices using this option. This is also used for performance
  82. testing and conformance testing.
  83.  
  84. The "-r" option is used to disable the dynamic range compression.
  85.  
  86.  
  87. Other projects using libdts
  88. ---------------------------
  89.  
  90. right now libdts is only being used by VLC media player
  91. (http://www.videolan.org/) a cross-platform video player and streaming
  92. solution.
  93.  
  94. If you use libdts in another project, let us know !
  95.  
  96.  
  97. Tasks
  98. -----
  99.  
  100. There are several places where we could easily use some help:
  101.  
  102.       *    Testing: If you find any stream that does not decode right
  103.     with libdts, let us know ! The best thing would be to mail to
  104.     the libdts-devel mailing list. Also if you have access to
  105.     encoders, we'd love to get test streams that would be free of
  106.     rights - so that we can put them on this server.
  107.  
  108.       *    Coding: you can have a look in the TODO file first ! The most
  109.     important items are probably to finish implementing the full
  110.         specification and to make sure of the accuracy of the audio output.
  111.  
  112.       *    Porting: If you're porting to a new architecture, you might
  113.     want to experiment with the compile flags defined in
  114.     configure.in . When you figure out whats fastest on your
  115.     platform, send us a patch !
  116.  
  117.  
  118. References
  119. ----------
  120.  
  121. The DTS Coherent Acoustics standard (ETSI 102 114 v1.2.1), as published by the
  122. ETSI, is available at http://pda.etsi.org/pda/queryform.asp (look for DTS
  123. Coherent Acoustics)
  124.  
  125.  
  126. SVN repository
  127. --------------
  128.  
  129. The latest libdts and dtsdec source code can always be found by anonymous
  130. SVN repository:
  131.  
  132. # svn co svn://svn.videolan.org/libdts/trunk libdts-trunk
  133.  
  134. If you build libdts from SVN you'll have to run ./bootstrap first.
  135.  
  136.  
  137. Support / mailing-lists
  138. -----------------------
  139.  
  140. See the support information at http://www.videolan.org/support/
  141.  
  142. libdts-devel
  143.  
  144. This is the main mailing list for technical discussion about
  145. libdts. Anyone wanting to work on libdts, or maybe just stay informed
  146. about the development process, should probably subscribe to this list.
  147.  
  148.  
  149. Unix build instructions
  150. -----------------------
  151.  
  152. ./configure
  153. make
  154. make install
  155.  
  156.  
  157. Building for win32
  158. ------------------
  159.  
  160. There are at least three ways to do it:
  161.  
  162. - natively on Windows using Microsoft VC++ and the vc++ project
  163.   included in this distribution.
  164.  
  165. - natively on Windows using MSYS + MINGW (www.mingw.org) (MSYS is a
  166.   minimal build environnement to compile unixish projects under
  167.   windows. It provides all the common unix tools like sh, gmake...)
  168.  
  169. - or on Linux, using the mingw32 cross-compiler
  170.  
  171.  
  172. Building using MSYS + MINGW on windows
  173. --------------------------------------
  174.  
  175. First you will need to download and install the latest MSYS (version
  176. 1.0.7 as of now) and MINGW. The installation is really easy. Begin
  177. with the MSYS auto-installer and once this is done, extract MINGW into
  178. c:\msys\1.0\mingw. You also have to remember to remove the make
  179. utility included with MINGW as it conflicts with the one from MSYS
  180. (just rename or remove c:\msys\1.0\mingw\bin\make.exe).
  181.  
  182. http://prdownloads.sourceforge.net/mingw/MSYS-1.0.7-i686-2002.04.24-1.exe
  183. http://prdownloads.sourceforge.net/mingw/MinGW-1.1.tar.gz
  184.  
  185. Then you can build the package using:
  186. # ./configure
  187. # make
  188.  
  189.  
  190. Building using the mingw32 cross-compiler
  191. -----------------------------------------
  192.  
  193. You need to install mingw32 first. For Debian GNU/Linux users, there
  194. is a mingw32 package. Otherwise you might get it from the mingw site
  195. at http://www.mingw.org/download.shtml.
  196.  
  197. The videolan project also keeps precompiled mingw32 binaries at
  198. http://www.videolan.org/vlc/windows.html . If you install these,
  199. you'll have to set your PATH accordingly to include
  200. /usr/local/cross-tools/bin too.
  201.  
  202. The build should then proceed using something like:
  203. # CC=i586-mingw32msvc-gcc ./configure --host=i586-mingw32msvc
  204. # make
  205.  
  206.