Skip to content

asciisplash.1

Ronald Record edited this page Apr 29, 2022 · 1 revision

title: ASCIISPLASH section: 1 header: User Manual footer: asciisplash 1.0.0 date: March 27, 2022

NAME

asciisplash - Launch a fun splashy screen of ASCIImatics animations

SYNOPSIS

asciisplash [-a] [-b] [-C] [-c numcycles] [-d] [-j] [-J] [-m] [-p] [-s song] [-u]

NOTE: asciisplash can be run by invoking mpplus [-a] [-b] [-jJ] [-m] [-n num] [-N] [-p] [-R] [-S]

See man mpplus for details on how to front-end asciisplash with mpplus

DESCRIPTION

The asciisplash command plays one of the ASCIImatics animations included in Asciiville. It's a fun demonstration of some of the capabilities of the ASCIImatics library. By default, asciisplash will play a series of animations about MusicPlayerPlus. Command line options can be used to tell asciisplash to play animations for the Julia Set or a Plasma animation as well as play a public domain audio to accompany the ascii art display.

COMMAND LINE OPTIONS

-a : indicates play audio accompaniment

-b : indicates play alternate audio accompaniment

-c numcycles : specifies the number of times to cycle

-C : indicates use alternate comments in Plasma effect

-d : enabled debug mode

-J : indicates use Julia Set effect and play multiple zooms with different parameters

-j : indicates use Julia Set effect

-m : indicates use MusicPlayerPlus effect

-p : indicates use Plasma effect

-s song : specifies the audio file to use as accompaniment

-u : displays this usage message and exits

Without any options the MusicPlayerPlus effect will repeat

EXAMPLES

asciisplash : Without options asciisplash will play a series of animations about MusicPlayerPlus. These will repeat until the 'q' key is pressed.

asciisplash -c 10 : Plays the MusicPlayerPlus ASCIImatics animations 10 times then exits

asciisplash -j -c 5 : Plays the Julia Set ASCIImatics animation 5 times then exits

asciisplash -p : Plays the Plasma ASCIImatics animation in an endless loop until the 'q' key is pressed

asciisplash -p -C : Plays the Plasma ASCIImatics animation using alternate comments

asciisplash -a -c 1 : Plays the MusicPlayerPlus ASCIImatics animation for one cycle accompanied by a public domain audio

asciisplash -a -j -s /u/audio/deep.wav : Plays the Julia Set ASCIImatics animation and the audio file /u/audio/deep.wav as accompaniment

AUTHORS

Written by Ronald Record github@ronrecord.com

LICENSING

ASCIISPLASH is distributed under an Open Source license. See the file LICENSE in the ASCIISPLASH source distribution for information on terms & conditions for accessing and otherwise using ASCIISPLASH and for a DISCLAIMER OF ALL WARRANTIES.

BUGS

Submit bug reports online at:

https://github.com/doctorfree/Asciiville/issues

SEE ALSO

asciijulia(1), asciimpplus(1), asciiplasma(1), asciisplash-tmux(1), asciiville(1)

Full documentation and sources at:

https://github.com/doctorfree/Asciiville