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. |
Applies a raised text effect onto an image. |
last modified: December 15, 2018
USAGE: bumptext -t text -s size [-p pointsize] [-f font] [-m mode] [-a angles] [-i intensity] [-g gravity] [-o offsets] [-c color] [-b blendval] infile outfile
-t .... text ............ text to apply to image; enclose in quotes PURPOSE: To apply a raised text effect onto an image. DESCRIPTION: BUMPTEXT applies a raised text effect onto an image. The text my be applied in either label or caption mode. Optionally, the image may be colorized. ARGUMENTS: -t text ... TEXT to apply to image. Be sure to enclose in quotes. -s size ... SIZE of text box. In label mode, the text will be placed all in one line. The size of the text will be determined either by the text box width or height or pointsize. Specifying pointsize and width or height is not a valid combination. In caption mode, the text will be placed in multiple rows as determined by the text box width and height. Pointsize may optionally be supplied in addition to the text box width and height. -p pointsize ... POINTSIZE is the size of the font. Values are integers greater than 0. The default is unspecified, so that the pointsize will be determined from the textbox width, height or widthxheight. -f font ... FONT is the text font or path to the font file. The default is Helvetica. -m mode ... MODE for adding text. Options are either label or caption. In label mode the text will all be in one row as determined by either the text box width or height or pointsize. In caption mode, the text will be on multiple rows to fill the text box width and height. The pointsize may be optionally specified along with the text box width and height. -a angles ... Angles are the AZIMUTHxALTITUDE angles used to specify the direction of lighting to create the bump effect. Azimuth angles are integers between 0 and 360 degrees. Altitude angles are integers between 0 and 90 degrees. The default="120x45" -i intensity ... INTENSITY is the intensity or strength of the raised text. Values are integers>=0. The default=20 -g gravity ... GRAVITY is the standard IM -gravity locations for placing the text. Choices are: northwest, north, northeast, west, center, east, southwest, south and southeast. The default=northwest. -o offsets ... OFFSETS are the x and y pixel offsets of the text location from the gravity settings. This is implemented via the -geometry setting. The default="+0+0" or no offset from the specified gravity setting. -c color ... COLOR is the colorization color to apply to the image. Choices are any valid opaque IM color specification. The default=white See http://imagemagick.org/script/color.php -b blendval ... BLENDVAL is the colorization blending amount. Values are integers between 0 and 100. A value of 0 is no colorization (the image is unchanged). A value of 100 changes the image to a constant color specified by the color argument. The default=0. 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. |
Original Image |
|
Arguments: -m label -s 300x -b 0 -a 120x45 -i 20 -g southeast -o "+10+10" -t "HAPPY HOLIDAYS" |
|
Arguments: -m label -s 300x -c white -b 70 -a 120x45 -i 20 -g southeast -o "+10+10" -t "HAPPY HOLIDAYS" |
|
Arguments: -m label -s 300x -c white -b 70 -a 120x45 -i 20 -g northwest -o "+10+10" -t "HAPPY HOLIDAYS" |
|
Arguments: -m caption -s 280x -p 36 -c white -b 70 -a 120x45 -i 20 -g northwest -o "+10+10" -t "HAPPY HOLIDAYS" |
What the script does is as follows:
This is equivalent to the following IM commands for the label case.
|