Name
ScaleTextObject -- scale a text object (V4.0)
Synopsis
ScaleTextObject(id, width, height[, smooth])
Library
text

Function
This command scales the text object specified by id to the specified dimensions. If the text object uses a vector font it will be scaled without a loss of quality. Optionally, you can choose to enable anti-aliased interpolation by passing True in the smooth argument.

You can pass #KEEPASPRAT as either width or height. Hollywood will calculate the size then automatically by taking the aspect-ratio of the text object into account. The width and height arguments can also be a string containing a percent specification, e.g. "50%".

Note that for vector text objects, ScaleTextObject() will always operate on the untransformed text object. This means that any previous transformations applied to the text object using ScaleTextObject(), TransformTextObject(), or RotateTextObject() will be undone when calling ScaleTextObject().

Inputs
id
identifier of the text object to scale
width
desired new width for the text object
height
desired new height for the text object
smooth
optional: whether or not anti-aliased interpolation shall be used (V9.1)
Example
ScaleTextObject(1, 600, 200)
Scales text object 1 to a resolution of 600x200.
Show TOC