Class DebugDrawExtensions

Namespace

Thunder.UnitsNET.Vectors.Geometry.MonoGame

Assembly

Thunder.UnitsNET.Vectors.Geometry.MonoGame.dll

Core DebugDraw infrastructure for rendering geometry shapes as wireframes using MonoGame's Microsoft.Xna.Framework.Graphics.SpriteBatch and a 1×1 pixel Microsoft.Xna.Framework.Graphics.Texture2D technique.

public static class DebugDrawExtensions

Inheritance

object

DebugDrawExtensions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

Typical usage:

// Once at startup:
var pixel = DebugDrawExtensions.CreatePixelTexture(GraphicsDevice);

// Each frame, inside a SpriteBatch.Begin/End block:
myCircle.DebugDraw(spriteBatch, pixel, worldToScreen, Color.Red);
myRect.DebugDraw(spriteBatch, pixel, worldToScreen, Color.Green);

The worldToScreen Transform2 encodes the camera:

• PositionScreen-space origin expressed as metre-lengths (e.g. screen centre (400, 300) = LengthPoint2.FromMeters(400, 300)).
• ScalePixels per physical metre (e.g. Ratio.FromDecimalFractions(64) = 1m = 64px).
• RotationCamera rotation (usually Direction2.East for no rotation).

Methods

CreatePixelTexture(GraphicsDevice)

Creates a 1×1 white pixel Microsoft.Xna.Framework.Graphics.Texture2D suitable for use with DrawLine(SpriteBatch, Texture2D, Vector2, Vector2, Color, float) and all DebugDraw extension methods.

public static Texture2D CreatePixelTexture(GraphicsDevice graphicsDevice)

Parameters

graphicsDevice GraphicsDevice

The active Microsoft.Xna.Framework.Graphics.GraphicsDevice.

Returns

Texture2D

A 1×1 Microsoft.Xna.Framework.Graphics.Texture2D filled with Microsoft.Xna.Framework.Color.White.

Examples

Texture2D pixel = DebugDrawExtensions.CreatePixelTexture(GraphicsDevice);

DrawLine(SpriteBatch, Texture2D, Vector2, Vector2, Color, float)

Draws a line between two screen-space points using a 1×1 pixel Microsoft.Xna.Framework.Graphics.Texture2D stretched and rotated to match the line direction and length.

public static void DrawLine(this SpriteBatch sb, Texture2D pixel, Vector2 from, Vector2 to, Color color, float thickness = 1)

Parameters

sb SpriteBatch

The Microsoft.Xna.Framework.Graphics.SpriteBatch to draw with. Must be in an active Begin/End block.

pixel Texture2D

A 1×1 white pixel texture (see CreatePixelTexture(GraphicsDevice)).

from Vector2

Start point in screen pixels.

to Vector2

End point in screen pixels.

color Color

Line colour.

thickness float

Line thickness in pixels. Defaults to 1.

Examples

spriteBatch.DrawLine(pixel, new Vector2(0, 0), new Vector2(100, 100), Color.Red, 2f);

WorldToScreen(LengthPoint2, Transform2)

Converts a world-space LengthPoint2 to a screen-space Microsoft.Xna.Framework.Vector2 using the given world-to-screen Transform2.

public static Vector2 WorldToScreen(LengthPoint2 worldPoint, Transform2 worldToScreen)

Parameters

worldPoint LengthPoint2

The point in world space.

worldToScreen Transform2

The camera transform. Position = screen origin (in metre-pixels), Scale = pixels per metre.

Returns

Vector2

Screen-space position in pixels.