Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
CharFXTransform¶
继承: RefCounted < Object
控制单个字符在 RichTextEffect 中的显示方式。
描述¶
通过在此对象上设置各种属性,可以控制单个字符在 RichTextEffect 中的显示方式。
教程¶
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
属性说明¶
Color color = Color(0, 0, 0, 1)
🔗
绘制字符所用的颜色。
自 RichTextLabel 被添加到场景树以来经过的时间(单位:秒)。时间在 RichTextLabel 暂停时停止(参见 Node.process_mode)。在 RichTextLabel 中的文本改变时重置。
注意:当 RichTextLabel 被隐藏时,时间仍在流逝。
Dictionary env = {}
🔗
void set_environment(value: Dictionary)
Dictionary get_environment()
包含在开头的 BBCode 标记中传递的参数。默认情况下,参数是字符串。如果它们的内容与 bool、int、float 之类的类型匹配,它们将被自动转换。格式为 #rrggbb
或 #rgb
的颜色代码将转换为不透明的 Color。字符串参数即使使用引号也不能包含空格。如果存在,引号也将出现在最终字符串中。
例如,开头的 BBCode 标签 [example foo = hello bar = true baz = 42 color =#ffffff]
将映射到以下 Dictionary:
{"foo": "hello", "bar": true, "baz": 42, "color": Color(1, 1, 1, 1)}
用于渲染字形的字体资源。
字素簇中的字形数量。该值在簇的第一个字形中设置。设置此属性不会影响绘制。
字形标志。详情见 GraphemeFlag。设置此属性不会影响绘制。
字体特定字形的索引。
Vector2 offset = Vector2(0, 0)
🔗
绘制字符的位置偏移量(单位:像素)。
如果为 true
,则调用 FX 变换进行轮廓绘制。设置该属性不会影响绘制。
Vector2i range = Vector2i(0, 0)
🔗
该字符串中的绝对字符范围,对应于字形。设置该属性不会影响绘制。
该字形的字符偏移量,相对于当前 RichTextEffect 自定义块。设置该属性不会影响绘制。
Transform2D transform = Transform2D(1, 0, 0, 1, 0, 0)
🔗
void set_transform(value: Transform2D)
Transform2D get_transform()
当前字形的当前变换。可以被覆盖(例如根据曲线来确定位置和旋转)。你还可以修改现有值,在其他效果的基础上应用变换。
如果为 true
,将绘制字符。如果为 false
,则隐藏字符。隐藏字符周围的字符将回流以占用隐藏字符的空间。如果不希望这样做,可以将它们的 color 设置为Color(1, 1, 1, 0)
。