Godot纹理绘制工具开发：blit_rect功能使用方法咨询

blit_rect是Godot针对Image类提供的底层像素操作方法，专门用于精准复制/绘制图像的矩形区域，是制作纹理绘制工具这类像素级编辑功能的核心API之一。

核心工作原理 #

• 本质是像素缓冲区的直接操作：跳过Godot节点渲染的上层逻辑，直接读写图像的像素数据，因此执行效率极高，适合实时绘制场景。
• 核心功能：将源图像中指定的矩形区域（源Rect），复制到目标图像的指定坐标位置，支持带透明度的像素混合。
• 参数逻辑（以GDScript的Image.blit_rect为例）：
  1. 第一个参数：作为像素来源的源Image对象
  2. 第二个参数：源图像中要复制的矩形区域Rect2（不能超出源图像的尺寸范围）
  3. 第三个参数：目标图像上的绘制起始坐标Vector2
  4. 部分Godot版本额外支持混合模式、透明度等可选参数，用于控制像素叠加效果

在纹理绘制工具中的典型用法 #

制作笔刷绘制功能时，blit_rect可以快速将笔刷纹理的有效区域绘制到画布上，示例代码如下：

# 初始化目标画布与笔刷图像
var canvas_image = Image.create(800, 600, false, Image.FORMAT_RGBA8)
canvas_image.fill(Color(1, 1, 1)) # 填充白色背景
var brush_image = load("res://brush_texture.png").get_image()

# 模拟鼠标点击位置绘制笔刷
func _on_mouse_click(mouse_pos: Vector2):
    # 定义笔刷的源区域（这里取整个笔刷图像）
    var source_rect = Rect2(0, 0, brush_image.get_width(), brush_image.get_height())
    # 计算目标位置，让笔刷中心对齐鼠标点
    var target_pos = mouse_pos - source_rect.size / 2
    # 执行绘制，将笔刷复制到画布
    canvas_image.blit_rect(brush_image, source_rect, target_pos)
    # 更新纹理显示
    $CanvasTextureRect.texture = ImageTexture.new_from_image(canvas_image)

注意事项 #

• 操作Image后必须更新对应的ImageTexture，否则界面不会显示修改后的像素
• 源矩形区域必须完全包含在源图像范围内，否则会出现像素读取错误
• 若需要不同的绘制效果，可结合Image的blend_rect方法（支持更多混合模式），但blit_rect在纯复制场景下效率更高

内容的提问来源于stack exchange，提问作者AbsolutePickle42