Index · Object → RefCounted → Resource → Mesh → PrimitiveMesh → TextMesh

TextMesh

Generate a PrimitiveMesh from the text.

Class Description

Generate a PrimitiveMesh from the text.

TextMesh can be generated only when using dynamic fonts with vector glyph contours. Bitmap fonts (including bitmap data in the TrueType/OpenType containers, like color emoji fonts) are not supported.

The UV layout is arranged in 4 horizontal strips, top to bottom: 40% of the height for the front face, 40% for the back face, 10% for the outer edges and 10% for the inner edges.

Properties

var autowrap_mode: TextServer.AutowrapMode = 0

If set to something other than TextServer.AUTOWRAP_OFF, the text gets wrapped inside the node's bounding rectangle. If you resize the node, it will change its height automatically to show all the text.

var curve_step: float = 0.5

Step (in pixels) used to approximate Bézier curves. Lower values result in smoother curves, but is slower to generate and render. Consider adjusting this according to the font size and the typical viewing distance.

Note: Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts.

var depth: float = 0.05

Depths of the mesh, if set to 0.0 only front surface, is generated, and UV layout is changed to use full texture for the front face only.

var font: Font

Font configuration used to display text.

var font_size: int = 16

Font size of the TextMesh's text. This property works in tandem with pixel_size. Higher values will result in a more detailed font, regardless of curve_step and pixel_size. Consider keeping this value below 63 (inclusive) for good performance, and adjust pixel_size as needed to enlarge text.

Note: Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's Node3D.scale instead.

var horizontal_alignment: HorizontalAlignment = 1

Controls the text's horizontal alignment. Supports left, center, right, and fill (also known as justify).

var justification_flags: TextServer.JustificationFlag = 163

Line fill alignment rules.

var language: String = ""

Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.

var line_spacing: float = 0.0

Additional vertical spacing between lines (in pixels), spacing is added to line descent. This value can be negative.

var offset: Vector2 = Vector2(0, 0)

The text drawing offset (in pixels).

Note: Changing this property will regenerate the mesh, which is a slow operation. To change the text's position in real-time efficiently, change the node's Node3D.position instead.

var pixel_size: float = 0.01

The size of one pixel's width on the text to scale it in 3D. This property works in tandem with font_size.

Note: Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's Node3D.scale instead.

var structured_text_bidi_override: TextServer.StructuredTextParser = 0

Set BiDi algorithm override for the structured text.

var structured_text_bidi_override_options: Array = []

Set additional options for BiDi override.

var text: String = ""

The text to generate mesh from.

Note: Due to being a Resource, it doesn't follow the rules of Node.auto_translate_mode. If disabling translation is desired, it should be done manually with Object.set_message_translation().

var text_direction: TextServer.Direction = 0

Base text writing direction.

var uppercase: bool = false

If true, all the text displays as UPPERCASE.

var vertical_alignment: VerticalAlignment = 1

Controls the text's vertical alignment. Supports top, center, and bottom.

var width: float = 500.0

Text width (in pixels), used for fill alignment.

Inherited from PrimitiveMesh (5)
var add_uv2: bool = false
var custom_aabb: AABB = AABB(0, 0, 0, 0, 0, 0)
var flip_faces: bool = false
var uv2_padding: float = 2.0
Inherited from Mesh (1)
var lightmap_size_hint: Vector2i = Vector2i(0, 0)
Inherited from Resource (4)

Methods

Inherited from PrimitiveMesh (3)
func request_update() -> void
Inherited from Mesh (26)
func _get_aabb() -> AABB
func _set_blend_shape_name(index: int, name: StringName) -> void
func _surface_get_arrays(index: int) -> Array
func _surface_get_format(index: int) -> int
func _surface_set_material(index: int, material: Material) -> void
func create_convex_shape(clean: bool = true, simplify: bool = false) -> ConvexPolygonShape3D
func create_outline(margin: float) -> Mesh
func get_aabb() -> AABB
func surface_get_arrays(surf_idx: int) -> Array
func surface_get_blend_shape_arrays(surf_idx: int) -> Array[void]
func surface_get_material(surf_idx: int) -> Material
func surface_set_material(surf_idx: int, material: Material) -> void
Inherited from Resource (18)
func _get_rid() -> RID
func _reset_state() -> void
func _set_path_cache(path: String) -> void
func _setup_local_to_scene() -> void
func copy_from_resource(resource: Resource) -> Error
func duplicate(deep: bool = false) -> Resource
func duplicate_deep(deep_subresources_mode: Resource.DeepDuplicateMode = 1) -> Resource
func emit_changed() -> void
func get_rid() -> RID
func is_built_in() -> bool
func reset_state() -> void
func set_id_for_path(path: String, id: String) -> void
func set_path_cache(path: String) -> void
func setup_local_to_scene() -> void
func take_over_path(path: String) -> void
Inherited from RefCounted (4)
func init_ref() -> bool
func reference() -> bool
func unreference() -> bool
Inherited from Object (62)
func _get(property: StringName) -> Variant
func _get_property_list() -> Dictionary[]
func _init() -> void
func _iter_get(iter: Variant) -> Variant
func _iter_init(iter: Array) -> bool
func _iter_next(iter: Array) -> bool
func _notification(what: int) -> void
func _set(property: StringName, value: Variant) -> bool
func _to_string() -> String
func _validate_property(property: Dictionary) -> void
func add_user_signal(signal: String, arguments: Array = []) -> void
func call(method: StringName) -> Variant
func callv(method: StringName, arg_array: Array) -> Variant
func cancel_free() -> void
func connect(signal: StringName, callable: Callable, flags: int = 0) -> Error
func disconnect(signal: StringName, callable: Callable) -> void
func emit_signal(signal: StringName) -> Error
func free() -> void
func get(property: StringName) -> Variant
func get_class() -> String
func get_incoming_connections() -> Dictionary[]
func get_indexed(property_path: NodePath) -> Variant
func get_meta(name: StringName, default: Variant = null) -> Variant
func get_meta_list() -> StringName[]
func get_method_list() -> Dictionary[]
func get_property_list() -> Dictionary[]
func get_signal_connection_list(signal: StringName) -> Dictionary[]
func get_signal_list() -> Dictionary[]
func has_meta(name: StringName) -> bool
func has_method(method: StringName) -> bool
func has_signal(signal: StringName) -> bool
func is_class(class: StringName) -> bool
func is_connected(signal: StringName, callable: Callable) -> bool
func notification(what: int, reversed: bool = false) -> void
func remove_meta(name: StringName) -> void
func remove_user_signal(signal: StringName) -> void
func set(property: StringName, value: Variant) -> void
func set_block_signals(enable: bool) -> void
func set_deferred(property: StringName, value: Variant) -> void
func set_indexed(property_path: NodePath, value: Variant) -> void
func set_message_translation(enable: bool) -> void
func set_meta(name: StringName, value: Variant) -> void
func set_script(script: Variant) -> void
func set_translation_domain(domain: StringName) -> void
func to_string() -> String
func tr(message: StringName, context: StringName = &"") -> String
func tr_n(message: StringName, plural_message: StringName, n: int, context: StringName = &"") -> String

Signals

Inherited from Resource (2)
signal changed()
Inherited from Object (2)