Thunder.UnitsNET.Vectors.Geometry.MonoGame 0.2.8

Thunder.UnitsNET.Vectors.Geometry.MonoGame

MonoGame / XNA integration for Thunder.UnitsNET.Vectors.Geometry.

Provides extension methods to convert unit-aware 2D geometry shapes — circles, rectangles, triangles, ellipses, arcs, sectors, capsules, and polygons — to XNA/MonoGame rendering primitives. Scaling is explicit: you always supply the unit and pixels-per-unit factor, keeping physics dimensions and screen pixels cleanly separated.

Supported frameworks: net8.0, net10.0

Quick start

// dotnet add package Thunder.UnitsNET.Vectors.Geometry
// dotnet add package Thunder.UnitsNET.Vectors.Geometry.MonoGame

using Thunder.UnitsNET.Vectors.Geometry;
using Thunder.UnitsNET.Vectors.Geometry.MonoGame;
using UnitsNet;
using UnitsNet.Units;
using Microsoft.Xna.Framework;

const double ppm = 64.0; // 64 pixels per metre

// Circle: get centre + radius for a circle-draw call
var circle = new Circle2(LengthVector2.FromMeters(5, 3), Radius.FromMeters(2));
Vector2 center = circle.GetXnaCenter(LengthUnit.Meter, ppm);   // (320, 192)
float   radius = circle.GetXnaRadius(LengthUnit.Meter, ppm);   // 128f

// Rectangle: get the four corners for a rotated-quad renderer
var rect = new Rectangle2(
    LengthVector2.FromMeters(0, 0),
    LengthVector2.FromMeters(4, 2),
    Directional.FromDegrees(30));
Vector2[] corners = rect.GetXnaCorners(LengthUnit.Meter, ppm);

// Triangle: get vertex array
var tri = new Triangle2(
    LengthVector2.FromMeters(0, 0),
    LengthVector2.FromMeters(3, 0),
    LengthVector2.FromMeters(1.5, 2));
Vector2[] verts = tri.GetXnaVertices(LengthUnit.Meter, ppm);

// Arc: get polyline for a line-strip renderer
var arc = new Arc2(
    new Circle2(LengthVector2.FromMeters(0, 0), Radius.FromMeters(5)),
    Directional.East,
    Angle.FromDegrees(90));
Vector2[] arcPoints = arc.GetXnaPolyline(LengthUnit.Meter, ppm);

// Polygon
var hex = Polygon2.CreateRegular(LengthVector2.FromMeters(0, 0), Length.FromMeters(3), 6);
Vector2[] hexVerts = hex.GetXnaVertices(LengthUnit.Meter, ppm);

// Directional → XNA rotation float (radians)
float rot = Directional.North.ToXnaRotation(); // MathF.PI / 2

Conversion API

GeometryXnaExtensions

All methods follow the pattern GetXnaXxx(LengthUnit unit, double scale) with convenience overloads that default scale = 1.0 and/or unit = LengthUnit.Meter.

Circle2

Rectangle2

Triangle2

Ellipse2

Arc2

Sector2

Capsule2

Polygon2

Directional

Scale parameter

scale is "pixels per unit". Examples:

• 64.0 → 1 metre = 64 pixels (tile-based game)
• 1.0 → 1 metre = 1 pixel (already in screen units)
• 100.0 → 1 metre = 100 pixels

Pass your pixels-per-unit constant at the call site rather than storing it as a global.

MonoGame dependency note

MonoGame.Framework.DesktopGL is declared as PrivateAssets="all" in this package. Add your own platform-specific MonoGame package to your game project.

Source repository

thunder-unitsnet-vectors