Struct Grid 

pub struct Grid { /* private fields */ }

A struct used to render a texture as a grid of sprites, where each sprite can be positioned, colored, and have its UV coordinates manipulated.

Implementations

impl Grid

pub fn get_grid_x(&self) -> i32

Gets the number of columns in the grid. And there are gridX + 1 vertices horizontally for rendering.

pub fn get_grid_y(&self) -> i32

Gets the number of rows in the grid. And there are gridY + 1 vertices vertically for rendering.

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

Sets whether depth writes are enabled.

pub fn is_depth_write(&self) -> bool

Gets whether depth writes are enabled.

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

Sets the blend function for the grid.

pub fn get_blend_func(&self) -> BlendFunc

Gets the blend function for the grid.

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

Sets the sprite effect applied to the grid. Default is SpriteEffect::new("builtin:vs_sprite", "builtin:fs_sprite").

pub fn get_effect(&self) -> SpriteEffect

Gets the sprite effect applied to the grid. Default is SpriteEffect::new("builtin:vs_sprite", "builtin:fs_sprite").

pub fn set_texture_rect(&mut self, val: &Rect)

Sets the rectangle within the texture that is used for the grid.

pub fn get_texture_rect(&self) -> Rect

Gets the rectangle within the texture that is used for the grid.

pub fn set_texture(&mut self, val: &Texture2D)

Sets the texture used for the grid.

pub fn get_texture(&self) -> Option<Texture2D>

Gets the texture used for the grid.

pub fn set_pos(&mut self, x: i32, y: i32, pos: &Vec2, z: f32)

Sets the position of a vertex in the grid.

Arguments

• x - The x-coordinate of the vertex in the grid.
• y - The y-coordinate of the vertex in the grid.
• pos - The new position of the vertex, represented by a Vec2 object.
• z - The new z-coordinate of the vertex.

pub fn get_pos(&self, x: i32, y: i32) -> Vec2

Gets the position of a vertex in the grid.

Arguments

• x - The x-coordinate of the vertex in the grid.
• y - The y-coordinate of the vertex in the grid.

Returns

• Vec2 - The current position of the vertex.

pub fn set_color(&mut self, x: i32, y: i32, color: &Color)

Sets the color of a vertex in the grid.

Arguments

• x - The x-coordinate of the vertex in the grid.
• y - The y-coordinate of the vertex in the grid.
• color - The new color of the vertex, represented by a Color object.

pub fn get_color(&self, x: i32, y: i32) -> Color

Gets the color of a vertex in the grid.

Arguments

• x - The x-coordinate of the vertex in the grid.
• y - The y-coordinate of the vertex in the grid.

Returns

• Color - The current color of the vertex.

pub fn move_uv(&mut self, x: i32, y: i32, offset: &Vec2)

Moves the UV coordinates of a vertex in the grid.

Arguments

• x - The x-coordinate of the vertex in the grid.
• y - The y-coordinate of the vertex in the grid.
• offset - The offset by which to move the UV coordinates, represented by a Vec2 object.

pub fn new(width: f32, height: f32, grid_x: i32, grid_y: i32) -> Grid

Creates a new Grid with the specified dimensions and grid size.

Arguments

• width - The width of the grid.
• height - The height of the grid.
• grid_x - The number of columns in the grid.
• grid_y - The number of rows in the grid.

Returns

• Grid - The new Grid instance.

pub fn with_texture_rect( texture: &Texture2D, texture_rect: &Rect, grid_x: i32, grid_y: i32, ) -> Grid

Creates a new Grid with the specified texture, texture rectangle, and grid size.

Arguments

• texture - The texture to use for the grid.
• texture_rect - The rectangle within the texture to use for the grid.
• grid_x - The number of columns in the grid.
• grid_y - The number of rows in the grid.

Returns

• Grid - The new Grid instance.

pub fn with_texture(texture: &Texture2D, grid_x: i32, grid_y: i32) -> Grid

Creates a new Grid with the specified texture, texture rectangle, and grid size.

Arguments

• texture - The texture to use for the grid.
• grid_x - The number of columns in the grid.
• grid_y - The number of rows in the grid.

Returns

• Grid - The new Grid instance.

pub fn with_file(clip_str: &str, grid_x: i32, grid_y: i32) -> Option<Grid>

Creates a new Grid with the specified clip string and grid size.

Arguments

• clip_str - The clip string to use for the grid. Can be “Image/file.png” and “Image/items.clip|itemA”.
• grid_x - The number of columns in the grid.
• grid_y - The number of rows in the grid.

Returns

• Grid - The new Grid instance.

Trait Implementations

impl Clone for Grid

fn clone(&self) -> Grid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Grid

fn drop(&mut self)

Executes the destructor for this type.

impl INode for Grid

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 Grid

fn raw(&self) -> i64

fn obj(&self) -> &dyn IObject

fn as_any(&self) -> &dyn Any

fn get_id(&self) -> i32