MeshExtensions

Static extension class providing utility methods for Mesh manipulation.

This class contains helper methods for common mesh operations such as:

• Creating quad geometry
• Setting dark colors for special shaders
• Creating arc/ring/pie geometry
• Creating grid-based meshes

These methods are available on any Mesh instance through Haxe's static extension feature.

using ceramic.MeshExtensions;

var mesh = new Mesh();
mesh.createQuad(100, 100); // Creates a 100x100 quad
mesh.createArc(50, 180, 10, 32, INSIDE); // Creates a semi-circle arc

Static Members #

Generates vertices, indices and uvs to form a rectangular quad.

Creates a quad with 4 vertices arranged as:

0 -- 1
|    |
3 -- 2

The quad is positioned with its top-left corner at (0,0). UV coordinates are mapped from 0 to 1 across the quad.

Assigns a dark color to all vertices in the mesh.

This method is used with special shaders that support a secondary "dark" color for advanced rendering effects. The dark color is stored in vertex attributes positions 2-5 (r, g, b, a) of each vertex.

Requirements:

• Mesh must have 6 floats per vertex
• Vertex layout: [x, y, darkR, darkG, darkB, darkA]

Assigns a dark color with alpha to all vertices in the mesh.

Similar to setDarkColor but preserves the alpha channel from the provided color. Used with special shaders that support transparent dark colors for effects like shadows or overlays.

Requirements:

• Mesh must have 6 floats per vertex
• Vertex layout: [x, y, darkR, darkG, darkB, darkA]

Generates vertices and indices to create arc, pie, ring or disc geometry.

This versatile method can create various circular shapes:

• Arc: Partial circle outline (angle < 360, thickness < radius)
• Ring: Full circle outline (angle = 360, thickness < radius)
• Pie: Filled partial circle (angle < 360, thickness = radius, borderPosition = INSIDE)
• Disc: Filled full circle (angle = 360, thickness = radius, borderPosition = INSIDE)

The shape is centered at (radius, radius) to ensure all vertices are positive.

Creates a grid of vertices with optional staggering and custom attributes.

Generates a rectangular grid of vertices that can be used for:

• Terrain meshes
• Grid-based effects
• Deformable surfaces
• Tilemap rendering

Vertices are arranged in row-major order (left to right, top to bottom).

Creates triangle indices for a grid of vertices.

Generates indices that connect grid vertices into triangles. Each grid cell is split into two triangles. The mirroring options allow for alternating triangle orientations, useful for:

• Reducing visual patterns in deformed meshes
• Creating more natural-looking terrain
• Special tessellation patterns

Default triangle pattern (no mirroring):

0---1
|\  |
| \ |
|  \|
3---2

Creates UV coordinates for a grid of vertices.

Generates UV coordinates that map linearly across the grid, stretching any applied texture across the entire mesh. UVs range from (0+offsetX, 0+offsetY) to (1+offsetX, 1+offsetY).

This is useful for:

• Applying textures to terrain meshes
• Creating texture-based deformation maps
• Mapping effects across grid surfaces