summaryrefslogtreecommitdiff
path: root/apps/codecs/liba52/README
diff options
context:
space:
mode:
authorSean Bartell <wingedtachikoma@gmail.com>2011-06-25 21:32:25 -0400
committerNils Wallménius <nils@rockbox.org>2012-04-25 22:13:20 +0200
commitf40bfc9267b13b54e6379dfe7539447662879d24 (patch)
tree9b20069d5e62809ff434061ad730096836f916f2 /apps/codecs/liba52/README
parenta0009907de7a0107d49040d8a180f140e2eff299 (diff)
downloadrockbox-f40bfc9267b13b54e6379dfe7539447662879d24.zip
rockbox-f40bfc9267b13b54e6379dfe7539447662879d24.tar.gz
rockbox-f40bfc9267b13b54e6379dfe7539447662879d24.tar.bz2
rockbox-f40bfc9267b13b54e6379dfe7539447662879d24.tar.xz
Add codecs to librbcodec.
Change-Id: Id7f4717d51ed02d67cb9f9cb3c0ada4a81843f97 Reviewed-on: http://gerrit.rockbox.org/137 Reviewed-by: Nils Wallménius <nils@rockbox.org> Tested-by: Nils Wallménius <nils@rockbox.org>
Diffstat (limited to 'apps/codecs/liba52/README')
-rw-r--r--apps/codecs/liba52/README180
1 files changed, 0 insertions, 180 deletions
diff --git a/apps/codecs/liba52/README b/apps/codecs/liba52/README
deleted file mode 100644
index eb6c64d..0000000
--- a/apps/codecs/liba52/README
+++ /dev/null
@@ -1,180 +0,0 @@
-
-
-ABOUT LIBA52
-
-liba52 is a free library for decoding ATSC A/52 streams. It is
-released under the terms of the GPL license. The A/52 standard is used
-in a variety of applications, including digital television and DVD. It
-is also known as AC-3.
-
-The main goals in liba52 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 liba52 to include any
- project-specific code, but it should still include enough
- features to be used by very diverse projects.
-
- * Precision - We are trying to implement all of the A/52
- standard, and to have a very precise output by doing all the
- calculations in floating point. We have a test suite that
- detects any deviation in the output when compared to previous
- versions. We do not have access to official A/52 test vectors
- though, so we have to use our judgement to ensure that such
- deviations are only intruduced when we fix bugs !
-
- * Speed - liba52 is really fast, on any modern PC it should take
- only a few percent of CPU time.
-
-The project homepage is at http://liba52.sourceforge.net/
-
-
-A52DEC
-
-a52dec is a test program for liba52. It decodes ATSC A/52 streams, and
-also includes a demultiplexer for mpeg-1 and mpeg-2 program streams.
-
-The liba52 source code is always distributed in the a52dec package, to
-make sure it easier for people to test it.
-
-The basic usage is to just type "a52dec file" where file is an ATSC
-A/52 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
-a52dec 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 "-c" option is used to disable all optimizations (currently only djbfft).
-
-The "-r" option is used to disable the dynamic range compression.
-
-
-OTHER PROJECTS USING LIBA52
-
-liba52 (and its ancestor libac3) is being used by various other
-projects, including:
-
- * xine (http://xine.sourceforge.net/) - started as a simple
- mpeg-2 audio and video decoder, but it since became a
- full-featured DVD and video media player.
-
- * VideoLAN (http://www.videolan.org/) - video streaming over an
- ethernet network, can also be used as a standalone player.
-
- * MPlayer (http://www.MPlayerHQ.hu) - another good player, it is
- also very robust against damaged streams.
-
- * movietime (http://movietime.sourceforge.net/) - still quite
- young, but it looks very promising !
-
- * ffmpeg (http://ffmpeg.sourceforge.net/) - a nice audio/video
- encoder and transcoder, uses liba52 for decoding A/52 streams.
-
- * Ogle (http://www.dtek.chalmers.se/groups/dvd/) - a good DVD
- player with menu support
-
- * a52decX (http://homepage1.nifty.com/~toku/software_en.html) -
- a graphical interface for a52dec in macintosh osX.
-
- * TCVP (http://tcvp.sf.net) - video and music player for unix.
-
- * bd4go (http://denisx.dyndns.org/bd4go/) - another graphical
- interface for macintosh osX.
-
- * drip (http://drip.sourceforge.net/) - a DVD to DIVX transcoder.
-
- * OMS (http://www.linuxvideo.org/oms/)
-
- * XMPS (http://xmps.sourceforge.net/)
-
- * GStreamer (http://www.gstreamer.net/) - a framework for
- streaming media; it has an A/52 decoding plugin based on liba52.
-
- * mpeglib (http://mpeglib.sourceforge.net/) - a video decoding
- library that usess liba52 when decoding A/52 streams.
-
-If you use liba52 in another project, let us know !
-
-
-TASKS
-
-There are several places where we could easily use some help:
-
- * Web design: This site sucks ! at the very least, we'd like to
- come up with a nicer background picture and a logo.
-
- * Testing: If you find any stream that does not decode right
- with liba52, let us know ! The best thing would be to mail to
- the liba52-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 item is probably to make the code fully reentrant.
-
- * 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 A/52 standard, as published by the ATSC, is available at
-http://www.atsc.org/standards/a_52a.pdf
-
-
-CVS SNAPSHOTS
-
-A daily snapshot is created using "make distcheck" every night and
-uploaded to http://liba52.sourceforge.net/files/a52dec-snapshot.tar.gz .
-It is easier to use than the CVS repository, because you do not need
-to have the right versions of automake, autoconf and libtool
-installed. It might be convenient when working on a liba52 port for
-example.
-
-
-CVS REPOSITORY
-
-The latest liba52 and a52dec source code can always be found by
-anonymous CVS:
-
-# export CVSROOT=:pserver:anonymous@cvs.liba52.sourceforge.net:/cvsroot/liba52
-# cvs login (Just press Return when prompted for a password)
-# cvs checkout a52dec
-
-You can also browse the latest changes online at
-http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/liba52/a52dec/
-
-The other CVS modules are ac3dec-livid for the CVS history of the
-project while it was still hosted on the linuxvideo.org servers, and
-ac3dec for the CVS history of the project while the linuxvideo.org
-servers were down and before the library switched its name to liba52.
-
-
-MAILING LISTS
-
-See the subscription information at http://liba52.sourceforge.net/lists.html
-
-liba52-devel
-
-This is the main mailing list for technical discussion about
-liba52. Anyone wanting to work on liba52, or maybe just stay informed
-about the development process, should probably subscribe to this list.
-
-liba52-checkins
-
-All liba52 checkins are announced there. This is a good way to keep
-track of what goes into CVS.
-
-liba52-announce
-
-This is a very low traffic mailing list, only for announcements of new
-versions of liba52. Only project administrators can post there.