Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

MeshInstance2D

继承： Node2D < CanvasItem < Node < Object

用于在 2D 中显示 Mesh 的节点。

描述

用于在 2D 中显示 Mesh 的节点。与显示带有大面积透明区域的 Sprite2D 节点相比，这种方式渲染速度更快，尤其是在视口分辨率较高且节点占据屏幕较大空间的情况下。这是因为使用专为适合精灵不透明区域而设计的网格可以降低 GPU 填充率（但会增加顶点处理的开销）。

如果 Mesh 需要被实例化数千次并彼此靠近，请考虑在 MultiMeshInstance2D 中改用 MultiMesh。

可以通过编辑器工具栏中的工具从已有的 Sprite2D 创建 MeshInstance2D。选择 Sprite2D 节点，然后在 2D 编辑器视口顶部选择 Sprite2D > 转换为 MeshInstance2D。

教程

• 2D 网格

属性

Mesh	mesh
Texture2D	texture

---

信号

texture_changed() 🔗

当 texture 被改变时触发。

---

属性说明

Mesh mesh 🔗

• void set_mesh(value: Mesh)

• Mesh get_mesh()

该 MeshInstance2D 绘制的 Mesh。

---

Texture2D texture 🔗

• void set_texture(value: Texture2D)

• Texture2D get_texture()

使用默认 CanvasItemMaterial 时，将使用的 Texture2D。可以在 CanvasItem 着色器中作为 TEXTURE 访问。