Copyright © Fred Weinhaus My scripts are available free of charge for non-commercial (non-profit) use, ONLY. For use of my scripts in commercial (for-profit) environments or non-free applications, please contact me (Fred Weinhaus) for licensing arrangements. My email address is fmw at alink dot net. If you: 1) redistribute, 2) incorporate any of these scripts into other free applications or 3) reprogram them in another scripting language, then you must contact me for permission, especially if the result might be used in a commercial or for-profit environment. Usage, whether stated or not in the script, is restricted to the above licensing arrangements. It is also subject, in a subordinate manner, to the ImageMagick license, which can be found at: http://www.imagemagick.org/script/license.php Please read the Pointers For Use on my home page to properly install and customize my scripts. |
Creates a sinusoidal curved scrolling text animation. |
last modified: December 15, 2018
USAGE: sinescrolltext -t "text" [-w width ] [-f font] [-c color] [-b bgcolor ]
[-a amplitude ] [-r repeats] [-p phase] [-F frames] [-d delay] [-D direction]
[-m mode ] [-R range] [infile] outfile
-t ... text ........ text string to be used to create the animation; required argument PURPOSE: Creates a sinusoidal curved scrolling text banner animation. DESCRIPTION: SINESCROLLTEXT creates sinusoidal curved scrolling text banner animation. The scrolling can be either to the right or left. The amplitude of the sine wave can be either constant or tapered to zero. ARGUMENTS: -t text ... TEXT string to be used to create the animation. This is a required argument -w width ... WIDTH of text in pixels. Values are integers>0. The default=500. The image height will be determined from the text height and the amplitude. -f font ... FONT to use for the text. Either the font name or path to font file may be used. The default=arial. -c color ... COLOR of the text. Any valid IM color is allowed. The default=black. -b bgcolor ... BGCOLOR is the background color for the animation frames. Any valid IM color is allowed. The default=white. -a amplitude ... AMPLITUDE (height up or down) of the text sine wave as a multiplier of the text height. Values are floats>=0. The default=1. -r repeats ... REPEATS are the number of repeats of the sine waveform cycle to span the image width. Values are floats>0. The default=1. (typically, in half or integer values). -p phase ... PHASE of the sinusoidal wave. The choices are 0 and 180. The default=0. -F frames ... FRAMES is the number of frames to generate in the animation. Values are integers>0. The default=25. -d delay ... DELAY is the animation delay between frames. Values are integers>0. The default=30. -D direction ... DIRECTION of the scrolling. Choices are: left (l) or right (r). The default=left. -m mode ... MODE for the type of sine wave amplitude. The choices are: constant (c) and tapered (t) to zero amplitude. The default=constant. -R range ... RANGE of the sine taper to zero amplitude as percent of width of the image. Values are 1<=integer<=100. The default=100 (tapered over the full width). A nominal value is 75. infile is optional and will be tiled (or cropped) to replace the background color. CAVEAT: No guarantee that this script will work on all platforms, nor that trapping of inconsistent parameters is complete and foolproof. Use At Your Own Risk. |
Example 1 |
Arguments: |
Arguments: |
Arguments: |
Arguments: |
Arguments: |
Arguments: |
Arguments: |
Example 2 |
Input: |
Arguments: |
What the script does is as follows:
This is equivalent to the following IM commands for the case of mode=constant
|