Version: 2022.3
LanguageEnglish
  • C#

Graphics.RenderMesh

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public static void RenderMesh(ref RenderParams rparams, Mesh mesh, int submeshIndex, Matrix4x4 objectToWorld, Nullable<Matrix4x4> prevObjectToWorld = null);

Parameters

rparams The parameters Unity uses to render the mesh.
mesh The Mesh to render.
submeshIndex The index of a submesh Unity renders when the Mesh contains multiple Materials (submeshes). For a Mesh with a single Material, use value 0.
objectToWorld The transformation matrix Unity uses to transform the mesh from object to world space.
prevObjectToWorld The previous frame transformation matrix Unity uses to calculate motion vectors for the mesh.

Description

Renders a mesh with given rendering parameters.

RenderMesh renders a Mesh for the current frame. This Mesh is affected by Lights, can cast and receive shadows, and is affected by Projectors. This Mesh can be rendered by all Cameras or by a specific Camera.

Use RenderMesh to control Mesh rendering programmatically without the need to create and manage GameObjects. RenderMesh submits the Mesh for rendering, which means it does not render the Mesh immediately. Unity renders the Mesh as part of normal rendering process. If you want to render a mesh immediately, use Graphics.DrawMeshNow.

RenderMesh does not apply any changes you make to the Material properties of a Mesh between calls. This is because it does not render the Mesh immediately. If you want to render series of Meshes that have the same Material, but with slightly different properties (for example, to change color of each mesh), use MaterialPropertyBlock parameter.

This call creates internal resources while the Mesh is in the render queue. The allocation happens immediately and exists until the end of frame if the object is in the render queue for all cameras. Otherwise, the allocation exists until the specified Camera finishes rendering.

Additional resources: MaterialPropertyBlock.

The following example renders 10 Meshes with a given Material:

using UnityEngine;

public class ExampleClass : MonoBehaviour { public Material material; public Mesh mesh;

void Update() { RenderParams rp = new RenderParams(material); for(int i=0; i<10; ++i) Graphics.RenderMesh(rp, mesh, 0, Matrix4x4.Translate(new Vector3(-4.5f+i, 0.0f, 5.0f))); } }
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961