CharFXTransform
继承: RefCounted
< Object
Controls how an individual character will be displayed in a RichTextEffect
.
描述
By setting various properties on this object, you can control how individual characters will be displayed in a RichTextEffect
.
属性
Color | color |
float | elapsed_time |
Dictionary | env |
RID | font |
int | glyph_count |
int | glyph_flags |
int | glyph_index |
Vector2 | offset |
bool | outline |
Vector2i | range |
int | relative_index |
Transform2D | transform |
bool | visible |
属性说明
Color
color = Color(0, 0, 0, 1)
The color the character will be drawn with.
float
elapsed_time = 0.0
The time elapsed since the RichTextLabel
was added to the scene tree (in seconds). Time stops when the RichTextLabel
is paused (see Node.process_mode
). Resets when the text in the RichTextLabel
is changed.
Note: Time still passes while the RichTextLabel
is hidden.
Dictionary
env = {}
void
set_environment ( value:Dictionary
)Dictionary
get_environment ( )
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 #rrggbb
or #rgb
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 [example foo=hello bar=true baz=42 color=#ffffff]
will map to the following Dictionary
:
{"foo": "hello", "bar": true, "baz": 42, "color": Color(1, 1, 1, 1)}
RID
font = RID()
Font resource used to render glyph.
int
glyph_count = 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.
int
glyph_flags = 0
Glyph flags. See GraphemeFlag for more info. Setting this property won't affect drawing.
int
glyph_index = 0
Font specific glyph index.
Vector2
offset = Vector2(0, 0)
The position offset the character will be drawn with (in pixels).
bool
outline = false
If true
, FX transform is called for outline drawing. Setting this property won't affect drawing.
Vector2i
range = Vector2i(0, 0)
Absolute character range in the string, corresponding to the glyph. Setting this property won't affect drawing.
int
relative_index = 0
The character offset of the glyph, relative to the current RichTextEffect
custom block. Setting this property won't affect drawing.
Transform2D
transform = Transform2D(1, 0, 0, 1, 0, 0)
void
set_transform ( value:Transform2D
)Transform2D
get_transform ( )
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.
bool
visible = true
If true
, the character will be drawn. If false
, 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 color
to Color(1, 1, 1, 0)
instead.
本方法通常需要用户覆盖才能生效。
本方法无副作用,不会修改该实例的任何成员变量。
本方法除了能接受在此处描述的参数外,还能够继续接受任意数量的参数。
本方法用于构造某个类型。
调用本方法无需实例,可直接使用类名进行调用。
本方法描述的是使用本类型作为左操作数的有效运算符。
这个值是由下列位标志构成位掩码的整数。
无返回值。