Regen for latest Box2D + some new issues fixed

Author: thomasvt

Box2dNet.Samples/Box2dMeshDrawer.cs

@@ -94,7 +94,7 @@ public void DrawWorld(b2WorldId worldId)
                 drawJointExtras = false,
                 drawBounds = false,
                 drawMass = false,
-                drawContactPoints = false,
+                contactDrawType = b2ContactDrawType.b2_drawContacts_None,
                 drawGraphColors = false,
                 drawContactNormals = false,
                 drawContactForces = false,

Box2dNet/Box2dNet.csproj

@@ -14,7 +14,7 @@
 		<RepositoryUrl>https://github.com/thomasvt/Box2D3Net</RepositoryUrl>
 		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 		<NoWarn>$(NoWarn);1591</NoWarn> <!-- suppress warnings for missing docs -->
-		<Version>3.1.8.7</Version>
+		<Version>3.1.8.8</Version>
 	</PropertyGroup>
 
 	<ItemGroup>

Box2dNet/Interop/B2Api.DebugDraw.cs

@@ -121,6 +121,8 @@ public struct b2DebugDraw
         /// Global scaling for joint drawing
         public float jointScale;
 
+        public b2ContactDrawType contactDrawType;
+
         /// Option to draw shapes
         [MarshalAs(UnmanagedType.U1)] public bool drawShapes;
 
@@ -139,9 +141,6 @@ public struct b2DebugDraw
         /// Option to draw body names
         [MarshalAs(UnmanagedType.U1)] public bool drawBodyNames;
 
-        /// Option to draw contact points
-        [MarshalAs(UnmanagedType.U1)] public bool drawContactPoints;
-
         /// Option to visualize the graph coloring used for contacts and joints
         [MarshalAs(UnmanagedType.U1)] public bool drawGraphColors;
 

Box2dNet/Interop/B2Api.cs

@@ -1,4 +1,4 @@
-// Generated by Box2dNetGen for Box2D v3 on 11/01/2026 07:32:50
+// Generated by Box2dNetGen for Box2D v3 on 25/03/2026 10:57:19
 
 using System.Runtime.InteropServices;
 using System.Numerics;
@@ -383,6 +383,20 @@ public enum b2HexColor
   b2_colorBox2DGreen = 0x8CC924,
 }
 
+public enum b2ContactDrawType
+{
+
+  b2_drawContacts_None = 0,
+
+  b2_drawContacts_Clip = 1,
+
+  b2_drawContacts_AnchorA = 2,
+
+  b2_drawContacts_AnchorB = 3,
+
+  b2_drawContacts_Average = 4,
+}
+
   /// <summary>
   /// Prototype for user allocation function
   /// </summary>
@@ -1658,21 +1672,26 @@ public partial struct b2ManifoldPoint
 {
 
   /// <summary>
-  /// Location of the contact point in world space. Subject to precision loss at large coordinates.
-  /// @note Should only be used for debugging.
+  /// Location of the contact point in world space when first clipped. Subject to precision
+  /// loss at large coordinates. This point lags behind when contact recycling is used.
+  /// @note Should only be used for debugging. Use anchorA and/or anchorB for game logic.
   /// </summary>
   /// <returns>Original C type: b2Vec2</returns>
-  public Vector2 point;
+  public Vector2 clipPoint;
 
   /// <summary>
-  /// Location of the contact point relative to shapeA's origin in world space
+  /// Location of the contact point relative to shapeA's origin in world space.
+  /// This can be converted to a world point using:
+  /// b2Vec2 worldPointA = b2Add(b2Body_GetCenter(myBodyIdA), anchorA);
   /// @note When used internally to the Box2D solver, this is relative to the body center of mass.
   /// </summary>
   /// <returns>Original C type: b2Vec2</returns>
   public Vector2 anchorA;
 
   /// <summary>
   /// Location of the contact point relative to shapeB's origin in world space
+  /// This can be converted to a world point using:
+  /// b2Vec2 worldPointB = b2Add(b2Body_GetCenter(myBodyIdB), anchorB);
   /// @note When used internally to the Box2D solver, this is relative to the body center of mass.
   /// </summary>
   /// <returns>Original C type: b2Vec2</returns>
@@ -1684,6 +1703,12 @@ public partial struct b2ManifoldPoint
   /// <returns>Original C type: float</returns>
   public float separation;
 
+  /// <summary>
+  /// Cached separation used for contact recycling
+  /// </summary>
+  /// <returns>Original C type: float</returns>
+  public float baseSeparation;
+
   /// <summary>
   /// The impulse along the manifold normal vector.
   /// </summary>
@@ -1725,12 +1750,13 @@ public partial struct b2ManifoldPoint
   [MarshalAs(UnmanagedType.U1)]
   public bool persisted;
 
-  public b2ManifoldPoint(in Vector2 point, in Vector2 anchorA, in Vector2 anchorB, in float separation, in float normalImpulse, in float tangentImpulse, in float totalNormalImpulse, in float normalVelocity, in ushort id, in bool persisted)
+  public b2ManifoldPoint(in Vector2 clipPoint, in Vector2 anchorA, in Vector2 anchorB, in float separation, in float baseSeparation, in float normalImpulse, in float tangentImpulse, in float totalNormalImpulse, in float normalVelocity, in ushort id, in bool persisted)
   {
-    this.point = point;
+    this.clipPoint = clipPoint;
     this.anchorA = anchorA;
     this.anchorB = anchorB;
     this.separation = separation;
+    this.baseSeparation = baseSeparation;
     this.normalImpulse = normalImpulse;
     this.tangentImpulse = tangentImpulse;
     this.totalNormalImpulse = totalNormalImpulse;
@@ -2727,21 +2753,24 @@ public partial struct b2ShapeDef
   public bool isSensor;
 
   /// <summary>
-  /// Enable sensor events for this shape. This applies to sensors and non-sensors. False by default, even for sensors.
+  /// Enable sensor events for this shape. This applies to sensors and non-sensors. Both shapes involved must have this flag set to true.
+  /// False by default, even for sensors.
   /// </summary>
   /// <returns>Original C type: bool</returns>
   [MarshalAs(UnmanagedType.U1)]
   public bool enableSensorEvents;
 
   /// <summary>
-  /// Enable contact events for this shape. Only applies to kinematic and dynamic bodies. Ignored for sensors. False by default.
+  /// Enable contact events for this shape. Only applies to kinematic and dynamic bodies. Only one shape involved needs this flag set to true.
+  /// Ignored for sensors. False by default.
   /// </summary>
   /// <returns>Original C type: bool</returns>
   [MarshalAs(UnmanagedType.U1)]
   public bool enableContactEvents;
 
   /// <summary>
-  /// Enable hit events for this shape. Only applies to kinematic and dynamic bodies. Ignored for sensors. False by default.
+  /// Enable hit events for this shape. Only applies to kinematic and dynamic bodies. Only one shape involved needs this flag set to true.
+  /// Ignored for sensors. False by default.
   /// </summary>
   /// <returns>Original C type: bool</returns>
   [MarshalAs(UnmanagedType.U1)]
@@ -4166,6 +4195,21 @@ public static partial class B2Api
   /// <returns>Original C type: int</returns>
 public const int B2_MAX_POLYGON_VERTICES = 8;
 
+  /// <returns>Original C type: int</returns>
+public const int B2_MAX_WORKERS = 64;
+
+  /// <returns>Original C type: int</returns>
+public const int B2_GRAPH_COLOR_COUNT = 24;
+
+  /// <returns>Original C type: int</returns>
+public const int B2_MAX_WORLDS = 128;
+
+  /// <returns>Original C type: float</returns>
+public const float B2_AABB_MARGIN_FRACTION = 0.125f;
+
+  /// <returns>Original C type: float</returns>
+public const float B2_TIME_TO_SLEEP = 0.5f;
+
   /// <summary>
   /// https://en.wikipedia.org/wiki/Pi
   /// </summary>
@@ -4764,6 +4808,24 @@ public static void b2World_SetPreSolveCallback(b2WorldId worldId, b2PreSolveFcn
 [DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
 public static extern void b2World_SetContactTuning(b2WorldId worldId, float hertz, float dampingRatio, float pushSpeed);
 
+  /// <summary>
+  /// Set the contact point recycling distance. Setting this to zero disables contact point recycling.
+  /// Usually in meters.
+  /// </summary>
+  /// <returns>Original C type: void</returns>
+  /// <param name="worldId">(Original C type: b2WorldId)</param>
+  /// <param name="recycleDistance">(Original C type: float)</param>
+[DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
+public static extern void b2World_SetContactRecycleDistance(b2WorldId worldId, float recycleDistance);
+
+  /// <summary>
+  /// Get the contact point recycling distance. Usually in meters.
+  /// </summary>
+  /// <returns>Original C type: float</returns>
+  /// <param name="worldId">(Original C type: b2WorldId)</param>
+[DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
+public static extern float b2World_GetContactRecycleDistance(b2WorldId worldId);
+
   /// <summary>
   /// Set the maximum linear speed. Usually in m/s.
   /// </summary>
@@ -6050,7 +6112,7 @@ public static void b2World_SetRestitutionCallback(b2WorldId worldId, b2Restituti
   /// <summary>
   /// Get the maximum capacity required for retrieving all the overlapped shapes on a sensor shape.
   /// This returns 0 if the provided shape is not a sensor.
-  /// @returns the required capacity to get all the overlaps in b2Shape_GetSensorOverlaps
+  /// @returns the required capacity to get all the overlaps in b2Shape_GetSensorData
   /// </summary>
   /// <returns>Original C type: int</returns>
   /// <param name="shapeId">the id of a sensor shape
@@ -6061,7 +6123,7 @@ public static void b2World_SetRestitutionCallback(b2WorldId worldId, b2Restituti
 public static extern int b2Shape_GetSensorCapacity(b2ShapeId shapeId);
 
   /// <summary>
-  /// Get the overlap data for a sensor shape.
+  /// Get the overlap data for a sensor shape computed the previous world step.
   /// @returns the number of elements filled in the provided array
   /// @warning do not ignore the return value, it specifies the valid number of elements
   /// @warning overlaps may contain destroyed shapes so use b2Shape_IsValid to confirm each overlap

Box2dNet/box2d.dll

@@ -1,4 +1,5 @@
-using System.Text.RegularExpressions;
+using System.Diagnostics;
+using System.Text.RegularExpressions;
 
 namespace Box2dNetGen.Extractors
 {
@@ -9,12 +10,17 @@ internal class ConstantsExtractor
         /// <summary>
         /// Extracts all `#define` constants that are useful for Box2dNet.
         /// </summary>
-        public static IEnumerable<ApiConstant> ExtractAllPrecompilerDefines(string src)
+        public static IEnumerable<ApiConstant> ExtractAllPrecompilerDefines(List<string> ignoreList, string src)
         {
             foreach (Match match in ApiConstantRegex.Matches(src))
             {
                 var identifier = match.Groups["identifier"].Value;
-                if (identifier.Contains('(')) continue; // skip #define's of functions
+                
+                if (ignoreList.Contains(identifier)) 
+                    continue;
+                if (identifier.Contains('(')) 
+                    continue; // skip #define's of functions
+
                 var value = match.Groups["value"].Value.Trim();
                 var type = value.Contains('.') ? "float" : "int";
                 if (type == "float" && !value.EndsWith("f")) value += "f";

Box2dNet/box2dd.dll

@@ -30,6 +30,8 @@ internal class Program
             { "b2Vec2", "Vector2" }
         };
 
+        private static readonly List<string> _precompilerConstantsIgnoreList = ["B2_ENABLE_VALIDATION"];
+
         /// <summary>
         /// Logic that decides whether we generate the convenience initializer ctors (ctors with parameters to set all the struct's fields)
         /// </summary>
@@ -78,7 +80,7 @@ private static async Task BuildCsWrapperAsync(string box2dFolder, string csFilen
             var src = await ReadSourceFiles(Path.Combine(box2dFolder, "include\\box2d"));
 
             Console.WriteLine("\n\nParsing C ...");
-            var constants = ConstantsExtractor.ExtractAllPrecompilerDefines(src).ToList();
+            var constants = ConstantsExtractor.ExtractAllPrecompilerDefines(_precompilerConstantsIgnoreList, src).ToList();
             var structs = new StructsExtractor(_excludedTypes, _structFieldModifiers).ExtractAllStructs(src).ToList();
             var delegates = DelegatesExtractor.ExtractAllDelegates(src).ToList();
             var functions = ApiFunctionsExtractor.ExtractAllApiFunctions(src).ToList();

Box2dNetGen/Box2dNetGen/Extractors/ConstantsExtractor.cs

@@ -154,7 +154,7 @@ There are now two folders with samples:
 
 # Regenerating the wrapper
 
-Normally, you don't need to regenerate the wrapper yourself. I regenerate every few weeks for the latest version of Box2D. The resulting Win x64 DLLs (debug and release) are also included in this repo and in the Nuget package. 
+Normally, you don't need to regenerate the wrapper yourself. I regenerate every few weeks/months for the latest version of Box2D depending on how active the project is. The resulting Win x64 DLLs (debug and release) are also included in this repo and in the Nuget package. 
 
 But if you need to do it yourself anyway, perform these steps:
 
@@ -196,6 +196,7 @@ Build the now updated Box2dNet solution and use the dll in your game, or directl
 
 # History
 
+* 2026/03/25: v3.1.8.8 - Regenerated
 * 2026/01/11: v3.1.8.7 - Regenerated
 * 2025/11/02: v3.1.8.6 - Regenerated
 * 2025/08/03: v3.1.8.5 - Regenerated