The text render extension draws a string to the screen. Strings can be wrapped on word boundaries and also rotated orthogonally. The following shows the effects of rotation on strings.
The text render extension uses many standard options but also includes:
- Text
-
The text string to display (string, optional)
- Font
-
The font to use (string, optional)
- Size
-
The point size of the string (number, optional)
- Underline
-
Specifies if the string show display an underline (1) or not display an underline (0 default).
- Overflow
-
Defines behaviour when text overflows available horizontal space. Options are do nothing ("none" default), wrap at word boundaries ("wrap"), wrap at character boundaries ("char") or end text with an ellipsis ("ellipsis").
- Rotation Style
-
Defines the behavior of text rotation and alignment.
(fixed) possible values are 0, 90, 180, 270, other values will be treated as 0
(free) any rotation angle can be specified, and the alignment and rotation will behave like the fill render extension with this option specified
(path) uses the next render extension on the control to align the text to a polygon or circle. Vertical alignment is ignored with this option specified
Rotation and position are determined on a per-glyph basis, along the specified path. If none of these are specified, the behavior will default back to the legacy behavior prior to Storyboard 7.2.