2019-09-24 17:44:48 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-07-06 16:08:05 +08:00
<class name= "CharFXTransform" inherits= "RefCounted" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2019-09-24 17:44:48 +08:00
<brief_description >
2019-12-07 03:50:17 +08:00
Controls how an individual character will be displayed in a [RichTextEffect].
2019-09-24 17:44:48 +08:00
</brief_description>
<description >
2019-12-07 03:50:17 +08:00
By setting various properties on this object, you can control how individual characters will be displayed in a [RichTextEffect].
2019-09-24 17:44:48 +08:00
</description>
<tutorials >
2021-11-15 17:43:07 +08:00
<link title= "BBCode in RichTextLabel" > $DOCS_URL/tutorials/ui/bbcode_in_richtextlabel.html</link>
2019-09-24 17:44:48 +08:00
</tutorials>
<members >
2024-02-22 01:51:08 +08:00
<member name= "color" type= "Color" setter= "set_color" getter= "get_color" default= "Color(0, 0, 0, 1)" keywords= "colour" >
2019-12-07 03:50:17 +08:00
The color the character will be drawn with.
2019-09-24 17:44:48 +08:00
</member>
<member name= "elapsed_time" type= "float" setter= "set_elapsed_time" getter= "get_elapsed_time" default= "0.0" >
2021-10-09 21:06:58 +08:00
The time elapsed since the [RichTextLabel] was added to the scene tree (in seconds). Time stops when the [RichTextLabel] is paused (see [member Node.process_mode]). Resets when the text in the [RichTextLabel] is changed.
2019-12-07 03:50:17 +08:00
[b]Note:[/b] Time still passes while the [RichTextLabel] is hidden.
2019-09-24 17:44:48 +08:00
</member>
<member name= "env" type= "Dictionary" setter= "set_environment" getter= "get_environment" default= "{}" >
2019-12-07 03:50:17 +08:00
Contains the arguments passed in the opening BBCode tag. By default, arguments are strings; if their contents match a type such as [bool], [int] or [float], they will be converted automatically. Color codes in the form [code]#rrggbb[/code] or [code]#rgb[/code] will be converted to an opaque [Color]. String arguments may not contain spaces, even if they're quoted. If present, quotes will also be present in the final string.
For example, the opening BBCode tag [code][example foo=hello bar=true baz=42 color=#ffffff][/code] will map to the following [Dictionary]:
[codeblock]
{"foo": "hello", "bar": true, "baz": 42, "color": Color(1, 1, 1, 1)}
[/codeblock]
2019-09-24 17:44:48 +08:00
</member>
2023-06-21 17:06:32 +08:00
<member name= "font" type= "RID" setter= "set_font" getter= "get_font" default= "RID()" >
2020-10-02 20:02:02 +08:00
Font resource used to render glyph.
</member>
2021-09-21 17:27:06 +08:00
<member name= "glyph_count" type= "int" setter= "set_glyph_count" getter= "get_glyph_count" default= "0" >
Number of glyphs in the grapheme cluster. This value is set in the first glyph of a cluster. Setting this property won't affect drawing.
</member>
<member name= "glyph_flags" type= "int" setter= "set_glyph_flags" getter= "get_glyph_flags" default= "0" >
Glyph flags. See [enum TextServer.GraphemeFlag] for more info. Setting this property won't affect drawing.
</member>
2020-10-02 20:02:02 +08:00
<member name= "glyph_index" type= "int" setter= "set_glyph_index" getter= "get_glyph_index" default= "0" >
Font specific glyph index.
</member>
2019-09-25 01:45:03 +08:00
<member name= "offset" type= "Vector2" setter= "set_offset" getter= "get_offset" default= "Vector2(0, 0)" >
2019-12-07 03:50:17 +08:00
The position offset the character will be drawn with (in pixels).
2019-09-24 17:44:48 +08:00
</member>
2020-10-02 20:02:02 +08:00
<member name= "outline" type= "bool" setter= "set_outline" getter= "is_outline" default= "false" >
2021-05-20 18:07:26 +08:00
If [code]true[/code], FX transform is called for outline drawing. Setting this property won't affect drawing.
2020-10-02 20:02:02 +08:00
</member>
2019-09-25 01:45:03 +08:00
<member name= "range" type= "Vector2i" setter= "set_range" getter= "get_range" default= "Vector2i(0, 0)" >
2020-10-02 20:02:02 +08:00
Absolute character range in the string, corresponding to the glyph. Setting this property won't affect drawing.
2019-09-24 17:44:48 +08:00
</member>
2022-12-02 15:50:54 +08:00
<member name= "relative_index" type= "int" setter= "set_relative_index" getter= "get_relative_index" default= "0" >
The character offset of the glyph, relative to the current [RichTextEffect] custom block. Setting this property won't affect drawing.
</member>
2023-06-03 22:42:26 +08:00
<member name= "transform" type= "Transform2D" setter= "set_transform" getter= "get_transform" default= "Transform2D(1, 0, 0, 1, 0, 0)" >
The current transform of the current glyph. It can be overridden (for example, by driving the position and rotation from a curve). You can also alter the existing value to apply transforms on top of other effects.
</member>
2019-09-24 17:44:48 +08:00
<member name= "visible" type= "bool" setter= "set_visibility" getter= "is_visible" default= "true" >
2019-12-07 03:50:17 +08:00
If [code]true[/code], the character will be drawn. If [code]false[/code], the character will be hidden. Characters around hidden characters will reflow to take the space of hidden characters. If this is not desired, set their [member color] to [code]Color(1, 1, 1, 0)[/code] instead.
2019-09-24 17:44:48 +08:00
</member>
</members>
</class>