FADE(1)

NAME
fade - fade a $HOME MOVIE script from one scene to another

SYNOPSIS
fade [-b image] [-m drawing_mode] [-f bitblt_function] [-r random_delay] [-r delay[/step] ] [-x x-rects] [-y y-rects] [-t begin_pause[/end_pause] ] [-z]

DESCRIPTION
fade fades from one display image to another in MGR-Movie format. The display is broken into a grid of rectangles. Each rectangle is faded from one image to the next in one of several different orders.

OPTIONS

-b image
    Blend mode. image is a display image in MGR format that the current screen image will be faded to. If not specified, no final image is displayed, typically the display is faded to black or white.

-m drawing_mode
    The drawing mode indicates the order in which the screen patches are faded. Modes 0-5 represent random, scanning left to right, scanning top down, semi-random left to right, semi-random top down, and inside-out respectively. Modes 6-11 are the same, only right and left reversed. Modes 12-17 have up and down reversed, and 18-23 have everything reversed.

-f bitblt_function
    Specifies the blit operation to use for fading. Useful values are: 0-fade to black, 15-fade to white, 12-change to image and 14- paint on image.

-r random_delay
    adds a random amount of delay aftert each patch, up to random_delay 100ths of seconds. The default is zero.

-r delay
    Adds delay 100ths of seconds of delay after each rectangle. The default is 3. If step specifies the delay happens after every step patches.

-x x-rects
    Specifies the # of patches across the display. The default is 10.

-y y-rects
    Specifies the # of patches down the display. The default is 10.

-t begin_pause[/end_pause]
    A pause of begin_pause seconds is added before and a pause of end_pause seconds is added after fade is finished.

-z  activates logging to standard output.

AUTHOR
S. A. Uhler

SEE ALSO
roll(1), mgr(1), play_data(1), vcr(1)