:github_url: hide .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/CharFXTransform.xml. .. _class_CharFXTransform: CharFXTransform =============== **Inherits:** :ref:`RefCounted` **<** :ref:`Object` Controls how an individual character will be displayed in a :ref:`RichTextEffect`. .. rst-class:: classref-introduction-group Description ----------- By setting various properties on this object, you can control how individual characters will be displayed in a :ref:`RichTextEffect`. .. rst-class:: classref-introduction-group Tutorials --------- - :doc:`BBCode in RichTextLabel <../tutorials/ui/bbcode_in_richtextlabel>` .. rst-class:: classref-reftable-group Properties ---------- .. table:: :widths: auto +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`color` | ``Color(0, 0, 0, 1)`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`elapsed_time` | ``0.0`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`Dictionary` | :ref:`env` | ``{}`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`RID` | :ref:`font` | ``RID()`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`glyph_count` | ``0`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`glyph_flags` | ``0`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`glyph_index` | ``0`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`Vector2` | :ref:`offset` | ``Vector2(0, 0)`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`bool` | :ref:`outline` | ``false`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`Vector2i` | :ref:`range` | ``Vector2i(0, 0)`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`relative_index` | ``0`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`Transform2D` | :ref:`transform` | ``Transform2D(1, 0, 0, 1, 0, 0)`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ | :ref:`bool` | :ref:`visible` | ``true`` | +---------------------------------------+----------------------------------------------------------------------+-----------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Property Descriptions --------------------- .. _class_CharFXTransform_property_color: .. rst-class:: classref-property :ref:`Color` **color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_color**\ (\ value\: :ref:`Color`\ ) - :ref:`Color` **get_color**\ (\ ) The color the character will be drawn with. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_elapsed_time: .. rst-class:: classref-property :ref:`float` **elapsed_time** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_elapsed_time**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_elapsed_time**\ (\ ) The time elapsed since the :ref:`RichTextLabel` was added to the scene tree (in seconds). Time stops when the :ref:`RichTextLabel` is paused (see :ref:`Node.process_mode`). Resets when the text in the :ref:`RichTextLabel` is changed. \ **Note:** Time still passes while the :ref:`RichTextLabel` is hidden. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_env: .. rst-class:: classref-property :ref:`Dictionary` **env** = ``{}`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_environment**\ (\ value\: :ref:`Dictionary`\ ) - :ref:`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 :ref:`bool`, :ref:`int` or :ref:`float`, they will be converted automatically. Color codes in the form ``#rrggbb`` or ``#rgb`` will be converted to an opaque :ref:`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 :ref:`Dictionary`: :: {"foo": "hello", "bar": true, "baz": 42, "color": Color(1, 1, 1, 1)} .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_font: .. rst-class:: classref-property :ref:`RID` **font** = ``RID()`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_font**\ (\ value\: :ref:`RID`\ ) - :ref:`RID` **get_font**\ (\ ) :ref:`TextServer` RID of the font used to render glyph, this value can be used with ``TextServer.font_*`` methods to retrieve font information. \ **Note:** Read-only. Setting this property won't affect drawing. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_glyph_count: .. rst-class:: classref-property :ref:`int` **glyph_count** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_glyph_count**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_glyph_count**\ (\ ) Number of glyphs in the grapheme cluster. This value is set in the first glyph of a cluster. \ **Note:** Read-only. Setting this property won't affect drawing. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_glyph_flags: .. rst-class:: classref-property :ref:`int` **glyph_flags** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_glyph_flags**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_glyph_flags**\ (\ ) Glyph flags. See :ref:`GraphemeFlag` for more info. \ **Note:** Read-only. Setting this property won't affect drawing. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_glyph_index: .. rst-class:: classref-property :ref:`int` **glyph_index** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_glyph_index**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_glyph_index**\ (\ ) Glyph index specific to the :ref:`font`. If you want to replace this glyph, use :ref:`TextServer.font_get_glyph_index()` with :ref:`font` to get a new glyph index for a single character. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_offset: .. rst-class:: classref-property :ref:`Vector2` **offset** = ``Vector2(0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_offset**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_offset**\ (\ ) The position offset the character will be drawn with (in pixels). .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_outline: .. rst-class:: classref-property :ref:`bool` **outline** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_outline**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_outline**\ (\ ) If ``true``, FX transform is called for outline drawing. \ **Note:** Read-only. Setting this property won't affect drawing. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_range: .. rst-class:: classref-property :ref:`Vector2i` **range** = ``Vector2i(0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_range**\ (\ value\: :ref:`Vector2i`\ ) - :ref:`Vector2i` **get_range**\ (\ ) Absolute character range in the string, corresponding to the glyph. \ **Note:** Read-only. Setting this property won't affect drawing. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_relative_index: .. rst-class:: classref-property :ref:`int` **relative_index** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_relative_index**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_relative_index**\ (\ ) The character offset of the glyph, relative to the current :ref:`RichTextEffect` custom block. \ **Note:** Read-only. Setting this property won't affect drawing. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_transform: .. rst-class:: classref-property :ref:`Transform2D` **transform** = ``Transform2D(1, 0, 0, 1, 0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_transform**\ (\ value\: :ref:`Transform2D`\ ) - :ref:`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. .. rst-class:: classref-item-separator ---- .. _class_CharFXTransform_property_visible: .. rst-class:: classref-property :ref:`bool` **visible** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_visibility**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_visible**\ (\ ) 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 :ref:`color` to ``Color(1, 1, 1, 0)`` instead. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)` .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)` .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)` .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)` .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)` .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)` .. |void| replace:: :abbr:`void (No return value.)`