H073.VertexKit 1.0.0

VertexKit

Lightweight geometry and render-command library for MonoGame. Handles vertex/index buffer creation, bounding volume computation, frustum culling, render sorting, GPU instancing, and dynamic meshes — so you can focus on what to draw, not how.

.NET 10 | MonoGame 3.8.4

Features

• Primitive — GPU-resident geometry with automatic bounds. The base unit for anything drawable.
• PrimitiveBuilder — Fluent builder that auto-selects the optimal vertex format and computes normals when missing.
• DynamicMesh<T> — Per-frame updatable geometry using DynamicVertexBuffer / DynamicIndexBuffer. Ideal for water, trails, deformable terrain.
• InstanceBatch<T> — Single draw call for thousands of instances (grass, trees, particles).
• RenderCommand — Immutable draw command struct carrying everything needed to issue a draw call.
• RenderSorter — Opaque front-to-back with material batching, transparent back-to-front.
• BoundsHelper — Bounding box/sphere computation, transform, merge, and frustum visibility tests.
• MeshHelper — Normal and tangent generation, polygon triangulation.

Vertex Formats

PrimitiveBuilder picks the right format automatically based on which data you provide.

Usage

Build a triangle

using VertexKit;

var primitive = new PrimitiveBuilder(GraphicsDevice)
    .SetPositions([
        new Vector3(0, 1, 0),
        new Vector3(-1, -1, 0),
        new Vector3(1, -1, 0)
    ])
    .SetIndices([0, 1, 2])
    .Build();

// Draw directly
primitive.Draw(GraphicsDevice);

// Or generate a render command for sorting/culling
var cmd = primitive.ToRenderCommand(Matrix.Identity);

Build a textured quad with a material

var quad = new PrimitiveBuilder(GraphicsDevice)
    .SetPositions([
        new Vector3(-1, 1, 0), new Vector3(1, 1, 0),
        new Vector3(-1, -1, 0), new Vector3(1, -1, 0)
    ])
    .SetTexCoords([
        new Vector2(0, 0), new Vector2(1, 0),
        new Vector2(0, 1), new Vector2(1, 1)
    ])
    .SetIndices([0, 1, 2, 2, 1, 3])
    .SetMaterial(myMaterial)
    .Build();

GPU instancing

var batch = new InstanceBatch<InstanceData>(GraphicsDevice, treePrimitive, maxInstances: 10000);

// Each frame:
batch.SetInstances(instanceArray, activeCount);
var cmd = batch.ToRenderCommand(material, boundingSphere);
cmd.Apply(GraphicsDevice);
cmd.Draw(GraphicsDevice);

Dynamic mesh (per-frame updates)

var water = new DynamicMesh<VertexPositionNormal>(GraphicsDevice, maxVertices: 4096, maxIndices: 12288);

// Each frame:
water.SetVertices(vertexArray, vertexCount);
water.SetIndices(indexArray, indexCount);
var cmd = water.ToRenderCommand(waterMaterial, Matrix.Identity, waterBounds);

Frustum culling and render sorting

var visible = new List<RenderCommand>();
RenderSorter.CollectVisible(allCommands, camera.Frustum, visible);

var span = CollectionsMarshal.AsSpan(visible);
RenderSorter.Sort(span, camera.Position);

foreach (var cmd in span)
{
    cmd.Material?.Apply();   // your shader setup
    cmd.Apply(GraphicsDevice);
    cmd.Draw(GraphicsDevice);
}

Custom material

Implement IRenderMaterial to integrate with the sort/cull pipeline:

public class MyMaterial : IRenderMaterial
{
    public bool IsOpaque => true;
    public int SortKey => _effect.GetHashCode();
}

Install

Add a project reference:

<ProjectReference Include="..\VertexKit\VertexKit.csproj" />