Thunder.UnitsNET.Vectors 0.7.0

Thunder.UnitsNET.Vectors

A unit-aware 2D/3D vector library for physics-driven game loops. Component types come from UnitsNet, so every operation preserves physical units — LengthVector2 / Duration returns SpeedVector2, not a raw float.

Supported frameworks: net8.0, net10.0

Quick start

using Thunder.UnitsNET.Vectors;
using UnitsNet;
using UnitsNet.Units;

// Position
var position = new LengthVector2(
    Length.FromMeters(3),
    Length.FromMeters(4));

// Kinematics: displacement over time → velocity
SpeedVector2 velocity = position / Duration.FromSeconds(2);

// Dynamics: F = ma
var accel = new AccelerationVector2(
    Acceleration.FromMetersPerSecondSquared(9.8),
    Acceleration.FromMetersPerSecondSquared(0));
ForceVector2 force = accel * Mass.FromKilograms(5);

// Dot product: work = F · d  (yields Energy)
Energy work = force.Dot(position);

// Normalize to a unit DoubleVector2 direction
DoubleVector2 dir = position.Normalize();

// Scalar magnitude
Length mag = position.Magnitude();

Kinematic operator chains

The same chains exist for all Vector3 variants.

Type inventory

2D types

3D types

Common API (all types)

What's new in v0.5.0

Unit-preserving operators — Jerk × Duration, Force × Duration, and Speed × Mass operators across all V2 and V3 types now preserve the caller's unit choice. Unit-mapping switches replace the previous SI-forced extraction pattern. Length.FromFeet(3) * Speed.FromFeetPerSecond(4) returns Momentum in FootPoundPerSecond, not KilogramMeterPerSecond.

Angular dynamics — TorqueVector3, RotationalSpeedVector3, RotationalAccelerationVector3 with cross-type operators: TorqueVector3 / MomentOfInertia → RotationalAccelerationVector3, RotationalSpeedVector3 × Duration → Angle, and scalar multiplication. All types are source-generated — zero hand-written boilerplate.

Polar constructors and dimension lifting — LengthVector2.FromPolar(Radius, Angle) constructs a vector from magnitude and direction. LengthVector2.Extend(z) → LengthVector3 lifts into 3D; LengthVector3.Truncate() → LengthVector2 drops the Z component.

See also — CHANGELOG.md for full Phase 5 release notes (M27–M31.2).

What's new in v0.4.0

Physics integration — PhysicsIntegration in Thunder.UnitsNET.Vectors provides unit-correct Euler, Velocity Verlet, drag, and friction helpers. All methods return unit-typed results; no raw double arithmetic at call sites.

Performance — All Phase 4 hot paths benchmarked and profiled. Zero heap allocation across all manifold, raycasting, path, and physics APIs. Rectangle_Rectangle manifold: 1,466 ns → 124 ns (colliding, 11.8×) / 27 ns (non-colliding, 44×) via inline raw-double OBB-OBB SAT.

MathExtensions optimization — Squared(Length) and Sqrt(Area) are now unit-preserving and zero ToUnit() calls. Length.FromFeet(4).Squared() returns Area in SquareFoot.

See also — CHANGELOG.md for the full Phase 4 release notes (M19–M26.2).

What's new in v0.3.0

Performance — Magnitude improved from 5.1 ns to 1.93 ns; Normalize is proportionally faster. All unit vector types now embed DoubleVector2/DoubleVector3 as their backing field, delegating raw math to a single authoritative layer. A future improvement to DoubleVector2/3 propagates automatically to all 23 types.

Build hygiene — Zero compiler warnings. CS1574 promoted to WarningsAsErrors.

See also — CHANGELOG.md for the full Phase 3 release notes covering M13–M18.2 (spatial queries, camera/viewport, generator improvements, benchmark suite, and internal representation overhaul).

📖 API docs · 💻 Source

Packages in this family

	Thunder.UnitsNET.Vectors — Core vector types (this package)
	Thunder.UnitsNET.Vectors.MonoGame — XNA/MonoGame conversions
	Thunder.UnitsNET.Vectors.Geometry — Unit-aware 2D geometry
	Thunder.UnitsNET.Vectors.Geometry.MonoGame — Geometry → MonoGame