GradientMesh

Procedural gradient meshes for Gideros, written in Lua.

GradientMesh is a small creative-coding utility for generating clean gradients, radial meshes, polygon-based color interpolation, texture masking, and playful visual experiments for 2D graphics.

Instead of drawing a flat bitmap gradient, the library builds mesh vertices, assigns colors to those vertices, and lets the Gideros renderer interpolate colors across triangles.

Preview

The examples below show two main use cases for Gideros Gradient Mesh: applying procedural gradients over image textures, and generating clean gradient-based background shapes directly from mesh geometry.

Gradient overlays

These examples use a source image as a texture and blend it with a generated gradient mesh. This is useful for hero images, game menus, splash screens, atmospheric backgrounds, and visual experiments where the image should keep its structure while gaining a stronger color mood.

Gradient backgrounds and shapes

These examples focus on pure gradient surfaces generated with mesh vertices and interpolated colors. They are useful for UI cards, menu backgrounds, decorative panels, abstract scenes, and quick visual prototyping inside Gideros.

These screenshots are generated examples. For a cleaner portfolio presentation, the visuals are intentionally kept simple: the image carries the gradient result, while names and descriptions live in the documentation instead of being embedded inside the screenshots.

What this documentation covers

Getting StartedCopy the Lua source into a Gideros project, require the module, and run the first mesh examples.ExamplesReview gradient overlays, texture masks, radial shapes, splash masks, and generated visual outputs.How It WorksUnderstand the mesh construction idea behind rectangular, radial, polygon, and texture-based gradients.API ReferenceBrowse the core options such as color, alpha, radius, edges, direction, texture, holes, and antialiasing.ArchitectureSee how source code, examples, rendered screenshots, and the Gideros project file fit together.ReleasesTrack documentation releases for the GitHub Pages version of GradientMesh.

Main use cases

GradientMesh is useful for:

• gradient cards and backgrounds;
• radial color fields;
• regular polygons;
• circles and ellipse-like shapes;
• textured gradient masks;
• experimental 2D visual effects.

Repository

• Source repository: HubertRonald/GradientMesh
• Runtime target: Gideros
• Language: Lua
• License: MIT