Debian Codegraph @

README

raw
1
2 MPEG, CCITT H.261 (P*64), JPEG
3 Image and Image sequence compression/decompression C software engines.
4
5
6 The Portable Video Research Group at Stanford have developed
7 image/image sequence compression and decompression engines (codecs)
8 for MPEG, CCITT H.261, and JPEG. The primary goal of these codecs is
9 to provide the functionality - these codecs are not optimized for
10 speed, rather completeness, and some of the code is kludgey.
11
12 Development of MPEG, P64, and JPEG engines has not been the primary
13 goal of the Portable Video Research Group. Our research has been
14 focused on software and hardware for portable wireless digital video
15 communication. The charter of this group ended in the summer of 1994.
16
17 COMMENTS/DISCLAIMERS:
18
19 This code has been compiled on the Sun Sparc and DECstation UNIX
20 machines; some code has been further checked on HP workstations.
21
22 For comments, bugs, and other mail relating to the source code, we
23 appreciate any comments. The code author can still be reached at Andy
24 C. Hung at [email protected]. The standard public domain
25 disclaimer applies: Caveat Emptor - no guarantee on accuracy or
26 software support.
27
28 References related to these codecs should NOT use any author's name,
29 or refer to Stanford University. Rather the Portable Video Research
30 Group or the acronym (PVRG) should be used, such as PVRG-MPEG,
31 PVRG-P64, PVRG-JPEG.
32
33 ANONYMOUS FTP:
34
35 The following files can be obtained through anonymous ftp from
36 havefun.stanford.edu, IP address [36.2.0.35]. The procedure is to use
37 ftp with the user name "anonymous" and an e-mail address for the
38 password.
39
40 CODEC DESCRIPTION:
41
42 I) PVRG-MPEG CODEC: (pub/mpeg/MPEGv1.2.1.tar.Z)
43
44 This public domain video encoder and decoder was generated according
45 to the Santa Clara August 1991 format. It has been tested
46 successfully with decoders using the Paris December 1991 format. The
47 codec is capable of encoding all MPEG types of frames. The algorithms
48 for rate control, buffer-constrained encoding, and quantization
49 decisions are similar, but not identical, to that of the (simulation
50 model 1-3) MPEG document. The rate control used is a simple
51 proportional Q-stepsize/Buffer loop that works though not very well -
52 better rate-control is the essence for good quality buffer-constrained
53 MPEG encoding. Verification of the buffering is possible so as to
54 provide streams for real-time decoders.
55
56 The MPEG codec performs compression and decompression on raw raster
57 scanned YCbCr (also known as digital YUV) files. The companion display
58 program for the X window system is described in section IV) below. A
59 manual of approximately 50 pages describes the program's use.
60
61 There are also MPEG compressed files from the table tennis sequence in
62 tennis.mpg and the flower garden sequence in flowg.mpg.
63
64 This codec was recently tested with the MPEG decoder of the Berkeley
65 Plateau Research group. If what you want is decoding and X display,
66 then you might want to look into their faster public domain MPEG
67 decoder/viewer. The Berkeley player is available via anonymous ftp
68 from toe.cs.berkeley.edu (128.32.149.117) in
69 /pub/multimedia/mpeg/mpeg-2.0.tar.Z. There is also an encoder at that
70 site. An ISO mpeg2 encoder and decoder is available by anonymous ftp
71 from ftp.netcom.com in the directory pub/c/cfogg/mpeg2 (alternate sites
72 may include ftp.uu.net).
73
74
75 II) PVRG-P64 CODEC: (pub/p64/P64v1.2.tar.Z)
76
77 This public domain video encoder and decoder is based on the CCITT
78 H.261 specification. Some encoding algorithms are based on the RM 8
79 encoder. We have tested it against a verified encoded sequence on the
80 CCITT 1992 specifications, but we would still appreciate anyone having
81 p64 video test sequences to let know. Like the MPEG codec, it
82 supports all the encoding and decoding modes, and has provisions for
83 buffer-constrained encoding, so it can produce streams for real-time
84 decoders.
85
86 The H.261 codec takes the similar YCbCr raster scanned files as the MPEG
87 codec, and performs compression and decompresion on raster scanned
88 YCbCr files. It can take standard CIF or NTSC-CIF files. The display
89 of these programs is described in section IV) below. A manual of
90 approximately 50 pages describes its use.
91
92 There are also P64 compressed files from the table tennis sequence in
93 table.p64 and the flower garden sequence in flowg.p64. The Inria
94 codec also performs H.261 video compression and is integrated into a
95 teleconferencing system; it can be obtained from avahi.inria.fr, in
96 /pub/h261.tar.Z.
97
98 III) PVRG-JPEG CODEC: (pub/jpeg/JPEGv1.2.tar.Z)
99
100 This public domain image encoder and decoder is based on the JPEG
101 Committee Draft. It supports all of the baseline for encoding and
102 decoding. The JPEG encoder is flexible in the variety of output
103 possible. It also supports lossless coding, though not as speedy as
104 we would like. The manual is approximately 50 pages long which
105 describes its use. The display program for JFIF-style (YCbCr) files is
106 described in section IV) below. The JFIF style is not a requirement
107 for this codec - it can compress and decompress CMYK, RGB, RGBalpha,
108 and other formats - this codec may be helpful if you wish to extract
109 information from non-JFIF encoded JPEG files.
110
111 This codec has been tested on publicly available JPEG data. For
112 general purpose X display, you might want to try the program "xv"
113 (version 2.0 or greater). The JPEG engine of the program "xv" is
114 based on the free, portable C code for JPEG compression available from
115 the Independent JPEG Group. (anonymous login - ftp.uu.net (137.39.1.9
116 or 192.48.96.9) /graphics/jpeg/jpegsrc.v4.tar.Z).
117
118 IV) X VIEWER: (pub/cv/CVv1.2.1.tar.Z)
119
120 This viewer allows the user to look at image or image sequences
121 generated through the codecs described above. These image or image
122 sequences are in the YCbCr (also known as digital YUV) colorspace
123 (either JFIF specified or CCIR 601 specified) and may be 4:1:1 (CIF,
124 or MPEG 4:2:0 style) or 2:1:1 (CCIR-601 4:2:2 style) or 1:1:1
125 (non-decimated or CCIR-601 4:4:4 style). A short manual of
126 approximately 2 pages describes its use.
127
128 ACKNOWLEDGEMENTS:
129
130 Funded by the Defense Advanced Research Projects Agency.
131
132 I am especially grateful to Hewlett Packard and Storm Technology for
133 their financial support during the earlier stages of codec
134 development. Any errors in the code and documentation are my own.
135 The following people are acknowledged for their advice and assistance.
136 Thanks, one and all.
137
138 The Portable Video Research Group at Stanford:
139 Teresa Meng, Peter Black, Navin Chaddha, Ben Gordon,
140 Sheila Hemami, Wee-Chiew Tan, Eli Tsern.
141
142 Adriaan Ligtenberg of Storm Technology.
143 Jeanne Wiseman, Andrew Fitzhugh, Gregory Yovanof and
144 Chuck Rosenberg of Hewlett Packard.
145 Eric Hamilton and Jean-Georges Fritsch of C-Cube Microsystems.
146
147 Lawrence Rowe of the Berkeley Plateau Research Group.
148 Tom Lane of the Independent JPEG Group.
149 Katsumi Tahara, Sony.
150 Ciaran Mc Goldrick.
151 Karl Lillevold.
152 Mats Lofkvist.
153 Hiroshi Saitoh, Panasonic.
154 Frank Gadegast.
155 Chad Fogg, Cascade.
156 Thierry Turletti, Inria.
157 Anders Klemets.
158 Graham Logan.
159 Jelle van Zeijl.
160 George Warner, AT&T.
161 Chris Adams, Hewlett Packard.
162 Kent Murray, Atlantic Centre For Remote Sensing Of The Oceans.
163 I. C. Yang.
164 Donald Lindsay.
165 Harald A. Schiller, Tektronix.
166 Ismail Dalgic.
167 Tom Shield.
168 Y. Fujii.