---
title: "Mesh3D"
---
<!-- DO NOT EDIT! This file was auto-generated by crates/build/re_types_builder/src/codegen/docs/website.rs -->

A 3D triangle mesh as specified by its per-mesh and per-vertex properties.

See also [`archetypes.Asset3D`](https://rerun.io/docs/reference/types/archetypes/asset3d).

If there are multiple [`archetypes.InstancePoses3D`](https://rerun.io/docs/reference/types/archetypes/instance_poses3d) instances logged to the same entity as a mesh,
an instance of the mesh will be drawn for each transform.

For transparency ordering, as well as back face culling (disabled by default),
front faces are assumed to be those with counter clockwise triangle winding order
(this is the same as in the GLTF specification).

## Fields
### Required
* `vertex_positions`: [`Position3D`](../components/position3d.md)

### Recommended
* `triangle_indices`: [`TriangleIndices`](../components/triangle_indices.md)
* `vertex_normals`: [`Vector3D`](../components/vector3d.md)

### Optional
* `vertex_colors`: [`Color`](../components/color.md)
* `vertex_texcoords`: [`Texcoord2D`](../components/texcoord2d.md)
* `albedo_factor`: [`AlbedoFactor`](../components/albedo_factor.md)
* `face_rendering`: [`MeshFaceRendering`](../components/mesh_face_rendering.md)
* `albedo_texture_buffer`: [`ImageBuffer`](../components/image_buffer.md)
* `albedo_texture_format`: [`ImageFormat`](../components/image_format.md)
* `class_ids`: [`ClassId`](../components/class_id.md)


## Can be shown in
* [Spatial3DView](../views/spatial3d_view.md)
* [Spatial2DView](../views/spatial2d_view.md) (if logged above active projection)
* [DataframeView](../views/dataframe_view.md)

## API reference links
 * 🌊 [C++ API docs for `Mesh3D`](https://ref.rerun.io/docs/cpp/stable/structrerun_1_1archetypes_1_1Mesh3D.html)
 * 🐍 [Python API docs for `Mesh3D`](https://ref.rerun.io/docs/python/stable/common/archetypes#rerun.archetypes.Mesh3D)
 * 🦀 [Rust API docs for `Mesh3D`](https://docs.rs/rerun/latest/rerun/archetypes/struct.Mesh3D.html)

## Examples

### Simple indexed 3D mesh

snippet: archetypes/mesh3d_indexed

<picture data-inline-viewer="snippets/archetypes/mesh3d_indexed">
  <source media="(max-width: 480px)" srcset="https://static.rerun.io/mesh3d_indexed/57c70dc992e6dc0bd9c5222ca084f5b6240cea75/480w.png">
  <source media="(max-width: 768px)" srcset="https://static.rerun.io/mesh3d_indexed/57c70dc992e6dc0bd9c5222ca084f5b6240cea75/768w.png">
  <source media="(max-width: 1024px)" srcset="https://static.rerun.io/mesh3d_indexed/57c70dc992e6dc0bd9c5222ca084f5b6240cea75/1024w.png">
  <source media="(max-width: 1200px)" srcset="https://static.rerun.io/mesh3d_indexed/57c70dc992e6dc0bd9c5222ca084f5b6240cea75/1200w.png">
  <img src="https://static.rerun.io/mesh3d_indexed/57c70dc992e6dc0bd9c5222ca084f5b6240cea75/full.png">
</picture>

### 3D mesh with instancing

snippet: archetypes/mesh3d_instancing

<picture data-inline-viewer="snippets/archetypes/mesh3d_instancing">
  <source media="(max-width: 480px)" srcset="https://static.rerun.io/mesh3d_leaf_transforms3d/c2d0ee033129da53168f5705625a9b033f3a3d61/480w.png">
  <source media="(max-width: 768px)" srcset="https://static.rerun.io/mesh3d_leaf_transforms3d/c2d0ee033129da53168f5705625a9b033f3a3d61/768w.png">
  <source media="(max-width: 1024px)" srcset="https://static.rerun.io/mesh3d_leaf_transforms3d/c2d0ee033129da53168f5705625a9b033f3a3d61/1024w.png">
  <source media="(max-width: 1200px)" srcset="https://static.rerun.io/mesh3d_leaf_transforms3d/c2d0ee033129da53168f5705625a9b033f3a3d61/1200w.png">
  <img src="https://static.rerun.io/mesh3d_leaf_transforms3d/c2d0ee033129da53168f5705625a9b033f3a3d61/full.png">
</picture>

### Update specific parts of a 3D mesh over time

snippet: archetypes/mesh3d_partial_updates

<picture data-inline-viewer="snippets/archetypes/mesh3d_partial_updates">
  <source media="(max-width: 480px)" srcset="https://static.rerun.io/mesh3d_partial_updates/79b8a83294ef2c1eb7f9ae7dea7267a17da464ae/480w.png">
  <source media="(max-width: 768px)" srcset="https://static.rerun.io/mesh3d_partial_updates/79b8a83294ef2c1eb7f9ae7dea7267a17da464ae/768w.png">
  <source media="(max-width: 1024px)" srcset="https://static.rerun.io/mesh3d_partial_updates/79b8a83294ef2c1eb7f9ae7dea7267a17da464ae/1024w.png">
  <source media="(max-width: 1200px)" srcset="https://static.rerun.io/mesh3d_partial_updates/79b8a83294ef2c1eb7f9ae7dea7267a17da464ae/1200w.png">
  <img src="https://static.rerun.io/mesh3d_partial_updates/79b8a83294ef2c1eb7f9ae7dea7267a17da464ae/full.png">
</picture>

