Regenerate from latest Box2D

Author: Thomas Vantroyen

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.6</Version>
+		<Version>3.1.8.7</Version>
 	</PropertyGroup>
 
 	<ItemGroup>

Box2dNet/Interop/B2Api.cs

@@ -1,4 +1,4 @@
-// Generated by Box2dNetGen for Box2D v3 on 02/11/2025 15:17:57
+// Generated by Box2dNetGen for Box2D v3 on 11/01/2026 07:32:50
 
 using System.Runtime.InteropServices;
 using System.Numerics;
@@ -404,10 +404,14 @@ public enum b2HexColor
   /// <returns>Original C type: void</returns>
   /// <param name="mem">the memory previously allocated through `b2AllocFcn`
   /// (Original C type: void*)</param>
+  /// <param name="size">the allocation size in bytes
+  /// (Original C type: unsigned int)</param>
   /// <param name="mem">the memory previously allocated through `b2AllocFcn`
   /// (Original C type: void*)</param>
+  /// <param name="size">the allocation size in bytes
+  /// (Original C type: unsigned int)</param>
   [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
-  public delegate void b2FreeFcn(IntPtr /* void* */ mem);
+  public delegate void b2FreeFcn(IntPtr /* void* */ mem, uint size);
 
   /// <summary>
   /// Prototype for the user assert callback. Return 0 to skip the debugger break.
@@ -419,6 +423,14 @@ public enum b2HexColor
   [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
   public delegate int b2AssertFcn(string condition, string fileName, int lineNumber);
 
+  /// <summary>
+  /// Prototype for user log callback. Used to log warnings.
+  /// </summary>
+  /// <returns>Original C type: void</returns>
+  /// <param name="message">(Original C type: const char*)</param>
+  [UnmanagedFunctionPointer(CallingConvention.Cdecl)]
+  public delegate void b2LogFcn(string message);
+
   /// <summary>
   /// This function receives proxies found in the AABB query.
   /// @return true if the query should continue
@@ -1687,6 +1699,8 @@ public partial struct b2ManifoldPoint
   /// <summary>
   /// The total normal impulse applied across sub-stepping and restitution. This is important
   /// to identify speculative contact points that had an interaction in the time step.
+  /// This includes the warm starting impulse, the sub-step delta impulse, and the restitution
+  /// impulse.
   /// </summary>
   /// <returns>Original C type: float</returns>
   public float totalNormalImpulse;
@@ -2469,10 +2483,20 @@ public partial struct b2BodyDef
   public bool isAwake;
 
   /// <summary>
-  /// Treat this body as high speed object that performs continuous collision detection
+  /// Treat this body as a high speed object that performs continuous collision detection
   /// against dynamic and kinematic bodies, but not other bullet bodies.
   /// @warning Bullets should be used sparingly. They are not a solution for general dynamic-versus-dynamic
-  /// continuous collision.
+  /// continuous collision. They do not guarantee accurate collision if both bodies are fast moving because
+  /// the bullet does a continuous check after all non-bullet bodies have moved. You could get unlucky and have
+  /// the bullet body end a time step very close to a non-bullet body and the non-bullet body then moves over
+  /// the bullet body. In continuous collision, initial overlap is ignored to avoid freezing bodies in place.
+  /// I do not recommend using them for game projectiles if precise collision timing is needed. Instead consider
+  /// using a ray or shape cast. You can use a marching ray or shape cast for projectile that moves over time.
+  /// If you want a fast moving projectile to collide with a fast moving target, you need to consider the relative
+  /// movement in your ray or shape cast. This is out of the scope of Box2D.
+  /// So what are good use cases for bullets? Pinball games or games with dynamic containers that hold other objects.
+  /// It should be a use case where it doesn't break the game if there is a collision missed, but the having them
+  /// captured improves the quality of the game.
   /// </summary>
   /// <returns>Original C type: bool</returns>
   [MarshalAs(UnmanagedType.U1)]
@@ -2742,6 +2766,7 @@ public partial struct b2ShapeDef
 
   /// <summary>
   /// Should the body update the mass properties when this shape is created. Default is true.
+  /// Warning: if this is true, you MUST call b2Body_ApplyMassFromShapes before simulating the world.
   /// </summary>
   /// <returns>Original C type: bool</returns>
   [MarshalAs(UnmanagedType.U1)]
@@ -2801,7 +2826,8 @@ public partial struct b2ChainDef
 
   /// <summary>
   /// The material count. Must be 1 or count. This allows you to provide one
-  /// material for all segments or a unique material per segment.
+  /// material for all segments or a unique material per segment. For open
+  /// chains, the material on the ghost segments are place holders.
   /// </summary>
   /// <returns>Original C type: int</returns>
   public int materialCount;
@@ -3174,13 +3200,13 @@ public partial struct b2DistanceJointDef
   public bool enableLimit;
 
   /// <summary>
-  /// Minimum length. Clamped to a stable minimum value.
+  /// Minimum length for limit. Clamped to a stable minimum value.
   /// </summary>
   /// <returns>Original C type: float</returns>
   public float minLength;
 
   /// <summary>
-  /// Maximum length. Must be greater than or equal to the minimum length.
+  /// Maximum length for limit. Must be greater than or equal to the minimum length.
   /// </summary>
   /// <returns>Original C type: float</returns>
   public float maxLength;
@@ -3860,6 +3886,14 @@ public partial struct b2ContactHitEvent
   /// <returns>Original C type: b2ShapeId</returns>
   public b2ShapeId shapeIdB;
 
+  /// <summary>
+  /// Id of the contact.
+  /// @warning this contact may have been destroyed
+  /// @see b2Contact_IsValid
+  /// </summary>
+  /// <returns>Original C type: b2ContactId</returns>
+  public b2ContactId contactId;
+
   /// <summary>
   /// Point where the shapes hit at the beginning of the time step.
   /// This is a mid-point between the two surfaces. It could be at speculative
@@ -3880,10 +3914,11 @@ public partial struct b2ContactHitEvent
   /// <returns>Original C type: float</returns>
   public float approachSpeed;
 
-  public b2ContactHitEvent(in b2ShapeId shapeIdA, in b2ShapeId shapeIdB, in Vector2 point, in Vector2 normal, in float approachSpeed)
+  public b2ContactHitEvent(in b2ShapeId shapeIdA, in b2ShapeId shapeIdB, in b2ContactId contactId, in Vector2 point, in Vector2 normal, in float approachSpeed)
   {
     this.shapeIdA = shapeIdA;
     this.shapeIdB = shapeIdB;
+    this.contactId = contactId;
     this.point = point;
     this.normal = normal;
     this.approachSpeed = approachSpeed;
@@ -4170,7 +4205,7 @@ public static void b2SetAllocator(b2AllocFcn allocFcn, b2FreeFcn freeFcn)
 public static extern int b2GetByteCount();
 
   /// <summary>
-  /// Override the default assert callback
+  /// Override the default assert function
   /// </summary>
   /// <returns>Original C type: void</returns>
   /// <param name="assertFcn">a non-null assert callback
@@ -4181,7 +4216,7 @@ public static void b2SetAllocator(b2AllocFcn allocFcn, b2FreeFcn freeFcn)
 public static extern void b2SetAssertFcn(IntPtr assertFcn);
 
   /// <summary>
-  /// Override the default assert callback
+  /// Override the default assert function
   /// </summary>
   /// <returns>Original C type: void</returns>
   /// <param name="assertFcn">a non-null assert callback
@@ -4193,6 +4228,30 @@ public static void b2SetAssertFcn(b2AssertFcn assertFcn)
     b2SetAssertFcn(Marshal.GetFunctionPointerForDelegate(assertFcn));
 }
 
+  /// <summary>
+  /// Override the default log function
+  /// </summary>
+  /// <returns>Original C type: void</returns>
+  /// <param name="logFcn">a non-null log callback
+  /// (Original C type: b2LogFcn*)</param>
+  /// <param name="logFcn">a non-null log callback
+  /// (Original C type: b2LogFcn*)</param>
+[DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
+public static extern void b2SetLogFcn(IntPtr logFcn);
+
+  /// <summary>
+  /// Override the default log function
+  /// </summary>
+  /// <returns>Original C type: void</returns>
+  /// <param name="logFcn">a non-null log callback
+  /// (Original C type: b2LogFcn*)</param>
+  /// <param name="logFcn">a non-null log callback
+  /// (Original C type: b2LogFcn*)</param>
+public static void b2SetLogFcn(b2LogFcn logFcn)
+{
+    b2SetLogFcn(Marshal.GetFunctionPointerForDelegate(logFcn));
+}
+
   /// <summary>
   /// Get the current version of Box2D
   /// </summary>
@@ -5032,15 +5091,28 @@ public static void b2World_SetRestitutionCallback(b2WorldId worldId, b2Restituti
   /// <summary>
   /// Set the velocity to reach the given transform after a given time step.
   /// The result will be close but maybe not exact. This is meant for kinematic bodies.
-  /// The target is not applied if the velocity would be below the sleep threshold.
-  /// This will automatically wake the body if asleep.
+  /// The target is not applied if the velocity would be below the sleep threshold and
+  /// the body is currently asleep.
   /// </summary>
   /// <returns>Original C type: void</returns>
-  /// <param name="bodyId">(Original C type: b2BodyId)</param>
-  /// <param name="target">(Original C type: b2Transform)</param>
-  /// <param name="timeStep">(Original C type: float)</param>
+  /// <param name="bodyId">The body id
+  /// (Original C type: b2BodyId)</param>
+  /// <param name="target">The target transform for the body
+  /// (Original C type: b2Transform)</param>
+  /// <param name="timeStep">The time step of the next call to b2World_Step
+  /// (Original C type: float)</param>
+  /// <param name="wake">Option to wake the body or not
+  /// (Original C type: bool)</param>
+  /// <param name="bodyId">The body id
+  /// (Original C type: b2BodyId)</param>
+  /// <param name="target">The target transform for the body
+  /// (Original C type: b2Transform)</param>
+  /// <param name="timeStep">The time step of the next call to b2World_Step
+  /// (Original C type: float)</param>
+  /// <param name="wake">Option to wake the body or not
+  /// (Original C type: bool)</param>
 [DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
-public static extern void b2Body_SetTargetTransform(b2BodyId bodyId, b2Transform target, float timeStep);
+public static extern void b2Body_SetTargetTransform(b2BodyId bodyId, b2Transform target, float timeStep, [MarshalAs(UnmanagedType.U1)] bool wake);
 
   /// <summary>
   /// Get the linear velocity of a local point attached to a body. Usually in meters per second.
@@ -5125,6 +5197,19 @@ public static void b2World_SetRestitutionCallback(b2WorldId worldId, b2Restituti
 [DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
 public static extern void b2Body_ApplyTorque(b2BodyId bodyId, float torque, [MarshalAs(UnmanagedType.U1)] bool wake);
 
+  /// <summary>
+  /// Clear the force and torque on this body. Forces and torques are automatically cleared after each world
+  /// step. So this only needs to be called if the application wants to remove the effect of previous
+  /// calls to apply forces and torques before the world step is called.
+  /// </summary>
+  /// <returns>Original C type: void</returns>
+  /// <param name="bodyId">The body id
+  /// (Original C type: b2BodyId)</param>
+  /// <param name="bodyId">The body id
+  /// (Original C type: b2BodyId)</param>
+[DllImport(Box2DLibrary, CallingConvention = CallingConvention.Cdecl)]
+public static extern void b2Body_ClearForces(b2BodyId bodyId);
+
   /// <summary>
   /// Apply an impulse at a point. This immediately modifies the velocity.
   /// It also modifies the angular velocity if the point of application
@@ -5557,7 +5642,7 @@ public static void b2World_SetRestitutionCallback(b2WorldId worldId, b2Restituti
   /// <summary>
   /// Create a capsule shape and attach it to a body. The shape definition and geometry are fully cloned.
   /// Contacts are not created until the next time step.
-  /// @return the shape id for accessing the shape
+  /// @return the shape id for accessing the shape, this will be b2_nullShapeId if the length is too small.
   /// </summary>
   /// <returns>Original C type: b2ShapeId</returns>
   /// <param name="bodyId">(Original C type: b2BodyId)</param>

Box2dNet/box2d.dll

@@ -196,43 +196,17 @@ Build the now updated Box2dNet solution and use the dll in your game, or directl
 
 # History
 
-## 2025/11/02: v3.1.8.6 for Box2D v3.1.1
-
-* Regenerated for latest commits on Box2D
-
-## 2025/08/03: v3.1.8.5 for Box2D v3.1.1
-
-* Regenerated for latest commits on Box2D
-* Messed up a few version numbers...
-
-## 2025/06/29: v3.1.8.2 for Box2D v3.1.1
-
-* Regenerated for latest commits on Box2D
-
-## 2025/06/22: v3.1.8 for Box2D v3.1.1
-
-* Started with the Box2D samples app rewritten in .NET + MonoGame: contains 1 sample now
-* B2DebugDraw struct bug fixed.
-
-## 2025/06/15: v3.1.7 for Box2D v3.1.1
-
-* Regenerated for updated Box2D 
-* Quite some changes in the Box2D original code since previous time. Box2dNetGen was refactored and adjusted accordingly.
+* 2026/01/11: v3.1.8.7 - Regenerated
+* 2025/11/02: v3.1.8.6 - Regenerated
+* 2025/08/03: v3.1.8.5 - Regenerated
+* 2025/06/29: v3.1.8.2 - Regenerated
+* 2025/06/22: v3.1.8 - Regenerated + 1 Box2D sample rewritten in .NET + MonoGame + B2DebugDraw struct bug fixed.
+* 2025/06/15: v3.1.7 - Regenerated + Box2dNetGen was refactored according to many changes in Box2D C code.
 
 > Box2D started using 3-part version labels. This messed up Box2dNet's versioning where the first two parts were Box2D's version and the third was for Box2dNet changes. I will switch to another system as of Box2D v3.2.0
 
-## 2025/06/15: v3.1.6 for Box2D v3.1
-
-* Small adjustment for Godot. https://github.com/thomasvt/Box2DNet/issues/2
-
-## 2025/05/06: v3.1.5 for Box2D v3.1
-
-* Added Span-based convenience properties like `b2BodyEvents.moveEventsAsSpan`.
-* Box2d API methods that take delegate pointers (IntPtr) were annoying to use as you couldn't see the actual delegate. Box2DNet now also generates an overload for these methods with the actual delegate as parameter. eg. `b2World_CastShape(b2WorldId worldId, in b2ShapeProxy proxy, Vector2 translation, b2QueryFilter filter, __b2CastResultFcn fcn__, IntPtr context)`
-
-## 2025/05/04: v3.1.4 for Box2D v3.1
-
-* Regenerated for updated Box2D
-* Started publishing `Box2dNet` as a nuget package
+* 2025/06/15: v3.1.6 - regenerated for Box2D v3.1 + https://github.com/thomasvt/Box2DNet/issues/2
+* 2025/05/06: v3.1.5 - regenerated for Box2D v3.1 + Span-based convenience properties + overloads with strongly typed delegates
+* 2025/05/04: v3.1.4 - regenerated for Box2D v3.1 + Started publishing `Box2dNet` as a nuget package
 
 ... older history not logged ...