Mesh

Edit

Meshes store arbitrary geometry data, and can be drawn with Pass:draw.

Meshes hold a list of vertices. The number of vertices is declared upfront when the Mesh is created, and it can not be resized afterwards.

The Mesh has a vertex format, which is a set of attributes comprising each vertex, like a position, color, etc.

The vertex indices in the Mesh describe the order that the vertices are rendered in. This is an optimization that allows vertices to be reused if they are used for multiple triangles, without duplicating all of their data.

The Mesh has a draw mode, which controls how the vertices are connected together to create pixels. It can either be points, lines, or triangles.

The Mesh can have a Material applied, which defines colors, textures, and other properties of its surface.

The draw range of the Mesh defines a subset of the vertices to render when the Mesh is drawn.

The bounding box of the Mesh allows LÖVR to skip rendering it when it's out of view.

Constructor

lovr.graphics.newMeshCreate a new Mesh.

Methods

Mesh:computeBoundingBoxCompute the bounding box of the Mesh.
Mesh:getBoundingBoxGet the bounding box of the Mesh.
Mesh:getDrawModeGet the draw mode of the Mesh.
Mesh:getDrawRangeGet the range of vertices drawn by the Mesh.
Mesh:getIndexBufferGet the Buffer backing the vertex indices of the Mesh.
Mesh:getIndicesGet the vertex indices in the Mesh.
Mesh:getMaterialGet the Material applied to the Mesh.
Mesh:getVertexBufferGet the Buffer backing the vertices of the Mesh.
Mesh:getVertexCountGet the number of vertices in the Mesh.
Mesh:getVertexFormatGet the vertex format of the Mesh.
Mesh:getVertexStrideGet the size of each vertex in the Mesh.
Mesh:getVerticesGet the vertices in the Mesh.
Mesh:setBoundingBoxSet or remove the bounding box of the Mesh.
Mesh:setDrawModeSet the draw mode of the Mesh.
Mesh:setDrawRangeSet the range of vertices drawn by the Mesh.
Mesh:setIndexBufferSet a Buffer for the Mesh to use for vertex indices.
Mesh:setIndicesSet the vertex indices of the Mesh.
Mesh:setMaterialSet a Material to use when drawing the Mesh.
Mesh:setVerticesSet vertices in the Mesh.

See also