box3d/samples/sample_issues.cpp

1983 lines
66 KiB
C++
Raw Normal View History

// SPDX-FileCopyrightText: 2026 Erin Catto
2026-05-10 13:36:52 -07:00
// SPDX-License-Identifier: MIT
#include "gfx/draw.h"
2026-05-10 13:36:52 -07:00
#include "imgui.h"
#include "mesh_loader.h"
#include "meshoptimizer.h"
2026-05-10 13:36:52 -07:00
#include "sample.h"
#include "box3d/box3d.h"
#include <ctype.h>
#include <iterator>
#include <stdio.h>
#include <stdlib.h>
2026-05-10 13:36:52 -07:00
#include <vector>
class Crash : public Sample
{
public:
explicit Crash( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 45.0f, 30.0f, 15.0f, { 0.0f, 2.0f, 0.0f } );
}
b3BodyId groundId;
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.position = { 0.0f, -1.0f, 0.0f };
groundId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
m_gridMesh = b3CreateGridMesh( 20, 20, 2, 0, true );
b3CreateMeshShape( groundId, &shapeDef, m_gridMesh, b3Vec3_one );
}
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.type = b3_dynamicBody;
bodyDef.position = { 2.0f, 4.0f, 0.0f };
m_bodyId1 = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3BoxHull box = b3MakeBoxHull( 0.5f, 0.5f, 0.5f );
b3CreateHullShape( m_bodyId1, &shapeDef, &box.base );
bodyDef.position = { -2.0f, 4.0f, 0.0f };
m_bodyId2 = b3CreateBody( m_worldId, &bodyDef );
b3CreateHullShape( m_bodyId2, &shapeDef, &box.base );
}
~Crash() override
{
b3DestroyMesh( m_gridMesh );
}
bool DrawControls() override
2026-05-10 13:36:52 -07:00
{
if ( ImGui::Button( "Add Joint" ) )
{
b3WeldJointDef jointDef = b3DefaultWeldJointDef();
jointDef.base.bodyIdA = m_bodyId1;
jointDef.base.bodyIdB = m_bodyId2;
b3CreateWeldJoint( m_worldId, &jointDef );
}
return true;
2026-05-10 13:36:52 -07:00
}
static Sample* Create( SampleContext* context )
{
return new Crash( context );
}
b3BodyId m_bodyId1;
b3BodyId m_bodyId2;
b3MeshData* m_gridMesh;
};
static int sampleCrash = RegisterSample( "Issues", "Crash", Crash::Create );
2026-05-10 13:36:52 -07:00
class MultiplePrismatic : public Sample
{
public:
explicit MultiplePrismatic( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 0.0f, 0.0f, 25.0f, { 0.0f, 5.0f, 0.0f } );
2026-05-10 13:36:52 -07:00
}
b3BodyId groundId;
{
b3BodyDef bodyDef = b3DefaultBodyDef();
groundId = b3CreateBody( m_worldId, &bodyDef );
}
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3BoxHull box = b3MakeBoxHull( 0.5f, 0.5f, 0.5f );
b3PrismaticJointDef jointDef = b3DefaultPrismaticJointDef();
jointDef.base.bodyIdA = groundId;
jointDef.base.localFrameA.p = { 0.0f, 0.0f, 0.0f };
jointDef.base.localFrameB.p = { 0.0f, -0.6f, 0.0f };
jointDef.base.drawScale = 2.0f;
jointDef.base.constraintHertz = 240.0f;
jointDef.lowerTranslation = -6.0f;
jointDef.upperTranslation = 6.0f;
jointDef.enableLimit = true;
for ( int i = 0; i < 6; ++i )
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.position = { 0.0f, 0.6f + 1.2f * i, 0.0f };
bodyDef.type = b3_dynamicBody;
b3BodyId bodyId = b3CreateBody( m_worldId, &bodyDef );
b3CreateHullShape( bodyId, &shapeDef, &box.base );
jointDef.base.bodyIdB = bodyId;
b3CreatePrismaticJoint( m_worldId, &jointDef );
jointDef.base.bodyIdA = bodyId;
jointDef.base.localFrameA.p = { 0.0f, 0.6f, 0.0f };
}
// huge mouse force
m_mouseForceScale = 1000000.0f;
}
static Sample* Create( SampleContext* context )
{
return new MultiplePrismatic( context );
}
};
static int sampleMultiplePrismatic =
RegisterSample( "Issues", "Multiple Prismatic", MultiplePrismatic::Create );
2026-05-10 13:36:52 -07:00
// bad hull SM_Waterfall_MED_Wide_01
static const b3Vec3 waterfallPoints[] = {
{ 0.100183107, -498.925385, -1275.39966 }, { 0.100183107, -498.925415, 0.125000000 },
{ 0.100183107, 486.343750, 0.125000000 }, { 0.100183107, 486.343719, -1275.39966 },
{ -395.117462, 486.343781, -1462.43750 }, { -395.117462, 486.343750, -96.7426758 },
{ -395.117462, -498.925415, -96.7424469 }, { -395.117462, -498.925446, -1462.52612 },
{ -186.979691, 486.294891, -1462.47949 }, { -298.250000, 486.294891, 0.125000000 },
{ -395.121216, 486.294891, -1462.52612 }, { -186.984360, -498.913361, -1462.48413 },
{ -298.250000, -498.913361, 0.125000000 },
};
static const b3Vec3 quadPoints[] = {
{ 100.000000, -142.292389, 130.826111 }, { 99.5354385, -71.3011093, 130.826111 },
{ 99.5930862, -80.1112213, -100.000000 }, { 100.000000, -142.292389, -100.000000 },
{ 99.5930862, -80.1112213, 130.826111 },
};
static const b3Vec3 thinBoxPoints[] = {
{ -11.3861933, -24.2451687, -12.0037909 }, { -11.3889809, -24.2466526, -11.9013014 },
{ -11.3804407, -24.3151531, -12.0046492 }, { -11.3832273, -24.3166409, -11.9021587 },
{ -14.4396200, -24.3636723, -12.1324549 }, { -14.4432650, -24.3655701, -12.0299988 },
{ -14.4356947, -24.4337788, -12.1336164 }, { -14.4393377, -24.4356804, -12.0311594 },
};
// Inline point sets are scaled from centimeters. A null point array is a file in data/hulls.
struct HullSource
{
const char* name;
const b3Vec3* points;
int count;
float scale;
};
static const HullSource hullSources[] = {
{ "waterfall", waterfallPoints, (int)std::size( waterfallPoints ), 0.01f },
{ "quad", quadPoints, (int)std::size( quadPoints ), 0.01f },
{ "thin box", thinBoxPoints, (int)std::size( thinBoxPoints ), 0.01f },
{ "axe.txt", nullptr, 0, 1.0f },
};
static constexpr int hullSourceCount = (int)std::size( hullSources );
// Reads x, y, z triples separated by commas or whitespace. A C source repro is
// also accepted: only the first initializer list is parsed, so counts and other
// numbers in the surrounding code are ignored.
static bool LoadHullPoints( const char* path, std::vector<b3Vec3>* points )
{
points->clear();
FILE* file = fopen( path, "rb" );
if ( file == nullptr )
{
fprintf( stderr, "Failed to open '%s'\n", path );
return false;
}
fseek( file, 0, SEEK_END );
long size = ftell( file );
fseek( file, 0, SEEK_SET );
if ( size < 0 )
{
fprintf( stderr, "Failed to read '%s'\n", path );
fclose( file );
return false;
}
std::vector<char> text( size + 1 );
size_t readCount = fread( text.data(), 1, size, file );
fclose( file );
text[readCount] = '\0';
char* begin = text.data();
char* end = begin + readCount;
for ( char* c = begin; *c != '\0'; ++c )
{
if ( *c != '{' )
{
continue;
}
char* prev = c - 1;
while ( prev >= begin && isspace( (unsigned char)*prev ) )
{
--prev;
}
if ( prev < begin || *prev != '=' )
{
continue;
}
begin = c + 1;
int depth = 1;
for ( end = begin; *end != '\0'; ++end )
{
if ( *end == '{' )
{
depth += 1;
}
else if ( *end == '}' && --depth == 0 )
{
break;
}
}
break;
}
*end = '\0';
std::vector<float> values;
char* cursor = begin;
while ( *cursor != '\0' )
{
char* stop;
float value = strtof( cursor, &stop );
if ( stop == cursor )
{
cursor += 1;
continue;
}
values.push_back( value );
cursor = stop;
}
if ( values.size() % 3 != 0 )
{
fprintf( stderr, "'%s' has %d values, not a multiple of 3\n", path, (int)values.size() );
}
int count = (int)values.size() / 3;
points->resize( count );
for ( int i = 0; i < count; ++i )
{
( *points )[i] = { values[3 * i], values[3 * i + 1], values[3 * i + 2] };
}
return count > 0;
}
2026-05-10 13:36:52 -07:00
class HullCrash : public Sample
{
public:
explicit HullCrash( SampleContext* context )
: Sample( context )
{
m_hull = nullptr;
m_sourceIndex = 3;
m_maxVertexCount = B3_MAX_HULL_VERTICES;
LoadPoints();
CreateHull();
2026-05-10 13:36:52 -07:00
if ( m_context->restart == false )
{
FrameView();
2026-05-10 13:36:52 -07:00
}
}
2026-05-10 13:36:52 -07:00
~HullCrash() override
{
if ( m_hull != nullptr )
{
b3DestroyHull( m_hull );
}
}
void LoadPoints()
{
const HullSource& source = hullSources[m_sourceIndex];
if ( source.points != nullptr )
{
m_points.assign( source.points, source.points + source.count );
}
else
{
char path[64];
snprintf( path, sizeof( path ), "data/hulls/%s", source.name );
LoadHullPoints( path, &m_points );
}
for ( b3Vec3& point : m_points )
{
point = source.scale * point;
}
2026-05-10 13:36:52 -07:00
// The reported failure used the point count as the limit
m_maxVertexCount = b3ClampInt( (int)m_points.size(), 4, B3_MAX_HULL_VERTICES );
2026-05-10 13:36:52 -07:00
}
void CreateHull()
2026-05-10 13:36:52 -07:00
{
if ( m_hull != nullptr )
{
b3DestroyHull( m_hull );
m_hull = nullptr;
}
int count = (int)m_points.size();
if ( count >= 4 )
{
m_hull = b3CreateHull( m_points.data(), count, m_maxVertexCount );
}
}
void FrameView()
{
if ( m_points.empty() )
{
return;
}
b3AABB bounds = b3MakeAABB( m_points.data(), (int)m_points.size(), 0.0f );
float radius = b3Length( b3AABB_Extents( bounds ) );
m_camera->SetView( 0.0f, 15.0f, b3MaxFloat( 3.0f * radius, 1.0f ),
b3ToPos( b3AABB_Center( bounds ) ) );
}
bool DrawControls() override
{
DrawTextLine( "points = %d", (int)m_points.size() );
if ( m_hull != nullptr )
{
DrawTextLine( "hull: vertices = %d, edges = %d, faces = %d", m_hull->vertexCount,
m_hull->edgeCount / 2, m_hull->faceCount );
}
else
{
DrawTextLine( "hull creation failed" );
}
if ( ImGui::BeginCombo( "Source", hullSources[m_sourceIndex].name ) )
{
for ( int i = 0; i < hullSourceCount; ++i )
{
if ( ImGui::Selectable( hullSources[i].name, i == m_sourceIndex ) )
{
m_sourceIndex = i;
LoadPoints();
CreateHull();
FrameView();
}
}
ImGui::EndCombo();
}
if ( ImGui::SliderInt( "Max Vertices", &m_maxVertexCount, 4, B3_MAX_HULL_VERTICES ) )
{
CreateHull();
2026-05-10 13:36:52 -07:00
}
return true;
2026-05-10 13:36:52 -07:00
}
void Render() override
{
if ( m_hull != nullptr )
{
DrawHull( b3WorldTransform_identity, m_hull, MakeColor( b3_colorYellow ) );
2026-05-10 13:36:52 -07:00
}
else
{
for ( const b3Vec3& point : m_points )
2026-05-10 13:36:52 -07:00
{
DrawPoint( b3ToPos( point ), 5.0f, MakeColor( b3_colorWhite ) );
2026-05-10 13:36:52 -07:00
}
}
DrawAxes( b3WorldTransform_identity, 1.0f );
2026-05-10 13:36:52 -07:00
Sample::Render();
}
static Sample* Create( SampleContext* sampleContext )
{
return new HullCrash( sampleContext );
}
std::vector<b3Vec3> m_points;
b3HullData* m_hull;
int m_sourceIndex;
int m_maxVertexCount;
2026-05-10 13:36:52 -07:00
};
static int sampleHullCrash = RegisterSample( "Issues", "Hull Crash", HullCrash::Create );
2026-05-10 13:36:52 -07:00
class ConvexJitter : public Sample
{
public:
explicit ConvexJitter( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 0.0f, 15.0f, 10.0f, { 0.0f, 2.0f, 0.0f } );
}
AddGroundBox( 10.0f );
2026-05-10 13:36:52 -07:00
float s = 0.01f;
{
b3Vec3 b = { -459.292877f, 217.398331f, 1.00115335f };
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.position = { s * b.x, s * b.z + 2.0f, s * b.y };
bodyDef.rotation = { { 0.0f, -0.707106769f, 0.0f }, 0.707106769f };
b3BodyId bodyId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
constexpr int count = 16;
b3Vec3 points[count];
points[0] = { -44.8770714, -91.6598053, -1.92012548 };
points[1] = { -92.5001831, 51.0151291, 15.8006573 };
points[2] = { -91.0282211, -9.44371605, 15.6148796 };
points[3] = { 90.2375641, 77.3870087, 15.9356089 };
points[4] = { -85.5353241, 91.3750992, -1.36629653 };
points[5] = { 88.9092178, -87.2975464, -1.86754704 };
points[6] = { 83.7932816, -89.8572235, 15.4168339 };
points[7] = { 87.0243988, 88.9776535, -1.32423306 };
points[8] = { -91.6564941, -85.4949493, 15.3782759 };
points[9] = { -90.2922516, -87.2074127, -1.92012548 };
points[10] = { -87.2944870, 89.9510498, 15.9215889 };
points[11] = { 79.2338104, 89.9690781, 15.9724140 };
points[12] = { -91.6744461, 81.0823212, -1.39959598 };
points[13] = { 90.3452759, -76.4459610, 15.4588966 };
points[14] = { -87.4021912, -89.2263107, 15.3677588 };
points[15] = { 76.3258057, 92.0059967, 1.82873762 };
for ( int i = 0; i < count; ++i )
{
b3Vec3 p = points[i];
points[i] = { s * p.x, s * p.z, s * p.y };
}
b3HullData* hull = b3CreateHull( points, count, count );
2026-05-10 13:36:52 -07:00
b3CreateHullShape( bodyId, &shapeDef, hull );
b3DestroyHull( hull );
}
{
b3Vec3 b = { -402.321838f, 157.310364f, 16.8169250f };
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.position = { s * b.x, s * b.z + 2.0f, s * b.y };
bodyDef.rotation = { { 0.0f, -0.00152086187f, 0.0f }, 0.999998868f };
bodyDef.type = b3_dynamicBody;
b3BodyId bodyId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
shapeDef.baseMaterial.rollingResistance = 0.1f;
constexpr int count = 18;
b3Vec3 points[count];
points[0] = { 29.5000000, 17.1488495, 0.175081104 };
points[1] = { 29.5000000, -17.2990532, 0.125000000 };
points[2] = { 29.4840164, -17.3057766, 24.0200863 };
points[3] = { 29.4840164, 17.1648350, 24.1781254 };
points[4] = { -29.1345520, 17.5529804, 0.125000000 };
points[5] = { -29.1345520, 17.5529804, 23.7899799 };
points[6] = { -29.1441040, 16.9679585, 24.3750000 };
points[7] = { -29.1345520, -17.2990532, 24.3750000 };
points[8] = { -29.1345520, -17.2990532, 0.175081253 };
points[9] = { 29.0720215, 17.5529785, 0.125000000 };
points[10] = { 29.0859070, 17.5629406, 23.8120594 };
points[11] = { 29.1401348, -17.2990532, 24.3750000 };
points[12] = { 29.1123581, 16.9722290, 24.4027710 };
points[13] = { 29.3944912, 17.2543602, 24.1206398 };
points[14] = { -29.1345520, -17.2990532, 24.0759430 };
points[15] = { -29.1345520, -16.9722252, 24.4027710 };
points[16] = { 29.1123619, -16.9722271, 24.4027729 };
points[17] = { 29.5000000, 17.3429642, 24.0000000 };
for ( int i = 0; i < count; ++i )
{
b3Vec3 p = points[i];
points[i] = { s * p.x, s * p.z, s * p.y };
}
b3HullData* hull = b3CreateHull( points, count, count );
2026-05-10 13:36:52 -07:00
b3CreateHullShape( bodyId, &shapeDef, hull );
b3DestroyHull( hull );
}
}
static Sample* Create( SampleContext* context )
{
return new ConvexJitter( context );
}
};
static int sampleConvexJitter = RegisterSample( "Issues", "Convex Jitter", ConvexJitter::Create );
class SBoxMover : public Sample
{
public:
explicit SBoxMover( SampleContext* context )
: Sample( context )
{
if ( m_context->restart == false )
{
m_camera->SetView( 45.0f, 30.0f, 12.0f, b3Pos_zero );
}
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.position = { -10.0f, 0.0f, -10.0f };
b3BodyId groundId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
m_heightField = b3CreateGrid( 40, 40, { 0.5f, 1.0f, 0.5f }, false );
// m_heightField = b3CreateWave( 40, 40, {1.0f, 2.0f, 1.0f}, 0.02f, 0.04f, false );
b3CreateHeightFieldShape( groundId, &shapeDef, m_heightField );
m_gridMesh = b3CreateGridMesh( 40, 40, 0.5f, 1, true );
// b3CreateMeshShape( groundId, &shapeDef, m_gridMesh, b3Vec3_one );
}
{
b3BodyDef bodyDef = b3DefaultBodyDef();
b3BodyId groundId = b3CreateBody( m_worldId, &bodyDef );
// m_boxMesh = b3CreateBoxMesh( { 0.0f, 1.0f, 0.0f }, { 1.0f, 1.0f, 1.0f }, true );
b3ShapeDef shapeDef = b3DefaultShapeDef();
m_boxMesh = b3CreatePlatformMesh( { 0.0f, 0.5f, 0.0f }, 1.0f, 2.0f, 5.0f );
b3Vec3 scale = b3Vec3_one;
b3CreateMeshShape( groundId, &shapeDef, m_boxMesh, scale );
}
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.type = b3_dynamicBody;
bodyDef.position = { 0.0f, 3.5f, 0.0f };
bodyDef.motionLocks.angularX = true;
bodyDef.motionLocks.angularY = true;
bodyDef.motionLocks.angularZ = true;
bodyDef.enableContactRecycling = false;
b3BodyId bodyId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3BoxHull box = b3MakeBoxHull( 0.25f, 1.0f, 0.25f );
b3CreateHullShape( bodyId, &shapeDef, &box.base );
}
}
~SBoxMover() override
{
b3DestroyMesh( m_boxMesh );
b3DestroyHeightField( m_heightField );
b3DestroyMesh( m_gridMesh );
}
void Render() override
{
Sample::Render();
b3Transform transform = { { 0.0f, 1.1f, 0.0f }, b3Quat_identity };
DrawAxes( b3MakeWorldTransform( transform ), 3.0f );
}
static Sample* Create( SampleContext* context )
{
return new SBoxMover( context );
}
b3MeshData* m_boxMesh;
b3HeightFieldData* m_heightField;
b3MeshData* m_gridMesh;
};
static int sampleBoxMesh = RegisterSample( "Issues", "s&box mover", SBoxMover::Create );
class CapsuleMeshBug : public Sample
{
public:
explicit CapsuleMeshBug( SampleContext* context )
: Sample( context )
{
if ( m_context->restart == false )
{
m_camera->SetView( 20.0f, 10.0f, 30.0f, { 0.0f, 2.0f, 0.0f } );
}
// --- Ground plane ---
{
b3BodyDef bodyDef = b3DefaultBodyDef();
b3BodyId body = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3BoxHull ground = b3MakeBoxHull( 50.0f, 0.1f, 50.0f );
b3CreateHullShape( body, &shapeDef, &ground.base );
}
// --- Building mesh on top of ground ---
m_building = CreateMeshData( "data/meshes/building.obj", 1.0f, false, false, true, true );
if ( m_building != nullptr )
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.position = { 0.0f, 0.1f, 0.0f };
b3BodyId body = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3CreateMeshShape( body, &shapeDef, m_building, b3Vec3_one );
}
// --- Locked capsule (same setup as player controller body) ---
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.type = b3_dynamicBody;
bodyDef.position = { 0.0f, 4.0f, 10.0f };
bodyDef.motionLocks.angularX = true;
bodyDef.motionLocks.angularY = true;
bodyDef.motionLocks.angularZ = true;
bodyDef.enableSleep = false;
bodyDef.enableContactRecycling = false;
b3BodyId body = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
shapeDef.baseMaterial.friction = 0.3f;
shapeDef.baseMaterial.customColor = b3_colorMagenta;
b3Capsule capsule = { { 0.0f, -0.5f, 0.0f }, { 0.0f, 0.5f, 0.0f }, 0.3f };
b3CreateCapsuleShape( body, &shapeDef, &capsule );
}
}
~CapsuleMeshBug() override
{
if ( m_building )
{
b3DestroyMesh( m_building );
}
}
static Sample* Create( SampleContext* context )
{
return new CapsuleMeshBug( context );
}
b3MeshData* m_building = nullptr;
};
static int sampleIndex = RegisterSample( "Issues", "Capsule Mesh", CapsuleMeshBug::Create );
// Reproduces s&box rigid body character ghost collisions on a FLAT floor.
//
// The s&box player is a fixed rotation dynamic body (zero radius box hull) moved by setting
// velocity. The floor here is modeled on an s&box map area that ghosts badly: concrete slabs
// and a run of parallel chamfered beams over deep pits. Every walkable vertex is at exactly
// y = 0 - there is nothing to climb and nothing to trip on. The only mesh features are AT or
// BELOW the walkable plane: chamfer facets sloping down from beam tops, pit walls and floors,
// T-junction seams between tiles tessellated at different resolutions, and a chunk seam where
// two mesh shapes meet (separate contact pairs, like s&box world chunks).
//
// Walking back and forth still launches the body upward (60-190 inch/s at run speed). No shape
// casts, no step up, no ground snapping - any upward velocity spike is a ghost collision from
// speculative hull vs triangle contacts against below-plane geometry.
class SBoxGhostCollisions : public Sample
{
public:
// s&box works in inches: 1 unit = 0.0254 m (40 units per meter)
static constexpr float SRC = 0.0254f;
// Floor layout (s&box inches)
static constexpr int m_halfLengthU = 256; // strip half length along x
static constexpr int m_halfWidthU = 64; // strip half width along z
static constexpr int m_tileSizeU = 32; // slab tile stride
// Beam section: beams run along z, the character walks along x across them.
// Tops are 12 wide with 1.5 chamfers, pits between are 10 wide and 24 deep.
// The 16 wide hull always spans the 13 gap between flat tops.
static constexpr float m_beamPitchU = 22.0f;
static constexpr float m_beamWidthU = 12.0f;
static constexpr float m_chamferWidthU = 1.5f;
static constexpr float m_chamferDropU = 1.0f;
static constexpr float m_pitDepthU = 24.0f;
static constexpr int m_beamCount = 9;
static constexpr float m_beamRegion0 = -94.0f; // first beam start
static constexpr float m_beamRegion1 = 94.0f; // last beam end
// Character (s&box player: 16 wide zero radius box hull, 72 tall, mass 500)
static constexpr float m_bodyHalfWidth = 16.0f * SRC;
static constexpr float m_bodyHalfHeight = 36.0f * SRC;
static constexpr float m_characterMass = 500.0f;
explicit SBoxGhostCollisions( SampleContext* context )
: Sample( context )
{
if ( m_context->restart == false )
{
m_camera->SetView( 90.0f, 25.0f, 10.0f, { 0.0f, 1.0f, 0.0f } );
}
2026-11-01 09:05:05 -08:00
m_fixWinding = true;
m_combineChunks = true;
m_remesh = true;
m_simplifyErrorMillimeters = 10.0f;
m_repeatSimplify = true;
2026-11-01 09:05:05 -08:00
CreateFloor();
// Character
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.type = b3_dynamicBody;
2026-07-10 16:14:53 -07:00
bodyDef.position = { -m_walkRangeX, m_bodyHalfHeight + 0.1f, 0.0f };
bodyDef.motionLocks.angularX = true;
bodyDef.motionLocks.angularY = true;
bodyDef.motionLocks.angularZ = true;
bodyDef.enableSleep = false;
bodyDef.enableContactRecycling = false;
bodyDef.gravityScale = 2.03f; // s&box gravity: 800 inch/s^2
bodyDef.name = "character";
2026-11-01 09:05:05 -08:00
bodyDef.safetyFactor = 0.05f;
m_characterId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
shapeDef.baseMaterial.friction = 0.0f;
shapeDef.baseMaterial.restitution = 0.0f;
// shapeDef.baseMaterial.customColor = b3_colorLimeGreen;
float volume = 8.0f * m_bodyHalfWidth * m_bodyHalfHeight * m_bodyHalfWidth;
shapeDef.density = m_characterMass / volume;
shapeDef.enableSpeculativeContact = false;
b3BoxHull box = b3MakeBoxHull( m_bodyHalfWidth, m_bodyHalfHeight, m_bodyHalfWidth );
b3CreateHullShape( m_characterId, &shapeDef, &box.base );
}
2026-07-10 16:14:53 -07:00
m_walkDirectionX = 1.0f;
m_walkDirectionZ = 1.0f;
m_walkSpeedX = 350.0f * SRC; // s&box run speed
m_walkSpeedZ = 20.0f * SRC;
m_launchCount = 0;
m_maxLaunchSpeed = 0.0f;
m_launchMarkerCount = 0;
m_wasLaunched = false;
m_stepWhilePaused = true;
}
~SBoxGhostCollisions() override
{
for ( int i = 0; i < 2; ++i )
{
if ( m_chunkMesh[i] != nullptr )
{
b3DestroyMesh( m_chunkMesh[i] );
}
}
}
2026-11-01 09:05:05 -08:00
void CreateFloor()
{
m_chunkTriangleCount[1] = 0;
m_simplifyPassCount[1] = 0;
if ( m_combineChunks )
{
CreateFloorChunk( 0, -(float)m_halfLengthU, (float)m_halfLengthU );
return;
}
2026-11-01 09:05:05 -08:00
// Two chunks meeting at x = 0, each its own body and mesh shape, so seam contacts live
// in separate contact pairs like s&box world mesh chunks. A beam top straddles the seam.
CreateFloorChunk( 0, -(float)m_halfLengthU, 0.0f );
CreateFloorChunk( 1, 0.0f, (float)m_halfLengthU );
}
void DestroyFloor()
{
for ( int i = 0; i < 2; ++i )
{
if ( B3_IS_NON_NULL( m_chunkBodyIds[i] ) )
{
b3DestroyBody( m_chunkBodyIds[i] );
b3DestroyMesh( m_chunkMesh[i] );
}
2026-11-01 09:05:05 -08:00
m_chunkBodyIds[i] = b3_nullBodyId;
m_chunkMesh[i] = nullptr;
}
}
// Deterministic integer hash for tile tessellation selection
static uint32_t Hash( uint32_t x )
{
x ^= x >> 16;
x *= 0x7feb352du;
x ^= x >> 15;
x *= 0x846ca68bu;
x ^= x >> 16;
return x;
}
static void EmitTriangle( std::vector<b3Vec3>& vertices, std::vector<int32_t>& indices,
b3Vec3 a, b3Vec3 b, b3Vec3 c )
{
int32_t base = (int32_t)vertices.size();
vertices.push_back( a );
vertices.push_back( b );
vertices.push_back( c );
indices.push_back( base );
indices.push_back( base + 1 );
indices.push_back( base + 2 );
}
// Horizontal patch at height y spanning [x0,x1]x[z0,z1] (inches), normal +y
static void EmitPatch( std::vector<b3Vec3>& vertices, std::vector<int32_t>& indices, float x0,
float x1, float z0, float z1, float y, float cell )
{
if ( x1 - x0 < 0.01f )
{
return;
}
int countX = (int)( ( x1 - x0 ) / cell + 0.99f );
int countZ = (int)( ( z1 - z0 ) / cell + 0.99f );
for ( int ix = 0; ix < countX; ++ix )
{
for ( int iz = 0; iz < countZ; ++iz )
{
float cx0 = x0 + ( x1 - x0 ) * (float)ix / (float)countX;
float cx1 = x0 + ( x1 - x0 ) * (float)( ix + 1 ) / (float)countX;
float cz0 = z0 + ( z1 - z0 ) * (float)iz / (float)countZ;
float cz1 = z0 + ( z1 - z0 ) * (float)( iz + 1 ) / (float)countZ;
b3Vec3 a = { SRC * cx0, SRC * y, SRC * cz0 };
b3Vec3 b = { SRC * cx1, SRC * y, SRC * cz0 };
b3Vec3 c = { SRC * cx1, SRC * y, SRC * cz1 };
b3Vec3 d = { SRC * cx0, SRC * y, SRC * cz1 };
// Alternate the split diagonal like typical cooked map data
if ( ( ix + iz ) & 1 )
{
EmitTriangle( vertices, indices, a, d, c );
EmitTriangle( vertices, indices, a, c, b );
}
else
{
EmitTriangle( vertices, indices, a, d, b );
EmitTriangle( vertices, indices, b, d, c );
}
}
}
}
// Sloped strip from edge (xLow, yLow) to edge (xHigh, yHigh) spanning the full z width
static void EmitSlope( std::vector<b3Vec3>& vertices, std::vector<int32_t>& indices, float xLow,
float yLow, float xHigh, float yHigh, float zCell, bool fixWinding )
{
2026-11-01 09:05:05 -08:00
// The original winding only faces out for a slope rising toward +x
bool flip = fixWinding && xHigh < xLow;
int countZ = (int)( 2.0f * (float)m_halfWidthU / zCell + 0.99f );
for ( int iz = 0; iz < countZ; ++iz )
{
float z0 =
-(float)m_halfWidthU + 2.0f * (float)m_halfWidthU * (float)iz / (float)countZ;
float z1 = -(float)m_halfWidthU +
2.0f * (float)m_halfWidthU * (float)( iz + 1 ) / (float)countZ;
b3Vec3 l0 = { SRC * xLow, SRC * yLow, SRC * z0 };
b3Vec3 l1 = { SRC * xLow, SRC * yLow, SRC * z1 };
b3Vec3 h0 = { SRC * xHigh, SRC * yHigh, SRC * z0 };
b3Vec3 h1 = { SRC * xHigh, SRC * yHigh, SRC * z1 };
2026-11-01 09:05:05 -08:00
if ( flip )
{
EmitTriangle( vertices, indices, l0, h1, l1 );
EmitTriangle( vertices, indices, l0, h0, h1 );
}
else
{
EmitTriangle( vertices, indices, l0, l1, h1 );
EmitTriangle( vertices, indices, l0, h1, h0 );
}
}
}
// Vertical wall at x from y0 (bottom) to y1 (top). facing = +1 faces +x, -1 faces -x
static void EmitWall( std::vector<b3Vec3>& vertices, std::vector<int32_t>& indices, float x,
float y0, float y1, int facing, float zCell, bool fixWinding )
{
2026-11-01 09:05:05 -08:00
// The original winding faced every wall into the solid
bool faceNegativeX = fixWinding ? facing < 0 : facing > 0;
int countZ = (int)( 2.0f * (float)m_halfWidthU / zCell + 0.99f );
for ( int iz = 0; iz < countZ; ++iz )
{
float z0 =
-(float)m_halfWidthU + 2.0f * (float)m_halfWidthU * (float)iz / (float)countZ;
float z1 = -(float)m_halfWidthU +
2.0f * (float)m_halfWidthU * (float)( iz + 1 ) / (float)countZ;
b3Vec3 b0 = { SRC * x, SRC * y0, SRC * z0 };
b3Vec3 b1 = { SRC * x, SRC * y0, SRC * z1 };
b3Vec3 t0 = { SRC * x, SRC * y1, SRC * z0 };
b3Vec3 t1 = { SRC * x, SRC * y1, SRC * z1 };
2026-11-01 09:05:05 -08:00
if ( faceNegativeX )
{
EmitTriangle( vertices, indices, b0, b1, t1 );
EmitTriangle( vertices, indices, b0, t1, t0 );
}
else
{
EmitTriangle( vertices, indices, b0, t0, t1 );
EmitTriangle( vertices, indices, b0, t1, b1 );
}
}
}
// Clip [a0,a1] to [c0,c1]
static bool ClipSpan( float a0, float a1, float c0, float c1, float* o0, float* o1 )
{
*o0 = a0 > c0 ? a0 : c0;
*o1 = a1 < c1 ? a1 : c1;
return *o1 - *o0 > 0.01f;
}
// Weld exact duplicates, then let meshoptimizer collapse every edge that leaves the surface in
// place. A t-junction vertex sits on an open border, so it can slide along that border onto a
// corner, which closes the seam. Flat collapses still cost a little from the simplifier's
// vertex regularization, so the error limit has to clear that while staying far below the inch
// scale cost of collapsing a real crease. Regularize options raise that cost. Vertex kinds are
// fixed per call, so a corner locked by a t-junction stays locked after its seam closes.
// Repeating reclassifies, but the error limit applies per pass, so deviation can accumulate.
// Winding is not repaired. Returns the number of passes.
static int Remesh( std::vector<b3Vec3>& vertices, std::vector<int32_t>& indices,
float errorLimit, unsigned int options, bool repeat )
{
size_t indexCount = indices.size();
const unsigned int* sourceIndices = reinterpret_cast<const unsigned int*>( indices.data() );
std::vector<unsigned int> remap( vertices.size() );
size_t vertexCount =
meshopt_generateVertexRemap( remap.data(), sourceIndices, indexCount, vertices.data(),
vertices.size(), sizeof( b3Vec3 ) );
std::vector<unsigned int> welded( indexCount );
meshopt_remapIndexBuffer( welded.data(), sourceIndices, indexCount, remap.data() );
std::vector<b3Vec3> positions( vertexCount );
meshopt_remapVertexBuffer( positions.data(), vertices.data(), vertices.size(),
sizeof( b3Vec3 ), remap.data() );
std::vector<unsigned int> simplified( indexCount );
int passCount = 0;
for ( ;; )
{
size_t simplifiedCount = meshopt_simplify(
simplified.data(), welded.data(), welded.size(), &positions[0].x, vertexCount,
sizeof( b3Vec3 ), 0, errorLimit, meshopt_SimplifyErrorAbsolute | options, nullptr );
passCount += 1;
bool reduced = simplifiedCount < welded.size();
welded.assign( simplified.begin(), simplified.begin() + simplifiedCount );
if ( repeat == false || reduced == false )
{
break;
}
}
size_t usedCount =
meshopt_optimizeVertexFetch( positions.data(), welded.data(), welded.size(),
positions.data(), vertexCount, sizeof( b3Vec3 ) );
positions.resize( usedCount );
vertices = positions;
indices.assign( welded.begin(), welded.end() );
return passCount;
}
void CreateFloorChunk( int chunk, float x0U, float x1U )
{
std::vector<b3Vec3> vertices;
std::vector<int32_t> indices;
float s0, s1;
// --- Concrete slabs at y = 0 outside the beam region ---
// Tiles tessellate at a hash-picked resolution so neighbors meet with T-junctions,
// like cooked s&box map collision.
float slabSpans[2][2] = { { -(float)m_halfLengthU, m_beamRegion0 },
{ m_beamRegion1, (float)m_halfLengthU } };
for ( int i = 0; i < 2; ++i )
{
if ( ClipSpan( slabSpans[i][0], slabSpans[i][1], x0U, x1U, &s0, &s1 ) == false )
{
continue;
}
for ( float tx = s0; tx < s1; tx += (float)m_tileSizeU )
{
float tx1 = b3MinFloat( tx + (float)m_tileSizeU, s1 );
for ( int tz = -m_halfWidthU; tz < m_halfWidthU; tz += m_tileSizeU )
{
// Seeded by side rather than chunk so combined and split floors tessellate the
// same
uint32_t side = tx < 0.0f ? 0u : 1u;
uint32_t h =
Hash( (uint32_t)( (int)tx * 73856093 ) ^ (uint32_t)( tz * 19349663 ) ^
(uint32_t)( side * 2654435761u ) );
float cells[3] = { 4.0f, 8.0f, 16.0f };
EmitPatch( vertices, indices, tx, tx1, (float)tz, (float)( tz + m_tileSizeU ),
0.0f, cells[h % 3] );
}
}
}
// --- Beam section: flat tops at y = 0, chamfers dropping to pits ---
float pitTop = -m_chamferDropU;
float pitBottom = -m_pitDepthU;
2026-11-01 09:05:05 -08:00
// Coarse walls and pit floors leave t-junctions against the 8 inch chamfer cells
float wellCell = 16.0f;
2026-11-01 09:05:05 -08:00
for ( int k = 0; k < m_beamCount; ++k )
{
float bx = m_beamRegion0 + m_beamPitchU * (float)k;
bool pitLeft = k > 0;
bool pitRight = k < m_beamCount - 1;
// Flat top (flush with the slab on outer sides)
float top0 = pitLeft ? bx + m_chamferWidthU : bx;
float top1 = pitRight ? bx + m_beamWidthU - m_chamferWidthU : bx + m_beamWidthU;
if ( ClipSpan( top0, top1, x0U, x1U, &s0, &s1 ) )
{
EmitPatch( vertices, indices, s0, s1, -(float)m_halfWidthU, (float)m_halfWidthU,
0.0f, 8.0f );
}
// Chamfers sloping below the walkable plane
if ( pitLeft && bx >= x0U && bx < x1U )
{
EmitSlope( vertices, indices, bx, pitTop, bx + m_chamferWidthU, 0.0f, 8.0f,
m_fixWinding );
}
if ( pitRight && bx + m_beamWidthU > x0U && bx + m_beamWidthU <= x1U )
{
EmitSlope( vertices, indices, bx + m_beamWidthU, pitTop,
bx + m_beamWidthU - m_chamferWidthU, 0.0f, 8.0f, m_fixWinding );
}
// Pit to the right of this beam
if ( pitRight )
{
float pitL = bx + m_beamWidthU;
float pitR = bx + m_beamPitchU;
if ( pitL >= x0U && pitL < x1U )
{
EmitWall( vertices, indices, pitL, pitBottom, pitTop, +1, wellCell,
m_fixWinding );
}
if ( pitR > x0U && pitR <= x1U )
{
EmitWall( vertices, indices, pitR, pitBottom, pitTop, -1, wellCell,
m_fixWinding );
}
if ( ClipSpan( pitL, pitR, x0U, x1U, &s0, &s1 ) )
{
EmitPatch( vertices, indices, s0, s1, -(float)m_halfWidthU, (float)m_halfWidthU,
pitBottom, wellCell );
}
}
}
if ( m_remesh )
{
m_simplifyPassCount[chunk] = Remesh(
vertices, indices, 0.001f * m_simplifyErrorMillimeters, 0, m_repeatSimplify );
}
m_chunkTriangleCount[chunk] = (int)( indices.size() / 3 );
b3MeshDef meshDef = {};
meshDef.vertices = vertices.data();
meshDef.indices = indices.data();
meshDef.vertexCount = (int)vertices.size();
meshDef.triangleCount = (int)( indices.size() / 3 );
meshDef.weldVertices = true;
meshDef.weldTolerance = 0.005f; // == B3_LINEAR_SLOP, same as s&box
meshDef.identifyEdges = true;
m_chunkMesh[chunk] = b3CreateMesh( &meshDef, nullptr, 0 );
b3BodyDef bodyDef = b3DefaultBodyDef();
2026-11-01 09:05:05 -08:00
m_chunkBodyIds[chunk] = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
2026-11-01 09:05:05 -08:00
b3CreateMeshShape( m_chunkBodyIds[chunk], &shapeDef, m_chunkMesh[chunk], b3Vec3_one );
}
void Step() override
{
// Drive the character with pure velocity control: keep the solver's vertical velocity,
// set the horizontal velocity. This is how the s&box player controller moves.
b3Pos position = b3Body_GetPosition( m_characterId );
2026-07-10 16:14:53 -07:00
if ( position.x > m_walkRangeX )
{
2026-07-10 16:14:53 -07:00
m_walkDirectionX = -1.0f;
}
2026-07-10 16:14:53 -07:00
else if ( position.x < -m_walkRangeX )
{
2026-07-10 16:14:53 -07:00
m_walkDirectionX = 1.0f;
}
if ( position.z > m_walkRangeZ )
{
m_walkDirectionZ = -1.0f;
}
else if ( position.z < -m_walkRangeZ )
{
m_walkDirectionZ = 1.0f;
}
b3Vec3 velocity = b3Body_GetLinearVelocity( m_characterId );
2026-07-10 16:14:53 -07:00
velocity.x = m_walkDirectionX * m_walkSpeedX;
velocity.z = m_walkDirectionZ * m_walkSpeedZ;
b3Body_SetLinearVelocity( m_characterId, velocity );
Sample::Step();
if ( m_didStep )
{
// The walkable plane is exactly y = 0, so the grounded body center never rises above
// rest height. Any upward velocity spike while grounded is a ghost collision: there
// is nothing to climb and nothing to bounce off.
position = b3Body_GetPosition( m_characterId );
velocity = b3Body_GetLinearVelocity( m_characterId );
bool grounded = position.y < m_bodyHalfHeight + 0.01f + 4.0f * SRC;
bool launched = velocity.y > m_launchThreshold;
if ( grounded && launched && m_wasLaunched == false )
{
m_launchCount += 1;
m_maxLaunchSpeed = b3MaxFloat( m_maxLaunchSpeed, velocity.y );
if ( m_launchMarkerCount < m_markerCapacity )
{
m_launchMarkers[m_launchMarkerCount] = position;
m_launchMarkerCount += 1;
}
}
m_wasLaunched = launched;
}
for ( int i = 0; i < m_launchMarkerCount; ++i )
{
DrawPoint( m_launchMarkers[i], 8.0f, MakeColor( b3_colorRed ) );
}
b3Vec3 currentVelocity = b3Body_GetLinearVelocity( m_characterId );
DrawTextLine( "ghost launches: %d, worst: %.2f m/s (%.0f inch/s)", m_launchCount,
m_maxLaunchSpeed, m_maxLaunchSpeed / SRC );
DrawTextLine( "vertical velocity: %.2f m/s", currentVelocity.y );
if ( m_combineChunks )
{
DrawTextLine( "floor triangles: %d", m_chunkTriangleCount[0] );
}
else
{
DrawTextLine( "floor triangles: %d (chunks %d + %d)",
m_chunkTriangleCount[0] + m_chunkTriangleCount[1],
m_chunkTriangleCount[0], m_chunkTriangleCount[1] );
}
if ( m_remesh )
{
DrawTextLine( m_combineChunks ? "simplify passes: %d" : "simplify passes: %d + %d",
m_simplifyPassCount[0], m_simplifyPassCount[1] );
}
}
bool DrawControls() override
{
2026-07-10 16:14:53 -07:00
float speedUX = m_walkSpeedX / SRC;
if ( ImGui::SliderFloat( "Walk Speed X (inch/s)", &speedUX, 100.0f, 400.0f, "%.0f" ) )
{
m_walkSpeedX = speedUX * SRC;
}
float speedUZ = m_walkSpeedZ / SRC;
if ( ImGui::SliderFloat( "Walk Speed Z (inch/s)", &speedUZ, 10.0f, 100.0f, "%.0f" ) )
{
2026-07-10 16:14:53 -07:00
m_walkSpeedZ = speedUZ * SRC;
}
2026-11-01 09:05:05 -08:00
bool rebuild = ImGui::Checkbox( "Fix Winding", &m_fixWinding );
rebuild = ImGui::Checkbox( "Combine Chunks", &m_combineChunks ) || rebuild;
rebuild = ImGui::Checkbox( "Remesh (meshoptimizer)", &m_remesh ) || rebuild;
ImGui::SliderFloat( "Simplify Error (mm)", &m_simplifyErrorMillimeters, 0.1f, 50.0f, "%.1f",
ImGuiSliderFlags_Logarithmic );
rebuild = ( ImGui::IsItemDeactivatedAfterEdit() && m_remesh ) || rebuild;
const char* regularizeNames[] = { "None", "Light", "Full" };
rebuild =
( ImGui::Checkbox( "Repeat Simplify", &m_repeatSimplify ) && m_remesh ) || rebuild;
2026-11-01 09:05:05 -08:00
if ( rebuild )
{
DestroyFloor();
CreateFloor();
}
if ( ImGui::Button( "Reset Counters" ) || rebuild )
{
m_launchCount = 0;
m_maxLaunchSpeed = 0.0f;
m_launchMarkerCount = 0;
}
ImGui::Text( "Launches: %d", m_launchCount );
return true;
}
static Sample* Create( SampleContext* context )
{
return new SBoxGhostCollisions( context );
}
static constexpr float m_walkRangeX = 3.5f; // turn around beyond +/- this x (meters)
static constexpr float m_walkRangeZ = 0.5f; // turn around beyond +/- this x (meters)
static constexpr float m_launchThreshold =
0.5f; // upward m/s counted as a ghost launch (~20 inch/s)
static constexpr int m_markerCapacity = 64;
b3MeshData* m_chunkMesh[2] = {};
2026-11-01 09:05:05 -08:00
b3BodyId m_chunkBodyIds[2] = { b3_nullBodyId, b3_nullBodyId };
bool m_fixWinding;
bool m_combineChunks;
bool m_remesh;
float m_simplifyErrorMillimeters;
bool m_repeatSimplify;
int m_simplifyPassCount[2] = {};
int m_chunkTriangleCount[2] = {};
b3BodyId m_characterId;
2026-07-10 16:14:53 -07:00
float m_walkDirectionX;
float m_walkDirectionZ;
float m_walkSpeedX;
float m_walkSpeedZ;
int m_launchCount;
float m_maxLaunchSpeed;
bool m_wasLaunched;
b3Pos m_launchMarkers[m_markerCapacity];
int m_launchMarkerCount;
};
static int sampleSBoxGhostCollisions =
RegisterSample( "Issues", "s&box Ghost Collisions", SBoxGhostCollisions::Create );
static const b3Vec3 s_metalWheel1Verts[317] = {
{ 0.010279f, 0.086341f, 0.051768f }, { -0.010314f, -0.084708f, 0.051804f },
{ 0.010279f, -0.084708f, 0.051768f }, { -0.010314f, 0.086341f, 0.051804f },
{ 0.029138f, -0.084708f, -0.043911f }, { 0.043724f, -0.084708f, -0.029376f },
{ 0.010098f, -0.084708f, -0.051759f }, { -0.010494f, -0.084708f, -0.051723f },
{ 0.051638f, -0.084708f, -0.010364f }, { 0.051674f, -0.084708f, 0.010229f },
{ 0.043827f, -0.084708f, 0.029268f }, { 0.029291f, -0.084708f, 0.043855f },
{ -0.029353f, -0.084708f, 0.043957f }, { -0.051889f, -0.084708f, -0.010183f },
{ -0.051853f, -0.084708f, 0.010409f }, { -0.043939f, -0.084708f, 0.029421f },
{ -0.029506f, -0.084708f, -0.043809f }, { -0.044042f, -0.084708f, -0.029222f },
{ -0.029353f, 0.086341f, 0.043957f }, { 0.043724f, 0.086341f, -0.029376f },
{ 0.029138f, 0.086341f, -0.043911f }, { 0.010098f, 0.086341f, -0.051759f },
{ 0.051638f, 0.086341f, -0.010364f }, { 0.051674f, 0.086341f, 0.010229f },
{ -0.044042f, 0.086341f, -0.029222f }, { 0.043827f, 0.086341f, 0.029268f },
{ -0.051889f, 0.086341f, -0.010183f }, { -0.043939f, 0.086341f, 0.029421f },
{ -0.029506f, 0.086341f, -0.043809f }, { 0.035354f, 0.070897f, 0.035658f },
{ 0.035354f, -0.069397f, 0.035658f }, { -0.035498f, 0.070897f, 0.035658f },
{ -0.035498f, -0.069397f, 0.035658f }, { 0.035354f, -0.069397f, 0.365503f },
{ 0.035354f, 0.070897f, 0.365503f }, { -0.035498f, 0.070897f, 0.365503f },
{ -0.035498f, -0.069397f, 0.365503f }, { 0.035354f, 0.070897f, -0.365033f },
{ 0.035354f, -0.069397f, -0.365033f }, { -0.035498f, 0.070897f, -0.365033f },
{ -0.035498f, -0.069397f, -0.365033f }, { 0.035354f, -0.069397f, -0.035187f },
{ 0.035354f, 0.070897f, -0.035187f }, { -0.035498f, 0.070897f, -0.035187f },
{ -0.035498f, -0.069397f, -0.035187f }, { -0.035494f, -0.069397f, -0.035191f },
{ -0.365340f, -0.069397f, -0.035191f }, { -0.035494f, 0.070897f, -0.035191f },
{ -0.365340f, 0.070897f, -0.035191f }, { -0.365340f, -0.069397f, 0.035661f },
{ -0.035494f, -0.069397f, 0.035661f }, { -0.035494f, 0.070897f, 0.035661f },
{ -0.365340f, 0.070897f, 0.035661f }, { 0.035350f, 0.070897f, -0.035191f },
{ 0.365196f, 0.070897f, -0.035191f }, { 0.035350f, -0.069397f, -0.035191f },
{ 0.365196f, -0.069397f, -0.035191f }, { 0.365196f, 0.070897f, 0.035661f },
{ 0.035350f, 0.070897f, 0.035661f }, { 0.035350f, -0.069397f, 0.035661f },
{ 0.365196f, -0.069397f, 0.035661f }, { -0.070802f, 0.086337f, 0.355420f },
{ -0.070802f, -0.084705f, 0.355420f }, { -0.097081f, 0.086335f, 0.487537f },
{ -0.097081f, -0.084704f, 0.487537f }, { -0.000108f, 0.086337f, 0.362383f },
{ -0.000108f, 0.086335f, 0.497088f }, { -0.000108f, -0.084704f, 0.497088f },
{ -0.000108f, -0.084705f, 0.362383f }, { -0.138787f, -0.084705f, 0.334799f },
{ -0.138787f, 0.086337f, 0.334799f }, { -0.070810f, -0.084705f, 0.355419f },
{ -0.070810f, 0.086337f, 0.355419f }, { -0.097090f, 0.086335f, 0.487536f },
{ -0.190336f, 0.086335f, 0.459250f }, { -0.190336f, -0.084704f, 0.459250f },
{ -0.097090f, -0.084704f, 0.487536f }, { -0.138795f, 0.086337f, 0.334796f },
{ -0.138795f, -0.084705f, 0.334796f }, { -0.201442f, 0.086337f, 0.301310f },
{ -0.201442f, -0.084705f, 0.301310f }, { -0.276280f, -0.084704f, 0.413313f },
{ -0.276280f, 0.086335f, 0.413313f }, { -0.190344f, 0.086335f, 0.459247f },
{ -0.190344f, -0.084704f, 0.459247f }, { -0.201450f, -0.084705f, 0.301306f },
{ -0.256361f, -0.084705f, 0.256241f }, { -0.201450f, 0.086337f, 0.301306f },
{ -0.256361f, 0.086337f, 0.256241f }, { -0.351612f, 0.086335f, 0.351492f },
{ -0.351612f, -0.084704f, 0.351492f }, { -0.276288f, 0.086335f, 0.413309f },
{ -0.276288f, -0.084704f, 0.413309f }, { -0.301431f, -0.084705f, 0.201325f },
{ -0.413435f, -0.084704f, 0.276163f }, { -0.413435f, 0.086335f, 0.276163f },
{ -0.301431f, 0.086337f, 0.201325f }, { -0.256367f, -0.084705f, 0.256236f },
{ -0.256367f, 0.086337f, 0.256236f }, { -0.351618f, 0.086335f, 0.351487f },
{ -0.351618f, -0.084704f, 0.351487f }, { -0.334922f, -0.084705f, 0.138670f },
{ -0.459374f, -0.084704f, 0.190220f }, { -0.459374f, 0.086335f, 0.190220f },
{ -0.334922f, 0.086337f, 0.138670f }, { -0.301436f, 0.086337f, 0.201318f },
{ -0.301436f, -0.084705f, 0.201318f }, { -0.413440f, 0.086335f, 0.276156f },
{ -0.413440f, -0.084704f, 0.276156f }, { -0.487663f, -0.084704f, 0.096966f },
{ -0.355546f, -0.084705f, 0.070686f }, { -0.459377f, -0.084704f, 0.190212f },
{ -0.334926f, -0.084705f, 0.138663f }, { -0.355546f, 0.086337f, 0.070686f },
{ -0.334926f, 0.086337f, 0.138663f }, { -0.487663f, 0.086335f, 0.096966f },
{ -0.459377f, 0.086335f, 0.190212f }, { -0.362511f, -0.084705f, -0.000016f },
{ -0.355549f, -0.084705f, 0.070678f }, { -0.497217f, -0.084704f, -0.000016f },
{ -0.487665f, -0.084704f, 0.096957f }, { -0.497217f, 0.086335f, -0.000016f },
{ -0.362511f, 0.086337f, -0.000016f }, { -0.355549f, 0.086337f, 0.070678f },
{ -0.487665f, 0.086335f, 0.096957f }, { -0.362512f, 0.086337f, -0.000024f },
{ -0.362512f, -0.084705f, -0.000024f }, { -0.355549f, 0.086337f, -0.070717f },
{ -0.355549f, -0.084705f, -0.070717f }, { -0.497217f, -0.084704f, -0.000024f },
{ -0.487666f, -0.084704f, -0.096997f }, { -0.497217f, 0.086335f, -0.000024f },
{ -0.487666f, 0.086335f, -0.096997f }, { -0.334927f, -0.084705f, -0.138702f },
{ -0.355548f, 0.086337f, -0.070726f }, { -0.355548f, -0.084705f, -0.070726f },
{ -0.334927f, 0.086337f, -0.138702f }, { -0.487665f, -0.084704f, -0.097005f },
{ -0.459379f, -0.084704f, -0.190252f }, { -0.487665f, 0.086335f, -0.097005f },
{ -0.459379f, 0.086335f, -0.190252f }, { -0.413442f, -0.084704f, -0.276196f },
{ -0.301439f, -0.084705f, -0.201358f }, { -0.334925f, -0.084705f, -0.138710f },
{ -0.459376f, -0.084704f, -0.190260f }, { -0.334925f, 0.086337f, -0.138710f },
{ -0.301439f, 0.086337f, -0.201358f }, { -0.459376f, 0.086335f, -0.190260f },
{ -0.413442f, 0.086335f, -0.276196f }, { -0.256370f, -0.084705f, -0.256276f },
{ -0.301434f, 0.086337f, -0.201365f }, { -0.301434f, -0.084705f, -0.201365f },
{ -0.256370f, 0.086337f, -0.256276f }, { -0.413438f, 0.086335f, -0.276203f },
{ -0.351621f, 0.086335f, -0.351527f }, { -0.413438f, -0.084704f, -0.276203f },
{ -0.351621f, -0.084704f, -0.351527f }, { -0.256364f, -0.084705f, -0.256283f },
{ -0.201453f, 0.086337f, -0.301347f }, { -0.256364f, 0.086337f, -0.256283f },
{ -0.201453f, -0.084705f, -0.301347f }, { -0.276292f, -0.084704f, -0.413350f },
{ -0.351615f, -0.084704f, -0.351534f }, { -0.351615f, 0.086335f, -0.351534f },
{ -0.276292f, 0.086335f, -0.413350f }, { -0.201447f, -0.084705f, -0.301352f },
{ -0.276285f, -0.084704f, -0.413355f }, { -0.138799f, -0.084705f, -0.334838f },
{ -0.190349f, -0.084704f, -0.459289f }, { -0.276285f, 0.086335f, -0.413355f },
{ -0.201447f, 0.086337f, -0.301352f }, { -0.190349f, 0.086335f, -0.459289f },
{ -0.138799f, 0.086337f, -0.334838f }, { -0.190341f, 0.086335f, -0.459293f },
{ -0.190341f, -0.084704f, -0.459293f }, { -0.138791f, -0.084705f, -0.334842f },
{ -0.138791f, 0.086337f, -0.334842f }, { -0.070815f, 0.086337f, -0.355462f },
{ -0.070815f, -0.084705f, -0.355462f }, { -0.097095f, 0.086335f, -0.487579f },
{ -0.097095f, -0.084704f, -0.487579f }, { -0.070807f, 0.086337f, -0.355464f },
{ -0.097086f, 0.086335f, -0.487581f }, { -0.097086f, -0.084704f, -0.487581f },
{ -0.070807f, -0.084705f, -0.355464f }, { -0.000113f, -0.084705f, -0.362427f },
{ -0.000113f, 0.086337f, -0.362427f }, { -0.000113f, 0.086335f, -0.497132f },
{ -0.000113f, -0.084704f, -0.497132f }, { 0.070588f, 0.086337f, -0.355465f },
{ 0.096868f, -0.084704f, -0.487582f }, { 0.096868f, 0.086335f, -0.487582f },
{ 0.070588f, -0.084705f, -0.355465f }, { -0.000105f, 0.086337f, -0.362427f },
{ -0.000105f, 0.086335f, -0.497133f }, { -0.000105f, -0.084704f, -0.497133f },
{ -0.000105f, -0.084705f, -0.362427f }, { 0.190123f, -0.084704f, -0.459294f },
{ 0.190123f, 0.086335f, -0.459294f }, { 0.138573f, -0.084705f, -0.334843f },
{ 0.138573f, 0.086337f, -0.334843f }, { 0.070597f, 0.086337f, -0.355463f },
{ 0.070597f, -0.084705f, -0.355463f }, { 0.096876f, -0.084704f, -0.487580f },
{ 0.096876f, 0.086335f, -0.487580f }, { 0.201229f, -0.084705f, -0.301354f },
{ 0.276067f, -0.084704f, -0.413358f }, { 0.201229f, 0.086337f, -0.301354f },
{ 0.138581f, -0.084705f, -0.334840f }, { 0.138581f, 0.086337f, -0.334840f },
{ 0.190131f, 0.086335f, -0.459292f }, { 0.276067f, 0.086335f, -0.413358f },
{ 0.190131f, -0.084704f, -0.459292f }, { 0.201236f, 0.086337f, -0.301350f },
{ 0.256147f, -0.084705f, -0.256286f }, { 0.256147f, 0.086337f, -0.256286f },
{ 0.201236f, -0.084705f, -0.301350f }, { 0.351398f, -0.084704f, -0.351537f },
{ 0.351398f, 0.086335f, -0.351537f }, { 0.276074f, -0.084704f, -0.413353f },
{ 0.276074f, 0.086335f, -0.413353f }, { 0.301218f, -0.084705f, -0.201369f },
{ 0.301218f, 0.086337f, -0.201369f }, { 0.256154f, -0.084705f, -0.256280f },
{ 0.256154f, 0.086337f, -0.256280f }, { 0.413221f, 0.086335f, -0.276207f },
{ 0.413221f, -0.084704f, -0.276207f }, { 0.351405f, 0.086335f, -0.351531f },
{ 0.351405f, -0.084704f, -0.351531f }, { 0.334709f, 0.086337f, -0.138715f },
{ 0.301223f, 0.086337f, -0.201362f }, { 0.334709f, -0.084705f, -0.138715f },
{ 0.301223f, -0.084705f, -0.201362f }, { 0.459160f, -0.084704f, -0.190264f },
{ 0.459160f, 0.086335f, -0.190264f }, { 0.413226f, 0.086335f, -0.276200f },
{ 0.413226f, -0.084704f, -0.276200f }, { 0.334713f, -0.084705f, -0.138707f },
{ 0.355333f, -0.084705f, -0.070731f }, { 0.334713f, 0.086337f, -0.138707f },
{ 0.355333f, 0.086337f, -0.070731f }, { 0.459164f, 0.086335f, -0.190257f },
{ 0.487450f, 0.086335f, -0.097010f }, { 0.487450f, -0.084704f, -0.097010f },
{ 0.459164f, -0.084704f, -0.190257f }, { 0.355335f, -0.084705f, -0.070722f },
{ 0.362298f, -0.084705f, -0.000029f }, { 0.355335f, 0.086337f, -0.070722f },
{ 0.362298f, 0.086337f, -0.000029f }, { 0.497003f, -0.084704f, -0.000029f },
{ 0.497003f, 0.086335f, -0.000029f }, { 0.487452f, 0.086335f, -0.097002f },
{ 0.487452f, -0.084704f, -0.097002f }, { 0.362298f, -0.084705f, -0.000021f },
{ 0.497003f, -0.084704f, -0.000021f }, { 0.355336f, -0.084705f, 0.070673f },
{ 0.487453f, -0.084704f, 0.096952f }, { 0.497003f, 0.086335f, -0.000021f },
{ 0.362298f, 0.086337f, -0.000021f }, { 0.355336f, 0.086337f, 0.070673f },
{ 0.487453f, 0.086335f, 0.096952f }, { 0.355334f, -0.084705f, 0.070681f },
{ 0.355334f, 0.086337f, 0.070681f }, { 0.487451f, 0.086335f, 0.096961f },
{ 0.487451f, -0.084704f, 0.096961f }, { 0.334714f, -0.084705f, 0.138658f },
{ 0.459165f, -0.084704f, 0.190207f }, { 0.334714f, 0.086337f, 0.138658f },
{ 0.459165f, 0.086335f, 0.190207f }, { 0.334711f, 0.086337f, 0.138666f },
{ 0.301225f, 0.086337f, 0.201313f }, { 0.459163f, 0.086335f, 0.190215f },
{ 0.413229f, 0.086335f, 0.276151f }, { 0.334711f, -0.084705f, 0.138666f },
{ 0.301225f, -0.084705f, 0.201313f }, { 0.413229f, -0.084704f, 0.276151f },
{ 0.459163f, -0.084704f, 0.190215f }, { 0.301221f, -0.084705f, 0.201321f },
{ 0.256157f, -0.084705f, 0.256232f }, { 0.301221f, 0.086337f, 0.201321f },
{ 0.256157f, 0.086337f, 0.256232f }, { 0.413224f, -0.084704f, 0.276159f },
{ 0.413224f, 0.086335f, 0.276159f }, { 0.351408f, 0.086335f, 0.351483f },
{ 0.351408f, -0.084704f, 0.351483f }, { 0.201240f, -0.084705f, 0.301302f },
{ 0.201240f, 0.086337f, 0.301302f }, { 0.256151f, -0.084705f, 0.256238f },
{ 0.256151f, 0.086337f, 0.256238f }, { 0.351402f, 0.086335f, 0.351489f },
{ 0.351402f, -0.084704f, 0.351489f }, { 0.276078f, 0.086335f, 0.413305f },
{ 0.276078f, -0.084704f, 0.413305f }, { 0.138586f, -0.084705f, 0.334793f },
{ 0.201233f, -0.084705f, 0.301307f }, { 0.190135f, -0.084704f, 0.459244f },
{ 0.276071f, -0.084704f, 0.413311f }, { 0.201233f, 0.086337f, 0.301307f },
{ 0.138586f, 0.086337f, 0.334793f }, { 0.276071f, 0.086335f, 0.413311f },
{ 0.190135f, 0.086335f, 0.459244f }, { 0.138578f, -0.084705f, 0.334797f },
{ 0.070602f, -0.084705f, 0.355417f }, { 0.138578f, 0.086337f, 0.334797f },
{ 0.070602f, 0.086337f, 0.355417f }, { 0.190127f, 0.086335f, 0.459248f },
{ 0.190127f, -0.084704f, 0.459248f }, { 0.096881f, 0.086335f, 0.487534f },
{ 0.096881f, -0.084704f, 0.487534f }, { 0.070593f, -0.084705f, 0.355419f },
{ 0.096873f, 0.086335f, 0.487536f }, { 0.096873f, -0.084704f, 0.487536f },
{ 0.070593f, 0.086337f, 0.355419f }, { -0.000100f, 0.086337f, 0.362382f },
{ -0.000100f, 0.086335f, 0.497087f }, { -0.000100f, -0.084704f, 0.497087f },
{ -0.000100f, -0.084705f, 0.362382f },
};
typedef struct WheelHullSpan
{
int offset;
int count;
} WheelHullSpan;
static const WheelHullSpan s_metalWheel1Hulls[37] = {
{ 0, 29 }, { 29, 8 }, { 37, 8 }, { 45, 8 }, { 53, 8 }, { 61, 8 }, { 69, 8 }, { 77, 8 },
{ 85, 8 }, { 93, 8 }, { 101, 8 }, { 109, 8 }, { 117, 8 }, { 125, 8 }, { 133, 8 }, { 141, 8 },
{ 149, 8 }, { 157, 8 }, { 165, 8 }, { 173, 8 }, { 181, 8 }, { 189, 8 }, { 197, 8 }, { 205, 8 },
{ 213, 8 }, { 221, 8 }, { 229, 8 }, { 237, 8 }, { 245, 8 }, { 253, 8 }, { 261, 8 }, { 269, 8 },
{ 277, 8 }, { 285, 8 }, { 293, 8 }, { 301, 8 }, { 309, 8 },
};
#define s_metalWheel1HullCount 37
// 30 metal_wheel1 props (37-piece convex decompositions) stacked. Body-pair contact merging
// lets them settle and sleep instead of wobbling.
class WheelStack : public Sample
{
public:
explicit WheelStack( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 0.0f, 12.0f, 5.0f, { 0.0f, 0.85f, 0.0f } );
}
AddGroundBox( 10.0f );
constexpr int N = 512;
b3Vec3 buffer[N];
int bufferCount = 0;
for ( int h = 0; h < s_metalWheel1HullCount; ++h )
{
const WheelHullSpan& span = s_metalWheel1Hulls[h];
m_hulls[h] = b3CreateHull( &s_metalWheel1Verts[span.offset], span.count, span.count );
const b3Vec3* points = b3GetHullPoints( m_hulls[h] );
for ( int j = 0; j < m_hulls[h]->vertexCount && bufferCount < N; ++j )
{
buffer[bufferCount] = points[j];
++bufferCount;
}
}
// Create a single hull that wraps the input hulls.
b3HullData* wheelHull = b3CreateHull( buffer, bufferCount, bufferCount );
const float height = 0.171f;
const float spacing = height + 0.006f;
const float startY = 0.5f * height + 0.004f;
b3ShapeDef shapeDef = b3DefaultShapeDef();
shapeDef.baseMaterial.friction = 0.6f;
for ( int i = 0; i < m_wheelCount; ++i )
{
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.type = b3_dynamicBody;
bodyDef.name = "wheel";
bodyDef.position = { 0.0f, startY + i * spacing, 0.0f };
b3BodyId bodyId = b3CreateBody( m_worldId, &bodyDef );
// for ( int h = 0; h < s_metalWheel1HullCount; ++h )
//{
// b3CreateHullShape( bodyId, &shapeDef, m_hulls[h] );
// }
// Using a single hull improves the simulation.
b3CreateHullShape( bodyId, &shapeDef, wheelHull );
}
b3DestroyHull( wheelHull );
b3World_SetContactTuning( m_worldId, 240.0f, 10.0f, 3.0f );
}
~WheelStack() override
{
for ( int h = 0; h < s_metalWheel1HullCount; ++h )
{
b3DestroyHull( m_hulls[h] );
}
}
void Step() override
{
Sample::Step();
b3Profile p = b3World_GetProfile( m_worldId );
float substepRate = m_context->hertz * m_context->subStepCount;
DrawTextLine( "wheels %d, hull pieces/wheel %d (%d total shapes)", m_wheelCount,
s_metalWheel1HullCount, m_wheelCount * s_metalWheel1HullCount );
DrawTextLine( "step %.0f hz, sub-steps %d -> substep rate %.0f hz", m_context->hertz,
m_context->subStepCount, substepRate );
DrawTextLine( "eff contact hz = min(240, %.0f) = %.0f", 0.125f * substepRate,
b3MinFloat( 240.0f, 0.125f * substepRate ) );
DrawTextLine( "step %.3f ms | collide %.3f ms (%.0f%%) | solve %.3f ms (%.0f%%)", p.step,
p.collide, p.step > 0.0f ? 100.0f * p.collide / p.step : 0.0f, p.solve,
p.step > 0.0f ? 100.0f * p.solve / p.step : 0.0f );
}
static Sample* Create( SampleContext* context )
{
return new WheelStack( context );
}
b3HullData* m_hulls[s_metalWheel1HullCount];
static constexpr int m_wheelCount = 30;
};
static int sampleWheelStack = RegisterSample( "Issues", "GMod Wheel Stack", WheelStack::Create );
// There was a problem where this bouncing box could gain energy. This has been fixed by the
// deferred restitution update.
class RestitutionOvershoot : public Sample
{
public:
static constexpr float m_boxHalf = 0.5f;
static constexpr float m_floorHalfXZ = 0.375f;
static constexpr float m_floorHalfY = 0.25f;
static constexpr float m_dropHeight = 10.0f;
static constexpr float m_tolerance = 0.05f;
explicit RestitutionOvershoot( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 20.0f, 0.0f, 28.0f, { 0.0f, m_dropHeight + m_boxHalf, 0.0f } );
}
b3BoxHull floor = b3MakeBoxHull( m_floorHalfXZ, m_floorHalfY, m_floorHalfXZ );
b3BodyDef floorDef = b3DefaultBodyDef();
floorDef.type = b3_staticBody;
floorDef.position = { 0.0f, -m_floorHalfY, 0.0f };
b3BodyId floorBody = b3CreateBody( m_worldId, &floorDef );
b3ShapeDef floorShape = b3DefaultShapeDef();
b3CreateHullShape( floorBody, &floorShape, &floor.base );
b3BoxHull box = b3MakeBoxHull( m_boxHalf, m_boxHalf, m_boxHalf );
b3BodyDef boxDef = b3DefaultBodyDef();
boxDef.type = b3_dynamicBody;
boxDef.position = { 0.0f, m_dropHeight, 0.0f };
boxDef.safetyFactor = 0.1f;
m_boxBody = b3CreateBody( m_worldId, &boxDef );
b3ShapeDef boxShape = b3DefaultShapeDef();
boxShape.baseMaterial.restitution = 1.0f;
b3CreateHullShape( m_boxBody, &boxShape, &box.base );
m_currentY = m_dropHeight;
m_maxBounceY = 0.0f;
m_bounced = false;
m_failed = false;
m_startEnergy = MeasureEnergy( m_worldId, &m_boxBody, 1 ).Total();
m_maxEnergy = m_startEnergy;
m_energyFailed = false;
}
void Step() override
{
Sample::Step();
if ( B3_IS_NON_NULL( m_boxBody ) == false )
{
return;
}
b3Pos position = b3Body_GetPosition( m_boxBody );
m_currentY = position.y;
b3Vec3 velocity = b3Body_GetLinearVelocity( m_boxBody );
if ( m_bounced == false && velocity.y > 0.0f )
{
m_bounced = true;
}
if ( m_bounced )
{
if ( position.y > m_maxBounceY )
{
m_maxBounceY = position.y;
}
if ( position.y > m_dropHeight + m_tolerance )
{
m_failed = true;
}
}
b3Pos markerPoint = { 0.0f, m_dropHeight + m_boxHalf, 0.0f };
DrawPlane( b3Vec3_axisY, markerPoint, MakeColor( b3_colorYellow ) );
// Perfect restitution and no friction, so the total energy may only decrease. It is the
// honest invariant here: the height check cannot tell a bounce that gained potential energy
// from one that converted it into spin, and this drop does both.
MechanicalEnergy energy = MeasureEnergy( m_worldId, &m_boxBody, 1 );
float total = energy.Total();
if ( total > m_maxEnergy )
{
m_maxEnergy = total;
}
if ( m_bounced && total > m_startEnergy * ( 1.0f + m_energyTolerance ) )
{
m_energyFailed = true;
}
DrawTextLine( "drop height = %.2f m", m_dropHeight );
DrawTextLine( "current y = %.2f m", m_currentY );
DrawTextLine( "max bounce = %.2f m", m_maxBounceY );
DrawTextLine( "kinetic = %.0f J linear + %.0f J angular", energy.linear,
energy.angular );
DrawTextLine( "potential = %.0f J", energy.potential );
DrawTextLine( "total = %.0f J (%.2f%% of start, peak %.2f%%)", total,
100.0f * total / m_startEnergy, 100.0f * m_maxEnergy / m_startEnergy );
if ( m_bounced == false )
{
DrawTextLine( "waiting for first bounce..." );
}
else if ( m_failed )
{
DrawTextLine( "FAIL: box exceeded drop height" );
}
else
{
DrawTextLine( "PASS: bounce stays at or below drop height" );
}
if ( m_energyFailed )
{
DrawTextLine( "FAIL: total energy increased" );
}
else if ( m_bounced )
{
DrawTextLine( "PASS: total energy did not increase" );
}
}
static Sample* Create( SampleContext* context )
{
return new RestitutionOvershoot( context );
}
static constexpr float m_energyTolerance = 0.001f;
b3BodyId m_boxBody = {};
float m_currentY = 0.0f;
float m_maxBounceY = 0.0f;
float m_startEnergy = 0.0f;
float m_maxEnergy = 0.0f;
bool m_bounced = false;
bool m_failed = false;
bool m_energyFailed = false;
};
static int sampleRestitutionOvershoot =
RegisterSample( "Issues", "Restitution Overshoot", RestitutionOvershoot::Create );
class SlideTwistOffCenterShape : public Sample
{
public:
explicit SlideTwistOffCenterShape( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( -30.0f, 17.0f, 30.0f, { 0.0f, 5.0f, 0.0f } );
}
AddGroundBox( 50.0f );
b3Quat orientation = b3MakeQuatFromAxisAngle( b3Vec3_axisX, 20.0f * B3_DEG_TO_RAD );
b3BodyDef bodyDef = b3DefaultBodyDef();
b3ShapeDef shapeDef = b3DefaultShapeDef();
bodyDef.position = { 0.0f, 4.0f, 0.0f };
bodyDef.rotation = orientation;
b3BodyId planeBody = b3CreateBody( m_worldId, &bodyDef );
b3BoxHull plane = b3MakeBoxHull( 10.0f, 0.5f, 10.0f );
shapeDef.baseMaterial.friction = 0.6f;
b3CreateHullShape( planeBody, &shapeDef, &plane.base );
b3Vec3 boxLocalCenter = { 1.0f, 0.5f, 1.0f };
b3Vec3 boxOffset = b3RotateVector( orientation, boxLocalCenter );
bodyDef.type = b3_dynamicBody;
bodyDef.position = { -boxOffset.x, 5.0f - boxOffset.y, -boxOffset.z };
bodyDef.rotation = orientation;
// bodyDef.angularVelocity = 25.0f * b3RotateVector( orientation, b3Vec3_axisY );
b3BodyId boxBody = b3CreateBody( m_worldId, &bodyDef );
b3BoxHull mBox = b3MakeOffsetBoxHull( 1.0f, 0.5f, 1.0f, boxLocalCenter );
shapeDef.baseMaterial.friction = 0.3f;
b3CreateHullShape( boxBody, &shapeDef, &mBox.base );
b3Body_SetAngularVelocity( boxBody, 25.0f * b3RotateVector( orientation, b3Vec3_axisY ) );
}
static Sample* Create( SampleContext* context )
{
return new SlideTwistOffCenterShape( context );
}
};
static int sampleSlideTwistOffCenterShape =
RegisterSample( "Issues", "Slide Twist Off Center Shape", SlideTwistOffCenterShape::Create );
// Very large dynamic bodies have overflow when computing the inertia tensor.
class HugeBox : public Sample
{
public:
explicit HugeBox( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 0.0f, 25.0f, 10.0f, b3Pos_zero );
}
AddGroundBox( 400.0f );
{
float a = 100.0f;
b3BoxHull cube = b3MakeCubeHull( a );
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.name = "cube";
bodyDef.type = b3_dynamicBody;
bodyDef.position = { 0.0f, a, 0.0f };
bodyDef.rotation = b3MakeQuatFromAxisAngle( { 0.0f, 0.0f, 1.0f }, 0.2f );
m_bodyId = b3CreateBody( m_worldId, &bodyDef );
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3CreateHullShape( m_bodyId, &shapeDef, &cube.base );
}
}
static Sample* Create( SampleContext* context )
{
return new HugeBox( context );
}
b3BodyId m_bodyId;
};
static int sampleHugeBox = RegisterSample( "Issues", "Huge Box", HugeBox::Create );
// A tilted cylinder whose bounds cover more than 512 height field triangles
class HeightfieldIssue : public Sample
{
public:
explicit HeightfieldIssue( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( -90.0f, 5.0f, 50.0f, { 50.0f, 10.0f, 50.0f } );
}
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3BodyDef bodyDef = b3DefaultBodyDef();
m_heightField = b3CreateGrid( 100, 100, { 1, 1, 1 }, false );
b3BodyId groundId = b3CreateBody( m_worldId, &bodyDef );
b3CreateHeightFieldShape( groundId, &shapeDef, m_heightField );
b3HullData* hull = b3CreateCylinder( 20, 5, -10, 24 );
bodyDef.type = b3_dynamicBody;
bodyDef.position = { 50, 20, 50 };
bodyDef.rotation = b3MakeQuatFromAxisAngle( b3Vec3_axisX, B3_PI / 4 );
b3BodyId bodyId = b3CreateBody( m_worldId, &bodyDef );
b3CreateHullShape( bodyId, &shapeDef, hull );
b3DestroyHull( hull );
}
~HeightfieldIssue() override
{
b3DestroyHeightField( m_heightField );
}
static Sample* Create( SampleContext* context )
{
return new HeightfieldIssue( context );
}
b3HeightFieldData* m_heightField;
};
static int sampleIssueIndex = RegisterSample( "Issues", "Heightfield", HeightfieldIssue::Create );
// Issue #135: the quasi static push out idiom, zero the velocity then step, drives a deeply
// overlapping body out through a thin static wall instead of back into the room. The solver
// resolves along the shallow exit, so once the mover center crosses the wall mid plane every
// step compounds the error outward. Interior is -x, exterior is +x. The wire box marks where
// a mover resting flush against the interior face belongs.
// This is NOT a bug. This is just how the separating axis works. I'm keeping this sample
// in case there is further discussion.
class ThinWallPushOut : public Sample
{
public:
static constexpr float m_wallHalfThickness = 0.1f;
static constexpr float m_wallHalfHeight = 1.5f;
static constexpr float m_moverHalfExtent = 0.5f;
static constexpr float m_tolerance = 0.01f;
explicit ThinWallPushOut( SampleContext* context )
: Sample( context )
{
if ( context->restart == false )
{
m_camera->SetView( 20.0f, 15.0f, 6.0f, { 0.0f, m_wallHalfHeight, 0.0f } );
}
// Furniture is dragged into place, never dropped
b3World_SetGravity( m_worldId, b3Vec3_zero );
AddGroundBox( 20.0f );
b3ShapeDef shapeDef = b3DefaultShapeDef();
b3BodyDef bodyDef = b3DefaultBodyDef();
bodyDef.name = "wall";
bodyDef.position = { 0.0f, m_wallHalfHeight, 0.0f };
b3BodyId wallId = b3CreateBody( m_worldId, &bodyDef );
b3BoxHull wall = b3MakeBoxHull( m_wallHalfThickness, m_wallHalfHeight, 2.0f );
b3CreateHullShape( wallId, &shapeDef, &wall.base );
bodyDef.name = "mover";
bodyDef.type = b3_dynamicBody;
bodyDef.position = { m_startX, m_wallHalfHeight, 0.0f };
// Velocity is zeroed every step, so without this the mover falls asleep on the first one
bodyDef.enableSleep = false;
// A room planner slides items on the floor plane and yaws them to face a wall
bodyDef.motionLocks = { false, true, false, true, false, true };
m_moverId = b3CreateBody( m_worldId, &bodyDef );
b3BoxHull mover = b3MakeBoxHull( m_moverHalfExtent, m_moverHalfExtent, m_moverHalfExtent );
shapeDef.baseMaterial.friction = 0.0f;
b3CreateHullShape( m_moverId, &shapeDef, &mover.base );
}
void PlaceMover()
{
b3Body_SetTransform( m_moverId, { m_startX, m_wallHalfHeight, 0.0f }, b3Quat_identity );
b3Body_SetLinearVelocity( m_moverId, b3Vec3_zero );
b3Body_SetAngularVelocity( m_moverId, b3Vec3_zero );
}
bool DrawControls() override
{
ImGui::PushItemWidth( 6.0f * ImGui::GetFontSize() );
// Anywhere past the wall mid plane tunnels out, even while the near face is far deeper
bool changed = ImGui::SliderFloat( "Start X", &m_startX, -0.6f, 0.6f, "%.2f" );
changed = changed || ImGui::Button( "Reset Mover" );
if ( changed )
{
PlaceMover();
}
ImGui::PopItemWidth();
return true;
}
void Step() override
{
// The reported idiom. Zeroing the velocity leaves the penetration correction as the
// only thing that can move the body.
b3Body_SetLinearVelocity( m_moverId, b3Vec3_zero );
b3Body_SetAngularVelocity( m_moverId, b3Vec3_zero );
Sample::Step();
float interiorRestX = -m_wallHalfThickness - m_moverHalfExtent;
float exteriorRestX = m_wallHalfThickness + m_moverHalfExtent;
b3Vec3 lower = { interiorRestX - m_moverHalfExtent, m_wallHalfHeight - m_moverHalfExtent,
-m_moverHalfExtent };
b3Vec3 upper = { interiorRestX + m_moverHalfExtent, m_wallHalfHeight + m_moverHalfExtent,
m_moverHalfExtent };
DrawAabb( lower, upper, MakeColor( b3_colorLime ) );
float x = (float)b3Body_GetPosition( m_moverId ).x;
DrawTextLine( "start x = %.3f m", m_startX );
DrawTextLine( "current x = %.3f m", x );
DrawTextLine( "interior rest x = %.3f m", interiorRestX );
if ( b3AbsFloat( x - exteriorRestX ) < m_tolerance )
{
DrawTextLine( "FAIL: mover pushed out of the room" );
}
else if ( b3AbsFloat( x - interiorRestX ) < m_tolerance )
{
DrawTextLine( "PASS: mover pushed back into the room" );
}
else
{
DrawTextLine( "relaxing ..." );
}
}
static Sample* Create( SampleContext* context )
{
return new ThinWallPushOut( context );
}
b3BodyId m_moverId = {};
float m_startX = 0.2f;
};
static int sampleThinWallPushOut =
RegisterSample( "Issues", "Thin Wall Push Out", ThinWallPushOut::Create );