Return to man.page CVS log

Up to [Research Unix] / researchv10dc / cmd / omovie

Annotation of researchv10dc/cmd/omovie/man.page, revision 1.1.1.1

1.1       root        1: .de DS
                      2: .if n .sp 1
                      3: .if t .sp 3p
                      4: .nf
                      5: .ft CW
                      6: ..
                      7: .de DE
                      8: .fi
                      9: .ft 1
                     10: .if n .sp 1
                     11: .if t .sp 3p
                     12: ..
                     13: .TH MOVIE 1
                     14: .SH NAME
                     15: movie, stills \- algorithm animation
                     16: .SH SYNOPSIS
                     17: .B movie
                     18: [ file ]
                     19: .br
                     20: .B stills
                     21: [ file ]
                     22: .SH DESCRIPTION
                     23: The first step in animating an algorithm is to prepare a
                     24: .I "script file"
                     25: (with suffix
                     26: .BR ".s" )
                     27: using these commands:
                     28: .DS
                     29: \f2optional label:\fP text   \f2options\fP \f2x\fP \f2y\fP \f2string\fP
                     30: \f2optional label:\fP line   \f2options\fP \f2x1\fP \f2y1\fP \f2x2\fP \f2y2\fP
                     31: \f2optional label:\fP box    \f2options\fP \f2x1\fP \f2y1\fP \f2x2\fP \f2y2\fP
                     32: \f2optional label:\fP circle \f2options\fP \f2x\fP \f2y\fP \f2radius\fP
                     33: erase  \f2label\fP
                     34: clear
                     35: click  \f2optional_name\fP
                     36: view   \f2name\fP
                     37: .DE
                     38: .PP
                     39: The command
                     40: .BR "movie fname.s"
                     41: develops
                     42: .BR fname.s
                     43: into the intermediate file
                     44: .BR fname.i
                     45: and uses that intermediate file to project the movie in a 
                     46: .IR mux (9.1)
                     47: or Sun window.
                     48: Button 1 stops and starts the movie;
                     49: button 2 adjusts view sizes and selects times;
                     50: button 3 sets various parameters.
                     51: .PP
                     52: The program
                     53: .I stills
                     54: is a preprocessor that converts commands bracketed by
                     55: .BR \&.begin
                     56: .BR stills
                     57: and
                     58: .BR \&.end
                     59: into
                     60: .IR pic (1)
                     61: commands; other output is passed through untouched.
                     62: Commands include
                     63: .DS
                     64: view   \f2viewname\fP \f2optional title, with blanks\fP
                     65: print  all | final | \f2clickname\fP all | \f2clickname\fP \f2int\fP+
                     66: file   \f2filename\fP.s
                     67: \f2parameter_name\fP  \f2value\fP
                     68: .DE
                     69: The script file is developed before being used.
                     70: Parameters include
                     71: .BR frameht
                     72: and
                     73: .BR framewid
                     74: (in inches),
                     75: .BR frames
                     76: and
                     77: .BR times
                     78: .BR "" ( invis
                     79: or
                     80: .BW vis )
                     81: and
                     82: .BR across
                     83: and
                     84: .BR down
                     85: (an optional value tells how many frames across or down the page).
                     86: .SH EXAMPLES
                     87: An insertion sort program might be animated by augmenting
                     88: the comparison and swap routines to write the script file
                     89: .BR "sort.s" .
                     90: One plays the movie by the command
                     91: .BR "movie sort.s" .
                     92: To make a series of several stills from the file, give
                     93: .I stills
                     94: input such as
                     95: .DS
                     96: \&.begin stills
                     97: file sort.s
                     98: print stages all
                     99: \&.end
                    100: .DE
                    101: .SH FILES
                    102: .br
                    103: .BR anim :
                    104: host end of animation; calls animterm
                    105: .br
                    106: .BR animterm :
                    107: terminal end of animation
                    108: .br
                    109: .BR develop
                    110: converts
                    111: .BR file.s
                    112: into
                    113: .BR file.i
                    114: if necessary; calls
                    115: .BR fdevelop
                    116: .br
                    117: .BR fdevelop
                    118: is used by develop
                    119: .SH SEE ALSO
                    120: .IR pic (1),
                    121: .IR troff (1).
                    122: .br
                    123: .IR "A System for Algorithm Animation" ,
                    124: J. L. Bentley and B. W. Kernighan,
                    125: CSTR 132 (Jan. 1987)
                    126: .SH BUGS
                    127: Inevitably.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.