【Godot】CanvasItem

（参考自deepseek回答）

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

1. CanvasItem 的定义

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

2. CanvasItem 的核心功能

2D 变换：
- CanvasItem 支持 2D 变换，包括：
  - 位置（position）
  - 旋转（rotation）
  - 缩放（scale）
- 这些变换可以嵌套，子节点会继承父节点的变换。
绘制：
- CanvasItem 提供了绘制方法（如 draw_line()、draw_rect()、draw_texture() 等），允许在 2D 场景中绘制形状、纹理和文本。
- 可以通过重写 _draw() 方法实现自定义绘制。
可见性：
- CanvasItem 提供了 visible 属性，用于控制对象的可见性。
- 当 visible 为 false 时，对象及其子对象不会被渲染。
层级管理：
- CanvasItem 使用 z_index 属性控制渲染顺序，z_index 值越大，对象越靠前。
输入事件：
- CanvasItem 可以处理 2D 输入事件（如鼠标点击、触摸等）。
- 通过重写 _input_event() 方法，可以实现自定义输入处理。

3. CanvasItem 的常见子类

Node2D：
- 用于 2D 场景中的可视对象（如精灵、物理对象等）。
- 提供了更高级的 2D 功能（如物理、动画等）。
Control：
- 用于 UI 控件（如按钮、标签、面板等）。
- 提供了布局、样式和交互功能。
Sprite2D：
- 用于显示 2D 纹理（如图片）。
- 是 Node2D 的子类，间接继承自 CanvasItem。
AnimatedSprite2D：
- 用于播放 2D 动画。
- 是 Node2D 的子类，间接继承自 CanvasItem。

4. CanvasItem 的使用示例

示例 1：自定义绘制

python 复制代码

extends CanvasItem

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

示例 2：控制可见性

python 复制代码

extends CanvasItem

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

示例 3：处理输入事件

python 复制代码

extends CanvasItem

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

5. CanvasItem 的常用属性和方法

属性/方法	说明
`position`	对象的位置（相对于父节点）。
`rotation`	对象的旋转角度（弧度制）。
`scale`	对象的缩放比例。
`visible`	对象的可见性。
`z_index`	对象的渲染层级，值越大越靠前。
`_draw()`	重写此方法以实现自定义绘制。
`_input_event()`	重写此方法以处理输入事件。
`draw_line()`	绘制一条线。
`draw_rect()`	绘制一个矩形。
`draw_texture()`	绘制一个纹理。

6. CanvasItem 的应用场景

自定义 2D 图形：
- 使用 _draw() 方法绘制自定义形状、图案或特效。
UI 控件：
- Control 类继承自 CanvasItem，用于创建复杂的 UI 界面。
2D 游戏对象：
- Node2D 及其子类（如 Sprite2D、AnimatedSprite2D）用于创建 2D 游戏中的角色、背景、道具等。
输入处理：
- 通过 _input_event() 方法实现 2D 对象的交互（如点击、拖拽等）。

总结

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