TextServerExtension

继承: TextServer < RefCounted < Object

派生: TextServerAdvanced, TextServerDummy, TextServerFallback

自定义 TextServer 实现(插件)的基类。

描述

外部的 TextServer 实现应该继承这个类。

方法

void

_cleanup() virtual

RID

_create_font() virtual required

RID

_create_font_linked_variation(font_rid: RID) virtual

RID

_create_shaped_text(direction: Direction, orientation: Orientation) virtual required

void

_draw_hex_code_box(canvas: RID, size: int, pos: Vector2, index: int, color: Color) virtual const

void

_font_clear_glyphs(font_rid: RID, size: Vector2i) virtual required

void

_font_clear_kerning_map(font_rid: RID, size: int) virtual

void

_font_clear_size_cache(font_rid: RID) virtual required

void

_font_clear_system_fallback_cache() virtual

void

_font_clear_textures(font_rid: RID, size: Vector2i) virtual required

void

_font_draw_glyph(font_rid: RID, canvas: RID, size: int, pos: Vector2, index: int, color: Color, oversampling: float) virtual required const

void

_font_draw_glyph_outline(font_rid: RID, canvas: RID, size: int, outline_size: int, pos: Vector2, index: int, color: Color, oversampling: float) virtual required const

FontAntialiasing

_font_get_antialiasing(font_rid: RID) virtual const

float

_font_get_ascent(font_rid: RID, size: int) virtual required const

float

_font_get_baseline_offset(font_rid: RID) virtual const

int

_font_get_char_from_glyph_index(font_rid: RID, size: int, glyph_index: int) virtual required const

float

_font_get_descent(font_rid: RID, size: int) virtual required const

bool

_font_get_disable_embedded_bitmaps(font_rid: RID) virtual const

float

_font_get_embolden(font_rid: RID) virtual const

int

_font_get_face_count(font_rid: RID) virtual const

int

_font_get_face_index(font_rid: RID) virtual const

int

_font_get_fixed_size(font_rid: RID) virtual required const

FixedSizeScaleMode

_font_get_fixed_size_scale_mode(font_rid: RID) virtual required const

bool

_font_get_generate_mipmaps(font_rid: RID) virtual const

float

_font_get_global_oversampling() virtual const

Vector2

_font_get_glyph_advance(font_rid: RID, size: int, glyph: int) virtual required const

Dictionary

_font_get_glyph_contours(font_rid: RID, size: int, index: int) virtual const

int

_font_get_glyph_index(font_rid: RID, size: int, char: int, variation_selector: int) virtual required const

PackedInt32Array

_font_get_glyph_list(font_rid: RID, size: Vector2i) virtual required const

Vector2

_font_get_glyph_offset(font_rid: RID, size: Vector2i, glyph: int) virtual required const

Vector2

_font_get_glyph_size(font_rid: RID, size: Vector2i, glyph: int) virtual required const

int

_font_get_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int) virtual required const

RID

_font_get_glyph_texture_rid(font_rid: RID, size: Vector2i, glyph: int) virtual required const

Vector2

_font_get_glyph_texture_size(font_rid: RID, size: Vector2i, glyph: int) virtual required const

Rect2

_font_get_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int) virtual required const

Hinting

_font_get_hinting(font_rid: RID) virtual const

bool

_font_get_keep_rounding_remainders(font_rid: RID) virtual const

Vector2

_font_get_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) virtual const

Array[Vector2i]

_font_get_kerning_list(font_rid: RID, size: int) virtual const

bool

_font_get_language_support_override(font_rid: RID, language: String) virtual

PackedStringArray

_font_get_language_support_overrides(font_rid: RID) virtual

int

_font_get_msdf_pixel_range(font_rid: RID) virtual const

int

_font_get_msdf_size(font_rid: RID) virtual const

String

_font_get_name(font_rid: RID) virtual const

Dictionary

_font_get_opentype_feature_overrides(font_rid: RID) virtual const

Dictionary

_font_get_ot_name_strings(font_rid: RID) virtual const

float

_font_get_oversampling(font_rid: RID) virtual const

float

_font_get_scale(font_rid: RID, size: int) virtual required const

bool

_font_get_script_support_override(font_rid: RID, script: String) virtual

PackedStringArray

_font_get_script_support_overrides(font_rid: RID) virtual

Array[Dictionary]

_font_get_size_cache_info(font_rid: RID) virtual const

Array[Vector2i]

_font_get_size_cache_list(font_rid: RID) virtual required const

int

_font_get_spacing(font_rid: RID, spacing: SpacingType) virtual const

int

_font_get_stretch(font_rid: RID) virtual const

BitField[FontStyle]

_font_get_style(font_rid: RID) virtual const

String

_font_get_style_name(font_rid: RID) virtual const

SubpixelPositioning

_font_get_subpixel_positioning(font_rid: RID) virtual const

String

_font_get_supported_chars(font_rid: RID) virtual required const

PackedInt32Array

_font_get_supported_glyphs(font_rid: RID) virtual required const

int

_font_get_texture_count(font_rid: RID, size: Vector2i) virtual required const

Image

_font_get_texture_image(font_rid: RID, size: Vector2i, texture_index: int) virtual required const

PackedInt32Array

_font_get_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int) virtual const

Transform2D

_font_get_transform(font_rid: RID) virtual const

float

_font_get_underline_position(font_rid: RID, size: int) virtual required const

float

_font_get_underline_thickness(font_rid: RID, size: int) virtual required const

Dictionary

_font_get_variation_coordinates(font_rid: RID) virtual const

int

_font_get_weight(font_rid: RID) virtual const

bool

_font_has_char(font_rid: RID, char: int) virtual required const

bool

_font_is_allow_system_fallback(font_rid: RID) virtual const

bool

_font_is_force_autohinter(font_rid: RID) virtual const

bool

_font_is_language_supported(font_rid: RID, language: String) virtual const

bool

_font_is_modulate_color_glyphs(font_rid: RID) virtual const

bool

_font_is_multichannel_signed_distance_field(font_rid: RID) virtual const

bool

_font_is_script_supported(font_rid: RID, script: String) virtual const

void

_font_remove_glyph(font_rid: RID, size: Vector2i, glyph: int) virtual required

void

_font_remove_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) virtual

void

_font_remove_language_support_override(font_rid: RID, language: String) virtual

void

_font_remove_script_support_override(font_rid: RID, script: String) virtual

void

_font_remove_size_cache(font_rid: RID, size: Vector2i) virtual required

void

_font_remove_texture(font_rid: RID, size: Vector2i, texture_index: int) virtual required

void

_font_render_glyph(font_rid: RID, size: Vector2i, index: int) virtual

void

_font_render_range(font_rid: RID, size: Vector2i, start: int, end: int) virtual

void

_font_set_allow_system_fallback(font_rid: RID, allow_system_fallback: bool) virtual

void

_font_set_antialiasing(font_rid: RID, antialiasing: FontAntialiasing) virtual

void

_font_set_ascent(font_rid: RID, size: int, ascent: float) virtual required

void

_font_set_baseline_offset(font_rid: RID, baseline_offset: float) virtual

void

_font_set_data(font_rid: RID, data: PackedByteArray) virtual

void

_font_set_data_ptr(font_rid: RID, data_ptr: const uint8_t*, data_size: int) virtual

void

_font_set_descent(font_rid: RID, size: int, descent: float) virtual required

void

_font_set_disable_embedded_bitmaps(font_rid: RID, disable_embedded_bitmaps: bool) virtual

void

_font_set_embolden(font_rid: RID, strength: float) virtual

void

_font_set_face_index(font_rid: RID, face_index: int) virtual

void

_font_set_fixed_size(font_rid: RID, fixed_size: int) virtual required

void

_font_set_fixed_size_scale_mode(font_rid: RID, fixed_size_scale_mode: FixedSizeScaleMode) virtual required

void

_font_set_force_autohinter(font_rid: RID, force_autohinter: bool) virtual

void

_font_set_generate_mipmaps(font_rid: RID, generate_mipmaps: bool) virtual

void

_font_set_global_oversampling(oversampling: float) virtual

void

_font_set_glyph_advance(font_rid: RID, size: int, glyph: int, advance: Vector2) virtual required

void

_font_set_glyph_offset(font_rid: RID, size: Vector2i, glyph: int, offset: Vector2) virtual required

void

_font_set_glyph_size(font_rid: RID, size: Vector2i, glyph: int, gl_size: Vector2) virtual required

void

_font_set_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int, texture_idx: int) virtual required

void

_font_set_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int, uv_rect: Rect2) virtual required

void

_font_set_hinting(font_rid: RID, hinting: Hinting) virtual

void

_font_set_keep_rounding_remainders(font_rid: RID, keep_rounding_remainders: bool) virtual

void

_font_set_kerning(font_rid: RID, size: int, glyph_pair: Vector2i, kerning: Vector2) virtual

void

_font_set_language_support_override(font_rid: RID, language: String, supported: bool) virtual

void

_font_set_modulate_color_glyphs(font_rid: RID, modulate: bool) virtual

void

_font_set_msdf_pixel_range(font_rid: RID, msdf_pixel_range: int) virtual

void

_font_set_msdf_size(font_rid: RID, msdf_size: int) virtual

void

_font_set_multichannel_signed_distance_field(font_rid: RID, msdf: bool) virtual

void

_font_set_name(font_rid: RID, name: String) virtual

void

_font_set_opentype_feature_overrides(font_rid: RID, overrides: Dictionary) virtual

void

_font_set_oversampling(font_rid: RID, oversampling: float) virtual

void

_font_set_scale(font_rid: RID, size: int, scale: float) virtual required

void

_font_set_script_support_override(font_rid: RID, script: String, supported: bool) virtual

void

_font_set_spacing(font_rid: RID, spacing: SpacingType, value: int) virtual

void

_font_set_stretch(font_rid: RID, stretch: int) virtual

void

_font_set_style(font_rid: RID, style: BitField[FontStyle]) virtual

void

_font_set_style_name(font_rid: RID, name_style: String) virtual

void

_font_set_subpixel_positioning(font_rid: RID, subpixel_positioning: SubpixelPositioning) virtual

void

_font_set_texture_image(font_rid: RID, size: Vector2i, texture_index: int, image: Image) virtual required

void

_font_set_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int, offset: PackedInt32Array) virtual

void

_font_set_transform(font_rid: RID, transform: Transform2D) virtual

void

_font_set_underline_position(font_rid: RID, size: int, underline_position: float) virtual required

void

_font_set_underline_thickness(font_rid: RID, size: int, underline_thickness: float) virtual required

void

_font_set_variation_coordinates(font_rid: RID, variation_coordinates: Dictionary) virtual

void

_font_set_weight(font_rid: RID, weight: int) virtual

Dictionary

_font_supported_feature_list(font_rid: RID) virtual const

Dictionary

_font_supported_variation_list(font_rid: RID) virtual const

String

_format_number(number: String, language: String) virtual const

void

_free_rid(rid: RID) virtual required

int

_get_features() virtual required const

Vector2

_get_hex_code_box_size(size: int, index: int) virtual const

String

_get_name() virtual required const

PackedByteArray

_get_support_data() virtual const

String

_get_support_data_filename() virtual const

String

_get_support_data_info() virtual const

bool

_has(rid: RID) virtual required

bool

_has_feature(feature: Feature) virtual required const

int

_is_confusable(string: String, dict: PackedStringArray) virtual const

bool

_is_locale_right_to_left(locale: String) virtual const

bool

_is_locale_using_support_data(locale: String) virtual const

bool

_is_valid_identifier(string: String) virtual const

bool

_is_valid_letter(unicode: int) virtual const

bool

_load_support_data(filename: String) virtual

int

_name_to_tag(name: String) virtual const

String

_parse_number(number: String, language: String) virtual const

Array[Vector3i]

_parse_structured_text(parser_type: StructuredTextParser, args: Array, text: String) virtual const

String

_percent_sign(language: String) virtual const

void

_reference_oversampling_level(oversampling: float) virtual

bool

_save_support_data(filename: String) virtual const

int

_shaped_get_run_count(shaped: RID) virtual const

Direction

_shaped_get_run_direction(shaped: RID, index: int) virtual const

RID

_shaped_get_run_font_rid(shaped: RID, index: int) virtual const

int

_shaped_get_run_font_size(shaped: RID, index: int) virtual const

String

_shaped_get_run_language(shaped: RID, index: int) virtual const

Variant

_shaped_get_run_object(shaped: RID, index: int) virtual const

Vector2i

_shaped_get_run_range(shaped: RID, index: int) virtual const

String

_shaped_get_run_text(shaped: RID, index: int) virtual const

int

_shaped_get_span_count(shaped: RID) virtual required const

Variant

_shaped_get_span_embedded_object(shaped: RID, index: int) virtual required const

Variant

_shaped_get_span_meta(shaped: RID, index: int) virtual required const

Variant

_shaped_get_span_object(shaped: RID, index: int) virtual required const

String

_shaped_get_span_text(shaped: RID, index: int) virtual required const

String

_shaped_get_text(shaped: RID) virtual required const

void

_shaped_set_span_update_font(shaped: RID, index: int, fonts: Array[RID], size: int, opentype_features: Dictionary) virtual required

bool

_shaped_text_add_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment, length: int, baseline: float) virtual required

bool

_shaped_text_add_string(shaped: RID, text: String, fonts: Array[RID], size: int, opentype_features: Dictionary, language: String, meta: Variant) virtual required

void

_shaped_text_clear(shaped: RID) virtual required

int

_shaped_text_closest_character_pos(shaped: RID, pos: int) virtual const

void

_shaped_text_draw(shaped: RID, canvas: RID, pos: Vector2, clip_l: float, clip_r: float, color: Color, oversampling: float) virtual const

void

_shaped_text_draw_outline(shaped: RID, canvas: RID, pos: Vector2, clip_l: float, clip_r: float, outline_size: int, color: Color, oversampling: float) virtual const

RID

_shaped_text_duplicate(shaped: RID) virtual required

float

_shaped_text_fit_to_width(shaped: RID, width: float, justification_flags: BitField[JustificationFlag]) virtual

float

_shaped_text_get_ascent(shaped: RID) virtual required const

void

_shaped_text_get_carets(shaped: RID, position: int, caret: CaretInfo*) virtual const

PackedInt32Array

_shaped_text_get_character_breaks(shaped: RID) virtual const

int

_shaped_text_get_custom_ellipsis(shaped: RID) virtual const

String

_shaped_text_get_custom_punctuation(shaped: RID) virtual const

float

_shaped_text_get_descent(shaped: RID) virtual required const

Direction

_shaped_text_get_direction(shaped: RID) virtual const

int

_shaped_text_get_dominant_direction_in_range(shaped: RID, start: int, end: int) virtual const

int

_shaped_text_get_ellipsis_glyph_count(shaped: RID) virtual required const

const Glyph*

_shaped_text_get_ellipsis_glyphs(shaped: RID) virtual required const

int

_shaped_text_get_ellipsis_pos(shaped: RID) virtual required const

int

_shaped_text_get_glyph_count(shaped: RID) virtual required const

const Glyph*

_shaped_text_get_glyphs(shaped: RID) virtual required const

Vector2

_shaped_text_get_grapheme_bounds(shaped: RID, pos: int) virtual const

Direction

_shaped_text_get_inferred_direction(shaped: RID) virtual const

PackedInt32Array

_shaped_text_get_line_breaks(shaped: RID, width: float, start: int, break_flags: BitField[LineBreakFlag]) virtual const

PackedInt32Array

_shaped_text_get_line_breaks_adv(shaped: RID, width: PackedFloat32Array, start: int, once: bool, break_flags: BitField[LineBreakFlag]) virtual const

int

_shaped_text_get_object_glyph(shaped: RID, key: Variant) virtual required const

Vector2i

_shaped_text_get_object_range(shaped: RID, key: Variant) virtual required const

Rect2

_shaped_text_get_object_rect(shaped: RID, key: Variant) virtual required const

Array

_shaped_text_get_objects(shaped: RID) virtual required const

Orientation

_shaped_text_get_orientation(shaped: RID) virtual const

RID

_shaped_text_get_parent(shaped: RID) virtual required const

bool

_shaped_text_get_preserve_control(shaped: RID) virtual const

bool

_shaped_text_get_preserve_invalid(shaped: RID) virtual const

Vector2i

_shaped_text_get_range(shaped: RID) virtual required const

PackedVector2Array

_shaped_text_get_selection(shaped: RID, start: int, end: int) virtual const

Vector2

_shaped_text_get_size(shaped: RID) virtual required const

int

_shaped_text_get_spacing(shaped: RID, spacing: SpacingType) virtual const

int

_shaped_text_get_trim_pos(shaped: RID) virtual required const

float

_shaped_text_get_underline_position(shaped: RID) virtual required const

float

_shaped_text_get_underline_thickness(shaped: RID) virtual required const

float

_shaped_text_get_width(shaped: RID) virtual required const

PackedInt32Array

_shaped_text_get_word_breaks(shaped: RID, grapheme_flags: BitField[GraphemeFlag], skip_grapheme_flags: BitField[GraphemeFlag]) virtual const

bool

_shaped_text_has_object(shaped: RID, key: Variant) virtual required const

int

_shaped_text_hit_test_grapheme(shaped: RID, coord: float) virtual const

int

_shaped_text_hit_test_position(shaped: RID, coord: float) virtual const

bool

_shaped_text_is_ready(shaped: RID) virtual required const

int

_shaped_text_next_character_pos(shaped: RID, pos: int) virtual const

int

_shaped_text_next_grapheme_pos(shaped: RID, pos: int) virtual const

void

_shaped_text_overrun_trim_to_width(shaped: RID, width: float, trim_flags: BitField[TextOverrunFlag]) virtual

int

_shaped_text_prev_character_pos(shaped: RID, pos: int) virtual const

int

_shaped_text_prev_grapheme_pos(shaped: RID, pos: int) virtual const

bool

_shaped_text_resize_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment, baseline: float) virtual required

void

_shaped_text_set_bidi_override(shaped: RID, override: Array) virtual

void

_shaped_text_set_custom_ellipsis(shaped: RID, char: int) virtual

void

_shaped_text_set_custom_punctuation(shaped: RID, punct: String) virtual

void

_shaped_text_set_direction(shaped: RID, direction: Direction) virtual

void

_shaped_text_set_orientation(shaped: RID, orientation: Orientation) virtual

void

_shaped_text_set_preserve_control(shaped: RID, enabled: bool) virtual

void

_shaped_text_set_preserve_invalid(shaped: RID, enabled: bool) virtual

void

_shaped_text_set_spacing(shaped: RID, spacing: SpacingType, value: int) virtual

bool

_shaped_text_shape(shaped: RID) virtual required

const Glyph*

_shaped_text_sort_logical(shaped: RID) virtual required

RID

_shaped_text_substr(shaped: RID, start: int, length: int) virtual required const

float

_shaped_text_tab_align(shaped: RID, tab_stops: PackedFloat32Array) virtual

bool

_shaped_text_update_breaks(shaped: RID) virtual

bool

_shaped_text_update_justification_ops(shaped: RID) virtual

bool

_spoof_check(string: String) virtual const

PackedInt32Array

_string_get_character_breaks(string: String, language: String) virtual const

PackedInt32Array

_string_get_word_breaks(string: String, language: String, chars_per_line: int) virtual const

String

_string_to_lower(string: String, language: String) virtual const

String

_string_to_title(string: String, language: String) virtual const

String

_string_to_upper(string: String, language: String) virtual const

String

_strip_diacritics(string: String) virtual const

String

_tag_to_name(tag: int) virtual const

void

_unreference_oversampling_level(oversampling: float) virtual


方法说明

void _cleanup() virtual 🔗

注销文本服务器前会调用该方法。


RID _create_font() virtual required 🔗

新建空的字体缓存条目资源。


RID _create_font_linked_variation(font_rid: RID) virtual 🔗

可选,如果字体支持额外间距或基线偏移,则实现该方法。

创建一个新的已有字体变体,该字体重复使用相同的字形缓存和字体数据。


RID _create_shaped_text(direction: Direction, orientation: Orientation) virtual required 🔗

使用给定的方向 direction 和朝向 orientation 新建用于复杂排版的缓冲。


void _draw_hex_code_box(canvas: RID, size: int, pos: Vector2, index: int, color: Color) virtual const 🔗

绘制显示字符十六进制代码的方框。


void _font_clear_glyphs(font_rid: RID, size: Vector2i) virtual required 🔗

从缓存条目中移除所有渲染字形信息。


void _font_clear_kerning_map(font_rid: RID, size: int) virtual 🔗

移除所有字距调整覆盖。


void _font_clear_size_cache(font_rid: RID) virtual required 🔗

从缓存条目中移除所有的字体大小。


void _font_clear_system_fallback_cache() virtual 🔗

释放所有自动加载的系统字体。


void _font_clear_textures(font_rid: RID, size: Vector2i) virtual required 🔗

从缓存条目中移除所有纹理。


void _font_draw_glyph(font_rid: RID, canvas: RID, size: int, pos: Vector2, index: int, color: Color, oversampling: float) virtual required const 🔗

使用字体 font_rid 和大小 size 在画布项中的指定位置绘制单个字形。如果 oversampling 大于零,则会将其作为字体过采样系数,否则使用视口的过采样设置。


void _font_draw_glyph_outline(font_rid: RID, canvas: RID, size: int, outline_size: int, pos: Vector2, index: int, color: Color, oversampling: float) virtual required const 🔗

使用字体 font_rid 和大小 size 在画布项中的指定位置绘制单个字形轮廓。如果 oversampling 大于零,则会将其作为字体过采样系数,否则使用视口的过采样设置。


FontAntialiasing _font_get_antialiasing(font_rid: RID) virtual const 🔗

返回字体的抗锯齿模式。


float _font_get_ascent(font_rid: RID, size: int) virtual required const 🔗

返回字体的上升幅度(超出基线的像素数)。


float _font_get_baseline_offset(font_rid: RID) virtual const 🔗

返回额外的基线偏移(作为字体高度的一部分)。


int _font_get_char_from_glyph_index(font_rid: RID, size: int, glyph_index: int) virtual required const 🔗

返回与 glyph_index 关联的字符代码,如果 glyph_index 无效则返回 0


float _font_get_descent(font_rid: RID, size: int) virtual required const 🔗

返回字体的减少量(低于基线的像素数)。


bool _font_get_disable_embedded_bitmaps(font_rid: RID) virtual const 🔗

返回字体是否仅用了内嵌位图加载。


float _font_get_embolden(font_rid: RID) virtual const 🔗

返回字体的加粗力度。


int _font_get_face_count(font_rid: RID) virtual const 🔗

返回 TrueType / OpenType 集合中的字体数。


int _font_get_face_index(font_rid: RID) virtual const 🔗

返回 TrueType / OpenType 集合中的活动字体索引。


int _font_get_fixed_size(font_rid: RID) virtual required const 🔗

返回位图字体的固定大小。


FixedSizeScaleMode _font_get_fixed_size_scale_mode(font_rid: RID) virtual required const 🔗

返回位图字体的缩放模式。


bool _font_get_generate_mipmaps(font_rid: RID) virtual const 🔗

如果启用了字体纹理 mipmap 生成,则返回 true


float _font_get_global_oversampling() virtual const 🔗

返回字体过采样系数,由 TextServer 中的所有字体共享。


Vector2 _font_get_glyph_advance(font_rid: RID, size: int, glyph: int) virtual required const 🔗

返回字形的推进量(下一个字形的偏移量)。


Dictionary _font_get_glyph_contours(font_rid: RID, size: int, index: int) virtual const 🔗

返回字形的轮廓。


int _font_get_glyph_index(font_rid: RID, size: int, char: int, variation_selector: int) virtual required const 🔗

返回 char 的字形索引,可以用 variation_selector 修改。


PackedInt32Array _font_get_glyph_list(font_rid: RID, size: Vector2i) virtual required const 🔗

返回缓存条目中的已渲染字形列表。


Vector2 _font_get_glyph_offset(font_rid: RID, size: Vector2i, glyph: int) virtual required const 🔗

返回字形的基线偏移量。


Vector2 _font_get_glyph_size(font_rid: RID, size: Vector2i, glyph: int) virtual required const 🔗

返回该字形的大小。


int _font_get_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int) virtual required const 🔗

返回包含该字形的缓存纹理的索引。


RID _font_get_glyph_texture_rid(font_rid: RID, size: Vector2i, glyph: int) virtual required const 🔗

返回包含该字形的缓存纹理的资源 ID。


Vector2 _font_get_glyph_texture_size(font_rid: RID, size: Vector2i, glyph: int) virtual required const 🔗

返回包含该字形的缓存纹理的大小。


Rect2 _font_get_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int) virtual required const 🔗

返回包含该字形的缓存纹理中的矩形。


Hinting _font_get_hinting(font_rid: RID) virtual const 🔗

返回字体微调模式。仅用于动态字体。


bool _font_get_keep_rounding_remainders(font_rid: RID) virtual const 🔗

返回字形位置的舍入行为。如果设为 true,在将字形对齐到像素边界时会累积余数,确保字形分布更加均匀。如果启用了次像素定位,则该设置无效。


Vector2 _font_get_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) virtual const 🔗

返回字形对的字距调整。


Array[Vector2i] _font_get_kerning_list(font_rid: RID, size: int) virtual const 🔗

返回字距调整覆盖的列表。


bool _font_get_language_support_override(font_rid: RID, language: String) virtual 🔗

如果为 language 启用了支持覆盖,则返回 true


PackedStringArray _font_get_language_support_overrides(font_rid: RID) virtual 🔗

返回语言支持覆盖的列表。


int _font_get_msdf_pixel_range(font_rid: RID) virtual const 🔗

返回最小和最大可表示有符号距离之间形状周围范围的宽度。


int _font_get_msdf_size(font_rid: RID) virtual const 🔗

返回用于生成 MSDF 纹理的源字体大小。


String _font_get_name(font_rid: RID) virtual const 🔗

返回字体家族名称。


Dictionary _font_get_opentype_feature_overrides(font_rid: RID) virtual const 🔗

返回字体 OpenType 特性集覆盖。


Dictionary _font_get_ot_name_strings(font_rid: RID) virtual const 🔗

返回 OpenType 字体名称字符串的 Dictionary(本地化的字体名称、版本、描述、许可信息、示例文本等)。


float _font_get_oversampling(font_rid: RID) virtual const 🔗

返回过采样系数覆盖值。如果设为正数,则会覆盖使用该字体的视口的过采样系数。见 Viewport.oversampling。该值不会覆盖 draw_* 方法的 oversampling 参数。仅适用于动态字体。


float _font_get_scale(font_rid: RID, size: int) virtual required const 🔗

返回颜色位图字体的缩放系数。


bool _font_get_script_support_override(font_rid: RID, script: String) virtual 🔗

如果为 script 启用了支持覆盖,则返回 true


PackedStringArray _font_get_script_support_overrides(font_rid: RID) virtual 🔗

返回文字支持覆盖的列表。


Array[Dictionary] _font_get_size_cache_info(font_rid: RID) virtual const 🔗

返回字体缓存信息,每个条目都包含以下字段:Vector2i size_px - 字体大小,单位为像素,float viewport_oversampling - 视口过采样系数,int glyphs - 已渲染的字形数,int textures - 已使用的纹理数,int textures_size - 纹理数据大小,单位为字节。


Array[Vector2i] _font_get_size_cache_list(font_rid: RID) virtual required const 🔗

返回缓存中字体大小的列表。每个大小都是由字体大小和轮廓大小组成的 Vector2i


int _font_get_spacing(font_rid: RID, spacing: SpacingType) virtual const 🔗

返回 spacing 的间距,单位为像素(与字体大小无关)。


int _font_get_stretch(font_rid: RID) virtual const 🔗

返回与正常宽度相比的字体拉伸量。一个介于 50%200% 之间的百分比值。


BitField[FontStyle] _font_get_style(font_rid: RID) virtual const 🔗

返回字体样式标志。


String _font_get_style_name(font_rid: RID) virtual const 🔗

返回字体样式名称。


SubpixelPositioning _font_get_subpixel_positioning(font_rid: RID) virtual const 🔗

返回字体的次像素字形定位模式。


String _font_get_supported_chars(font_rid: RID) virtual required const 🔗

返回包含字体中所有可用字符的字符串。


PackedInt32Array _font_get_supported_glyphs(font_rid: RID) virtual required const 🔗

返回包含字体中所有字形索引的数组。


int _font_get_texture_count(font_rid: RID, size: Vector2i) virtual required const 🔗

返回字体缓存条目所使用的纹理数。


Image _font_get_texture_image(font_rid: RID, size: Vector2i, texture_index: int) virtual required const 🔗

返回字体缓存纹理图像数据。


PackedInt32Array _font_get_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int) virtual const 🔗

返回包含字形打包数据的数组。


Transform2D _font_get_transform(font_rid: RID) virtual const 🔗

返回应用于字体轮廓的 2D 变换。


float _font_get_underline_position(font_rid: RID, size: int) virtual required const 🔗

返回基线下方下划线的像素偏移。


float _font_get_underline_thickness(font_rid: RID, size: int) virtual required const 🔗

返回下划线的粗细度,单位为像素。


Dictionary _font_get_variation_coordinates(font_rid: RID) virtual const 🔗

返回指定字体缓存条目的变体坐标。


int _font_get_weight(font_rid: RID) virtual const 🔗

返回该字体的字重(粗度)。一个在 100...999 范围内的值,正常字体字重为 400,粗体字体字重为 700


bool _font_has_char(font_rid: RID, char: int) virtual required const 🔗

如果该字体中包含 Unicode 字符 char,则返回 true


bool _font_is_allow_system_fallback(font_rid: RID) virtual const 🔗

如果可以自动使用系统字体作为回退字体,则返回 true


bool _font_is_force_autohinter(font_rid: RID) virtual const 🔗

如果设置为 true,则支持自动微调,优先于字体内置微调。


bool _font_is_language_supported(font_rid: RID, language: String) virtual const 🔗

Returns true if the font supports the given language (as a ISO 639 code).


bool _font_is_modulate_color_glyphs(font_rid: RID) virtual const 🔗

Returns true if color modulation is applied when drawing the font's colored glyphs.


bool _font_is_multichannel_signed_distance_field(font_rid: RID) virtual const 🔗

如果使用从动态字体矢量数据生成的单个多通道有符号距离场渲染所有大小的字形,则返回 true


bool _font_is_script_supported(font_rid: RID, script: String) virtual const 🔗

Returns true if the font supports the given script (as a ISO 15924 code).


void _font_remove_glyph(font_rid: RID, size: Vector2i, glyph: int) virtual required 🔗

从缓存条目中移除指定的字体大小。


void _font_remove_kerning(font_rid: RID, size: int, glyph_pair: Vector2i) virtual 🔗

移除字形对的字距调整覆盖。


void _font_remove_language_support_override(font_rid: RID, language: String) virtual 🔗

移除语言支持覆盖。


void _font_remove_script_support_override(font_rid: RID, script: String) virtual 🔗

移除文字支持覆盖。


void _font_remove_size_cache(font_rid: RID, size: Vector2i) virtual required 🔗

从缓存条目中移除指定的字体大小。


void _font_remove_texture(font_rid: RID, size: Vector2i, texture_index: int) virtual required 🔗

从缓存条目中移除指定的纹理。


void _font_render_glyph(font_rid: RID, size: Vector2i, index: int) virtual 🔗

将指定的字符渲染到字体缓存纹理。


void _font_render_range(font_rid: RID, size: Vector2i, start: int, end: int) virtual 🔗

将范围内的字符渲染到字体缓存纹理。


void _font_set_allow_system_fallback(font_rid: RID, allow_system_fallback: bool) virtual 🔗

如果设置为 true,则可以自动将系统字体作为回退使用。


void _font_set_antialiasing(font_rid: RID, antialiasing: FontAntialiasing) virtual 🔗

使用字体抗锯齿模式。


void _font_set_ascent(font_rid: RID, size: int, ascent: float) virtual required 🔗

设置字体的升部(基线上方的像素数)。


void _font_set_baseline_offset(font_rid: RID, baseline_offset: float) virtual 🔗

设置额外的基线偏移(作为字体高度的一部分)。


void _font_set_data(font_rid: RID, data: PackedByteArray) virtual 🔗

设置字体源数据,例如动态字体的源文件内容。


void _font_set_data_ptr(font_rid: RID, data_ptr: const uint8_t*, data_size: int) virtual 🔗

设置字体源数据指针,例如动态字体的源文件内容。


void _font_set_descent(font_rid: RID, size: int, descent: float) virtual required 🔗

设置字体的降部(基线下方的像素数)。


void _font_set_disable_embedded_bitmaps(font_rid: RID, disable_embedded_bitmaps: bool) virtual 🔗

如果设置为 true,则禁用内嵌字体位图的加载。


void _font_set_embolden(font_rid: RID, strength: float) virtual 🔗

设置字体的加粗强度。如果 strength 不等于零,则会加粗字体轮廓。负值会减小轮廓的粗细度。


void _font_set_face_index(font_rid: RID, face_index: int) virtual 🔗

在 TrueType / OpenType 集合中设置活动字体索引。


void _font_set_fixed_size(font_rid: RID, fixed_size: int) virtual required 🔗

设置位图字体的固定大小。如果设置为大于零的值,则会为所有字体大小使用相同的缓存条目。


void _font_set_fixed_size_scale_mode(font_rid: RID, fixed_size_scale_mode: FixedSizeScaleMode) virtual required 🔗

设置位图字体缩放模式。仅当 fixed_size 大于零时才使用该属性。


void _font_set_force_autohinter(font_rid: RID, force_autohinter: bool) virtual 🔗

如果设置为 true,则优先使用自动微调,而不是字体的内置微调。


void _font_set_generate_mipmaps(font_rid: RID, generate_mipmaps: bool) virtual 🔗

如果设置为 true,则启用字体纹理 mipmap 生成。


void _font_set_global_oversampling(oversampling: float) virtual 🔗

返回过采样系数,由 TextServer 中的所有字体共享。


void _font_set_glyph_advance(font_rid: RID, size: int, glyph: int, advance: Vector2) virtual required 🔗

设置字形推进(下一个字形的偏移量)。


void _font_set_glyph_offset(font_rid: RID, size: Vector2i, glyph: int, offset: Vector2) virtual required 🔗

设置字形相对于基线的偏移量。


void _font_set_glyph_size(font_rid: RID, size: Vector2i, glyph: int, gl_size: Vector2) virtual required 🔗

设置字形的大小。


void _font_set_glyph_texture_idx(font_rid: RID, size: Vector2i, glyph: int, texture_idx: int) virtual required 🔗

设置包含该字形的缓存纹理的索引。


void _font_set_glyph_uv_rect(font_rid: RID, size: Vector2i, glyph: int, uv_rect: Rect2) virtual required 🔗

设置包含该字形的缓存纹理中,该字形的矩形区域。


void _font_set_hinting(font_rid: RID, hinting: Hinting) virtual 🔗

设置字体微调模式。仅由动态字体使用。


void _font_set_keep_rounding_remainders(font_rid: RID, keep_rounding_remainders: bool) virtual 🔗

设置字形位置的舍入行为。如果设为 true,则会将字形与像素边界对齐时的舍入余数进行累积,确保字形分布更为均匀。启用次像素定位时该设置无效。


void _font_set_kerning(font_rid: RID, size: int, glyph_pair: Vector2i, kerning: Vector2) virtual 🔗

设置字形对的字距调整。


void _font_set_language_support_override(font_rid: RID, language: String, supported: bool) virtual 🔗

_font_is_language_supported() 添加覆盖。


void _font_set_modulate_color_glyphs(font_rid: RID, modulate: bool) virtual 🔗

如果设为 true,则绘制彩色字形时会应用颜色调制,否则只会对灰度字形应用。


void _font_set_msdf_pixel_range(font_rid: RID, msdf_pixel_range: int) virtual 🔗

设置最小和最大可表示有符号距离之间形状周围范围的宽度。


void _font_set_msdf_size(font_rid: RID, msdf_size: int) virtual 🔗

设置用于生成 MSDF 纹理的源字体大小。


void _font_set_multichannel_signed_distance_field(font_rid: RID, msdf: bool) virtual 🔗

如果设置为 true,则所有大小的字形都使用从动态字体向量数据生成的单个多通道带符号距离场进行渲染。MSDF 渲染能够使用任意缩放系数显示字体,字体不会变得模糊,字体大小的改变也不会消耗 CPU 的性能(因为字体不再需要在 CPU 上进行光栅化)。缺点是MSDF 无法使用字体微调。缺少字体微调时,锐度可能降低,较小的字体可能不易阅读。


void _font_set_name(font_rid: RID, name: String) virtual 🔗

设置该字体的家族名称。


void _font_set_opentype_feature_overrides(font_rid: RID, overrides: Dictionary) virtual 🔗

设置字体 OpenType 特性集覆盖。


void _font_set_oversampling(font_rid: RID, oversampling: float) virtual 🔗

如果设为正数,则会覆盖使用该字体的视口的过采样系数。见 Viewport.oversampling。该值不会覆盖 draw_* 方法的 oversampling 参数。仅适用于动态字体。


void _font_set_scale(font_rid: RID, size: int, scale: float) virtual required 🔗

设置彩色位图字体的缩放系数。


void _font_set_script_support_override(font_rid: RID, script: String, supported: bool) virtual 🔗

_font_is_script_supported() 添加覆盖。


void _font_set_spacing(font_rid: RID, spacing: SpacingType, value: int) virtual 🔗

spacing 的间距设置为 value,单位为像素(与字体大小无关)。


void _font_set_stretch(font_rid: RID, stretch: int) virtual 🔗

设置与正常宽度相比的字体拉伸量,是一个在 50%200% 之间的百分比值。


void _font_set_style(font_rid: RID, style: BitField[FontStyle]) virtual 🔗

设置字体的样式标志。


void _font_set_style_name(font_rid: RID, name_style: String) virtual 🔗

设置字体的样式名称。


void _font_set_subpixel_positioning(font_rid: RID, subpixel_positioning: SubpixelPositioning) virtual 🔗

设置字体的次像素字形定位模式。


void _font_set_texture_image(font_rid: RID, size: Vector2i, texture_index: int, image: Image) virtual required 🔗

设置字体的缓存纹理图像数据。


void _font_set_texture_offsets(font_rid: RID, size: Vector2i, texture_index: int, offset: PackedInt32Array) virtual 🔗

设置包含字形打包数据的数组。


void _font_set_transform(font_rid: RID, transform: Transform2D) virtual 🔗

设置应用于字体轮廓的 2D 变换,可用于倾斜、翻转、旋转字形。


void _font_set_underline_position(font_rid: RID, size: int, underline_position: float) virtual required 🔗

设置基线下方下划线的像素偏移。


void _font_set_underline_thickness(font_rid: RID, size: int, underline_thickness: float) virtual required 🔗

设置下划线的粗细度,单位为像素。


void _font_set_variation_coordinates(font_rid: RID, variation_coordinates: Dictionary) virtual 🔗

为指定的字体缓存条目设置变体坐标。


void _font_set_weight(font_rid: RID, weight: int) virtual 🔗

设置字体的字重(粗度),是一个在 100...999 范围内的值。正常字体字重为 400,粗体字体字重为 700


Dictionary _font_supported_feature_list(font_rid: RID) virtual const 🔗

返回支持的 OpenType 特性的字典。


Dictionary _font_supported_variation_list(font_rid: RID) virtual const 🔗

返回支持的 OpenType 变体坐标的字典。


String _format_number(number: String, language: String) virtual const 🔗

已弃用: Use TranslationServer.format_number() instead.

Converts a number from Western Arabic (0..9) to the numeral system used in the given language.

If language is an empty string, the active locale will be used.


void _free_rid(rid: RID) virtual required 🔗

释放由该 TextServer 创建的某个对象。


int _get_features() virtual required const 🔗

返回文本服务器的特性,见 Feature


Vector2 _get_hex_code_box_size(size: int, index: int) virtual const 🔗

返回替换字符的大小(在无效字符处绘制的带十六进制字符代码的框)。


String _get_name() virtual required const 🔗

返回该服务器接口的名称。


PackedByteArray _get_support_data() virtual const 🔗

返回默认的 TextServer 数据库(例如 ICU 中断迭代器和字典)。


String _get_support_data_filename() virtual const 🔗

返回默认的 TextServer 数据库(例如 ICU 中断迭代器和字典)文件名。


String _get_support_data_info() virtual const 🔗

返回 TextServer 数据库(例如 ICU 中断迭代器和字典)的描述。


bool _has(rid: RID) virtual required 🔗

如果 rid 是该文本服务器拥有的有效资源,则返回 true


bool _has_feature(feature: Feature) virtual required const 🔗

如果服务器支持某个功能,则返回 true


int _is_confusable(string: String, dict: PackedStringArray) virtual const 🔗

返回 dict 中第一个与 string 在视觉上可能产生混淆的字符串的索引,如果没有找到则返回 -1


bool _is_locale_right_to_left(locale: String) virtual const 🔗

如果区域设置为从右至左,则返回 true


bool _is_locale_using_support_data(locale: String) virtual const 🔗

Returns true if the locale requires text server support data for line/word breaking.


bool _is_valid_identifier(string: String) virtual const 🔗

如果 string 是有效的标识符,则返回 true


bool _is_valid_letter(unicode: int) virtual const 🔗

There is currently no description for this method. Please help us by contributing one!


bool _load_support_data(filename: String) virtual 🔗

加载可选的 TextServer 数据库(例如 ICU 中断迭代器和字典)。


int _name_to_tag(name: String) virtual const 🔗

Converts the given readable name of a feature, variation, script, or language to an OpenType tag.


String _parse_number(number: String, language: String) virtual const 🔗

已弃用: Use TranslationServer.parse_number() instead.

Converts number from the numeral system used in the given language to Western Arabic (0..9).

If language is an empty string, the active locale will be used.


Array[Vector3i] _parse_structured_text(parser_type: StructuredTextParser, args: Array, text: String) virtual const 🔗

BiDi 算法覆盖函数的默认实现。


String _percent_sign(language: String) virtual const 🔗

已弃用: Use TranslationServer.get_percent_sign() instead.

Returns percent sign used in the given language.


void _reference_oversampling_level(oversampling: float) virtual 🔗

将指定过采样等级的引用计数调大。该方法由 Viewport 调用,不应直接使用。


bool _save_support_data(filename: String) virtual const 🔗

将可选的 TextServer 数据库(例如 ICU 中断迭代器和字典)保存至文件。


int _shaped_get_run_count(shaped: RID) virtual const 🔗

返回缓冲中统一文本行程的个数。


Direction _shaped_get_run_direction(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的方向。


RID _shaped_get_run_font_rid(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的字体 RID。


int _shaped_get_run_font_size(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的字体大小。


String _shaped_get_run_language(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的语言。


Variant _shaped_get_run_object(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的内嵌对象。


Vector2i _shaped_get_run_range(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的源文本范围。


String _shaped_get_run_text(shaped: RID, index: int) virtual const 🔗

返回索引为 index 的文本行程(按显示顺序)的源文本。


int _shaped_get_span_count(shaped: RID) virtual required const 🔗

返回使用 _shaped_text_add_string()_shaped_text_add_object() 添加的文本区间的数量。


Variant _shaped_get_span_embedded_object(shaped: RID, index: int) virtual required const 🔗

返回文本内嵌对象的键。


Variant _shaped_get_span_meta(shaped: RID, index: int) virtual required const 🔗

返回文本区间的元数据。


Variant _shaped_get_span_object(shaped: RID, index: int) virtual required const 🔗

返回文本区间内嵌对象的键。


String _shaped_get_span_text(shaped: RID, index: int) virtual required const 🔗

返回文本区间的源文本。


String _shaped_get_text(shaped: RID) virtual required const 🔗

返回文本缓冲的源文本,包含对象替换字符。


void _shaped_set_span_update_font(shaped: RID, index: int, fonts: Array[RID], size: int, opentype_features: Dictionary) virtual required 🔗

在不更改文本的情况下,更改文本区间的字体、字体大小和 OpenType 特性。


bool _shaped_text_add_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment, length: int, baseline: float) virtual required 🔗

向文本缓冲中添加内联对象,key 必须唯一。在文本中,对象使用 length 个对象替换字符表示。


bool _shaped_text_add_string(shaped: RID, text: String, fonts: Array[RID], size: int, opentype_features: Dictionary, language: String, meta: Variant) virtual required 🔗

添加文本区间和字体,将其绘制到文本缓冲中。


void _shaped_text_clear(shaped: RID) virtual required 🔗

清空文本缓冲(移除文本和内联对象)。


int _shaped_text_closest_character_pos(shaped: RID, pos: int) virtual const 🔗

返回距离 pos 最近的组合字符位置。


void _shaped_text_draw(shaped: RID, canvas: RID, pos: Vector2, clip_l: float, clip_r: float, color: Color, oversampling: float) virtual const 🔗

在画布项的给定位置绘制塑形后的文本,颜色为 colorpos 指定的是基线的最左侧(横向排版)或基线的最顶部(纵向排版)。如果 oversampling 大于零则会用作字体过采样系数,否则使用视口的过采样设置。


void _shaped_text_draw_outline(shaped: RID, canvas: RID, pos: Vector2, clip_l: float, clip_r: float, outline_size: int, color: Color, oversampling: float) virtual const 🔗

在画布项的给定位置绘制塑形后的文本轮廓,颜色为 colorpos 指定的是基线的最左侧(横向排版)或基线的最顶部(纵向排版)。如果 oversampling 大于零则会用作字体过采样系数,否则使用视口的过采样设置。


RID _shaped_text_duplicate(shaped: RID) virtual required 🔗

Duplicates shaped text buffer.


float _shaped_text_fit_to_width(shaped: RID, width: float, justification_flags: BitField[JustificationFlag]) virtual 🔗

两端对齐文本以适合指定宽度,返回新的文本宽度。


float _shaped_text_get_ascent(shaped: RID) virtual required const 🔗

返回该文本的升部(水平排版时为基线上方的像素数,垂直排版时为基线左侧的像素数)。


void _shaped_text_get_carets(shaped: RID, position: int, caret: CaretInfo*) virtual const 🔗

返回与文本中字符偏移 position 对应的文本光标的形状。返回的光标形状是宽度为 1 像素的矩形。


PackedInt32Array _shaped_text_get_character_breaks(shaped: RID) virtual const 🔗

返回组合字符边界的数组。


int _shaped_text_get_custom_ellipsis(shaped: RID) virtual const 🔗

返回文字裁剪时使用的省略字符。


String _shaped_text_get_custom_punctuation(shaped: RID) virtual const 🔗

返回自定义标点字符列表,用于断字。如果被设置为空字符串,则使用服务器的默认值。


float _shaped_text_get_descent(shaped: RID) virtual required const 🔗

返回该文本的降部(水平排版时为基线下方的像素数,垂直排版时为基线右侧的像素数)。


Direction _shaped_text_get_direction(shaped: RID) virtual const 🔗

返回文本的方向。


int _shaped_text_get_dominant_direction_in_range(shaped: RID, start: int, end: int) virtual const 🔗

返回文本范围内的主要书写方向。


int _shaped_text_get_ellipsis_glyph_count(shaped: RID) virtual required const 🔗

返回省略号中的字形数。


const Glyph* _shaped_text_get_ellipsis_glyphs(shaped: RID) virtual required const 🔗

返回省略号中的字形数组。


int _shaped_text_get_ellipsis_pos(shaped: RID) virtual required const 🔗

返回省略号的位置。


int _shaped_text_get_glyph_count(shaped: RID) virtual required const 🔗

返回缓冲区中的字形数。


const Glyph* _shaped_text_get_glyphs(shaped: RID) virtual required const 🔗

返回字形数组,按视觉顺序排序。


Vector2 _shaped_text_get_grapheme_bounds(shaped: RID, pos: int) virtual const 🔗

将复合字符的边界返回为距行首的偏移量。


Direction _shaped_text_get_inferred_direction(shaped: RID) virtual const 🔗

返回由 BiDi 算法推断的文本书写方向。


PackedInt32Array _shaped_text_get_line_breaks(shaped: RID, width: float, start: int, break_flags: BitField[LineBreakFlag]) virtual const 🔗

对文本进行断行,返回每一行的字符范围。


PackedInt32Array _shaped_text_get_line_breaks_adv(shaped: RID, width: PackedFloat32Array, start: int, once: bool, break_flags: BitField[LineBreakFlag]) virtual const 🔗

将文本拆分为行和列。返回每段的字符范围。


int _shaped_text_get_object_glyph(shaped: RID, key: Variant) virtual required const 🔗

返回内联对象的字形索引。


Vector2i _shaped_text_get_object_range(shaped: RID, key: Variant) virtual required const 🔗

返回内联对象的字符范围。


Rect2 _shaped_text_get_object_rect(shaped: RID, key: Variant) virtual required const 🔗

返回内联对象的边界矩形。


Array _shaped_text_get_objects(shaped: RID) virtual required const 🔗

返回内联对象的数组。


Orientation _shaped_text_get_orientation(shaped: RID) virtual const 🔗

返回文本朝向。


RID _shaped_text_get_parent(shaped: RID) virtual required const 🔗

返回子字符串源自哪个父缓冲区。


bool _shaped_text_get_preserve_control(shaped: RID) virtual const 🔗

如果文本缓冲区被配置为显示控制字符,则返回 true


bool _shaped_text_get_preserve_invalid(shaped: RID) virtual const 🔗

如果文本缓冲区被配置为显示十六进制代码来代替无效字符,则返回 true


Vector2i _shaped_text_get_range(shaped: RID) virtual required const 🔗

返回父缓冲区中子字符串缓冲区的字符范围。


PackedVector2Array _shaped_text_get_selection(shaped: RID, start: int, end: int) virtual const 🔗

返回用于指定字符范围的选区矩形。


Vector2 _shaped_text_get_size(shaped: RID) virtual required const 🔗

返回该文本的大小。


int _shaped_text_get_spacing(shaped: RID, spacing: SpacingType) virtual const 🔗

返回字形或行之间添加的额外间距,单位为像素。


int _shaped_text_get_trim_pos(shaped: RID) virtual required const 🔗

返回超出修剪的位置。


float _shaped_text_get_underline_position(shaped: RID) virtual required const 🔗

返回基线下方下划线的像素偏移。


float _shaped_text_get_underline_thickness(shaped: RID) virtual required const 🔗

返回下划线的粗细度。


float _shaped_text_get_width(shaped: RID) virtual required const 🔗

返回文本的宽度(对于水平排版)或高度(对于垂直排版)。


PackedInt32Array _shaped_text_get_word_breaks(shaped: RID, grapheme_flags: BitField[GraphemeFlag], skip_grapheme_flags: BitField[GraphemeFlag]) virtual const 🔗

将文本分解成单词并返回字符范围的数组。请使用 grapheme_flags 来设置哪些字符会被用于分解。


bool _shaped_text_has_object(shaped: RID, key: Variant) virtual required const 🔗

Returns true if an object with key is embedded in this shaped text buffer.


int _shaped_text_hit_test_grapheme(shaped: RID, coord: float) virtual const 🔗

返回字素的索引,该字素位于基线上指定像素偏移的位置,如果没有找到,则返回 -1


int _shaped_text_hit_test_position(shaped: RID, coord: float) virtual const 🔗

返回基线处指定像素偏移处的文本光标的偏移量。该函数始终返回一个有效位置。


bool _shaped_text_is_ready(shaped: RID) virtual required const 🔗

如果缓冲区成功塑形,则返回 true


int _shaped_text_next_character_pos(shaped: RID, pos: int) virtual const 🔗

返回距离 pos 最近的组合字符结束位置。


int _shaped_text_next_grapheme_pos(shaped: RID, pos: int) virtual const 🔗

返回距离 pos 最近的字素结束位置。


void _shaped_text_overrun_trim_to_width(shaped: RID, width: float, trim_flags: BitField[TextOverrunFlag]) virtual 🔗

如果文本超出给定宽度,则修剪文本。


int _shaped_text_prev_character_pos(shaped: RID, pos: int) virtual const 🔗

返回距离 pos 最近的组合字符开始位置。


int _shaped_text_prev_grapheme_pos(shaped: RID, pos: int) virtual const 🔗

返回距离 pos 最近的字素开始位置。


bool _shaped_text_resize_object(shaped: RID, key: Variant, size: Vector2, inline_align: InlineAlignment, baseline: float) virtual required 🔗

设置嵌入对象的新大小和对齐方式。


void _shaped_text_set_bidi_override(shaped: RID, override: Array) virtual 🔗

为结构化文本设置 BiDi 算法覆盖。


void _shaped_text_set_custom_ellipsis(shaped: RID, char: int) virtual 🔗

设置文字裁剪时使用的省略字符。


void _shaped_text_set_custom_punctuation(shaped: RID, punct: String) virtual 🔗

设置自定义标点字符列表,用于断字。如果被设置为空字符串,则使用服务器的默认值。


void _shaped_text_set_direction(shaped: RID, direction: Direction) virtual 🔗

设置所需的文本方向。如果设置为 TextServer.DIRECTION_AUTO,方向将根据缓冲区的内容和当前的区域设置来检测。


void _shaped_text_set_orientation(shaped: RID, orientation: Orientation) virtual 🔗

设置想要的文本朝向。


void _shaped_text_set_preserve_control(shaped: RID, enabled: bool) virtual 🔗

如果设置为 true,则文本缓冲区将显示控制字符。


void _shaped_text_set_preserve_invalid(shaped: RID, enabled: bool) virtual 🔗

如果设置为 true,则文本缓冲区会将无效字符显示为十六进制代码,否则不显示任何内容。


void _shaped_text_set_spacing(shaped: RID, spacing: SpacingType, value: int) virtual 🔗

设置字形之间或行与行之间添加的额外像素间距。


bool _shaped_text_shape(shaped: RID) virtual required 🔗

形状缓冲区(如果未塑形)。如果字符串塑形成功,则返回 true


const Glyph* _shaped_text_sort_logical(shaped: RID) virtual required 🔗

按逻辑顺序返回文本字形。


RID _shaped_text_substr(shaped: RID, start: int, length: int) virtual required const 🔗

返回 shaped 文本缓冲区中字符串的子字符串的文本缓冲区(包括内联对象)。


float _shaped_text_tab_align(shaped: RID, tab_stops: PackedFloat32Array) virtual 🔗

将塑形文本与给定的制表位对齐。


bool _shaped_text_update_breaks(shaped: RID) virtual 🔗

更新塑形文本中的断点。该方法由分词函数的默认实现调用。


bool _shaped_text_update_justification_ops(shaped: RID) virtual 🔗

更新塑形文本中的对齐点。该方法由文本对齐函数的默认实现调用。


bool _spoof_check(string: String) virtual const 🔗

如果 string 可能试图混淆读者,则返回 true


PackedInt32Array _string_get_character_breaks(string: String, language: String) virtual const 🔗

返回组合字符边界的数组。


PackedInt32Array _string_get_word_breaks(string: String, language: String, chars_per_line: int) virtual const 🔗

返回分词边界的数组。数组中的元素是单词起始位置和结束位置的偏移量。因此数组的长度始终为偶数。


String _string_to_lower(string: String, language: String) virtual const 🔗

返回将该字符串转换为小写 lowercase 的结果。


String _string_to_title(string: String, language: String) virtual const 🔗

Returns the string converted to Title Case.


String _string_to_upper(string: String, language: String) virtual const 🔗

返回将该字符串转换为大写 UPPERCASE 的结果。


String _strip_diacritics(string: String) virtual const 🔗

从字符串中剥离变音符号。


String _tag_to_name(tag: int) virtual const 🔗

Converts the given OpenType tag to the readable name of a feature, variation, script, or language.


void _unreference_oversampling_level(oversampling: float) virtual 🔗

将指定过采样等级的引用计数调小,计数变零时释放过采样等级的字体缓存。该方法由 Viewport 调用,不应直接使用。