Struct Label 

pub struct Label { /* private fields */ }

A node for rendering text using a TrueType font.

Implementations

impl Label

pub fn set_alignment(&mut self, val: TextAlign)

Sets the text alignment setting.

pub fn get_alignment(&self) -> TextAlign

Gets the text alignment setting.

pub fn set_alpha_ref(&mut self, val: f32)

Sets the alpha threshold value. Pixels with alpha values below this value will not be drawn. Only works with label.effect = SpriteEffect::new("builtin:vs_sprite", "builtin:fs_spritealphatest").

pub fn get_alpha_ref(&self) -> f32

Gets the alpha threshold value. Pixels with alpha values below this value will not be drawn. Only works with label.effect = SpriteEffect::new("builtin:vs_sprite", "builtin:fs_spritealphatest").

pub fn set_text_width(&mut self, val: f32)

Sets the width of the text used for text wrapping. Set to Label::AutomaticWidth to disable wrapping. Default is Label::AutomaticWidth.

pub fn get_text_width(&self) -> f32

Gets the width of the text used for text wrapping. Set to Label::AutomaticWidth to disable wrapping. Default is Label::AutomaticWidth.

pub fn set_spacing(&mut self, val: f32)

Sets the gap in pixels between characters.

pub fn get_spacing(&self) -> f32

Gets the gap in pixels between characters.

pub fn set_line_gap(&mut self, val: f32)

Sets the gap in pixels between lines of text.

pub fn get_line_gap(&self) -> f32

Gets the gap in pixels between lines of text.

pub fn set_outline_color(&mut self, val: &Color)

Sets the color of the outline, only works with SDF label.

pub fn get_outline_color(&self) -> Color

Gets the color of the outline, only works with SDF label.

pub fn set_outline_width(&mut self, val: f32)

Sets the width of the outline, only works with SDF label.

pub fn get_outline_width(&self) -> f32

Gets the width of the outline, only works with SDF label.

pub fn set_smooth(&mut self, val: &Vec2)

Sets the smooth value of the text, only works with SDF label, default is (0.7, 0.7).

pub fn get_smooth(&self) -> Vec2

Gets the smooth value of the text, only works with SDF label, default is (0.7, 0.7).

pub fn set_text(&mut self, val: &str)

Sets the text to be rendered.

pub fn get_text(&self) -> String

Gets the text to be rendered.

pub fn set_blend_func(&mut self, val: BlendFunc)

Sets the blend function for the label.

pub fn get_blend_func(&self) -> BlendFunc

Gets the blend function for the label.

pub fn set_depth_write(&mut self, val: bool)

Sets whether depth writing is enabled. (Default is false)

pub fn is_depth_write(&self) -> bool

Gets whether depth writing is enabled. (Default is false)

pub fn set_batched(&mut self, val: bool)

Sets whether the label is using batched rendering. When using batched rendering the label.get_character() function will no longer work, but it provides better rendering performance. Default is true.

pub fn is_batched(&self) -> bool

Gets whether the label is using batched rendering. When using batched rendering the label.get_character() function will no longer work, but it provides better rendering performance. Default is true.

pub fn set_effect(&mut self, val: &SpriteEffect)

Sets the sprite effect used to render the text.

pub fn get_effect(&self) -> SpriteEffect

Gets the sprite effect used to render the text.

pub fn get_character_count(&self) -> i32

Gets the number of characters in the label.

pub fn get_character(&mut self, index: i32) -> Option<Sprite>

Returns the sprite for the character at the specified index.

Arguments

• index - The index of the character sprite to retrieve.

Returns

• Option<Sprite> - The sprite for the character, or None if the index is out of range.

pub fn get_automatic_width() -> f32

Gets the value to use for automatic width calculation

pub fn new(font_name: &str, font_size: i32, sdf: bool) -> Option<Label>

Creates a new Label object with the specified font name and font size.

Arguments

• font_name - The name of the font to use for the label. Can be font file path with or without file extension.
• font_size - The size of the font to use for the label.
• sdf - Whether to use SDF rendering or not. With SDF rendering, the outline feature will be enabled.

Returns

• Label - The new Label object.

pub fn with_str(font_str: &str) -> Option<Label>

Creates a new Label object with the specified font string.

Arguments

• font_str - The font string to use for the label. Should be in the format “fontName;fontSize;sdf”, where sdf should be “true” or “false”.

Returns

• Label - The new Label object.

Trait Implementations

impl Clone for Label

fn clone(&self) -> Label

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Drop for Label

fn drop(&mut self)

Executes the destructor for this type.

impl INode for Label

fn set_order(&mut self, val: i32)

Sets the order of the node in the parent’s children array.

fn get_order(&self) -> i32

Gets the order of the node in the parent’s children array.

fn set_angle(&mut self, val: f32)

Sets the rotation angle of the node in degrees.

fn get_angle(&self) -> f32

Gets the rotation angle of the node in degrees.

fn set_angle_x(&mut self, val: f32)

Sets the X-axis rotation angle of the node in degrees.

fn get_angle_x(&self) -> f32

Gets the X-axis rotation angle of the node in degrees.

fn set_angle_y(&mut self, val: f32)

Sets the Y-axis rotation angle of the node in degrees.

fn get_angle_y(&self) -> f32

Gets the Y-axis rotation angle of the node in degrees.

fn set_scale_x(&mut self, val: f32)

Sets the X-axis scale factor of the node.

fn get_scale_x(&self) -> f32

Gets the X-axis scale factor of the node.

fn set_scale_y(&mut self, val: f32)

Sets the Y-axis scale factor of the node.

fn get_scale_y(&self) -> f32

Gets the Y-axis scale factor of the node.

fn set_x(&mut self, val: f32)

Sets the X-axis position of the node.

fn get_x(&self) -> f32

Gets the X-axis position of the node.

fn set_y(&mut self, val: f32)

Sets the Y-axis position of the node.

fn get_y(&self) -> f32

Gets the Y-axis position of the node.

fn set_z(&mut self, val: f32)

Sets the Z-axis position of the node.

fn get_z(&self) -> f32

Gets the Z-axis position of the node.

fn set_position(&mut self, val: &Vec2)

Sets the position of the node as a Vec2 object.

fn get_position(&self) -> Vec2

Gets the position of the node as a Vec2 object.

fn set_skew_x(&mut self, val: f32)

Sets the X-axis skew angle of the node in degrees.

fn get_skew_x(&self) -> f32

Gets the X-axis skew angle of the node in degrees.

fn set_skew_y(&mut self, val: f32)

Sets the Y-axis skew angle of the node in degrees.

fn get_skew_y(&self) -> f32

Gets the Y-axis skew angle of the node in degrees.

fn set_visible(&mut self, val: bool)

Sets whether the node is visible.

fn is_visible(&self) -> bool

Gets whether the node is visible.

fn set_anchor(&mut self, val: &Vec2)

Sets the anchor point of the node as a Vec2 object.

fn get_anchor(&self) -> Vec2

Gets the anchor point of the node as a Vec2 object.

fn set_width(&mut self, val: f32)

Sets the width of the node.

fn get_width(&self) -> f32

Gets the width of the node.

fn set_height(&mut self, val: f32)

Sets the height of the node.

fn get_height(&self) -> f32

Gets the height of the node.

fn set_size(&mut self, val: &Size)

Sets the size of the node as a Size object.

fn get_size(&self) -> Size

Gets the size of the node as a Size object.

fn set_tag(&mut self, val: &str)

Sets the tag of the node as a string.

fn get_tag(&self) -> String

Gets the tag of the node as a string.

fn set_opacity(&mut self, val: f32)

Sets the opacity of the node, should be 0 to 1.0.

fn get_opacity(&self) -> f32

Gets the opacity of the node, should be 0 to 1.0.

fn set_color(&mut self, val: &Color)

Sets the color of the node as a Color object.

fn get_color(&self) -> Color

Gets the color of the node as a Color object.

fn set_color3(&mut self, val: &Color3)

Sets the color of the node as a Color3 object.

fn get_color3(&self) -> Color3

Gets the color of the node as a Color3 object.

fn set_pass_opacity(&mut self, val: bool)

Sets whether to pass the opacity value to child nodes.

fn is_pass_opacity(&self) -> bool

Gets whether to pass the opacity value to child nodes.

fn set_pass_color3(&mut self, val: bool)

Sets whether to pass the color value to child nodes.

fn is_pass_color3(&self) -> bool

Gets whether to pass the color value to child nodes.

fn set_transform_target(&mut self, val: &dyn INode)

Sets the target node acts as a parent node for transforming this node.

fn get_transform_target(&self) -> Option<Node>

Gets the target node acts as a parent node for transforming this node.

fn set_scheduler(&mut self, val: &Scheduler)

Sets the scheduler used for scheduling update and action callbacks.

fn get_scheduler(&self) -> Scheduler

Gets the scheduler used for scheduling update and action callbacks.

fn get_children(&self) -> Option<Array>

Gets the children of the node as an Array object, could be None.

fn get_parent(&self) -> Option<Node>

Gets the parent of the node, could be None.

fn is_running(&self) -> bool

Gets whether the node is currently running in a scene tree.

fn is_scheduled(&self) -> bool

Gets whether the node is currently scheduling a function for updates.

fn get_action_count(&self) -> i32

Gets the number of actions currently running on the node.

fn get_data(&self) -> Dictionary

Gets additional data stored on the node as a Dictionary object.

fn set_touch_enabled(&mut self, val: bool)

Sets whether touch events are enabled on the node.

fn is_touch_enabled(&self) -> bool

Gets whether touch events are enabled on the node.

fn set_swallow_touches(&mut self, val: bool)

Sets whether the node should swallow touch events.

fn is_swallow_touches(&self) -> bool

Gets whether the node should swallow touch events.

fn set_swallow_mouse_wheel(&mut self, val: bool)

Sets whether the node should swallow mouse wheel events.

fn is_swallow_mouse_wheel(&self) -> bool

Gets whether the node should swallow mouse wheel events.

fn set_keyboard_enabled(&mut self, val: bool)

Sets whether keyboard events are enabled on the node.

fn is_keyboard_enabled(&self) -> bool

Gets whether keyboard events are enabled on the node.

fn set_controller_enabled(&mut self, val: bool)

Sets whether controller events are enabled on the node.

fn is_controller_enabled(&self) -> bool

Gets whether controller events are enabled on the node.

fn set_render_group(&mut self, val: bool)

Sets whether to group the node’s rendering with all its recursive children.

fn is_render_group(&self) -> bool

Gets whether to group the node’s rendering with all its recursive children.

fn set_show_debug(&mut self, val: bool)

Sets whether debug graphic should be displayed for the node.

fn is_show_debug(&self) -> bool

Gets whether debug graphic should be displayed for the node.

fn set_render_order(&mut self, val: i32)

Sets the rendering order number for group rendering. Nodes with lower rendering orders are rendered earlier.

fn get_render_order(&self) -> i32

Gets the rendering order number for group rendering. Nodes with lower rendering orders are rendered earlier.

fn add_child_with_order_tag(&mut self, child: &dyn INode, order: i32, tag: &str)

Adds a child node to the current node.

fn add_child_with_order(&mut self, child: &dyn INode, order: i32)

Adds a child node to the current node.

fn add_child(&mut self, child: &dyn INode)

Adds a child node to the current node.

fn add_to_with_order_tag( &mut self, parent: &dyn INode, order: i32, tag: &str, ) -> Node

Adds the current node to a parent node.

fn add_to_with_order(&mut self, parent: &dyn INode, order: i32) -> Node

Adds the current node to a parent node.

fn add_to(&mut self, parent: &dyn INode) -> Node

Adds the current node to a parent node.

fn remove_child(&mut self, child: &dyn INode, cleanup: bool)

Removes a child node from the current node.

fn remove_child_by_tag(&mut self, tag: &str, cleanup: bool)

Removes a child node from the current node by tag.

fn remove_all_children(&mut self, cleanup: bool)

Removes all child nodes from the current node.

fn remove_from_parent(&mut self, cleanup: bool)

Removes the current node from its parent node.

fn move_to_parent(&mut self, parent: &dyn INode)

Moves the current node to a new parent node without triggering node events.

fn cleanup(&mut self)

Cleans up the current node.

fn get_child_by_tag(&mut self, tag: &str) -> Option<Node>

Gets a child node by tag.

fn schedule(&mut self, update_func: Box<dyn FnMut(f64) -> bool>)

Schedules a main function to run every frame. Call this function again to replace the previous scheduled main function or coroutine.

fn unschedule(&mut self)

Unschedules the current node’s scheduled main function.

fn convert_to_node_space(&mut self, world_point: &Vec2) -> Vec2

Converts a point from world space to node space.

fn convert_to_world_space(&mut self, node_point: &Vec2) -> Vec2

Converts a point from node space to world space.

fn convert_to_window_space( &mut self, node_point: &Vec2, callback: Box<dyn FnMut(&Vec2)>, )

Converts a point from node space to world space.

fn each_child( &mut self, visitor_func: Box<dyn FnMut(&dyn INode) -> bool>, ) -> bool

Calls the given function for each child node of this node.

fn traverse(&mut self, visitor_func: Box<dyn FnMut(&dyn INode) -> bool>) -> bool

Traverses the node hierarchy starting from this node and calls the given function for each visited node. The nodes without TraverseEnabled flag are not visited.

fn traverse_all( &mut self, visitor_func: Box<dyn FnMut(&dyn INode) -> bool>, ) -> bool

Traverses the entire node hierarchy starting from this node and calls the given function for each visited node.

fn run_action_def(&mut self, def: ActionDef, looped: bool) -> f32

Runs an action defined by the given action definition on this node.

fn run_action(&mut self, action: &Action, looped: bool) -> f32

Runs an action on this node.

fn stop_all_actions(&mut self)

Stops all actions running on this node.

fn perform_def(&mut self, action_def: ActionDef, looped: bool) -> f32

Runs an action defined by the given action definition right after clearing all the previous running actions.

fn perform(&mut self, action: &Action, looped: bool) -> f32

Runs an action on this node right after clearing all the previous running actions.

fn stop_action(&mut self, action: &Action)

Stops the given action running on this node.

fn align_items_vertically(&mut self, padding: f32) -> Size

Vertically aligns all child nodes within the node using the given size and padding.

fn align_items_vertically_with_size( &mut self, size: &Size, padding: f32, ) -> Size

Vertically aligns all child nodes within the node using the given size and padding.

fn align_items_horizontally(&mut self, padding: f32) -> Size

Horizontally aligns all child nodes within the node using the given size and padding.

fn align_items_horizontally_with_size( &mut self, size: &Size, padding: f32, ) -> Size

Horizontally aligns all child nodes within the node using the given size and padding.

fn align_items(&mut self, padding: f32) -> Size

Aligns all child nodes within the node using the given size and padding.

fn align_items_with_size(&mut self, size: &Size, padding: f32) -> Size

Aligns all child nodes within the node using the given size and padding.

fn move_and_cull_items(&mut self, delta: &Vec2)

Moves and changes child nodes’ visibility based on their position in parent’s area.

fn attach_ime(&mut self)

Attaches the input method editor (IME) to the node. Makes node recieving “AttachIME”, “DetachIME”, “TextInput”, “TextEditing” events.

fn detach_ime(&mut self)

Detaches the input method editor (IME) from the node.

fn grab(&mut self) -> Grabber

Creates a texture grabber for the specified node.

fn grab_with_size(&mut self, grid_x: i32, grid_y: i32) -> Grabber

Creates a texture grabber for the specified node with a specified grid size.

fn stop_grab(&mut self)

Removes the texture grabber for the specified node.

fn set_transform_target_null(&mut self)

Removes the transform target for the specified node.

fn slot(&mut self, event_name: &str, handler: Box<dyn FnMut(&mut CallStack)>)

Associates the given handler function with the node event.

fn gslot(&mut self, event_name: &str, handler: Box<dyn FnMut(&mut CallStack)>)

Associates the given handler function with a global event.

fn emit(&mut self, name: &str, stack: &CallStack)

Emits an event to a node, triggering the event handler associated with the event name.

fn on_update(&mut self, update_func: Box<dyn FnMut(f64) -> bool>)

Schedules a function to run every frame. Call this function again to schedule multiple functions.

fn on_render(&mut self, render_func: Box<dyn FnMut(f64) -> bool>)

Registers a callback for event triggered when the node is entering the rendering phase. The callback is called every frame, and ensures that its call order is consistent with the rendering order of the scene tree, such as rendering child nodes after their parent nodes. Recommended for calling vector drawing functions.

impl IObject for Label

fn raw(&self) -> i64

fn obj(&self) -> &dyn IObject

fn as_any(&self) -> &dyn Any

fn get_id(&self) -> i32