Tools

Utility functions and helpers for common operations

Initializes the random number generator

Converts a range to a list

Creates a list of numbers from 'from' to 'to'

Removes the first occurrence of an element from a list

Returns a random element from the list

Gets the shared random number generator

Builder class for creating custom mesh shapes with vertices, texture coordinates, and triangle indices

Important: Position and texture arrays must have the same number of elements (each representing x,y pairs)

Indices must be divisible by 3 (triangles) and reference valid vertex indices

Creates a new empty ShapeBuilder

Use addPosition(), addTexture(), and addIndex() to build the mesh, then call build() to create the shape

Adds a position vertex from a Vec2

Must be paired with a corresponding addTexture() call to maintain equal array lengths

Adds a position vertex from coordinates

Must be paired with a corresponding addTexture() call to maintain equal array lengths

Adds a texture coordinate from a Vec2

UV coordinates should be normalized (0.0 to 1.0)

Must be paired with a corresponding addPosition() call to maintain equal array lengths

Adds a texture coordinate from UV values

UV coordinates should be normalized (0.0 to 1.0)

Must be paired with a corresponding addPosition() call to maintain equal array lengths

Adds a triangle index referencing a vertex by its order

Indices must form complete triangles (count must be divisible by 3)

Each index must be >= 0 and < number of vertices added

Validates that the shape data is correct

Checks: position/texture arrays are equal length, indices are divisible by 3, indices are in valid range

Builds and returns the shape with the given texture image, or null if validation fails

Returns null if position/texture counts don't match, indices aren't divisible by 3, or indices are out of range