CharFXTransform

继承： RefCounted < Object

控制单个字符在 RichTextEffect 中的显示方式。

描述

通过在此对象上设置各种属性，可以控制单个字符在 RichTextEffect 中的显示方式。

教程

• RichTextLabel 中的 BBCode

• RichTextEffect 测试项目（第三方）

属性

属性说明

Color color = Color(0, 0, 0, 1)

• void set_color ( Color value )

• Color get_color ( )

绘制字符所用的颜色。

float elapsed_time = 0.0

• void set_elapsed_time ( float value )

• float get_elapsed_time ( )

自 RichTextLabel 被添加到场景树以来经过的时间（单位：秒）。时间在 RichTextLabel 暂停时停止（参见 Node.process_mode）。在 RichTextLabel 中的文本改变时重置。

注意：当 RichTextLabel 被隐藏时，时间仍在流逝。

Dictionary env = {}

• void set_environment ( Dictionary value )

• 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)}

RID font = RID()

• void set_font ( RID value )

• RID get_font ( )

用于渲染字形的字体资源。

int glyph_count = 0

• void set_glyph_count ( int value )

• int get_glyph_count ( )

字素簇中的字形数量。该值在簇的第一个字形中设置。设置此属性不会影响绘制。

int glyph_flags = 0

• void set_glyph_flags ( int value )

• int get_glyph_flags ( )

字形标志。详情见 GraphemeFlag。设置此属性不会影响绘制。

int glyph_index = 0

• void set_glyph_index ( int value )

• int get_glyph_index ( )

字体特定字形的索引。

Vector2 offset = Vector2(0, 0)

• void set_offset ( Vector2 value )

• Vector2 get_offset ( )

绘制字符的位置偏移量（单位：像素）。

bool outline = false

• void set_outline ( bool value )

• bool is_outline ( )

如果为 true，则调用 FX 变换进行轮廓绘制。设置该属性不会影响绘制。

Vector2i range = Vector2i(0, 0)

• void set_range ( Vector2i value )

• Vector2i get_range ( )

该字符串中的绝对字符范围，对应于字形。设置该属性不会影响绘制。

int relative_index = 0

• void set_relative_index ( int value )

• int get_relative_index ( )

该字形的字符偏移量，相对于当前 RichTextEffect 自定义块。设置该属性不会影响绘制。

Transform2D transform = Transform2D(1, 0, 0, 1, 0, 0)

• void set_transform ( Transform2D value )

• Transform2D get_transform ( )

当前字形的当前变换。可以被覆盖（例如根据曲线来确定位置和旋转）。你还可以修改现有值，在其他效果的基础上应用变换。

bool visible = true

• void set_visibility ( bool value )

• bool is_visible ( )

如果为 true，将绘制字符。如果为 false，则隐藏字符。隐藏字符周围的字符将回流以占用隐藏字符的空间。如果不希望这样做，可以将它们的 color 设置为Color(1, 1, 1, 0)。

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.