74 Chapter 3
•
•
•
•
SmoothFactor - specifies the power of two for image scale-based smoothing. If “1” is
specified, the text will be drawn at twice the specified size and scaled down. If “2” is
specified, the text is drawn at four times the size. This scaling produces smoother text for
renderers with poor anti-aliasing at smaller text sizes. The Smooth parameter must be set
to “true” for this parameter to have any effect.
Baseline - if specified, the text is treated as though it is always the height of the largest
character. This allows text to be aligned between different calls to the function. The
distance, in pixels, between the baselines of two lines of text is 1.5 times the point-size of
the text. Thus for 30-point text the line spacing is 45 pixels. If this parameter is not specified,
this function measures the actual height of the text and centers it accordingly.
Spacing - adjusts the spacing between the text characters. The default is 0. A negative
value draws the text characters closer together.
Kern - if set to “true”, which is the default, it optimizes the spacing between text
characters. If you do not want to use kerning, specify this parameter as “false”.
NOTE: PostScript fonts store the kerning information in a separate file with a .afm extension. This
file must be present in order for kerning to be applied to the text.
Blend - specifies the type of blending used to combine the drawn object with the images.
Blend options are: “Normal”, “Darken”, “Lighten”, “Hue”, “Saturation”, “Color”,
“Luminosity”, “Multiply”, “Screen”, “Dissolve”, “Overlay”, “HardLight”, “SoftLight”,
“Difference”, “Exclusion”, “Dodge”, “ColorBurn”, “Under”, “Colorize” (causes only the
hue component of the source to be stamped down on the image), and “Prenormal”.
Tile - if set to “true”, the text wraps continuously along both the x and y axis so that it
spans the entire target image. The tiling starts in the location specified by the X and Y and
HandleX and HandleY parameters. If not specified, tiling starts from the target image’s
center.
NOTE: If the source image is larger than the target image, setting the Tile parameter to true has
no effect, unless the source image is sufficiently offset from the center to allow this effect to display.
Append - if set to “true”, drawText() appends the text of the previous call to the specified
text string.
NOTE: Append works best when drawing a single line of left-justified text, as subsequent calls to
drawText() will not maintain the wrap or justification information.
ClearType - if specified as “true”, the Windows ClearType text renderer will be used if
available.
DPI - specifies the DPI used for text rendering. The default value is 72.
NOTE: The DPI parameter is not available if MediaRich is running on Mac, Linux, or Solaris.
