Previous Element | Next Element |
Segment
This defines a single text segment inside a Textfield
symbol. All text in a segment shares a common font, text
size, and color. The first segment must define a font, font
size and color. All subsequent segments can inherit those
attributes from segments defined previously. The segment
must contain at least one character specified in either the
text attribute or in the binaryCodes attribute and the
maximum muber of characters in a Segment is 255.
Attributes
| fontID | The name of the Font or FontDefinition symbol used to render the text. | |
| Type | String | |
| fontSize | The size of the font used to render the text. | |
| Type | Float | |
| x | Optional X position to place text. Continues from prior segment (0 if this is the first Segment element) if not specified. | |
| Type | Float | |
| Default Value | 0 | |
| y | Optional Y position to place text. Continues from prior segment (0 if this is the first Segment element) if not specified. | |
| Type | Float | |
| Default Value | 0 | |
| text | Actual text string to render. | |
| Type | String | |
| binaryCodes | Alternative representation or text string to render specifying a tuple of character codes used in the text. This can be used where no codes are applicable for the glyphs stored in the font and each glyph is referenced by index only. This can occasional occur for some pre-existing optimized SWF movies. | |
| Value Template | (Code,...) | |
| From Value | 1 | |
| To Value | Unlimited provided codes are defined within the Font element. | |
| color | The color specified as an RGB/RGBA tuple, a hex string or a color name. The first number of the tuple represents the red intensity, the second green, and the third blue. A minimum value of 0 for each color results in black and a max value of 255 for each color results in white. For RGBA the first three attributes are the same as above and the fourth is the degree of opacity of the color with 0 being totally transparent and 255 totally opaque. Alternatively the color can be specified as in SVG either in hexadecimal with a '#' leading character or by name using the color names defined in the SVG specification. Since these do not specify opacity, an additional opacity attribute can be defined. | |
| Value Template | rgb(Color, Color, Color) | |
| Value Template | rgba(Color, Color, Color, Color) | |
| From Value | 0 | |
| To Value | 255 | |
| Value Template | #ColorColorColor | |
| From Value | 00 | |
| To Value | ff | |
| Value Range | Any SVG color name supported in the SVG1.1 specification. | |
| opacity | Optional attribute specifying the opacity of the color with 0 being totally transparent and 1.0 totally opaque. This will override any opacity channel value specified as part of the color attribute. | |
| From Value | 0.0 | |
| To Value | 1.0 | |
| Default Value | 1.0 | |
| advances | Optional list of advances for each specified text character. Each advance is added to the current X position after rendering a character. This allows tight control over rendering. If a value of 'auto' is specified then the the system will calculate advances automatically using the specified font. Negative advances permits the text to flow from right-to-left. | |
| Value Template | (Advance,...) | |
| Type | Float | |
Child Elements
None
Parent Elements
TextExamples
Text Segments ExampleUser-Defined Font Example
Clipping and Text Clipping Example
Timeline Replace Examples
Previous Element | Next Element |