131 lines
4.2 KiB
Plaintext
131 lines
4.2 KiB
Plaintext
|
|
||
|
|
JOrbis
|
||
|
|
|
||
|
|
a pure Java(TM) Ogg Vorbis decoder
|
||
|
|
by ymnk, JCraft,Inc.
|
||
|
|
|
||
|
|
http://www.jcraft.com/jorbis/
|
||
|
|
|
||
|
|
Last modified: Mon May 7 14:31:03 UTC 2001
|
||
|
|
|
||
|
|
Description
|
||
|
|
===========
|
||
|
|
|
||
|
|
JOrbis is a pure Java Ogg Vorbis decoder.
|
||
|
|
JOrbis accepts Ogg Vorbis bitstreams and decodes them to raw PCMs.
|
||
|
|
|
||
|
|
|
||
|
|
Documentation
|
||
|
|
=============
|
||
|
|
|
||
|
|
Read before asking.
|
||
|
|
|
||
|
|
* README files all over the source tree have info related to the stuff
|
||
|
|
in the directories.
|
||
|
|
|
||
|
|
|
||
|
|
Directories & Files in the Source Tree
|
||
|
|
======================================
|
||
|
|
|
||
|
|
* com/ has source trees of JOrbis.
|
||
|
|
* player/ has source and binaries of pure Java Ogg Vorbis player.
|
||
|
|
|
||
|
|
|
||
|
|
Copyrights & Disclaimers
|
||
|
|
========================
|
||
|
|
|
||
|
|
JOrbis is copyrighted by JCraft Inc. and is licensed through the
|
||
|
|
GNU Lesser General Public License.
|
||
|
|
Read the COPYING.LIB file for the complete license.
|
||
|
|
|
||
|
|
|
||
|
|
Credits
|
||
|
|
=======
|
||
|
|
All credits goes to authors, Moty<monty@xiph.org>,The XIPHOPHORUS Company
|
||
|
|
and contributers of Ogg Vorbis.
|
||
|
|
|
||
|
|
|
||
|
|
What is Ogg Vorbis?
|
||
|
|
===================
|
||
|
|
Here is a quote from README of Ogg Vorbis CODEC from
|
||
|
|
the Developer site for Ogg Vorbis(http://xiph.org/ogg/vorbis/).
|
||
|
|
|
||
|
|
"Vorbis is a general purpose audio and music encoding format
|
||
|
|
contemporary to MPEG-4's AAC and TwinVQ, the next generation beyond
|
||
|
|
MPEG audio layer 3. Unlike the MPEG sponsored formats (and other
|
||
|
|
proprietary formats such as RealAudio G2 and Windows' flavor of the
|
||
|
|
month), the Vorbis CODEC specification belongs to the public domain.
|
||
|
|
All the technical details are published and documented, and any
|
||
|
|
software entity may make full use of the format without royalty or
|
||
|
|
patent concerns."
|
||
|
|
|
||
|
|
|
||
|
|
Why JOrbis?
|
||
|
|
===========
|
||
|
|
We sympathize the aim of Ogg project.
|
||
|
|
JOrbis is our contribution to the Ogg project in our style.
|
||
|
|
We think the ubiquity of Vorbis decoder will leverage the
|
||
|
|
popularity of Ogg Vorbis. We hope JOrbis will run on any platform,
|
||
|
|
any devices and any web browsers, which support Java and
|
||
|
|
every people will enjoy streamed musics without without royalty or
|
||
|
|
patent concerns.
|
||
|
|
|
||
|
|
|
||
|
|
Features
|
||
|
|
========
|
||
|
|
* JOrbis is in pure JavaTM.
|
||
|
|
JOrbis will run on JDK1.0.* or higher and may run on J2METM.
|
||
|
|
* JOrbis is under LGPL.
|
||
|
|
|
||
|
|
|
||
|
|
Current Status
|
||
|
|
==============
|
||
|
|
The sound quality of outputs from JOrbis has been improved.
|
||
|
|
If you had tried last version(0.0.1) and been disappointed with its quality,
|
||
|
|
try current version. It will be worth trying.
|
||
|
|
However, in current implementation, the efficiency has not been cared and
|
||
|
|
many CPU resources are required. Much work must be done to solve this problem.
|
||
|
|
|
||
|
|
|
||
|
|
How To Try JOrbis
|
||
|
|
=================
|
||
|
|
A sample program DecodeExample.java has been included in an archive.<br>
|
||
|
|
If you are on RedHat's GNU/Linux box, just try,
|
||
|
|
|
||
|
|
$ cat foo.ogg | java com.jcraft.jorbis.DecodeExample | esdcat
|
||
|
|
|
||
|
|
If outputs are noisy, save outputs in a file then cat it to esdcat.
|
||
|
|
Ogg files are available at http://vorbis.com/listen.html
|
||
|
|
and if you have Ogg Vorbis CODEC from xiph.org, you can make ogg files
|
||
|
|
by your self.
|
||
|
|
|
||
|
|
How To Play JOrbisPlayer
|
||
|
|
========================
|
||
|
|
The Ogg Voribs player, 'JOrbisPlayer', is available at the 'player' directory.
|
||
|
|
It is a pure Java program, but it uses Java Sound APIs.
|
||
|
|
If you have J2SE V.1.3 Java VM, you can enjoy it.
|
||
|
|
*step1: Copy contents in the 'player' directory to some directory,
|
||
|
|
which is accessible via the http server.
|
||
|
|
*step2: Copy some ogg files to that directory.
|
||
|
|
*step3: Change directory to that directory, make 'playlist' file.
|
||
|
|
For example, 'ls *.ogg > playlist'
|
||
|
|
*step4: Open 'JOrbisPlayer.html' file by a web browser via http server.
|
||
|
|
JOrbisPlayer will run on a web browser automatically.
|
||
|
|
'JOrbisPlayer' also works as an application, so just try 'java JOrbisPlayer'
|
||
|
|
in the 'player' directory. For example, on GNU/Linux,
|
||
|
|
|
||
|
|
$ cd player
|
||
|
|
$ export CLASSPATH=.:..
|
||
|
|
$ java JOrbisPlayer foo.ogg bar.ogg http://shomewahre/goo.ogg
|
||
|
|
|
||
|
|
If you don't have the direct connections to the Internet and
|
||
|
|
you have the http proxy server at 192.168.0.1:80, try as follows,
|
||
|
|
$ java -Dhttp.proxyHost=192.168.0.1 -Dhttp.proxyPort=80 JOrbisPlayer http://shomewahre/goo.ogg
|
||
|
|
|
||
|
|
In our experiences, if your machine has a Cerelon, you will be able to
|
||
|
|
enjoy JOrbisPlayer.
|
||
|
|
|
||
|
|
|
||
|
|
If you have any comments, suggestions and questions, write us
|
||
|
|
at jorbis@jcraft.com
|