cpython/Demo/sgi/video
Thomas Wouters 7e47402264 Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either
comments, docstrings or error messages. I fixed two minor things in
test_winreg.py ("didn't" -> "Didn't" and "Didnt" -> "Didn't").

There is a minor style issue involved: Guido seems to have preferred English
grammar (behaviour, honour) in a couple places. This patch changes that to
American, which is the more prominent style in the source. I prefer English
myself, so if English is preferred, I'd be happy to supply a patch myself ;)
2000-07-16 12:04:32 +00:00
..
.cvsignore Hide .fdc files here. 1997-05-28 16:14:48 +00:00
DisplayVideoIn.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
Dsend.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
IN.py Python equivalent of <netinet/in.h> (SGI specific, hence not in python/lib). 1992-09-24 15:02:46 +00:00
LiveVideoIn.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
LiveVideoOut.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
Makefile
OldVcopy.py Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either 2000-07-16 12:04:32 +00:00
README Vrec.py, Vrecb.py: 1993-02-25 16:10:16 +00:00
VCR.py Fixed faulty apply call 1994-06-07 14:44:02 +00:00
VFile.py Use constants defined in cl module. (Sjoerd) 1998-10-09 13:26:29 +00:00
VGrabber.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
Vaddcache.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vb.py Use constants defined in cl module. (Sjoerd) 1998-10-09 13:26:29 +00:00
VbForm.fd VFile - Added support for creating compression lib movies 1993-07-23 11:59:25 +00:00
Vcopy.py typos fixed by Rob Hooft 2000-06-28 14:48:01 +00:00
VcrIndex.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
Vedit.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
VeditForm.fd VFile.py: fix bogus getrandomframe(). 1993-02-16 16:10:02 +00:00
Vfix.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vgeneric.py Vgeneric -- used in frozen version 1994-10-07 11:05:50 +00:00
Viewer.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
Vinfo.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vmkjpeg.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vplay.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vrec.py Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either 2000-07-16 12:04:32 +00:00
Vrecb.py Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either 2000-07-16 12:04:32 +00:00
Vrecc.py Added mono, grey2 and grey4 formats 1992-12-23 15:37:20 +00:00
Vreceive.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vsend.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vstat.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
Vtime.py typos fixed by Rob Hooft 2000-06-28 14:48:01 +00:00
Vunjpeg.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
aplay.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
cam.py
camcorder.py
cmif-film.ms
colorsys.py
i2v.c
imgconv.py Removed unnecessary import of cl and CL. (Sjoerd) 1998-10-09 13:26:01 +00:00
makemovie.py Minor improvements, comments; fix Vinfo -d. 1992-08-18 21:11:18 +00:00
rgb2video.py Uniformly replaced init() functions by __init__() constructors. 1993-12-17 15:11:41 +00:00
senddefs.py Added options to Vsend and Vreceive; moved common defaults to senddefs. 1992-09-24 15:01:37 +00:00
squash.c
squash2.c
statit.py
svgrab24.c Grab a 24-bit image off the StarterVideo 1993-06-08 12:48:44 +00:00
syncaudio.py
tomono.c
tv.py
v2i.c
vcopy.py Changes for supporting monochrome and greyscale video (not yet fully 1992-12-14 12:25:21 +00:00
video.doc Added usage() and help() to Vrecb, and turn on -f by default. 1993-02-05 15:34:22 +00:00
video.py Append /ufs/guido/src/video to sys.path. 1992-05-12 12:33:44 +00:00
video2rgb.py /usr/local/bin/python -> /usr/bin/env python 1996-11-27 19:52:01 +00:00
vinfo.py Print real width and warn for stride not a multiple of 4 bytes 1992-05-07 15:21:52 +00:00
vpregs.py
vtime.py
watchcursor.py Fixed watch cursor origin 1993-03-17 12:11:47 +00:00

README

CMIF video tools
================

This directory contains Python and C programs to manipulate files
containing digitized video in the "CMIF video format".

An introduction to using the basic tools is in the file "video.doc".

A description of the video file format is in the file "cmif-film.ms"
(troff/nroff -ms input).


History
-------

We started this in October 1991, when we had a large framegrabber
board on loan from SGI for a few weeks: we developed a movie recording
program and added numerous features, including still frame capture and
synchronous sound recording using a second machine (the machine
holding the framegrabber board didn't have audio).

During the following months, when we started using and processing the
recorded film fragments, the "CMIF video format" was revised several
times, and we eventually created an object-oriented interface for
reading and writing various incarnations of these files, called VFile.
(This module is also used by our flagship application, the CMIF
editor, not in this directory but in /ufs/guido/mm/.)

When we got our own Indigo entry-level video board (in June 1992) and
a version of the Irix video library that supported capturing PAL
format (in August 1992), Sjoerd added an interface to the video
library to Python (sv) and Guido wrote Vrec.py (based upon a still
frame grabber by Sjoerd, in turn based upon SGI demo code in C) to
record a movie using it.  Vrec was soon followed by modernized
versions of the other programs (Vinfo, Vplay, Vtime) and an
interactive editor (Vedit).  Finally, VFile was rewritten for more
modularity, functionality and robustness, and various other tools were
added as needed.  Also, new options were added to existing tools, and
several new video file formats were added.

	Guido van Rossum
	Jack Jansen
	Sjoerd Mullender


Overview of files
-----------------

cmif-film.ms	description of the CMIF video file format (more than a
		little out of date -- read the source for VFile for
		more info about new file formats)


These are programs with a command line interface:

Vrec.py		record video movies using the Indigo video library and
		board

Vplay.py	play video movies

Vinfo.py	show statistics on movies

Vtime.py	Copy a video file, manipulating the time codes (e.g.
		faster/slower, or regenerate time codes, or drop
		frames too close apart)

Vcopy.py	Universal video file copying tool.  Can manipulate the
		time codes, change the type, size, and packfactor.
		Subsumes Vtime.py.

Vmkjpeg.py	compress an rgb or grey video file to jpeg[grey] format

Vunjpeg.py	expand a jpeg[grey] video file to rgb or grey format

Vfix.py		truncate the scan line width of a video file to
		a multiple of 4 ('grey' images only)

Vedit.py	interactive video editing program (uses the FORMS library)

Vsend.py	unicast or multicast live video as UDP packets

Vreceive.py	receive transmissions from Vsend

Vaddcache.py	add a "cached index" to a video file, for faster playing

Vrecb.py	like Vrec.py but uses "burst capture" -- somewhat specialized

Dsend.py	like Vsend.py but sends screen snapshots (to Vreceive.py)

DisplayVideoIn.py	Like LiveVideoIn.py but reads screen snapshots

rgb2video.py	combine a sequence of rgb image files into a CMIF video file

video2rgb.py	split a CMIF video file into a sequence of rgb image files


These modules and files are used by the above programs:

VFile.py	classes that read and write CMIF video files

Viewer.py	two viewer classes used by Vedit

LiveVideoIn.py	live video input class, used by Vsend

LiveVideoOut.py	live video output class, used by Vsend and Vreceive

imgconv.py	Image conversion subroutines for rgb2video.py

senddefs.py	Defaults shared by Vsend and Vreceice

watchcursor.py	Generally useful module to define a watch cursor in GL

VeditForm.fd	FORMS' fdesign definition for Vedit's form