:github_url: hide .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/4.2/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/4.2/doc/classes/TextServer.xml. .. _class_TextServer: TextServer ========== **Inherits:** :ref:`RefCounted` **<** :ref:`Object` **Inherited By:** :ref:`TextServerExtension` A server interface for font management and text rendering. .. rst-class:: classref-introduction-group Description ----------- **TextServer** is the API backend for managing fonts and rendering text. .. rst-class:: classref-reftable-group Methods ------- .. table:: :widths: auto +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`create_font` **(** **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`create_font_linked_variation` **(** :ref:`RID` font_rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`create_shaped_text` **(** :ref:`Direction` direction=0, :ref:`Orientation` orientation=0 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`draw_hex_code_box` **(** :ref:`RID` canvas, :ref:`int` size, :ref:`Vector2` pos, :ref:`int` index, :ref:`Color` color **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_clear_glyphs` **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_clear_kerning_map` **(** :ref:`RID` font_rid, :ref:`int` size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_clear_size_cache` **(** :ref:`RID` font_rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_clear_textures` **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_draw_glyph` **(** :ref:`RID` font_rid, :ref:`RID` canvas, :ref:`int` size, :ref:`Vector2` pos, :ref:`int` index, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_draw_glyph_outline` **(** :ref:`RID` font_rid, :ref:`RID` canvas, :ref:`int` size, :ref:`int` outline_size, :ref:`Vector2` pos, :ref:`int` index, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`FontAntialiasing` | :ref:`font_get_antialiasing` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_ascent` **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_char_from_glyph_index` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` glyph_index **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_descent` **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_embolden` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_face_count` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_face_index` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_fixed_size` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`FixedSizeScaleMode` | :ref:`font_get_fixed_size_scale_mode` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_get_generate_mipmaps` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_global_oversampling` **(** **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`font_get_glyph_advance` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`font_get_glyph_contours` **(** :ref:`RID` font, :ref:`int` size, :ref:`int` index **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_glyph_index` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` char, :ref:`int` variation_selector **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`font_get_glyph_list` **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`font_get_glyph_offset` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`font_get_glyph_size` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_glyph_texture_idx` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`font_get_glyph_texture_rid` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`font_get_glyph_texture_size` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2` | :ref:`font_get_glyph_uv_rect` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Hinting` | :ref:`font_get_hinting` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`font_get_kerning` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`Vector2i` glyph_pair **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i[]` | :ref:`font_get_kerning_list` **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_get_language_support_override` **(** :ref:`RID` font_rid, :ref:`String` language **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`font_get_language_support_overrides` **(** :ref:`RID` font_rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_msdf_pixel_range` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_msdf_size` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`font_get_name` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`font_get_opentype_feature_overrides` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`font_get_ot_name_strings` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_oversampling` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_scale` **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_get_script_support_override` **(** :ref:`RID` font_rid, :ref:`String` script **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`font_get_script_support_overrides` **(** :ref:`RID` font_rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i[]` | :ref:`font_get_size_cache_list` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_spacing` **(** :ref:`RID` font_rid, :ref:`SpacingType` spacing **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_stretch` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |bitfield|\<:ref:`FontStyle`\> | :ref:`font_get_style` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`font_get_style_name` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`SubpixelPositioning` | :ref:`font_get_subpixel_positioning` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`font_get_supported_chars` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_texture_count` **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Image` | :ref:`font_get_texture_image` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`font_get_texture_offsets` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Transform2D` | :ref:`font_get_transform` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_underline_position` **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`font_get_underline_thickness` **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`font_get_variation_coordinates` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`font_get_weight` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_has_char` **(** :ref:`RID` font_rid, :ref:`int` char **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_is_allow_system_fallback` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_is_force_autohinter` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_is_language_supported` **(** :ref:`RID` font_rid, :ref:`String` language **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_is_multichannel_signed_distance_field` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`font_is_script_supported` **(** :ref:`RID` font_rid, :ref:`String` script **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_remove_glyph` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_remove_kerning` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`Vector2i` glyph_pair **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_remove_language_support_override` **(** :ref:`RID` font_rid, :ref:`String` language **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_remove_script_support_override` **(** :ref:`RID` font_rid, :ref:`String` script **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_remove_size_cache` **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_remove_texture` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_render_glyph` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` index **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_render_range` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` start, :ref:`int` end **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_allow_system_fallback` **(** :ref:`RID` font_rid, :ref:`bool` allow_system_fallback **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_antialiasing` **(** :ref:`RID` font_rid, :ref:`FontAntialiasing` antialiasing **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_ascent` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` ascent **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_data` **(** :ref:`RID` font_rid, :ref:`PackedByteArray` data **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_descent` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` descent **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_embolden` **(** :ref:`RID` font_rid, :ref:`float` strength **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_face_index` **(** :ref:`RID` font_rid, :ref:`int` face_index **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_fixed_size` **(** :ref:`RID` font_rid, :ref:`int` fixed_size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_fixed_size_scale_mode` **(** :ref:`RID` font_rid, :ref:`FixedSizeScaleMode` fixed_size_scale_mode **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_force_autohinter` **(** :ref:`RID` font_rid, :ref:`bool` force_autohinter **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_generate_mipmaps` **(** :ref:`RID` font_rid, :ref:`bool` generate_mipmaps **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_global_oversampling` **(** :ref:`float` oversampling **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_glyph_advance` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` glyph, :ref:`Vector2` advance **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_glyph_offset` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`Vector2` offset **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_glyph_size` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`Vector2` gl_size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_glyph_texture_idx` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`int` texture_idx **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_glyph_uv_rect` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`Rect2` uv_rect **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_hinting` **(** :ref:`RID` font_rid, :ref:`Hinting` hinting **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_kerning` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`Vector2i` glyph_pair, :ref:`Vector2` kerning **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_language_support_override` **(** :ref:`RID` font_rid, :ref:`String` language, :ref:`bool` supported **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_msdf_pixel_range` **(** :ref:`RID` font_rid, :ref:`int` msdf_pixel_range **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_msdf_size` **(** :ref:`RID` font_rid, :ref:`int` msdf_size **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_multichannel_signed_distance_field` **(** :ref:`RID` font_rid, :ref:`bool` msdf **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_name` **(** :ref:`RID` font_rid, :ref:`String` name **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_opentype_feature_overrides` **(** :ref:`RID` font_rid, :ref:`Dictionary` overrides **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_oversampling` **(** :ref:`RID` font_rid, :ref:`float` oversampling **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_scale` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` scale **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_script_support_override` **(** :ref:`RID` font_rid, :ref:`String` script, :ref:`bool` supported **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_spacing` **(** :ref:`RID` font_rid, :ref:`SpacingType` spacing, :ref:`int` value **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_stretch` **(** :ref:`RID` font_rid, :ref:`int` weight **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_style` **(** :ref:`RID` font_rid, |bitfield|\<:ref:`FontStyle`\> style **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_style_name` **(** :ref:`RID` font_rid, :ref:`String` name **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_subpixel_positioning` **(** :ref:`RID` font_rid, :ref:`SubpixelPositioning` subpixel_positioning **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_texture_image` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index, :ref:`Image` image **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_texture_offsets` **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index, :ref:`PackedInt32Array` offset **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_transform` **(** :ref:`RID` font_rid, :ref:`Transform2D` transform **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_underline_position` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` underline_position **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_underline_thickness` **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` underline_thickness **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_variation_coordinates` **(** :ref:`RID` font_rid, :ref:`Dictionary` variation_coordinates **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`font_set_weight` **(** :ref:`RID` font_rid, :ref:`int` weight **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`font_supported_feature_list` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`font_supported_variation_list` **(** :ref:`RID` font_rid **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`format_number` **(** :ref:`String` number, :ref:`String` language="" **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`free_rid` **(** :ref:`RID` rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_features` **(** **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_hex_code_box_size` **(** :ref:`int` size, :ref:`int` index **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_name` **(** **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_support_data_filename` **(** **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_support_data_info` **(** **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has` **(** :ref:`RID` rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_feature` **(** :ref:`Feature` feature **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`is_confusable` **(** :ref:`String` string, :ref:`PackedStringArray` dict **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_locale_right_to_left` **(** :ref:`String` locale **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_valid_identifier` **(** :ref:`String` string **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`load_support_data` **(** :ref:`String` filename **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`name_to_tag` **(** :ref:`String` name **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`parse_number` **(** :ref:`String` number, :ref:`String` language="" **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i[]` | :ref:`parse_structured_text` **(** :ref:`StructuredTextParser` parser_type, :ref:`Array` args, :ref:`String` text **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`percent_sign` **(** :ref:`String` language="" **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`save_support_data` **(** :ref:`String` filename **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_get_span_count` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`shaped_get_span_meta` **(** :ref:`RID` shaped, :ref:`int` index **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_set_span_update_font` **(** :ref:`RID` shaped, :ref:`int` index, :ref:`RID[]` fonts, :ref:`int` size, :ref:`Dictionary` opentype_features={} **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_add_object` **(** :ref:`RID` shaped, :ref:`Variant` key, :ref:`Vector2` size, :ref:`InlineAlignment` inline_align=5, :ref:`int` length=1, :ref:`float` baseline=0.0 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_add_string` **(** :ref:`RID` shaped, :ref:`String` text, :ref:`RID[]` fonts, :ref:`int` size, :ref:`Dictionary` opentype_features={}, :ref:`String` language="", :ref:`Variant` meta=null **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_clear` **(** :ref:`RID` rid **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_closest_character_pos` **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_draw` **(** :ref:`RID` shaped, :ref:`RID` canvas, :ref:`Vector2` pos, :ref:`float` clip_l=-1, :ref:`float` clip_r=-1, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_draw_outline` **(** :ref:`RID` shaped, :ref:`RID` canvas, :ref:`Vector2` pos, :ref:`float` clip_l=-1, :ref:`float` clip_r=-1, :ref:`int` outline_size=1, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_fit_to_width` **(** :ref:`RID` shaped, :ref:`float` width, |bitfield|\<:ref:`JustificationFlag`\> justification_flags=3 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_get_ascent` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`shaped_text_get_carets` **(** :ref:`RID` shaped, :ref:`int` position **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`shaped_text_get_character_breaks` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`shaped_text_get_custom_punctuation` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_get_descent` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Direction` | :ref:`shaped_text_get_direction` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Direction` | :ref:`shaped_text_get_dominant_direction_in_range` **(** :ref:`RID` shaped, :ref:`int` start, :ref:`int` end **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_get_ellipsis_glyph_count` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary[]` | :ref:`shaped_text_get_ellipsis_glyphs` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_get_ellipsis_pos` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_get_glyph_count` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary[]` | :ref:`shaped_text_get_glyphs` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`shaped_text_get_grapheme_bounds` **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Direction` | :ref:`shaped_text_get_inferred_direction` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`shaped_text_get_line_breaks` **(** :ref:`RID` shaped, :ref:`float` width, :ref:`int` start=0, |bitfield|\<:ref:`LineBreakFlag`\> break_flags=3 **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`shaped_text_get_line_breaks_adv` **(** :ref:`RID` shaped, :ref:`PackedFloat32Array` width, :ref:`int` start=0, :ref:`bool` once=true, |bitfield|\<:ref:`LineBreakFlag`\> break_flags=3 **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2` | :ref:`shaped_text_get_object_rect` **(** :ref:`RID` shaped, :ref:`Variant` key **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`shaped_text_get_objects` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Orientation` | :ref:`shaped_text_get_orientation` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`shaped_text_get_parent` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_get_preserve_control` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_get_preserve_invalid` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`shaped_text_get_range` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedVector2Array` | :ref:`shaped_text_get_selection` **(** :ref:`RID` shaped, :ref:`int` start, :ref:`int` end **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`shaped_text_get_size` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_get_spacing` **(** :ref:`RID` shaped, :ref:`SpacingType` spacing **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_get_trim_pos` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_get_underline_position` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_get_underline_thickness` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_get_width` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`shaped_text_get_word_breaks` **(** :ref:`RID` shaped, |bitfield|\<:ref:`GraphemeFlag`\> grapheme_flags=264 **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_has_visible_chars` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_hit_test_grapheme` **(** :ref:`RID` shaped, :ref:`float` coords **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_hit_test_position` **(** :ref:`RID` shaped, :ref:`float` coords **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_is_ready` **(** :ref:`RID` shaped **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_next_character_pos` **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_next_grapheme_pos` **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_overrun_trim_to_width` **(** :ref:`RID` shaped, :ref:`float` width=0, |bitfield|\<:ref:`TextOverrunFlag`\> overrun_trim_flags=0 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_prev_character_pos` **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_prev_grapheme_pos` **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_resize_object` **(** :ref:`RID` shaped, :ref:`Variant` key, :ref:`Vector2` size, :ref:`InlineAlignment` inline_align=5, :ref:`float` baseline=0.0 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_bidi_override` **(** :ref:`RID` shaped, :ref:`Array` override **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_custom_punctuation` **(** :ref:`RID` shaped, :ref:`String` punct **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_direction` **(** :ref:`RID` shaped, :ref:`Direction` direction=0 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_orientation` **(** :ref:`RID` shaped, :ref:`Orientation` orientation=0 **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_preserve_control` **(** :ref:`RID` shaped, :ref:`bool` enabled **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_preserve_invalid` **(** :ref:`RID` shaped, :ref:`bool` enabled **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`shaped_text_set_spacing` **(** :ref:`RID` shaped, :ref:`SpacingType` spacing, :ref:`int` value **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_shape` **(** :ref:`RID` shaped **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary[]` | :ref:`shaped_text_sort_logical` **(** :ref:`RID` shaped **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`shaped_text_substr` **(** :ref:`RID` shaped, :ref:`int` start, :ref:`int` length **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_tab_align` **(** :ref:`RID` shaped, :ref:`PackedFloat32Array` tab_stops **)** | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`spoof_check` **(** :ref:`String` string **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`string_get_character_breaks` **(** :ref:`String` string, :ref:`String` language="" **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`string_get_word_breaks` **(** :ref:`String` string, :ref:`String` language="", :ref:`int` chars_per_line=0 **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`string_to_lower` **(** :ref:`String` string, :ref:`String` language="" **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`string_to_upper` **(** :ref:`String` string, :ref:`String` language="" **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`strip_diacritics` **(** :ref:`String` string **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`tag_to_name` **(** :ref:`int` tag **)** |const| | +-----------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Enumerations ------------ .. _enum_TextServer_FontAntialiasing: .. rst-class:: classref-enumeration enum **FontAntialiasing**: .. _class_TextServer_constant_FONT_ANTIALIASING_NONE: .. rst-class:: classref-enumeration-constant :ref:`FontAntialiasing` **FONT_ANTIALIASING_NONE** = ``0`` Font glyphs are rasterized as 1-bit bitmaps. .. _class_TextServer_constant_FONT_ANTIALIASING_GRAY: .. rst-class:: classref-enumeration-constant :ref:`FontAntialiasing` **FONT_ANTIALIASING_GRAY** = ``1`` Font glyphs are rasterized as 8-bit grayscale anti-aliased bitmaps. .. _class_TextServer_constant_FONT_ANTIALIASING_LCD: .. rst-class:: classref-enumeration-constant :ref:`FontAntialiasing` **FONT_ANTIALIASING_LCD** = ``2`` Font glyphs are rasterized for LCD screens. LCD subpixel layout is determined by the value of ``gui/theme/lcd_subpixel_layout`` project settings. LCD subpixel anti-aliasing mode is suitable only for rendering horizontal, unscaled text in 2D. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_FontLCDSubpixelLayout: .. rst-class:: classref-enumeration enum **FontLCDSubpixelLayout**: .. _class_TextServer_constant_FONT_LCD_SUBPIXEL_LAYOUT_NONE: .. rst-class:: classref-enumeration-constant :ref:`FontLCDSubpixelLayout` **FONT_LCD_SUBPIXEL_LAYOUT_NONE** = ``0`` Unknown or unsupported subpixel layout, LCD subpixel antialiasing is disabled. .. _class_TextServer_constant_FONT_LCD_SUBPIXEL_LAYOUT_HRGB: .. rst-class:: classref-enumeration-constant :ref:`FontLCDSubpixelLayout` **FONT_LCD_SUBPIXEL_LAYOUT_HRGB** = ``1`` Horizontal RGB subpixel layout. .. _class_TextServer_constant_FONT_LCD_SUBPIXEL_LAYOUT_HBGR: .. rst-class:: classref-enumeration-constant :ref:`FontLCDSubpixelLayout` **FONT_LCD_SUBPIXEL_LAYOUT_HBGR** = ``2`` Horizontal BGR subpixel layout. .. _class_TextServer_constant_FONT_LCD_SUBPIXEL_LAYOUT_VRGB: .. rst-class:: classref-enumeration-constant :ref:`FontLCDSubpixelLayout` **FONT_LCD_SUBPIXEL_LAYOUT_VRGB** = ``3`` Vertical RGB subpixel layout. .. _class_TextServer_constant_FONT_LCD_SUBPIXEL_LAYOUT_VBGR: .. rst-class:: classref-enumeration-constant :ref:`FontLCDSubpixelLayout` **FONT_LCD_SUBPIXEL_LAYOUT_VBGR** = ``4`` Vertical BGR subpixel layout. .. _class_TextServer_constant_FONT_LCD_SUBPIXEL_LAYOUT_MAX: .. rst-class:: classref-enumeration-constant :ref:`FontLCDSubpixelLayout` **FONT_LCD_SUBPIXEL_LAYOUT_MAX** = ``5`` Represents the size of the :ref:`FontLCDSubpixelLayout` enum. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_Direction: .. rst-class:: classref-enumeration enum **Direction**: .. _class_TextServer_constant_DIRECTION_AUTO: .. rst-class:: classref-enumeration-constant :ref:`Direction` **DIRECTION_AUTO** = ``0`` Text direction is determined based on contents and current locale. .. _class_TextServer_constant_DIRECTION_LTR: .. rst-class:: classref-enumeration-constant :ref:`Direction` **DIRECTION_LTR** = ``1`` Text is written from left to right. .. _class_TextServer_constant_DIRECTION_RTL: .. rst-class:: classref-enumeration-constant :ref:`Direction` **DIRECTION_RTL** = ``2`` Text is written from right to left. .. _class_TextServer_constant_DIRECTION_INHERITED: .. rst-class:: classref-enumeration-constant :ref:`Direction` **DIRECTION_INHERITED** = ``3`` Text writing direction is the same as base string writing direction. Used for BiDi override only. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_Orientation: .. rst-class:: classref-enumeration enum **Orientation**: .. _class_TextServer_constant_ORIENTATION_HORIZONTAL: .. rst-class:: classref-enumeration-constant :ref:`Orientation` **ORIENTATION_HORIZONTAL** = ``0`` Text is written horizontally. .. _class_TextServer_constant_ORIENTATION_VERTICAL: .. rst-class:: classref-enumeration-constant :ref:`Orientation` **ORIENTATION_VERTICAL** = ``1`` Left to right text is written vertically from top to bottom. Right to left text is written vertically from bottom to top. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_JustificationFlag: .. rst-class:: classref-enumeration flags **JustificationFlag**: .. _class_TextServer_constant_JUSTIFICATION_NONE: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_NONE** = ``0`` Do not justify text. .. _class_TextServer_constant_JUSTIFICATION_KASHIDA: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_KASHIDA** = ``1`` Justify text by adding and removing kashidas. .. _class_TextServer_constant_JUSTIFICATION_WORD_BOUND: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_WORD_BOUND** = ``2`` Justify text by changing width of the spaces between the words. .. _class_TextServer_constant_JUSTIFICATION_TRIM_EDGE_SPACES: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_TRIM_EDGE_SPACES** = ``4`` Remove trailing and leading spaces from the justified text. .. _class_TextServer_constant_JUSTIFICATION_AFTER_LAST_TAB: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_AFTER_LAST_TAB** = ``8`` Only apply justification to the part of the text after the last tab. .. _class_TextServer_constant_JUSTIFICATION_CONSTRAIN_ELLIPSIS: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_CONSTRAIN_ELLIPSIS** = ``16`` Apply justification to the trimmed line with ellipsis. .. _class_TextServer_constant_JUSTIFICATION_SKIP_LAST_LINE: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_SKIP_LAST_LINE** = ``32`` Do not apply justification to the last line of the paragraph. .. _class_TextServer_constant_JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS** = ``64`` Do not apply justification to the last line of the paragraph with visible characters (takes precedence over :ref:`JUSTIFICATION_SKIP_LAST_LINE`). .. _class_TextServer_constant_JUSTIFICATION_DO_NOT_SKIP_SINGLE_LINE: .. rst-class:: classref-enumeration-constant :ref:`JustificationFlag` **JUSTIFICATION_DO_NOT_SKIP_SINGLE_LINE** = ``128`` Always apply justification to the paragraphs with a single line (:ref:`JUSTIFICATION_SKIP_LAST_LINE` and :ref:`JUSTIFICATION_SKIP_LAST_LINE_WITH_VISIBLE_CHARS` are ignored). .. rst-class:: classref-item-separator ---- .. _enum_TextServer_AutowrapMode: .. rst-class:: classref-enumeration enum **AutowrapMode**: .. _class_TextServer_constant_AUTOWRAP_OFF: .. rst-class:: classref-enumeration-constant :ref:`AutowrapMode` **AUTOWRAP_OFF** = ``0`` Autowrap is disabled. .. _class_TextServer_constant_AUTOWRAP_ARBITRARY: .. rst-class:: classref-enumeration-constant :ref:`AutowrapMode` **AUTOWRAP_ARBITRARY** = ``1`` Wraps the text inside the node's bounding rectangle by allowing to break lines at arbitrary positions, which is useful when very limited space is available. .. _class_TextServer_constant_AUTOWRAP_WORD: .. rst-class:: classref-enumeration-constant :ref:`AutowrapMode` **AUTOWRAP_WORD** = ``2`` Wraps the text inside the node's bounding rectangle by soft-breaking between words. .. _class_TextServer_constant_AUTOWRAP_WORD_SMART: .. rst-class:: classref-enumeration-constant :ref:`AutowrapMode` **AUTOWRAP_WORD_SMART** = ``3`` Behaves similarly to :ref:`AUTOWRAP_WORD`, but force-breaks a word if that single word does not fit in one line. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_LineBreakFlag: .. rst-class:: classref-enumeration flags **LineBreakFlag**: .. _class_TextServer_constant_BREAK_NONE: .. rst-class:: classref-enumeration-constant :ref:`LineBreakFlag` **BREAK_NONE** = ``0`` Do not break the line. .. _class_TextServer_constant_BREAK_MANDATORY: .. rst-class:: classref-enumeration-constant :ref:`LineBreakFlag` **BREAK_MANDATORY** = ``1`` Break the line at the line mandatory break characters (e.g. ``"\n"``). .. _class_TextServer_constant_BREAK_WORD_BOUND: .. rst-class:: classref-enumeration-constant :ref:`LineBreakFlag` **BREAK_WORD_BOUND** = ``2`` Break the line between the words. .. _class_TextServer_constant_BREAK_GRAPHEME_BOUND: .. rst-class:: classref-enumeration-constant :ref:`LineBreakFlag` **BREAK_GRAPHEME_BOUND** = ``4`` Break the line between any unconnected graphemes. .. _class_TextServer_constant_BREAK_ADAPTIVE: .. rst-class:: classref-enumeration-constant :ref:`LineBreakFlag` **BREAK_ADAPTIVE** = ``8`` Should be used only in conjunction with :ref:`BREAK_WORD_BOUND`, break the line between any unconnected graphemes, if it's impossible to break it between the words. .. _class_TextServer_constant_BREAK_TRIM_EDGE_SPACES: .. rst-class:: classref-enumeration-constant :ref:`LineBreakFlag` **BREAK_TRIM_EDGE_SPACES** = ``16`` Remove edge spaces from the broken line segments. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_VisibleCharactersBehavior: .. rst-class:: classref-enumeration enum **VisibleCharactersBehavior**: .. _class_TextServer_constant_VC_CHARS_BEFORE_SHAPING: .. rst-class:: classref-enumeration-constant :ref:`VisibleCharactersBehavior` **VC_CHARS_BEFORE_SHAPING** = ``0`` Trims text before the shaping. e.g, increasing :ref:`Label.visible_characters` or :ref:`RichTextLabel.visible_characters` value is visually identical to typing the text. .. _class_TextServer_constant_VC_CHARS_AFTER_SHAPING: .. rst-class:: classref-enumeration-constant :ref:`VisibleCharactersBehavior` **VC_CHARS_AFTER_SHAPING** = ``1`` Displays glyphs that are mapped to the first :ref:`Label.visible_characters` or :ref:`RichTextLabel.visible_characters` characters from the beginning of the text. .. _class_TextServer_constant_VC_GLYPHS_AUTO: .. rst-class:: classref-enumeration-constant :ref:`VisibleCharactersBehavior` **VC_GLYPHS_AUTO** = ``2`` Displays :ref:`Label.visible_ratio` or :ref:`RichTextLabel.visible_ratio` glyphs, starting from the left or from the right, depending on :ref:`Control.layout_direction` value. .. _class_TextServer_constant_VC_GLYPHS_LTR: .. rst-class:: classref-enumeration-constant :ref:`VisibleCharactersBehavior` **VC_GLYPHS_LTR** = ``3`` Displays :ref:`Label.visible_ratio` or :ref:`RichTextLabel.visible_ratio` glyphs, starting from the left. .. _class_TextServer_constant_VC_GLYPHS_RTL: .. rst-class:: classref-enumeration-constant :ref:`VisibleCharactersBehavior` **VC_GLYPHS_RTL** = ``4`` Displays :ref:`Label.visible_ratio` or :ref:`RichTextLabel.visible_ratio` glyphs, starting from the right. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_OverrunBehavior: .. rst-class:: classref-enumeration enum **OverrunBehavior**: .. _class_TextServer_constant_OVERRUN_NO_TRIMMING: .. rst-class:: classref-enumeration-constant :ref:`OverrunBehavior` **OVERRUN_NO_TRIMMING** = ``0`` No text trimming is performed. .. _class_TextServer_constant_OVERRUN_TRIM_CHAR: .. rst-class:: classref-enumeration-constant :ref:`OverrunBehavior` **OVERRUN_TRIM_CHAR** = ``1`` Trims the text per character. .. _class_TextServer_constant_OVERRUN_TRIM_WORD: .. rst-class:: classref-enumeration-constant :ref:`OverrunBehavior` **OVERRUN_TRIM_WORD** = ``2`` Trims the text per word. .. _class_TextServer_constant_OVERRUN_TRIM_ELLIPSIS: .. rst-class:: classref-enumeration-constant :ref:`OverrunBehavior` **OVERRUN_TRIM_ELLIPSIS** = ``3`` Trims the text per character and adds an ellipsis to indicate that parts are hidden. .. _class_TextServer_constant_OVERRUN_TRIM_WORD_ELLIPSIS: .. rst-class:: classref-enumeration-constant :ref:`OverrunBehavior` **OVERRUN_TRIM_WORD_ELLIPSIS** = ``4`` Trims the text per word and adds an ellipsis to indicate that parts are hidden. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_TextOverrunFlag: .. rst-class:: classref-enumeration flags **TextOverrunFlag**: .. _class_TextServer_constant_OVERRUN_NO_TRIM: .. rst-class:: classref-enumeration-constant :ref:`TextOverrunFlag` **OVERRUN_NO_TRIM** = ``0`` No trimming is performed. .. _class_TextServer_constant_OVERRUN_TRIM: .. rst-class:: classref-enumeration-constant :ref:`TextOverrunFlag` **OVERRUN_TRIM** = ``1`` Trims the text when it exceeds the given width. .. _class_TextServer_constant_OVERRUN_TRIM_WORD_ONLY: .. rst-class:: classref-enumeration-constant :ref:`TextOverrunFlag` **OVERRUN_TRIM_WORD_ONLY** = ``2`` Trims the text per word instead of per grapheme. .. _class_TextServer_constant_OVERRUN_ADD_ELLIPSIS: .. rst-class:: classref-enumeration-constant :ref:`TextOverrunFlag` **OVERRUN_ADD_ELLIPSIS** = ``4`` Determines whether an ellipsis should be added at the end of the text. .. _class_TextServer_constant_OVERRUN_ENFORCE_ELLIPSIS: .. rst-class:: classref-enumeration-constant :ref:`TextOverrunFlag` **OVERRUN_ENFORCE_ELLIPSIS** = ``8`` Determines whether the ellipsis at the end of the text is enforced and may not be hidden. .. _class_TextServer_constant_OVERRUN_JUSTIFICATION_AWARE: .. rst-class:: classref-enumeration-constant :ref:`TextOverrunFlag` **OVERRUN_JUSTIFICATION_AWARE** = ``16`` Accounts for the text being justified before attempting to trim it (see :ref:`JustificationFlag`). .. rst-class:: classref-item-separator ---- .. _enum_TextServer_GraphemeFlag: .. rst-class:: classref-enumeration flags **GraphemeFlag**: .. _class_TextServer_constant_GRAPHEME_IS_VALID: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_VALID** = ``1`` Grapheme is supported by the font, and can be drawn. .. _class_TextServer_constant_GRAPHEME_IS_RTL: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_RTL** = ``2`` Grapheme is part of right-to-left or bottom-to-top run. .. _class_TextServer_constant_GRAPHEME_IS_VIRTUAL: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_VIRTUAL** = ``4`` Grapheme is not part of source text, it was added by justification process. .. _class_TextServer_constant_GRAPHEME_IS_SPACE: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_SPACE** = ``8`` Grapheme is whitespace. .. _class_TextServer_constant_GRAPHEME_IS_BREAK_HARD: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_BREAK_HARD** = ``16`` Grapheme is mandatory break point (e.g. ``"\n"``). .. _class_TextServer_constant_GRAPHEME_IS_BREAK_SOFT: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_BREAK_SOFT** = ``32`` Grapheme is optional break point (e.g. space). .. _class_TextServer_constant_GRAPHEME_IS_TAB: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_TAB** = ``64`` Grapheme is the tabulation character. .. _class_TextServer_constant_GRAPHEME_IS_ELONGATION: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_ELONGATION** = ``128`` Grapheme is kashida. .. _class_TextServer_constant_GRAPHEME_IS_PUNCTUATION: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_PUNCTUATION** = ``256`` Grapheme is punctuation character. .. _class_TextServer_constant_GRAPHEME_IS_UNDERSCORE: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_UNDERSCORE** = ``512`` Grapheme is underscore character. .. _class_TextServer_constant_GRAPHEME_IS_CONNECTED: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_CONNECTED** = ``1024`` Grapheme is connected to the previous grapheme. Breaking line before this grapheme is not safe. .. _class_TextServer_constant_GRAPHEME_IS_SAFE_TO_INSERT_TATWEEL: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_SAFE_TO_INSERT_TATWEEL** = ``2048`` It is safe to insert a U+0640 before this grapheme for elongation. .. _class_TextServer_constant_GRAPHEME_IS_EMBEDDED_OBJECT: .. rst-class:: classref-enumeration-constant :ref:`GraphemeFlag` **GRAPHEME_IS_EMBEDDED_OBJECT** = ``4096`` Grapheme is an object replacement character for the embedded object. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_Hinting: .. rst-class:: classref-enumeration enum **Hinting**: .. _class_TextServer_constant_HINTING_NONE: .. rst-class:: classref-enumeration-constant :ref:`Hinting` **HINTING_NONE** = ``0`` Disables font hinting (smoother but less crisp). .. _class_TextServer_constant_HINTING_LIGHT: .. rst-class:: classref-enumeration-constant :ref:`Hinting` **HINTING_LIGHT** = ``1`` Use the light font hinting mode. .. _class_TextServer_constant_HINTING_NORMAL: .. rst-class:: classref-enumeration-constant :ref:`Hinting` **HINTING_NORMAL** = ``2`` Use the default font hinting mode (crisper but less smooth). \ **Note:** This hinting mode changes both horizontal and vertical glyph metrics. If applied to monospace font, some glyphs might have different width. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_SubpixelPositioning: .. rst-class:: classref-enumeration enum **SubpixelPositioning**: .. _class_TextServer_constant_SUBPIXEL_POSITIONING_DISABLED: .. rst-class:: classref-enumeration-constant :ref:`SubpixelPositioning` **SUBPIXEL_POSITIONING_DISABLED** = ``0`` Glyph horizontal position is rounded to the whole pixel size, each glyph is rasterized once. .. _class_TextServer_constant_SUBPIXEL_POSITIONING_AUTO: .. rst-class:: classref-enumeration-constant :ref:`SubpixelPositioning` **SUBPIXEL_POSITIONING_AUTO** = ``1`` Glyph horizontal position is rounded based on font size. - To one quarter of the pixel size if font size is smaller or equal to :ref:`SUBPIXEL_POSITIONING_ONE_QUARTER_MAX_SIZE`. - To one half of the pixel size if font size is smaller or equal to :ref:`SUBPIXEL_POSITIONING_ONE_HALF_MAX_SIZE`. - To the whole pixel size for larger fonts. .. _class_TextServer_constant_SUBPIXEL_POSITIONING_ONE_HALF: .. rst-class:: classref-enumeration-constant :ref:`SubpixelPositioning` **SUBPIXEL_POSITIONING_ONE_HALF** = ``2`` Glyph horizontal position is rounded to one half of the pixel size, each glyph is rasterized up to two times. .. _class_TextServer_constant_SUBPIXEL_POSITIONING_ONE_QUARTER: .. rst-class:: classref-enumeration-constant :ref:`SubpixelPositioning` **SUBPIXEL_POSITIONING_ONE_QUARTER** = ``3`` Glyph horizontal position is rounded to one quarter of the pixel size, each glyph is rasterized up to four times. .. _class_TextServer_constant_SUBPIXEL_POSITIONING_ONE_HALF_MAX_SIZE: .. rst-class:: classref-enumeration-constant :ref:`SubpixelPositioning` **SUBPIXEL_POSITIONING_ONE_HALF_MAX_SIZE** = ``20`` Maximum font size which will use one half of the pixel subpixel positioning in :ref:`SUBPIXEL_POSITIONING_AUTO` mode. .. _class_TextServer_constant_SUBPIXEL_POSITIONING_ONE_QUARTER_MAX_SIZE: .. rst-class:: classref-enumeration-constant :ref:`SubpixelPositioning` **SUBPIXEL_POSITIONING_ONE_QUARTER_MAX_SIZE** = ``16`` Maximum font size which will use one quarter of the pixel subpixel positioning in :ref:`SUBPIXEL_POSITIONING_AUTO` mode. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_Feature: .. rst-class:: classref-enumeration enum **Feature**: .. _class_TextServer_constant_FEATURE_SIMPLE_LAYOUT: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_SIMPLE_LAYOUT** = ``1`` TextServer supports simple text layouts. .. _class_TextServer_constant_FEATURE_BIDI_LAYOUT: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_BIDI_LAYOUT** = ``2`` TextServer supports bidirectional text layouts. .. _class_TextServer_constant_FEATURE_VERTICAL_LAYOUT: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_VERTICAL_LAYOUT** = ``4`` TextServer supports vertical layouts. .. _class_TextServer_constant_FEATURE_SHAPING: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_SHAPING** = ``8`` TextServer supports complex text shaping. .. _class_TextServer_constant_FEATURE_KASHIDA_JUSTIFICATION: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_KASHIDA_JUSTIFICATION** = ``16`` TextServer supports justification using kashidas. .. _class_TextServer_constant_FEATURE_BREAK_ITERATORS: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_BREAK_ITERATORS** = ``32`` TextServer supports complex line/word breaking rules (e.g. dictionary based). .. _class_TextServer_constant_FEATURE_FONT_BITMAP: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_FONT_BITMAP** = ``64`` TextServer supports loading bitmap fonts. .. _class_TextServer_constant_FEATURE_FONT_DYNAMIC: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_FONT_DYNAMIC** = ``128`` TextServer supports loading dynamic (TrueType, OpeType, etc.) fonts. .. _class_TextServer_constant_FEATURE_FONT_MSDF: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_FONT_MSDF** = ``256`` TextServer supports multichannel signed distance field dynamic font rendering. .. _class_TextServer_constant_FEATURE_FONT_SYSTEM: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_FONT_SYSTEM** = ``512`` TextServer supports loading system fonts. .. _class_TextServer_constant_FEATURE_FONT_VARIABLE: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_FONT_VARIABLE** = ``1024`` TextServer supports variable fonts. .. _class_TextServer_constant_FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION** = ``2048`` TextServer supports locale dependent and context sensitive case conversion. .. _class_TextServer_constant_FEATURE_USE_SUPPORT_DATA: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_USE_SUPPORT_DATA** = ``4096`` TextServer require external data file for some features, see :ref:`load_support_data`. .. _class_TextServer_constant_FEATURE_UNICODE_IDENTIFIERS: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_UNICODE_IDENTIFIERS** = ``8192`` TextServer supports UAX #31 identifier validation, see :ref:`is_valid_identifier`. .. _class_TextServer_constant_FEATURE_UNICODE_SECURITY: .. rst-class:: classref-enumeration-constant :ref:`Feature` **FEATURE_UNICODE_SECURITY** = ``16384`` TextServer supports `Unicode Technical Report #36 `__ and `Unicode Technical Standard #39 `__ based spoof detection features. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_ContourPointTag: .. rst-class:: classref-enumeration enum **ContourPointTag**: .. _class_TextServer_constant_CONTOUR_CURVE_TAG_ON: .. rst-class:: classref-enumeration-constant :ref:`ContourPointTag` **CONTOUR_CURVE_TAG_ON** = ``1`` Contour point is on the curve. .. _class_TextServer_constant_CONTOUR_CURVE_TAG_OFF_CONIC: .. rst-class:: classref-enumeration-constant :ref:`ContourPointTag` **CONTOUR_CURVE_TAG_OFF_CONIC** = ``0`` Contour point isn't on the curve, but serves as a control point for a conic (quadratic) Bézier arc. .. _class_TextServer_constant_CONTOUR_CURVE_TAG_OFF_CUBIC: .. rst-class:: classref-enumeration-constant :ref:`ContourPointTag` **CONTOUR_CURVE_TAG_OFF_CUBIC** = ``2`` Contour point isn't on the curve, but serves as a control point for a cubic Bézier arc. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_SpacingType: .. rst-class:: classref-enumeration enum **SpacingType**: .. _class_TextServer_constant_SPACING_GLYPH: .. rst-class:: classref-enumeration-constant :ref:`SpacingType` **SPACING_GLYPH** = ``0`` Spacing for each glyph. .. _class_TextServer_constant_SPACING_SPACE: .. rst-class:: classref-enumeration-constant :ref:`SpacingType` **SPACING_SPACE** = ``1`` Spacing for the space character. .. _class_TextServer_constant_SPACING_TOP: .. rst-class:: classref-enumeration-constant :ref:`SpacingType` **SPACING_TOP** = ``2`` Spacing at the top of the line. .. _class_TextServer_constant_SPACING_BOTTOM: .. rst-class:: classref-enumeration-constant :ref:`SpacingType` **SPACING_BOTTOM** = ``3`` Spacing at the bottom of the line. .. _class_TextServer_constant_SPACING_MAX: .. rst-class:: classref-enumeration-constant :ref:`SpacingType` **SPACING_MAX** = ``4`` Represents the size of the :ref:`SpacingType` enum. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_FontStyle: .. rst-class:: classref-enumeration flags **FontStyle**: .. _class_TextServer_constant_FONT_BOLD: .. rst-class:: classref-enumeration-constant :ref:`FontStyle` **FONT_BOLD** = ``1`` Font is bold. .. _class_TextServer_constant_FONT_ITALIC: .. rst-class:: classref-enumeration-constant :ref:`FontStyle` **FONT_ITALIC** = ``2`` Font is italic or oblique. .. _class_TextServer_constant_FONT_FIXED_WIDTH: .. rst-class:: classref-enumeration-constant :ref:`FontStyle` **FONT_FIXED_WIDTH** = ``4`` Font have fixed-width characters. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_StructuredTextParser: .. rst-class:: classref-enumeration enum **StructuredTextParser**: .. _class_TextServer_constant_STRUCTURED_TEXT_DEFAULT: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_DEFAULT** = ``0`` Use default Unicode BiDi algorithm. .. _class_TextServer_constant_STRUCTURED_TEXT_URI: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_URI** = ``1`` BiDi override for URI. .. _class_TextServer_constant_STRUCTURED_TEXT_FILE: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_FILE** = ``2`` BiDi override for file path. .. _class_TextServer_constant_STRUCTURED_TEXT_EMAIL: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_EMAIL** = ``3`` BiDi override for email. .. _class_TextServer_constant_STRUCTURED_TEXT_LIST: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_LIST** = ``4`` BiDi override for lists. Structured text options: list separator :ref:`String`. .. _class_TextServer_constant_STRUCTURED_TEXT_GDSCRIPT: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_GDSCRIPT** = ``5`` BiDi override for GDScript. .. _class_TextServer_constant_STRUCTURED_TEXT_CUSTOM: .. rst-class:: classref-enumeration-constant :ref:`StructuredTextParser` **STRUCTURED_TEXT_CUSTOM** = ``6`` User defined structured text BiDi override function. .. rst-class:: classref-item-separator ---- .. _enum_TextServer_FixedSizeScaleMode: .. rst-class:: classref-enumeration enum **FixedSizeScaleMode**: .. _class_TextServer_constant_FIXED_SIZE_SCALE_DISABLE: .. rst-class:: classref-enumeration-constant :ref:`FixedSizeScaleMode` **FIXED_SIZE_SCALE_DISABLE** = ``0`` Bitmap font is not scaled. .. _class_TextServer_constant_FIXED_SIZE_SCALE_INTEGER_ONLY: .. rst-class:: classref-enumeration-constant :ref:`FixedSizeScaleMode` **FIXED_SIZE_SCALE_INTEGER_ONLY** = ``1`` Bitmap font is scaled to the closest integer multiple of the font's fixed size. This is the recommended option for pixel art fonts. .. _class_TextServer_constant_FIXED_SIZE_SCALE_ENABLED: .. rst-class:: classref-enumeration-constant :ref:`FixedSizeScaleMode` **FIXED_SIZE_SCALE_ENABLED** = ``2`` Bitmap font is scaled to an arbitrary (fractional) size. This is the recommended option for non-pixel art fonts. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Method Descriptions ------------------- .. _class_TextServer_method_create_font: .. rst-class:: classref-method :ref:`RID` **create_font** **(** **)** Creates a new, empty font cache entry resource. To free the resulting resource, use the :ref:`free_rid` method. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_create_font_linked_variation: .. rst-class:: classref-method :ref:`RID` **create_font_linked_variation** **(** :ref:`RID` font_rid **)** Creates a new variation existing font which is reusing the same glyph cache and font data. To free the resulting resource, use the :ref:`free_rid` method. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_create_shaped_text: .. rst-class:: classref-method :ref:`RID` **create_shaped_text** **(** :ref:`Direction` direction=0, :ref:`Orientation` orientation=0 **)** Creates new buffer for complex text layout, with the given ``direction`` and ``orientation``. To free the resulting buffer, use :ref:`free_rid` method. \ **Note:** Direction is ignored if server does not support :ref:`FEATURE_BIDI_LAYOUT` feature (supported by :ref:`TextServerAdvanced`). \ **Note:** Orientation is ignored if server does not support :ref:`FEATURE_VERTICAL_LAYOUT` feature (supported by :ref:`TextServerAdvanced`). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_draw_hex_code_box: .. rst-class:: classref-method void **draw_hex_code_box** **(** :ref:`RID` canvas, :ref:`int` size, :ref:`Vector2` pos, :ref:`int` index, :ref:`Color` color **)** |const| Draws box displaying character hexadecimal code. Used for replacing missing characters. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_clear_glyphs: .. rst-class:: classref-method void **font_clear_glyphs** **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** Removes all rendered glyphs information from the cache entry. \ **Note:** This function will not remove textures associated with the glyphs, use :ref:`font_remove_texture` to remove them manually. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_clear_kerning_map: .. rst-class:: classref-method void **font_clear_kerning_map** **(** :ref:`RID` font_rid, :ref:`int` size **)** Removes all kerning overrides. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_clear_size_cache: .. rst-class:: classref-method void **font_clear_size_cache** **(** :ref:`RID` font_rid **)** Removes all font sizes from the cache entry. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_clear_textures: .. rst-class:: classref-method void **font_clear_textures** **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** Removes all textures from font cache entry. \ **Note:** This function will not remove glyphs associated with the texture, use :ref:`font_remove_glyph` to remove them manually. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_draw_glyph: .. rst-class:: classref-method void **font_draw_glyph** **(** :ref:`RID` font_rid, :ref:`RID` canvas, :ref:`int` size, :ref:`Vector2` pos, :ref:`int` index, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| Draws single glyph into a canvas item at the position, using ``font_rid`` at the size ``size``. \ **Note:** Glyph index is specific to the font, use glyphs indices returned by :ref:`shaped_text_get_glyphs` or :ref:`font_get_glyph_index`. \ **Note:** If there are pending glyphs to render, calling this function might trigger the texture cache update. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_draw_glyph_outline: .. rst-class:: classref-method void **font_draw_glyph_outline** **(** :ref:`RID` font_rid, :ref:`RID` canvas, :ref:`int` size, :ref:`int` outline_size, :ref:`Vector2` pos, :ref:`int` index, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| Draws single glyph outline of size ``outline_size`` into a canvas item at the position, using ``font_rid`` at the size ``size``. \ **Note:** Glyph index is specific to the font, use glyphs indices returned by :ref:`shaped_text_get_glyphs` or :ref:`font_get_glyph_index`. \ **Note:** If there are pending glyphs to render, calling this function might trigger the texture cache update. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_antialiasing: .. rst-class:: classref-method :ref:`FontAntialiasing` **font_get_antialiasing** **(** :ref:`RID` font_rid **)** |const| Returns font anti-aliasing mode. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_ascent: .. rst-class:: classref-method :ref:`float` **font_get_ascent** **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| Returns the font ascent (number of pixels above the baseline). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_char_from_glyph_index: .. rst-class:: classref-method :ref:`int` **font_get_char_from_glyph_index** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` glyph_index **)** |const| Returns character code associated with ``glyph_index``, or ``0`` if ``glyph_index`` is invalid. See :ref:`font_get_glyph_index`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_descent: .. rst-class:: classref-method :ref:`float` **font_get_descent** **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| Returns the font descent (number of pixels below the baseline). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_embolden: .. rst-class:: classref-method :ref:`float` **font_get_embolden** **(** :ref:`RID` font_rid **)** |const| Returns font embolden strength. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_face_count: .. rst-class:: classref-method :ref:`int` **font_get_face_count** **(** :ref:`RID` font_rid **)** |const| Returns number of faces in the TrueType / OpenType collection. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_face_index: .. rst-class:: classref-method :ref:`int` **font_get_face_index** **(** :ref:`RID` font_rid **)** |const| Returns an active face index in the TrueType / OpenType collection. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_fixed_size: .. rst-class:: classref-method :ref:`int` **font_get_fixed_size** **(** :ref:`RID` font_rid **)** |const| Returns bitmap font fixed size. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_fixed_size_scale_mode: .. rst-class:: classref-method :ref:`FixedSizeScaleMode` **font_get_fixed_size_scale_mode** **(** :ref:`RID` font_rid **)** |const| Returns bitmap font scaling mode. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_generate_mipmaps: .. rst-class:: classref-method :ref:`bool` **font_get_generate_mipmaps** **(** :ref:`RID` font_rid **)** |const| Returns ``true`` if font texture mipmap generation is enabled. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_global_oversampling: .. rst-class:: classref-method :ref:`float` **font_get_global_oversampling** **(** **)** |const| Returns the font oversampling factor, shared by all fonts in the TextServer. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_advance: .. rst-class:: classref-method :ref:`Vector2` **font_get_glyph_advance** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` glyph **)** |const| Returns glyph advance (offset of the next glyph). \ **Note:** Advance for glyphs outlines is the same as the base glyph advance and is not saved. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_contours: .. rst-class:: classref-method :ref:`Dictionary` **font_get_glyph_contours** **(** :ref:`RID` font, :ref:`int` size, :ref:`int` index **)** |const| Returns outline contours of the glyph as a :ref:`Dictionary` with the following contents: \ ``points`` - :ref:`PackedVector3Array`, containing outline points. ``x`` and ``y`` are point coordinates. ``z`` is the type of the point, using the :ref:`ContourPointTag` values. \ ``contours`` - :ref:`PackedInt32Array`, containing indices the end points of each contour. \ ``orientation`` - :ref:`bool`, contour orientation. If ``true``, clockwise contours must be filled. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_index: .. rst-class:: classref-method :ref:`int` **font_get_glyph_index** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` char, :ref:`int` variation_selector **)** |const| Returns the glyph index of a ``char``, optionally modified by the ``variation_selector``. See :ref:`font_get_char_from_glyph_index`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_list: .. rst-class:: classref-method :ref:`PackedInt32Array` **font_get_glyph_list** **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** |const| Returns list of rendered glyphs in the cache entry. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_offset: .. rst-class:: classref-method :ref:`Vector2` **font_get_glyph_offset** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| Returns glyph offset from the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_size: .. rst-class:: classref-method :ref:`Vector2` **font_get_glyph_size** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| Returns size of the glyph. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_texture_idx: .. rst-class:: classref-method :ref:`int` **font_get_glyph_texture_idx** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| Returns index of the cache texture containing the glyph. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_texture_rid: .. rst-class:: classref-method :ref:`RID` **font_get_glyph_texture_rid** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| Returns resource ID of the cache texture containing the glyph. \ **Note:** If there are pending glyphs to render, calling this function might trigger the texture cache update. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_texture_size: .. rst-class:: classref-method :ref:`Vector2` **font_get_glyph_texture_size** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| Returns size of the cache texture containing the glyph. \ **Note:** If there are pending glyphs to render, calling this function might trigger the texture cache update. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_glyph_uv_rect: .. rst-class:: classref-method :ref:`Rect2` **font_get_glyph_uv_rect** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** |const| Returns rectangle in the cache texture containing the glyph. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_hinting: .. rst-class:: classref-method :ref:`Hinting` **font_get_hinting** **(** :ref:`RID` font_rid **)** |const| Returns the font hinting mode. Used by dynamic fonts only. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_kerning: .. rst-class:: classref-method :ref:`Vector2` **font_get_kerning** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`Vector2i` glyph_pair **)** |const| Returns kerning for the pair of glyphs. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_kerning_list: .. rst-class:: classref-method :ref:`Vector2i[]` **font_get_kerning_list** **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| Returns list of the kerning overrides. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_language_support_override: .. rst-class:: classref-method :ref:`bool` **font_get_language_support_override** **(** :ref:`RID` font_rid, :ref:`String` language **)** Returns ``true`` if support override is enabled for the ``language``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_language_support_overrides: .. rst-class:: classref-method :ref:`PackedStringArray` **font_get_language_support_overrides** **(** :ref:`RID` font_rid **)** Returns list of language support overrides. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_msdf_pixel_range: .. rst-class:: classref-method :ref:`int` **font_get_msdf_pixel_range** **(** :ref:`RID` font_rid **)** |const| Returns the width of the range around the shape between the minimum and maximum representable signed distance. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_msdf_size: .. rst-class:: classref-method :ref:`int` **font_get_msdf_size** **(** :ref:`RID` font_rid **)** |const| Returns source font size used to generate MSDF textures. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_name: .. rst-class:: classref-method :ref:`String` **font_get_name** **(** :ref:`RID` font_rid **)** |const| Returns font family name. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_opentype_feature_overrides: .. rst-class:: classref-method :ref:`Dictionary` **font_get_opentype_feature_overrides** **(** :ref:`RID` font_rid **)** |const| Returns font OpenType feature set override. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_ot_name_strings: .. rst-class:: classref-method :ref:`Dictionary` **font_get_ot_name_strings** **(** :ref:`RID` font_rid **)** |const| Returns :ref:`Dictionary` with OpenType font name strings (localized font names, version, description, license information, sample text, etc.). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_oversampling: .. rst-class:: classref-method :ref:`float` **font_get_oversampling** **(** :ref:`RID` font_rid **)** |const| Returns font oversampling factor, if set to ``0.0`` global oversampling factor is used instead. Used by dynamic fonts only. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_scale: .. rst-class:: classref-method :ref:`float` **font_get_scale** **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| Returns scaling factor of the color bitmap font. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_script_support_override: .. rst-class:: classref-method :ref:`bool` **font_get_script_support_override** **(** :ref:`RID` font_rid, :ref:`String` script **)** Returns ``true`` if support override is enabled for the ``script``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_script_support_overrides: .. rst-class:: classref-method :ref:`PackedStringArray` **font_get_script_support_overrides** **(** :ref:`RID` font_rid **)** Returns list of script support overrides. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_size_cache_list: .. rst-class:: classref-method :ref:`Vector2i[]` **font_get_size_cache_list** **(** :ref:`RID` font_rid **)** |const| Returns list of the font sizes in the cache. Each size is :ref:`Vector2i` with font size and outline size. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_spacing: .. rst-class:: classref-method :ref:`int` **font_get_spacing** **(** :ref:`RID` font_rid, :ref:`SpacingType` spacing **)** |const| Returns the spacing for ``spacing`` (see :ref:`SpacingType`) in pixels (not relative to the font size). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_stretch: .. rst-class:: classref-method :ref:`int` **font_get_stretch** **(** :ref:`RID` font_rid **)** |const| Returns font stretch amount, compared to a normal width. A percentage value between ``50%`` and ``200%``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_style: .. rst-class:: classref-method |bitfield|\<:ref:`FontStyle`\> **font_get_style** **(** :ref:`RID` font_rid **)** |const| Returns font style flags, see :ref:`FontStyle`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_style_name: .. rst-class:: classref-method :ref:`String` **font_get_style_name** **(** :ref:`RID` font_rid **)** |const| Returns font style name. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_subpixel_positioning: .. rst-class:: classref-method :ref:`SubpixelPositioning` **font_get_subpixel_positioning** **(** :ref:`RID` font_rid **)** |const| Returns font subpixel glyph positioning mode. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_supported_chars: .. rst-class:: classref-method :ref:`String` **font_get_supported_chars** **(** :ref:`RID` font_rid **)** |const| Returns a string containing all the characters available in the font. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_texture_count: .. rst-class:: classref-method :ref:`int` **font_get_texture_count** **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** |const| Returns number of textures used by font cache entry. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_texture_image: .. rst-class:: classref-method :ref:`Image` **font_get_texture_image** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index **)** |const| Returns font cache texture image data. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_texture_offsets: .. rst-class:: classref-method :ref:`PackedInt32Array` **font_get_texture_offsets** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index **)** |const| Returns array containing glyph packing data. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_transform: .. rst-class:: classref-method :ref:`Transform2D` **font_get_transform** **(** :ref:`RID` font_rid **)** |const| Returns 2D transform applied to the font outlines. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_underline_position: .. rst-class:: classref-method :ref:`float` **font_get_underline_position** **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| Returns pixel offset of the underline below the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_underline_thickness: .. rst-class:: classref-method :ref:`float` **font_get_underline_thickness** **(** :ref:`RID` font_rid, :ref:`int` size **)** |const| Returns thickness of the underline in pixels. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_variation_coordinates: .. rst-class:: classref-method :ref:`Dictionary` **font_get_variation_coordinates** **(** :ref:`RID` font_rid **)** |const| Returns variation coordinates for the specified font cache entry. See :ref:`font_supported_variation_list` for more info. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_get_weight: .. rst-class:: classref-method :ref:`int` **font_get_weight** **(** :ref:`RID` font_rid **)** |const| Returns weight (boldness) of the font. A value in the ``100...999`` range, normal font weight is ``400``, bold font weight is ``700``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_has_char: .. rst-class:: classref-method :ref:`bool` **font_has_char** **(** :ref:`RID` font_rid, :ref:`int` char **)** |const| Returns ``true`` if a Unicode ``char`` is available in the font. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_is_allow_system_fallback: .. rst-class:: classref-method :ref:`bool` **font_is_allow_system_fallback** **(** :ref:`RID` font_rid **)** |const| Returns ``true`` if system fonts can be automatically used as fallbacks. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_is_force_autohinter: .. rst-class:: classref-method :ref:`bool` **font_is_force_autohinter** **(** :ref:`RID` font_rid **)** |const| Returns ``true`` if auto-hinting is supported and preferred over font built-in hinting. Used by dynamic fonts only. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_is_language_supported: .. rst-class:: classref-method :ref:`bool` **font_is_language_supported** **(** :ref:`RID` font_rid, :ref:`String` language **)** |const| Returns ``true``, if font supports given language (`ISO 639 `__ code). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_is_multichannel_signed_distance_field: .. rst-class:: classref-method :ref:`bool` **font_is_multichannel_signed_distance_field** **(** :ref:`RID` font_rid **)** |const| Returns ``true`` if glyphs of all sizes are rendered using single multichannel signed distance field generated from the dynamic font vector data. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_is_script_supported: .. rst-class:: classref-method :ref:`bool` **font_is_script_supported** **(** :ref:`RID` font_rid, :ref:`String` script **)** |const| Returns ``true``, if font supports given script (ISO 15924 code). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_remove_glyph: .. rst-class:: classref-method void **font_remove_glyph** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph **)** Removes specified rendered glyph information from the cache entry. \ **Note:** This function will not remove textures associated with the glyphs, use :ref:`font_remove_texture` to remove them manually. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_remove_kerning: .. rst-class:: classref-method void **font_remove_kerning** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`Vector2i` glyph_pair **)** Removes kerning override for the pair of glyphs. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_remove_language_support_override: .. rst-class:: classref-method void **font_remove_language_support_override** **(** :ref:`RID` font_rid, :ref:`String` language **)** Remove language support override. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_remove_script_support_override: .. rst-class:: classref-method void **font_remove_script_support_override** **(** :ref:`RID` font_rid, :ref:`String` script **)** Removes script support override. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_remove_size_cache: .. rst-class:: classref-method void **font_remove_size_cache** **(** :ref:`RID` font_rid, :ref:`Vector2i` size **)** Removes specified font size from the cache entry. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_remove_texture: .. rst-class:: classref-method void **font_remove_texture** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index **)** Removes specified texture from the cache entry. \ **Note:** This function will not remove glyphs associated with the texture, remove them manually, using :ref:`font_remove_glyph`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_render_glyph: .. rst-class:: classref-method void **font_render_glyph** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` index **)** Renders specified glyph to the font cache texture. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_render_range: .. rst-class:: classref-method void **font_render_range** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` start, :ref:`int` end **)** Renders the range of characters to the font cache texture. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_allow_system_fallback: .. rst-class:: classref-method void **font_set_allow_system_fallback** **(** :ref:`RID` font_rid, :ref:`bool` allow_system_fallback **)** If set to ``true``, system fonts can be automatically used as fallbacks. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_antialiasing: .. rst-class:: classref-method void **font_set_antialiasing** **(** :ref:`RID` font_rid, :ref:`FontAntialiasing` antialiasing **)** Sets font anti-aliasing mode. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_ascent: .. rst-class:: classref-method void **font_set_ascent** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` ascent **)** Sets the font ascent (number of pixels above the baseline). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_data: .. rst-class:: classref-method void **font_set_data** **(** :ref:`RID` font_rid, :ref:`PackedByteArray` data **)** Sets font source data, e.g contents of the dynamic font source file. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_descent: .. rst-class:: classref-method void **font_set_descent** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` descent **)** Sets the font descent (number of pixels below the baseline). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_embolden: .. rst-class:: classref-method void **font_set_embolden** **(** :ref:`RID` font_rid, :ref:`float` strength **)** Sets font embolden strength. If ``strength`` is not equal to zero, emboldens the font outlines. Negative values reduce the outline thickness. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_face_index: .. rst-class:: classref-method void **font_set_face_index** **(** :ref:`RID` font_rid, :ref:`int` face_index **)** Sets an active face index in the TrueType / OpenType collection. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_fixed_size: .. rst-class:: classref-method void **font_set_fixed_size** **(** :ref:`RID` font_rid, :ref:`int` fixed_size **)** Sets bitmap font fixed size. If set to value greater than zero, same cache entry will be used for all font sizes. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_fixed_size_scale_mode: .. rst-class:: classref-method void **font_set_fixed_size_scale_mode** **(** :ref:`RID` font_rid, :ref:`FixedSizeScaleMode` fixed_size_scale_mode **)** Sets bitmap font scaling mode. This property is used only if ``fixed_size`` is greater than zero. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_force_autohinter: .. rst-class:: classref-method void **font_set_force_autohinter** **(** :ref:`RID` font_rid, :ref:`bool` force_autohinter **)** If set to ``true`` auto-hinting is preferred over font built-in hinting. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_generate_mipmaps: .. rst-class:: classref-method void **font_set_generate_mipmaps** **(** :ref:`RID` font_rid, :ref:`bool` generate_mipmaps **)** If set to ``true`` font texture mipmap generation is enabled. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_global_oversampling: .. rst-class:: classref-method void **font_set_global_oversampling** **(** :ref:`float` oversampling **)** Sets oversampling factor, shared by all font in the TextServer. \ **Note:** This value can be automatically changed by display server. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_glyph_advance: .. rst-class:: classref-method void **font_set_glyph_advance** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`int` glyph, :ref:`Vector2` advance **)** Sets glyph advance (offset of the next glyph). \ **Note:** Advance for glyphs outlines is the same as the base glyph advance and is not saved. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_glyph_offset: .. rst-class:: classref-method void **font_set_glyph_offset** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`Vector2` offset **)** Sets glyph offset from the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_glyph_size: .. rst-class:: classref-method void **font_set_glyph_size** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`Vector2` gl_size **)** Sets size of the glyph. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_glyph_texture_idx: .. rst-class:: classref-method void **font_set_glyph_texture_idx** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`int` texture_idx **)** Sets index of the cache texture containing the glyph. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_glyph_uv_rect: .. rst-class:: classref-method void **font_set_glyph_uv_rect** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` glyph, :ref:`Rect2` uv_rect **)** Sets rectangle in the cache texture containing the glyph. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_hinting: .. rst-class:: classref-method void **font_set_hinting** **(** :ref:`RID` font_rid, :ref:`Hinting` hinting **)** Sets font hinting mode. Used by dynamic fonts only. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_kerning: .. rst-class:: classref-method void **font_set_kerning** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`Vector2i` glyph_pair, :ref:`Vector2` kerning **)** Sets kerning for the pair of glyphs. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_language_support_override: .. rst-class:: classref-method void **font_set_language_support_override** **(** :ref:`RID` font_rid, :ref:`String` language, :ref:`bool` supported **)** Adds override for :ref:`font_is_language_supported`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_msdf_pixel_range: .. rst-class:: classref-method void **font_set_msdf_pixel_range** **(** :ref:`RID` font_rid, :ref:`int` msdf_pixel_range **)** Sets the width of the range around the shape between the minimum and maximum representable signed distance. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_msdf_size: .. rst-class:: classref-method void **font_set_msdf_size** **(** :ref:`RID` font_rid, :ref:`int` msdf_size **)** Sets source font size used to generate MSDF textures. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_multichannel_signed_distance_field: .. rst-class:: classref-method void **font_set_multichannel_signed_distance_field** **(** :ref:`RID` font_rid, :ref:`bool` msdf **)** If set to ``true``, glyphs of all sizes are rendered using single multichannel signed distance field generated from the dynamic font vector data. MSDF rendering allows displaying the font at any scaling factor without blurriness, and without incurring a CPU cost when the font size changes (since the font no longer needs to be rasterized on the CPU). As a downside, font hinting is not available with MSDF. The lack of font hinting may result in less crisp and less readable fonts at small sizes. \ **Note:** MSDF font rendering does not render glyphs with overlapping shapes correctly. Overlapping shapes are not valid per the OpenType standard, but are still commonly found in many font files, especially those converted by Google Fonts. To avoid issues with overlapping glyphs, consider downloading the font file directly from the type foundry instead of relying on Google Fonts. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_name: .. rst-class:: classref-method void **font_set_name** **(** :ref:`RID` font_rid, :ref:`String` name **)** Sets the font family name. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_opentype_feature_overrides: .. rst-class:: classref-method void **font_set_opentype_feature_overrides** **(** :ref:`RID` font_rid, :ref:`Dictionary` overrides **)** Sets font OpenType feature set override. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_oversampling: .. rst-class:: classref-method void **font_set_oversampling** **(** :ref:`RID` font_rid, :ref:`float` oversampling **)** Sets font oversampling factor, if set to ``0.0`` global oversampling factor is used instead. Used by dynamic fonts only. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_scale: .. rst-class:: classref-method void **font_set_scale** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` scale **)** Sets scaling factor of the color bitmap font. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_script_support_override: .. rst-class:: classref-method void **font_set_script_support_override** **(** :ref:`RID` font_rid, :ref:`String` script, :ref:`bool` supported **)** Adds override for :ref:`font_is_script_supported`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_spacing: .. rst-class:: classref-method void **font_set_spacing** **(** :ref:`RID` font_rid, :ref:`SpacingType` spacing, :ref:`int` value **)** Sets the spacing for ``spacing`` (see :ref:`SpacingType`) to ``value`` in pixels (not relative to the font size). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_stretch: .. rst-class:: classref-method void **font_set_stretch** **(** :ref:`RID` font_rid, :ref:`int` weight **)** Sets font stretch amount, compared to a normal width. A percentage value between ``50%`` and ``200%``. \ **Note:** This value is used for font matching only and will not affect font rendering. Use :ref:`font_set_face_index`, :ref:`font_set_variation_coordinates`, or :ref:`font_set_transform` instead. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_style: .. rst-class:: classref-method void **font_set_style** **(** :ref:`RID` font_rid, |bitfield|\<:ref:`FontStyle`\> style **)** Sets the font style flags, see :ref:`FontStyle`. \ **Note:** This value is used for font matching only and will not affect font rendering. Use :ref:`font_set_face_index`, :ref:`font_set_variation_coordinates`, :ref:`font_set_embolden`, or :ref:`font_set_transform` instead. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_style_name: .. rst-class:: classref-method void **font_set_style_name** **(** :ref:`RID` font_rid, :ref:`String` name **)** Sets the font style name. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_subpixel_positioning: .. rst-class:: classref-method void **font_set_subpixel_positioning** **(** :ref:`RID` font_rid, :ref:`SubpixelPositioning` subpixel_positioning **)** Sets font subpixel glyph positioning mode. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_texture_image: .. rst-class:: classref-method void **font_set_texture_image** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index, :ref:`Image` image **)** Sets font cache texture image data. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_texture_offsets: .. rst-class:: classref-method void **font_set_texture_offsets** **(** :ref:`RID` font_rid, :ref:`Vector2i` size, :ref:`int` texture_index, :ref:`PackedInt32Array` offset **)** Sets array containing glyph packing data. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_transform: .. rst-class:: classref-method void **font_set_transform** **(** :ref:`RID` font_rid, :ref:`Transform2D` transform **)** Sets 2D transform, applied to the font outlines, can be used for slanting, flipping and rotating glyphs. For example, to simulate italic typeface by slanting, apply the following transform ``Transform2D(1.0, slant, 0.0, 1.0, 0.0, 0.0)``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_underline_position: .. rst-class:: classref-method void **font_set_underline_position** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` underline_position **)** Sets pixel offset of the underline below the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_underline_thickness: .. rst-class:: classref-method void **font_set_underline_thickness** **(** :ref:`RID` font_rid, :ref:`int` size, :ref:`float` underline_thickness **)** Sets thickness of the underline in pixels. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_variation_coordinates: .. rst-class:: classref-method void **font_set_variation_coordinates** **(** :ref:`RID` font_rid, :ref:`Dictionary` variation_coordinates **)** Sets variation coordinates for the specified font cache entry. See :ref:`font_supported_variation_list` for more info. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_set_weight: .. rst-class:: classref-method void **font_set_weight** **(** :ref:`RID` font_rid, :ref:`int` weight **)** Sets weight (boldness) of the font. A value in the ``100...999`` range, normal font weight is ``400``, bold font weight is ``700``. \ **Note:** This value is used for font matching only and will not affect font rendering. Use :ref:`font_set_face_index`, :ref:`font_set_variation_coordinates`, or :ref:`font_set_embolden` instead. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_supported_feature_list: .. rst-class:: classref-method :ref:`Dictionary` **font_supported_feature_list** **(** :ref:`RID` font_rid **)** |const| Returns the dictionary of the supported OpenType features. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_font_supported_variation_list: .. rst-class:: classref-method :ref:`Dictionary` **font_supported_variation_list** **(** :ref:`RID` font_rid **)** |const| Returns the dictionary of the supported OpenType variation coordinates. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_format_number: .. rst-class:: classref-method :ref:`String` **format_number** **(** :ref:`String` number, :ref:`String` language="" **)** |const| Converts a number from the Western Arabic (0..9) to the numeral systems used in ``language``. If ``language`` is omitted, the active locale will be used. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_free_rid: .. rst-class:: classref-method void **free_rid** **(** :ref:`RID` rid **)** Frees an object created by this **TextServer**. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_get_features: .. rst-class:: classref-method :ref:`int` **get_features** **(** **)** |const| Returns text server features, see :ref:`Feature`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_get_hex_code_box_size: .. rst-class:: classref-method :ref:`Vector2` **get_hex_code_box_size** **(** :ref:`int` size, :ref:`int` index **)** |const| Returns size of the replacement character (box with character hexadecimal code that is drawn in place of invalid characters). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_get_name: .. rst-class:: classref-method :ref:`String` **get_name** **(** **)** |const| Returns the name of the server interface. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_get_support_data_filename: .. rst-class:: classref-method :ref:`String` **get_support_data_filename** **(** **)** |const| Returns default TextServer database (e.g. ICU break iterators and dictionaries) filename. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_get_support_data_info: .. rst-class:: classref-method :ref:`String` **get_support_data_info** **(** **)** |const| Returns TextServer database (e.g. ICU break iterators and dictionaries) description. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_has: .. rst-class:: classref-method :ref:`bool` **has** **(** :ref:`RID` rid **)** Returns ``true`` if ``rid`` is valid resource owned by this text server. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_has_feature: .. rst-class:: classref-method :ref:`bool` **has_feature** **(** :ref:`Feature` feature **)** |const| Returns ``true`` if the server supports a feature. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_is_confusable: .. rst-class:: classref-method :ref:`int` **is_confusable** **(** :ref:`String` string, :ref:`PackedStringArray` dict **)** |const| Returns index of the first string in ``dict`` which is visually confusable with the ``string``, or ``-1`` if none is found. \ **Note:** This method doesn't detect invisible characters, for spoof detection use it in combination with :ref:`spoof_check`. \ **Note:** Always returns ``-1`` if the server does not support the :ref:`FEATURE_UNICODE_SECURITY` feature. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_is_locale_right_to_left: .. rst-class:: classref-method :ref:`bool` **is_locale_right_to_left** **(** :ref:`String` locale **)** |const| Returns ``true`` if locale is right-to-left. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_is_valid_identifier: .. rst-class:: classref-method :ref:`bool` **is_valid_identifier** **(** :ref:`String` string **)** |const| Returns ``true`` if ``string`` is a valid identifier. If the text server supports the :ref:`FEATURE_UNICODE_IDENTIFIERS` feature, a valid identifier must: - Conform to normalization form C. - Begin with a Unicode character of class XID_Start or ``"_"``. - May contain Unicode characters of class XID_Continue in the other positions. - Use UAX #31 recommended scripts only (mixed scripts are allowed). If the :ref:`FEATURE_UNICODE_IDENTIFIERS` feature is not supported, a valid identifier must: - Begin with a Unicode character of class XID_Start or ``"_"``. - May contain Unicode characters of class XID_Continue in the other positions. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_load_support_data: .. rst-class:: classref-method :ref:`bool` **load_support_data** **(** :ref:`String` filename **)** Loads optional TextServer database (e.g. ICU break iterators and dictionaries). \ **Note:** This function should be called before any other TextServer functions used, otherwise it won't have any effect. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_name_to_tag: .. rst-class:: classref-method :ref:`int` **name_to_tag** **(** :ref:`String` name **)** |const| Converts readable feature, variation, script or language name to OpenType tag. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_parse_number: .. rst-class:: classref-method :ref:`String` **parse_number** **(** :ref:`String` number, :ref:`String` language="" **)** |const| Converts ``number`` from the numeral systems used in ``language`` to Western Arabic (0..9). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_parse_structured_text: .. rst-class:: classref-method :ref:`Vector3i[]` **parse_structured_text** **(** :ref:`StructuredTextParser` parser_type, :ref:`Array` args, :ref:`String` text **)** |const| Default implementation of the BiDi algorithm override function. See :ref:`StructuredTextParser` for more info. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_percent_sign: .. rst-class:: classref-method :ref:`String` **percent_sign** **(** :ref:`String` language="" **)** |const| Returns percent sign used in the ``language``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_save_support_data: .. rst-class:: classref-method :ref:`bool` **save_support_data** **(** :ref:`String` filename **)** |const| Saves optional TextServer database (e.g. ICU break iterators and dictionaries) to the file. \ **Note:** This function is used by during project export, to include TextServer database. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_get_span_count: .. rst-class:: classref-method :ref:`int` **shaped_get_span_count** **(** :ref:`RID` shaped **)** |const| Returns number of text spans added using :ref:`shaped_text_add_string` or :ref:`shaped_text_add_object`. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_get_span_meta: .. rst-class:: classref-method :ref:`Variant` **shaped_get_span_meta** **(** :ref:`RID` shaped, :ref:`int` index **)** |const| Returns text span metadata. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_set_span_update_font: .. rst-class:: classref-method void **shaped_set_span_update_font** **(** :ref:`RID` shaped, :ref:`int` index, :ref:`RID[]` fonts, :ref:`int` size, :ref:`Dictionary` opentype_features={} **)** Changes text span font, font size and OpenType features, without changing the text. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_add_object: .. rst-class:: classref-method :ref:`bool` **shaped_text_add_object** **(** :ref:`RID` shaped, :ref:`Variant` key, :ref:`Vector2` size, :ref:`InlineAlignment` inline_align=5, :ref:`int` length=1, :ref:`float` baseline=0.0 **)** Adds inline object to the text buffer, ``key`` must be unique. In the text, object is represented as ``length`` object replacement characters. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_add_string: .. rst-class:: classref-method :ref:`bool` **shaped_text_add_string** **(** :ref:`RID` shaped, :ref:`String` text, :ref:`RID[]` fonts, :ref:`int` size, :ref:`Dictionary` opentype_features={}, :ref:`String` language="", :ref:`Variant` meta=null **)** Adds text span and font to draw it to the text buffer. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_clear: .. rst-class:: classref-method void **shaped_text_clear** **(** :ref:`RID` rid **)** Clears text buffer (removes text and inline objects). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_closest_character_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_closest_character_pos** **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| Returns composite character position closest to the ``pos``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_draw: .. rst-class:: classref-method void **shaped_text_draw** **(** :ref:`RID` shaped, :ref:`RID` canvas, :ref:`Vector2` pos, :ref:`float` clip_l=-1, :ref:`float` clip_r=-1, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| Draw shaped text into a canvas item at a given position, with ``color``. ``pos`` specifies the leftmost point of the baseline (for horizontal layout) or topmost point of the baseline (for vertical layout). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_draw_outline: .. rst-class:: classref-method void **shaped_text_draw_outline** **(** :ref:`RID` shaped, :ref:`RID` canvas, :ref:`Vector2` pos, :ref:`float` clip_l=-1, :ref:`float` clip_r=-1, :ref:`int` outline_size=1, :ref:`Color` color=Color(1, 1, 1, 1) **)** |const| Draw the outline of the shaped text into a canvas item at a given position, with ``color``. ``pos`` specifies the leftmost point of the baseline (for horizontal layout) or topmost point of the baseline (for vertical layout). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_fit_to_width: .. rst-class:: classref-method :ref:`float` **shaped_text_fit_to_width** **(** :ref:`RID` shaped, :ref:`float` width, |bitfield|\<:ref:`JustificationFlag`\> justification_flags=3 **)** Adjusts text width to fit to specified width, returns new text width. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_ascent: .. rst-class:: classref-method :ref:`float` **shaped_text_get_ascent** **(** :ref:`RID` shaped **)** |const| Returns the text ascent (number of pixels above the baseline for horizontal layout or to the left of baseline for vertical). \ **Note:** Overall ascent can be higher than font ascent, if some glyphs are displaced from the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_carets: .. rst-class:: classref-method :ref:`Dictionary` **shaped_text_get_carets** **(** :ref:`RID` shaped, :ref:`int` position **)** |const| Returns shapes of the carets corresponding to the character offset ``position`` in the text. Returned caret shape is 1 pixel wide rectangle. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_character_breaks: .. rst-class:: classref-method :ref:`PackedInt32Array` **shaped_text_get_character_breaks** **(** :ref:`RID` shaped **)** |const| Returns array of the composite character boundaries. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_custom_punctuation: .. rst-class:: classref-method :ref:`String` **shaped_text_get_custom_punctuation** **(** :ref:`RID` shaped **)** |const| Returns custom punctuation character list, used for word breaking. If set to empty string, server defaults are used. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_descent: .. rst-class:: classref-method :ref:`float` **shaped_text_get_descent** **(** :ref:`RID` shaped **)** |const| Returns the text descent (number of pixels below the baseline for horizontal layout or to the right of baseline for vertical). \ **Note:** Overall descent can be higher than font descent, if some glyphs are displaced from the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_direction: .. rst-class:: classref-method :ref:`Direction` **shaped_text_get_direction** **(** :ref:`RID` shaped **)** |const| Returns direction of the text. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_dominant_direction_in_range: .. rst-class:: classref-method :ref:`Direction` **shaped_text_get_dominant_direction_in_range** **(** :ref:`RID` shaped, :ref:`int` start, :ref:`int` end **)** |const| Returns dominant direction of in the range of text. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_ellipsis_glyph_count: .. rst-class:: classref-method :ref:`int` **shaped_text_get_ellipsis_glyph_count** **(** :ref:`RID` shaped **)** |const| Returns number of glyphs in the ellipsis. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_ellipsis_glyphs: .. rst-class:: classref-method :ref:`Dictionary[]` **shaped_text_get_ellipsis_glyphs** **(** :ref:`RID` shaped **)** |const| Returns array of the glyphs in the ellipsis. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_ellipsis_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_get_ellipsis_pos** **(** :ref:`RID` shaped **)** |const| Returns position of the ellipsis. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_glyph_count: .. rst-class:: classref-method :ref:`int` **shaped_text_get_glyph_count** **(** :ref:`RID` shaped **)** |const| Returns number of glyphs in the buffer. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_glyphs: .. rst-class:: classref-method :ref:`Dictionary[]` **shaped_text_get_glyphs** **(** :ref:`RID` shaped **)** |const| Returns an array of glyphs in the visual order. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_grapheme_bounds: .. rst-class:: classref-method :ref:`Vector2` **shaped_text_get_grapheme_bounds** **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| Returns composite character's bounds as offsets from the start of the line. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_inferred_direction: .. rst-class:: classref-method :ref:`Direction` **shaped_text_get_inferred_direction** **(** :ref:`RID` shaped **)** |const| Returns direction of the text, inferred by the BiDi algorithm. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_line_breaks: .. rst-class:: classref-method :ref:`PackedInt32Array` **shaped_text_get_line_breaks** **(** :ref:`RID` shaped, :ref:`float` width, :ref:`int` start=0, |bitfield|\<:ref:`LineBreakFlag`\> break_flags=3 **)** |const| Breaks text to the lines and returns character ranges for each line. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_line_breaks_adv: .. rst-class:: classref-method :ref:`PackedInt32Array` **shaped_text_get_line_breaks_adv** **(** :ref:`RID` shaped, :ref:`PackedFloat32Array` width, :ref:`int` start=0, :ref:`bool` once=true, |bitfield|\<:ref:`LineBreakFlag`\> break_flags=3 **)** |const| Breaks text to the lines and columns. Returns character ranges for each segment. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_object_rect: .. rst-class:: classref-method :ref:`Rect2` **shaped_text_get_object_rect** **(** :ref:`RID` shaped, :ref:`Variant` key **)** |const| Returns bounding rectangle of the inline object. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_objects: .. rst-class:: classref-method :ref:`Array` **shaped_text_get_objects** **(** :ref:`RID` shaped **)** |const| Returns array of inline objects. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_orientation: .. rst-class:: classref-method :ref:`Orientation` **shaped_text_get_orientation** **(** :ref:`RID` shaped **)** |const| Returns text orientation. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_parent: .. rst-class:: classref-method :ref:`RID` **shaped_text_get_parent** **(** :ref:`RID` shaped **)** |const| Returns the parent buffer from which the substring originates. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_preserve_control: .. rst-class:: classref-method :ref:`bool` **shaped_text_get_preserve_control** **(** :ref:`RID` shaped **)** |const| Returns ``true`` if text buffer is configured to display control characters. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_preserve_invalid: .. rst-class:: classref-method :ref:`bool` **shaped_text_get_preserve_invalid** **(** :ref:`RID` shaped **)** |const| Returns ``true`` if text buffer is configured to display hexadecimal codes in place of invalid characters. \ **Note:** If set to ``false``, nothing is displayed in place of invalid characters. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_range: .. rst-class:: classref-method :ref:`Vector2i` **shaped_text_get_range** **(** :ref:`RID` shaped **)** |const| Returns substring buffer character range in the parent buffer. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_selection: .. rst-class:: classref-method :ref:`PackedVector2Array` **shaped_text_get_selection** **(** :ref:`RID` shaped, :ref:`int` start, :ref:`int` end **)** |const| Returns selection rectangles for the specified character range. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_size: .. rst-class:: classref-method :ref:`Vector2` **shaped_text_get_size** **(** :ref:`RID` shaped **)** |const| Returns size of the text. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_spacing: .. rst-class:: classref-method :ref:`int` **shaped_text_get_spacing** **(** :ref:`RID` shaped, :ref:`SpacingType` spacing **)** |const| Returns extra spacing added between glyphs or lines in pixels. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_trim_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_get_trim_pos** **(** :ref:`RID` shaped **)** |const| Returns the position of the overrun trim. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_underline_position: .. rst-class:: classref-method :ref:`float` **shaped_text_get_underline_position** **(** :ref:`RID` shaped **)** |const| Returns pixel offset of the underline below the baseline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_underline_thickness: .. rst-class:: classref-method :ref:`float` **shaped_text_get_underline_thickness** **(** :ref:`RID` shaped **)** |const| Returns thickness of the underline. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_width: .. rst-class:: classref-method :ref:`float` **shaped_text_get_width** **(** :ref:`RID` shaped **)** |const| Returns width (for horizontal layout) or height (for vertical) of the text. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_get_word_breaks: .. rst-class:: classref-method :ref:`PackedInt32Array` **shaped_text_get_word_breaks** **(** :ref:`RID` shaped, |bitfield|\<:ref:`GraphemeFlag`\> grapheme_flags=264 **)** |const| Breaks text into words and returns array of character ranges. Use ``grapheme_flags`` to set what characters are used for breaking (see :ref:`GraphemeFlag`). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_has_visible_chars: .. rst-class:: classref-method :ref:`bool` **shaped_text_has_visible_chars** **(** :ref:`RID` shaped **)** |const| Returns ``true`` if text buffer contains any visible characters. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_hit_test_grapheme: .. rst-class:: classref-method :ref:`int` **shaped_text_hit_test_grapheme** **(** :ref:`RID` shaped, :ref:`float` coords **)** |const| Returns grapheme index at the specified pixel offset at the baseline, or ``-1`` if none is found. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_hit_test_position: .. rst-class:: classref-method :ref:`int` **shaped_text_hit_test_position** **(** :ref:`RID` shaped, :ref:`float` coords **)** |const| Returns caret character offset at the specified pixel offset at the baseline. This function always returns a valid position. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_is_ready: .. rst-class:: classref-method :ref:`bool` **shaped_text_is_ready** **(** :ref:`RID` shaped **)** |const| Returns ``true`` if buffer is successfully shaped. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_next_character_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_next_character_pos** **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| Returns composite character end position closest to the ``pos``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_next_grapheme_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_next_grapheme_pos** **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| Returns grapheme end position closest to the ``pos``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_overrun_trim_to_width: .. rst-class:: classref-method void **shaped_text_overrun_trim_to_width** **(** :ref:`RID` shaped, :ref:`float` width=0, |bitfield|\<:ref:`TextOverrunFlag`\> overrun_trim_flags=0 **)** Trims text if it exceeds the given width. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_prev_character_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_prev_character_pos** **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| Returns composite character start position closest to the ``pos``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_prev_grapheme_pos: .. rst-class:: classref-method :ref:`int` **shaped_text_prev_grapheme_pos** **(** :ref:`RID` shaped, :ref:`int` pos **)** |const| Returns grapheme start position closest to the ``pos``. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_resize_object: .. rst-class:: classref-method :ref:`bool` **shaped_text_resize_object** **(** :ref:`RID` shaped, :ref:`Variant` key, :ref:`Vector2` size, :ref:`InlineAlignment` inline_align=5, :ref:`float` baseline=0.0 **)** Sets new size and alignment of embedded object. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_bidi_override: .. rst-class:: classref-method void **shaped_text_set_bidi_override** **(** :ref:`RID` shaped, :ref:`Array` override **)** Overrides BiDi for the structured text. Override ranges should cover full source text without overlaps. BiDi algorithm will be used on each range separately. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_custom_punctuation: .. rst-class:: classref-method void **shaped_text_set_custom_punctuation** **(** :ref:`RID` shaped, :ref:`String` punct **)** Sets custom punctuation character list, used for word breaking. If set to empty string, server defaults are used. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_direction: .. rst-class:: classref-method void **shaped_text_set_direction** **(** :ref:`RID` shaped, :ref:`Direction` direction=0 **)** Sets desired text direction. If set to :ref:`DIRECTION_AUTO`, direction will be detected based on the buffer contents and current locale. \ **Note:** Direction is ignored if server does not support :ref:`FEATURE_BIDI_LAYOUT` feature (supported by :ref:`TextServerAdvanced`). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_orientation: .. rst-class:: classref-method void **shaped_text_set_orientation** **(** :ref:`RID` shaped, :ref:`Orientation` orientation=0 **)** Sets desired text orientation. \ **Note:** Orientation is ignored if server does not support :ref:`FEATURE_VERTICAL_LAYOUT` feature (supported by :ref:`TextServerAdvanced`). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_preserve_control: .. rst-class:: classref-method void **shaped_text_set_preserve_control** **(** :ref:`RID` shaped, :ref:`bool` enabled **)** If set to ``true`` text buffer will display control characters. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_preserve_invalid: .. rst-class:: classref-method void **shaped_text_set_preserve_invalid** **(** :ref:`RID` shaped, :ref:`bool` enabled **)** If set to ``true`` text buffer will display invalid characters as hexadecimal codes, otherwise nothing is displayed. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_set_spacing: .. rst-class:: classref-method void **shaped_text_set_spacing** **(** :ref:`RID` shaped, :ref:`SpacingType` spacing, :ref:`int` value **)** Sets extra spacing added between glyphs or lines in pixels. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_shape: .. rst-class:: classref-method :ref:`bool` **shaped_text_shape** **(** :ref:`RID` shaped **)** Shapes buffer if it's not shaped. Returns ``true`` if the string is shaped successfully. \ **Note:** It is not necessary to call this function manually, buffer will be shaped automatically as soon as any of its output data is requested. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_sort_logical: .. rst-class:: classref-method :ref:`Dictionary[]` **shaped_text_sort_logical** **(** :ref:`RID` shaped **)** Returns text glyphs in the logical order. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_substr: .. rst-class:: classref-method :ref:`RID` **shaped_text_substr** **(** :ref:`RID` shaped, :ref:`int` start, :ref:`int` length **)** |const| Returns text buffer for the substring of the text in the ``shaped`` text buffer (including inline objects). .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_shaped_text_tab_align: .. rst-class:: classref-method :ref:`float` **shaped_text_tab_align** **(** :ref:`RID` shaped, :ref:`PackedFloat32Array` tab_stops **)** Aligns shaped text to the given tab-stops. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_spoof_check: .. rst-class:: classref-method :ref:`bool` **spoof_check** **(** :ref:`String` string **)** |const| Returns ``true`` if ``string`` is likely to be an attempt at confusing the reader. \ **Note:** Always returns ``false`` if the server does not support the :ref:`FEATURE_UNICODE_SECURITY` feature. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_string_get_character_breaks: .. rst-class:: classref-method :ref:`PackedInt32Array` **string_get_character_breaks** **(** :ref:`String` string, :ref:`String` language="" **)** |const| Returns array of the composite character boundaries. :: var ts = TextServerManager.get_primary_interface() print(ts.string_get_word_breaks("Test ❤️‍🔥 Test")) # Prints [1, 2, 3, 4, 5, 9, 10, 11, 12, 13, 14] .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_string_get_word_breaks: .. rst-class:: classref-method :ref:`PackedInt32Array` **string_get_word_breaks** **(** :ref:`String` string, :ref:`String` language="", :ref:`int` chars_per_line=0 **)** |const| Returns an array of the word break boundaries. Elements in the returned array are the offsets of the start and end of words. Therefore the length of the array is always even. When ``chars_per_line`` is greater than zero, line break boundaries are returned instead. :: var ts = TextServerManager.get_primary_interface() print(ts.string_get_word_breaks("Godot Engine")) # Prints [0, 5, 6, 12] print(ts.string_get_word_breaks("Godot Engine", "en", 5)) # Prints [0, 5, 6, 11, 11, 12] .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_string_to_lower: .. rst-class:: classref-method :ref:`String` **string_to_lower** **(** :ref:`String` string, :ref:`String` language="" **)** |const| Returns the string converted to lowercase. \ **Note:** Casing is locale dependent and context sensitive if server support :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` feature (supported by :ref:`TextServerAdvanced`). \ **Note:** The result may be longer or shorter than the original. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_string_to_upper: .. rst-class:: classref-method :ref:`String` **string_to_upper** **(** :ref:`String` string, :ref:`String` language="" **)** |const| Returns the string converted to uppercase. \ **Note:** Casing is locale dependent and context sensitive if server support :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` feature (supported by :ref:`TextServerAdvanced`). \ **Note:** The result may be longer or shorter than the original. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_strip_diacritics: .. rst-class:: classref-method :ref:`String` **strip_diacritics** **(** :ref:`String` string **)** |const| Strips diacritics from the string. \ **Note:** The result may be longer or shorter than the original. .. rst-class:: classref-item-separator ---- .. _class_TextServer_method_tag_to_name: .. rst-class:: classref-method :ref:`String` **tag_to_name** **(** :ref:`int` tag **)** |const| Converts OpenType tag to readable feature, variation, script or language name. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |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.)`