MeshInstance2D

继承： Node2D < CanvasItem < Node < Object

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

描述

Node used for displaying a Mesh in 2D. This can be faster to render compared to displaying a Sprite2D node with large transparent areas, especially if the node takes up a lot of space on screen at high viewport resolutions. This is because using a mesh designed to fit the sprite's opaque areas will reduce GPU fill rate utilization (at the cost of increased vertex processing utilization).

When a Mesh has to be instantiated more than thousands of times close to each other, consider using a MultiMesh in a MultiMeshInstance2D instead.

A MeshInstance2D can be created from an existing Sprite2D via a tool in the editor toolbar. Select the Sprite2D node, then choose Sprite2D > Convert to MeshInstance2D at the top of the 2D editor viewport.

教程

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 访问。