summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/classes/RichTextEffect.xml2
-rw-r--r--doc/classes/RichTextLabel.xml23
2 files changed, 23 insertions, 2 deletions
diff --git a/doc/classes/RichTextEffect.xml b/doc/classes/RichTextEffect.xml
index ca95557f1b..774fa2bf9c 100644
--- a/doc/classes/RichTextEffect.xml
+++ b/doc/classes/RichTextEffect.xml
@@ -4,7 +4,7 @@
A custom effect for a [RichTextLabel].
</brief_description>
<description>
- A custom effect for a [RichTextLabel].
+ A custom effect for a [RichTextLabel], which can be loaded in the [RichTextLabel] inspector or using [method RichTextLabel.install_effect].
[b]Note:[/b] For a [RichTextEffect] to be usable, a BBCode tag must be defined as a member variable called [code]bbcode[/code] in the script.
[codeblocks]
[gdscript skip-lint]
diff --git a/doc/classes/RichTextLabel.xml b/doc/classes/RichTextLabel.xml
index c9a48e46b2..85dea1485a 100644
--- a/doc/classes/RichTextLabel.xml
+++ b/doc/classes/RichTextLabel.xml
@@ -225,7 +225,28 @@
<return type="void" />
<param index="0" name="effect" type="Variant" />
<description>
- Installs a custom effect. [param effect] should be a valid [RichTextEffect].
+ Installs a custom effect. This can also be done in the RichTextLabel inspector using the [member custom_effects] property. [param effect] should be a valid [RichTextEffect].
+ Example RichTextEffect:
+ [codeblock]
+ # effect.gd
+ class_name MyCustomEffect
+ extends RichTextEffect
+
+ var bbcode = "my_custom_effect"
+
+ # ...
+ [/codeblock]
+ Registering the above effect in RichTextLabel from script:
+ [codeblock]
+ # rich_text_label.gd
+ extends RichTextLabel
+
+ func _ready():
+ install_effect(MyCustomEffect.new())
+
+ # Alternatively, if not using `class_name` in the script that extends RichTextEffect:
+ install_effect(preload("res://effect.gd").new())
+ [/codeblock]
</description>
</method>
<method name="is_menu_visible" qualifiers="const">