play_data(1L)

NAME
play_data - play back the video portion of a $HOME MOVIE.

SYNOPSIS
play_data [-x <pels>] [-y <pels>] [-w <pels>] [-h <pels>] [-s <speed>] <script1> 2>/dev/null
vcr | play_data -v [-x <pels>] [-y <pels>] [-w <pels>] [-h <pels>] | play_audio 2> /dev/null

DESCRIPTION
play_data manages the playback of an $HOME MOVIE video script. play_data currently runs only on monochrome Sun Workstations.

In the first incantation, play_data reads script as a file generated by $HOME MOVIE (or stdin if script is "-") and plays it back on the sun console. If script ends in .Z , do_data calls zcat to uncompress it first.

The command line flags x,y,w,h specify the portion of the Sun display to use. X and y indicate the origin from the upper left corner, whereas w and h are the width and height in pixels. The s flag specifies the playback speed in percent of normal. A speed of 200 plays back twice as fast as the default value of 100.

In the second incantation, vcr mode, do_data accepts commands from vcr an MGR based driver program. The x,y,w, and h flags retain their meaning. The playback speed in controlled through the vcr interface. Vcr input to play_data consists of one of the following commands:

S	script
    Starts playing the script script.

s speed
    sets the playback speed (in percent).

P pid
    Sets the id of the process to send a hangup signal when the playback is finished.

All other commands are written to stdout, to potentially be interpreted by a downstream filter. Additional commands are sent to stdout to synchronize and control play_audio which plays back the audio portion of the $HOME MOVIE script. These include

S script
    to start a new sound script.

s speed
    to set the audio playback speed and

B bytes
    to indicate the current byte offset into the audio file.

If The environment variable DEBUG is set, debugging output is spewed onto stderr.

BUGS

*   play_data is still under development and emits debugging stuff to stderr.

*   play_data only reads commands (in vcr mode) during pauses in the playback. If the playback speed too fast there are no pauses, and no commands are interpreted.

SEE ALSO
mgr(1L) play_audio(1L) movie(1L) roll(1L) vcr(1L)

AUTHOR
S. A. Uhler