【Godot】CanvasItem

（参考自deepseek回答）
在 Godot 引擎中，CanvasItem 是一个非常重要的类，它是所有 2D 渲染对象的基础类。CanvasItem 提供了 2D 渲染、变换、绘制和可见性控制等功能，是 Godot 2D 系统的核心组成部分。

1. CanvasItem 的定义

• CanvasItem 继承自 Node，是 Node2D、Control（UI 控件）等 2D 类的基类。
• 它负责管理 2D 对象的绘制、变换和可见性。

2. CanvasItem 的核心功能

1. 2D 变换：

   • CanvasItem 支持 2D 变换，包括：
     • 位置（position）
     • 旋转（rotation）
     • 缩放（scale）
   • 这些变换可以嵌套，子节点会继承父节点的变换。

2. 绘制：

   • CanvasItem 提供了绘制方法（如 draw_line()、draw_rect()、draw_texture() 等），允许在 2D 场景中绘制形状、纹理和文本。
   • 可以通过重写 _draw() 方法实现自定义绘制。

3. 可见性：

   • CanvasItem 提供了 visible 属性，用于控制对象的可见性。
   • 当 visible 为 false 时，对象及其子对象不会被渲染。

4. 层级管理：

   • CanvasItem 使用 z_index 属性控制渲染顺序，z_index 值越大，对象越靠前。

5. 输入事件：

   • CanvasItem 可以处理 2D 输入事件（如鼠标点击、触摸等）。
   • 通过重写 _input_event() 方法，可以实现自定义输入处理。

3. CanvasItem 的常见子类

1. Node2D：

   • 用于 2D 场景中的可视对象（如精灵、物理对象等）。
   • 提供了更高级的 2D 功能（如物理、动画等）。

2. Control：

   • 用于 UI 控件（如按钮、标签、面板等）。
   • 提供了布局、样式和交互功能。

3. Sprite2D：

   • 用于显示 2D 纹理（如图片）。
   • 是 Node2D 的子类，间接继承自 CanvasItem。

4. AnimatedSprite2D：

   • 用于播放 2D 动画。
   • 是 Node2D 的子类，间接继承自 CanvasItem。

4. CanvasItem 的使用示例

示例 1：自定义绘制

extends CanvasItem

func _draw():
    # 绘制一个红色矩形
    draw_rect(Rect2(50, 50, 100, 100), Color(1, 0, 0))

示例 2：控制可见性

extends CanvasItem

func _ready():
    # 隐藏对象
    visible = false

示例 3：处理输入事件

extends CanvasItem

func _input_event(viewport, event, shape_idx):
    if event is InputEventMouseButton and event.pressed:
        print("CanvasItem clicked!")

5. CanvasItem 的常用属性和方法

6. CanvasItem 的应用场景

1. 自定义 2D 图形：

   • 使用 _draw() 方法绘制自定义形状、图案或特效。

2. UI 控件：

   • Control 类继承自 CanvasItem，用于创建复杂的 UI 界面。

3. 2D 游戏对象：

   • Node2D 及其子类（如 Sprite2D、AnimatedSprite2D）用于创建 2D 游戏中的角色、背景、道具等。

4. 输入处理：

   • 通过 _input_event() 方法实现 2D 对象的交互（如点击、拖拽等）。

总结

CanvasItem 是 Godot 2D 系统的核心类，提供了 2D 渲染、变换、绘制和输入处理等功能。它是 Node2D 和 Control 等类的基类，广泛应用于 2D 游戏和 UI 开发中。通过 CanvasItem，开发者可以实现复杂的 2D 图形和交互效果。