DragonFly On-Line Manual Pages

Search: Section:  

cave(1)                DragonFly General Commands Manual               cave(1)


NAME

       cave - Play ascii character animations.


SYNOPSIS

       cave [ -hvSsqd ] [ -f fps ] [ -c cue ] [ -r regex ] [ -t seconds ] file
       ...


DESCRIPTION

       cave is an acronym for Character Animation Viewer for Everyone. It
       plays ascii character animations with an curses(3) interface.  cave
       tries to determine the location of the frame deliminator automatically
       (top or bottom of the frame).  Files compressed with gzip(1) are
       supported.


OPTIONS

       -f fps Initial frames-per-second. The default is 15.

       -c cue Skip this many frames when using the cue keys. The default is 8.

       -r regex
              An alternate extended regular expression used to specify a frame
              deliminator.  See REGEX EXAMPLES below.

       -d     Make a specified frame deliminator a value for a frame delay.
              This is the default if no alternate frame delay is specified.

       -s     Go directly into screensaver mode on startup cycling through
              multiple files.

       -S     Go directly into screensaver mode shuffling the order of files
              if more than one file is specified.

       -q     When in screensaver mode, quit after a keypress.

       -t seconds
              When in screensaver mode, if an animations length is less than
              this amount of seconds then it will loop until it is reached.
              The default is 30. Note that this only works when more than one
              file is specified.

       -h     Program help text.

       -v     Version and copyright information.


INTERACTIVE COMMANDS

       Press 'h' after loading a file to see a list of available interactive
       commands.


REGEX EXAMPLES

       ^[0-9]+[[:space:]]*$
              Match a line beginning (^) with at least one (+) digit ([0-9])
              with zero or more (*) trailing whitespace characters until end-
              of-line ($). This is the default and is used for frame delays.

       ^,$    Match a line beginning with a comma immediately followed by end-
              of-line.


SEE ALSO

       re_format(7), gzip(1)


AUTHOR

       Copyright (C) 2002 Ben Kibbey <bjk@arbornet.org>. Distributed under the
       terms of the GNU General Public License version 2.

                                                                       cave(1)

Search: Section: