Attention: Here be dragons (unstable version)

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

Checking the stable version of the documentation...

PointMesh

Inherits: PrimitiveMesh < Mesh < Resource < RefCounted < Object

Mesh with a single Point primitive.

Description

The PointMesh is made from a single point. Instead of relying on triangles, points are rendered as a single rectangle on the screen with a constant size. They are intended to be used with Particle systems, but can be used as a cheap way to render constant size billboarded sprites (for example in a point cloud).

PointMeshes, must be used with a material that has a point size. Point size can be accessed in a shader with POINT_SIZE, or in a BaseMaterial3D by setting BaseMaterial3D.use_point_size and the variable BaseMaterial3D.point_size.

When using PointMeshes, properties that normally alter vertices will be ignored, including billboard mode, grow, and cull face.