box3d/samples/gfx/debug_adapter.h
Erin Catto 3362633204
Dynamic Mover (#202)
Port the dynamic character mover from Box2D including the mover joint
and pogo joint.

Match the mover and sample structure of Box2D.
2026-10-27 22:33:17 -07:00

63 lines
2.3 KiB
C

// SPDX-FileCopyrightText: 2026 Erin Catto
// SPDX-License-Identifier: MIT
#pragma once
#include "box3d/types.h"
#include "gfx/utility.h"
#ifdef __cplusplus
extern "C"
{
#endif
// World-space minor-cell size of the procedural ground grid (meters). Major
// lines fire every 10 cells inside the shader. Shared so the host can wrap the
// draw origin to the grid period and keep the grid crisp far from the origin.
#define BOX3D_GROUND_GRID_CELL_SIZE 1.0f
// Shapes carrying this name draw with the grid instead of a solid material.
#define BOX3D_GROUND_SHAPE_NAME "ground"
void InitAdapter( void );
// Unconditionally flush the debug-shape pool: release the GPU mesh references
// held by live hull/mesh/heightfield shapes and rebuild the free list. Call
// before b3DestroyWorld (or on scene switch). Defensive even when
// destroyDebugShape already fired for every shape. After this,
// GetDebugShapeCount() == 0 and the next world allocates from the pool bottom.
void ResetAdapterPool( void );
void AttachToWorldDef( b3WorldDef* def );
void MakeDebugDraw( b3DebugDraw* out );
b3DebugDraw* GetGuiDraw( void );
void ApplyGuiFlags( b3DebugDraw* out );
int GetDebugShapeCount( void );
// Tag a Box3D shape so the renderer draws it with the procedural ground grid. The tag is the shape
// name, which lives in the world rather than in the renderer, so it is captured by a recording and
// comes back on replay. Ignores an invalid shape, which lets a scene hand over a ground it may not
// have created.
void SetGroundShape( b3ShapeId shapeId );
void SetShapeMaterial( b3ShapeId shapeId, Vec4 color, float metallic, float roughness );
void SetTransparentDynamic( bool enabled );
void SetTransparentKinematic( bool enabled );
void SetBodyAlpha( b3BodyId bodyId, float alpha );
// View box for compound child culling, world space. Set once per frame before
// b3World_Draw. A compound then submits only the children overlapping this box
// instead of walking its entire child set.
void SetViewBounds( b3AABB bounds );
// Children appended in the last draw, and the total across drawn compounds.
int GetLastCompoundDrawStats( int* outTotal );
void SetSelectedBody( b3BodyId bodyId );
void SetSelectedShape( b3ShapeId shapeId );
void ClearSelection( void );
b3BodyId GetSelectedBody( void );
bool IsBodySelected( b3BodyId bodyId );
#ifdef __cplusplus
} // extern "C"
#endif