MediaScript Objects and Methods 73
•
•
•
•
•
“extrabold” or “ultrabold” (“extra” or “ultra” are also acceptable)
•
“heavy” or “black”
Other Style parameter values are “Underline”, “Italic” or “Italics”, and “Strikethru” or
“Strikeout”).
NOTE: You can combine Style parameter values. For example: Style @ “Bold Italic”
Text - specifies the text to be drawn. The text string must be enclosed in quotes. To indicate
a line break, insert \n into the text.
Color - specifies the color to be used for the text. The default value for text color is the
image’s foreground color. For more information about setting an image’s foreground color,
see setColor().
If a color palette is available for coloring the text, you can use the Index parameter to
colorize the image (as an alternative to the Color parameter).
NOTE: You cannot specify values for both the Color and Index parameters.
Unlock - specifies a color value that determines which pixels are displayed in the overlaid
source image. Using this parameter causes the selected foreground (source) image to
display only where the specified color value appears in the current (background) image.
Saturation - specifies the value used for the weighting for the change in saturation for
destination pixels. A value of 255 changes the saturation of pixels to the specified color. A
value of 128 changes the saturation of a pixel to a mid-value between the pixel’s current
color and the specified color.
NOTE: The Saturation parameter only functions when the Blend parameter is set to
“colorize.”
Size - sets the point size of the font to be used. The default size is 12.
Justify - specifies how the text will be justified. The default is “center”. Other options are
“left”, “right”, and “justified”. (The “justified” option is available for Windows only.) This
parameter only affects text with multiple lines.
Wrap - specifies a value used to force a new line whenever the text gets longer than the
specified number of pixels (in this case correct word breaking is used).
Opacity - specifies opacity of the text. The default value is 255 (completely solid).
X and Y - specify the text’s position on the image, based on text’s anchor point. The default
value is the center point of the image.
Handlex and Handley - specify the anchor point of the text (for example, Handlex =
left/center/right, Handley= top/middle/bottom) relative to the placement point of the
image (as specified by the X and Y parameters described above). The default values are
center and middle.
Angle - allows the text to be rotated clockwise by the specified angle (in degrees).
Line - specifies line spacing. The default spacing between lines of text is 1.5.
Smooth - specifies that the text is drawn with five-level anti-aliasing.
