1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
-----------------------------------------------------
Vorbis SPI.
Project Homepage :
http://www.javazoom.net/vorbisspi/vorbisspi.html
Online MP3, OGG Vorbis Forum :
http://www.javazoom.net/services/forums/index.jsp
-----------------------------------------------------
Vorbis SPI adds OGG Vorbis capabilities to JavaSound API.
It is based on JOrbis library (Java Ogg Vorbis decoder).
How to install it :
-----------------
Add vorbisspi1.0.3.jar, tritonus_share.jar, jorbis-0.0.15.jar, jogg-0.0.7.jar into
your runtime CLASSPATH. Your application should rely on JavaSound API only. The
Java Virtual Machine will load the VorbisSPI at runtime.
Known problems :
--------------
- Low sampling rates such as 14Khz are not supported.
- AudioInputStream is closed at the end of song for some icecast streams
with title streaming enabled.
Changes :
-------
11/23/2007 : VorbisSPI 1.0.3
----------------------------
- Tritonus share update support.
10/01/2005 : VorbisSPI 1.0.2
----------------------------
- UTF-8 support added for Ogg comments.
+ JOrbis 0.0.15 included.
11/02/2004 : VorbisSPI 1.0.1
----------------------------
+ JOrbis 0.0.14 included.
It fixes a file lock bug.
04/05/2004 : VorbisSPI 1.0
--------------------------
- Custom information (bitrate, ...), available through AudioFileFormat.getType(),
workaround has been removed. Use TAudioFormat.properties() and
TAudioFileFormat.properties() now. Here are all new parameters :
AudioFormat parameters :
~~~~~~~~~~~~~~~~~~~~~~
- bitrate : [Integer], bitrate in bits per seconds, average bitrate for VBR enabled stream.
- vbr : [Boolean], VBR flag
AudioFileFormat parameters :
~~~~~~~~~~~~~~~~~~~~~~~~~~
+ Standard parameters :
- duration : [Long], duration in microseconds.
- title : [String], Title of the stream.
- author : [String], Name of the artist of the stream.
- album : [String], Name of the album of the stream.
- date : [String], The date (year) of the recording or release of the stream.
- copyright : [String], Copyright message of the stream.
- comment : [String], Comment of the stream.
+ Extended Ogg Vorbis parameters :
- ogg.length.bytes : [Integer], length in bytes.
- ogg.bitrate.min.bps : [Integer], minimum bitrate.
- ogg.bitrate.nominal.bps : [Integer], nominal bitrate.
- ogg.bitrate.max.bps : [Integer], maximum bitrate.
- ogg.channels : [Integer], number of channels 1 : mono, 2 : stereo.
- ogg.frequency.hz : [Integer], sampling rate in hz.
- ogg.version : [Integer], version.
- ogg.serial : [Integer], serial number.
- ogg.comment.track : [String], track number.
- ogg.comment.genre : [String], genre field.
- ogg.comment.encodedby : [String], encoded by field.
- ogg.comment.ext : [String], extended comments (indexed):
For instance :
ogg.comment.ext.1=Something
ogg.comment.ext.2=Another comment
DecodedVorbisAudioInputStream parameters :
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- ogg.position.byte : [Long], current position in bytes in the stream.
03/15/2004 : VorbisSPI 0.9
--------------------------
- Hang bug fixed for some Ogg Vorbis songs.
11/11/2003 : VorbisSPI 0.8
---------------------------
- WAV/AU SPI conflict bug fixed.
- AudioInputStream.available() bug fixed.
- Custom information available through AudioFileFormat.getType() workaround :
VORBISxNominalBitRateInBpsxLengthInMilliSeconds (e.g. VORBISx128000x282267)
Note that this workaround will be removed in VorbisSPI 1.0. Another workaround
to pass extra parameters (Ogg comments, Bitrates, ... ) will be available and
compliant with JDK 1.5.
- Design improved :
tritonus_share.jar included (old Tritonus classes removed).
TDebug class used for debugging traces.
(Use -Dtritonus.TraceAudioFileReader=true to enable traces)
jUnit classes included.
04/15/2003 : VorbisSPI 0.7a
---------------------------
META-INF/services folder fixed.
03/24/2003 : VorbisSPI 0.7
--------------------------
- OGG Vorbis streaming support improved.
+ JOrbis 0.0.12 included.
03/04/2002 : VorbisSPI 0.6
--------------------------
- OGG Vorbis streaming support improved.
- Nominal BitRate added to encoding type.
- File length returned.
+ JOrbis 0.0.11 included.
10/01/2001 : VorbisSPI 0.5
--------------------------
+ JOrbis 0.0.8 included.
Project started. It is licensed under LGPL.
Note :
-----
Ogg Vorbis is a fully Open, non-proprietary, patent-and-royalty-free,
general-purpose compressed audio format for high quality (44.1-48.0kHz,
16+ bit, polyphonic) audio and music at fixed and variable bitrates
from 16 to 128 kbps/channel. This places Vorbis in the same class as audio
representations including MPEG-1 audio layer 3, MPEG-4 audio (AAC
and TwinVQ), and PAC.
Vorbis is the first of a planned family of Ogg multimedia coding formats
being developed as part of Xiphophorus's Ogg multimedia project.
|
