2026-05-10 13:36:52 -07:00
|
|
|
// SPDX-FileCopyrightText: 2025 Erin Catto
|
|
|
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
#include "gfx/debug_adapter.h"
|
|
|
|
|
#include "gfx/keycodes.h"
|
|
|
|
|
#include "gfx/renderer.h"
|
|
|
|
|
#include "host/gui.h"
|
2026-05-10 13:36:52 -07:00
|
|
|
#include "sample.h"
|
2026-06-06 10:06:05 -07:00
|
|
|
#include "sokol_app.h"
|
|
|
|
|
#include "sokol_glue.h"
|
|
|
|
|
|
|
|
|
|
#include "box3d/box3d.h"
|
|
|
|
|
#include "box3d/math_functions.h"
|
2026-06-18 20:51:16 -07:00
|
|
|
#include "gfx/draw.h"
|
2026-05-10 13:36:52 -07:00
|
|
|
|
|
|
|
|
#include <stdio.h>
|
2026-06-06 10:06:05 -07:00
|
|
|
#include <stdlib.h>
|
|
|
|
|
#include <string.h>
|
|
|
|
|
#include <thread>
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
#if defined( _WIN32 )
|
|
|
|
|
#define WIN32_LEAN_AND_MEAN
|
|
|
|
|
#define NOMINMAX
|
|
|
|
|
// clang-format off
|
|
|
|
|
#include <windows.h>
|
|
|
|
|
#include <timeapi.h> // timeBeginPeriod for fine sleep granularity
|
|
|
|
|
// clang-format on
|
|
|
|
|
#pragma comment( lib, "winmm.lib" ) // MSVC auto-link
|
2026-05-10 13:36:52 -07:00
|
|
|
#endif
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static SampleContext s_context;
|
|
|
|
|
static int s_frame = 0;
|
|
|
|
|
static int s_frameLimit = -1;
|
|
|
|
|
static int s_sampleOverride = -1;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static int CompareSamples( const void* a, const void* b )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
SampleEntry* entryA = (SampleEntry*)a;
|
|
|
|
|
SampleEntry* entryB = (SampleEntry*)b;
|
|
|
|
|
|
|
|
|
|
int result = strcmp( entryA->Category, entryB->Category );
|
|
|
|
|
if ( result == 0 )
|
|
|
|
|
{
|
|
|
|
|
result = strcmp( entryA->Name, entryB->Name );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return result;
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static void SortSamples()
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-28 10:44:34 -07:00
|
|
|
// Sorting reorders the table, so recover the replay viewer's slot by identity.
|
|
|
|
|
SampleCreateFcn* replayFcn = ( g_replayIndex >= 0 ) ? g_sampleEntries[g_replayIndex].CreateFcn : nullptr;
|
2026-06-06 10:06:05 -07:00
|
|
|
qsort( g_sampleEntries, g_sampleCount, sizeof( SampleEntry ), CompareSamples );
|
2026-06-28 10:44:34 -07:00
|
|
|
if ( replayFcn != nullptr )
|
|
|
|
|
{
|
|
|
|
|
g_replayIndex = -1;
|
|
|
|
|
for ( int i = 0; i < g_sampleCount; ++i )
|
|
|
|
|
{
|
|
|
|
|
if ( g_sampleEntries[i].CreateFcn == replayFcn )
|
|
|
|
|
{
|
|
|
|
|
g_replayIndex = i;
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// Single host UI callback fired from inside StartUIFrame: menu bar, panels, and
|
|
|
|
|
// the active sample's drawer.
|
|
|
|
|
static void OnDrawUI( void )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
DrawUI( &s_context );
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static void OnInit( void )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
#if defined( _WIN32 )
|
|
|
|
|
timeBeginPeriod( 1 );
|
|
|
|
|
#endif
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
const sg_environment env = sglue_environment();
|
|
|
|
|
InitRenderer( &env );
|
|
|
|
|
InitUI( &env, OnDrawUI );
|
|
|
|
|
InitAdapter();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
constexpr float DEG = 3.14159265358979323846f / 180.0f;
|
|
|
|
|
s_context.camera.SetFov( 50.0f * DEG );
|
2026-06-26 21:10:10 -07:00
|
|
|
s_context.camera.SetClip( 0.1f, Camera::kViewDistance );
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
s_context.Load();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-28 10:44:34 -07:00
|
|
|
// First run with no settings opens with the controls window up.
|
|
|
|
|
s_context.showControls = s_context.newUser;
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
int cores = (int)std::thread::hardware_concurrency();
|
|
|
|
|
s_context.workerCount = b3ClampInt( cores / 2, 1, 8 );
|
|
|
|
|
s_context.windowWidth = sapp_width();
|
|
|
|
|
s_context.windowHeight = sapp_height();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
SortSamples();
|
|
|
|
|
|
2026-06-28 10:44:34 -07:00
|
|
|
// A first run with no settings opens straight into the replay viewer.
|
|
|
|
|
int index = s_context.sampleIndex;
|
|
|
|
|
if ( s_context.newUser && g_replayIndex >= 0 )
|
|
|
|
|
{
|
|
|
|
|
index = g_replayIndex;
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// --sample N selects a registered sample by sorted index, overriding the
|
|
|
|
|
// persisted one. Lets a headless --frames run target a specific sample.
|
|
|
|
|
if ( s_sampleOverride >= 0 && s_sampleOverride < g_sampleCount )
|
|
|
|
|
{
|
|
|
|
|
index = s_sampleOverride;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
SelectSample( &s_context, index, false );
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static void OnEvent( const sapp_event* e )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-28 10:44:34 -07:00
|
|
|
//if ( e->type == SAPP_EVENTTYPE_KEY_DOWN || e->type == SAPP_EVENTTYPE_CHAR )
|
|
|
|
|
//{
|
|
|
|
|
// volatile int dummy = 0;
|
|
|
|
|
// dummy = 32;
|
|
|
|
|
//}
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-20 23:35:04 -07:00
|
|
|
bool uiCaptured = false;
|
|
|
|
|
if (s_context.camera.m_thirdPerson == false)
|
|
|
|
|
{
|
|
|
|
|
uiCaptured = HandleEvent( e );
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// The camera must always see button releases and focus loss, even when the UI
|
|
|
|
|
// captures the event. Otherwise a release over an ImGui panel never clears the
|
|
|
|
|
// drag flag and the camera keeps orbiting.
|
|
|
|
|
const bool releaseOrUnfocus = e->type == SAPP_EVENTTYPE_MOUSE_UP || e->type == SAPP_EVENTTYPE_UNFOCUSED;
|
2026-06-20 23:35:04 -07:00
|
|
|
if ( uiCaptured == false || releaseOrUnfocus )
|
2026-06-06 10:06:05 -07:00
|
|
|
{
|
|
|
|
|
s_context.camera.OnEvent( e );
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-20 23:35:04 -07:00
|
|
|
if ( uiCaptured )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
|
|
|
|
return;
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// Keep keyboard mods only. sokol packs the held mouse button into modifiers
|
|
|
|
|
// (SAPP_MODIFIER_LMB == 0x100), which would defeat the sample's modifiers == 0 checks.
|
|
|
|
|
const int mods = e->modifiers & ( SAPP_MODIFIER_SHIFT | SAPP_MODIFIER_CTRL | SAPP_MODIFIER_ALT | SAPP_MODIFIER_SUPER );
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
switch ( e->type )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
case SAPP_EVENTTYPE_KEY_DOWN:
|
|
|
|
|
SetKeyDown( e->key_code, true );
|
|
|
|
|
|
|
|
|
|
// Global shortcuts on first press; repeats are ignored. The sokol
|
|
|
|
|
// analog of Box2D's KeyCallback.
|
|
|
|
|
if ( e->key_repeat == false )
|
|
|
|
|
{
|
|
|
|
|
switch ( e->key_code )
|
|
|
|
|
{
|
|
|
|
|
case KEY_TAB:
|
|
|
|
|
s_context.showUI = !s_context.showUI;
|
|
|
|
|
break;
|
|
|
|
|
|
2026-06-28 10:44:34 -07:00
|
|
|
case KEY_ESCAPE:
|
|
|
|
|
// Layered cancel. An open picker is an ImGui popup that
|
|
|
|
|
// already swallowed this. So peel the controls window, then
|
|
|
|
|
// the selection. Quit lives on Ctrl+Q now.
|
|
|
|
|
if ( s_context.showControls )
|
|
|
|
|
{
|
|
|
|
|
s_context.showControls = false;
|
|
|
|
|
}
|
|
|
|
|
else
|
|
|
|
|
{
|
|
|
|
|
ClearSelection();
|
|
|
|
|
}
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_Q:
|
|
|
|
|
if ( mods & MOD_CTRL )
|
|
|
|
|
{
|
|
|
|
|
sapp_request_quit();
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
s_context.sample->Keyboard( e->key_code, ACTION_PRESS, mods );
|
|
|
|
|
break;
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
case KEY_O:
|
|
|
|
|
if ( mods & MOD_CTRL )
|
|
|
|
|
{
|
|
|
|
|
// Ctrl+O opens the fuzzy picker. Force the UI visible so it shows.
|
|
|
|
|
s_context.showUI = true;
|
|
|
|
|
s_context.openSamplePicker = true;
|
|
|
|
|
}
|
|
|
|
|
else
|
|
|
|
|
{
|
|
|
|
|
s_context.singleStep += ( mods & MOD_SHIFT ) ? 5 : 1;
|
|
|
|
|
}
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_P:
|
2026-06-28 10:44:34 -07:00
|
|
|
// Pause stays on P. Space is not bound here on purpose. Global
|
|
|
|
|
// keys are dispatched before the sample sees them, so claiming
|
|
|
|
|
// Space would steal jump from the Mover sample.
|
2026-06-06 10:06:05 -07:00
|
|
|
s_context.pause = !s_context.pause;
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_M:
|
|
|
|
|
s_context.showMetrics = !s_context.showMetrics;
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_R:
|
|
|
|
|
SelectSample( &s_context, s_context.sampleIndex, true );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_LEFT_BRACKET:
|
|
|
|
|
SelectSample( &s_context, b3MaxInt( 0, s_context.sampleIndex - 1 ), false );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_RIGHT_BRACKET:
|
|
|
|
|
SelectSample( &s_context, b3MinInt( g_sampleCount - 1, s_context.sampleIndex + 1 ), false );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case KEY_F:
|
|
|
|
|
{
|
2026-06-26 21:10:10 -07:00
|
|
|
// Frame the selection, or let the sample frame its whole scene when nothing is
|
|
|
|
|
// selected. A non-body selection such as a recorded query supplies its own bounds and
|
|
|
|
|
// takes priority over the hovered body. The replay viewer's scene lives in a
|
|
|
|
|
// player-owned world, not the base world, so the whole-scene case routes through
|
|
|
|
|
// FocusHome.
|
|
|
|
|
Camera& cam = s_context.camera;
|
|
|
|
|
float aspect = cam.m_height > 0 ? (float)cam.m_width / (float)cam.m_height : 1.0f;
|
|
|
|
|
b3AABB bounds;
|
|
|
|
|
if ( s_context.sample->FocusBounds( &bounds ) )
|
2026-06-06 10:06:05 -07:00
|
|
|
{
|
2026-06-26 21:10:10 -07:00
|
|
|
cam.Frame( bounds, aspect, 1.5f );
|
2026-06-06 10:06:05 -07:00
|
|
|
}
|
|
|
|
|
else
|
|
|
|
|
{
|
2026-06-26 21:10:10 -07:00
|
|
|
b3BodyId bodyId = s_context.sample->FocusBody();
|
|
|
|
|
if ( B3_IS_NON_NULL( bodyId ) )
|
|
|
|
|
{
|
|
|
|
|
cam.Frame( b3Body_ComputeAABB( bodyId ), aspect, 1.5f );
|
|
|
|
|
}
|
|
|
|
|
else
|
|
|
|
|
{
|
|
|
|
|
s_context.sample->FocusHome();
|
|
|
|
|
}
|
2026-06-06 10:06:05 -07:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
default:
|
|
|
|
|
s_context.sample->Keyboard( e->key_code, ACTION_PRESS, mods );
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case SAPP_EVENTTYPE_KEY_UP:
|
|
|
|
|
SetKeyDown( e->key_code, false );
|
|
|
|
|
break;
|
|
|
|
|
|
2026-06-28 10:44:34 -07:00
|
|
|
case SAPP_EVENTTYPE_CHAR:
|
|
|
|
|
// ? toggles the controls window. Read the typed character so it works
|
|
|
|
|
// on any layout and a text field can still type a literal ?, since the
|
|
|
|
|
// picker captures the event before it reaches here.
|
|
|
|
|
if ( e->char_code == '?' && e->key_repeat == false )
|
|
|
|
|
{
|
|
|
|
|
s_context.showControls = !s_context.showControls;
|
|
|
|
|
}
|
|
|
|
|
break;
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
case SAPP_EVENTTYPE_MOUSE_DOWN:
|
|
|
|
|
s_context.mouseX = e->mouse_x;
|
|
|
|
|
s_context.mouseY = e->mouse_y;
|
|
|
|
|
s_context.sample->MouseDown( { e->mouse_x, e->mouse_y }, e->mouse_button, mods );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case SAPP_EVENTTYPE_MOUSE_UP:
|
|
|
|
|
s_context.sample->MouseUp( { e->mouse_x, e->mouse_y }, e->mouse_button );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case SAPP_EVENTTYPE_MOUSE_MOVE:
|
|
|
|
|
s_context.mouseX = e->mouse_x;
|
|
|
|
|
s_context.mouseY = e->mouse_y;
|
|
|
|
|
s_context.mouseDX = e->mouse_dx;
|
|
|
|
|
s_context.mouseDY = e->mouse_dy;
|
|
|
|
|
s_context.sample->MouseMove( { e->mouse_x, e->mouse_y } );
|
|
|
|
|
break;
|
|
|
|
|
|
|
|
|
|
case SAPP_EVENTTYPE_RESIZED:
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
int w = sapp_width();
|
|
|
|
|
int h = sapp_height();
|
|
|
|
|
s_context.minimized = ( w == 0 || h == 0 );
|
|
|
|
|
if ( s_context.minimized == false )
|
|
|
|
|
{
|
|
|
|
|
s_context.windowWidth = w;
|
|
|
|
|
s_context.windowHeight = h;
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
2026-06-06 10:06:05 -07:00
|
|
|
break;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
default:
|
|
|
|
|
break;
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// Pace the loop to 60 Hz so the fixed 1/60 physics step plays at real time on any
|
|
|
|
|
// display. Sleep the bulk of the idle time, then spin the last bit since sleep wakes
|
|
|
|
|
// are only accurate to about a millisecond.
|
|
|
|
|
static void LimitFrameRate( uint64_t frameStart )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
const float targetMs = 1000.0f / 60.0f;
|
|
|
|
|
const float spinMs = 2.0f;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
int sleepMs = (int)( targetMs - spinMs - b3GetMilliseconds( frameStart ) );
|
|
|
|
|
if ( sleepMs > 0 )
|
|
|
|
|
{
|
|
|
|
|
b3Sleep( sleepMs );
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
while ( b3GetMilliseconds( frameStart ) < targetMs )
|
|
|
|
|
{
|
|
|
|
|
b3Yield();
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static void OnFrame( void )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
if ( s_frameLimit >= 0 && s_frame >= s_frameLimit )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
sapp_quit();
|
|
|
|
|
return;
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
const uint64_t frameStart = b3GetTicks();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// Nothing to draw while minimized. sapp reports a 0x0 framebuffer then, which
|
|
|
|
|
// would drive the swapchain and every render target to zero size. Pace the
|
|
|
|
|
// loop so it doesn't spin and bail.
|
|
|
|
|
if ( s_context.minimized )
|
|
|
|
|
{
|
|
|
|
|
if ( s_frameLimit < 0 )
|
|
|
|
|
{
|
|
|
|
|
LimitFrameRate( frameStart );
|
|
|
|
|
}
|
|
|
|
|
return;
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-28 10:44:34 -07:00
|
|
|
// Handle a deferred Replay > Open request before any GPU work this frame.
|
|
|
|
|
// The native picker blocks on a nested run loop. Running it here (no pass
|
|
|
|
|
// open, no buffers updated, no ImGui frame begun) keeps it from re-entering
|
|
|
|
|
// a half-built frame the way it did when invoked from inside the UI callback.
|
|
|
|
|
if ( s_context.openReplayPicker )
|
|
|
|
|
{
|
|
|
|
|
s_context.openReplayPicker = false;
|
|
|
|
|
OpenReplayFileDialog( &s_context );
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
const float dt = (float)sapp_frame_duration();
|
|
|
|
|
const int W = sapp_width();
|
|
|
|
|
const int H = sapp_height();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
Camera& camera = s_context.camera;
|
|
|
|
|
camera.Update( dt, W, H );
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-26 21:10:10 -07:00
|
|
|
// Push the current length scale and Z-up choice. The replay player sets length
|
|
|
|
|
// units from its header on load and restores them on close, so querying every
|
|
|
|
|
// frame tracks load/unload without extra wiring. Live samples sit at 1 unit per
|
|
|
|
|
// meter, leaving the transform identity.
|
|
|
|
|
camera.SetRenderTransform( b3GetLengthUnitsPerMeter(), s_context.viewZUp );
|
|
|
|
|
|
2026-06-18 20:51:16 -07:00
|
|
|
// Sync the draw origin to the camera eye once per frame, before any drawing. This must hold even
|
|
|
|
|
// for samples that drive their own Step without calling Sample::Step. Render re-syncs after Step
|
2026-06-26 21:10:10 -07:00
|
|
|
// because a third person follow moves the eye while stepping. The draw origin is in simulation
|
|
|
|
|
// space; the view folds in the scale and up axis.
|
|
|
|
|
SetDrawOrigin( camera.DrawOrigin() );
|
2026-06-18 20:51:16 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
ResetFrameArena();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// Apply the per-frame draw state the UI owns, then advance the sample. Step
|
|
|
|
|
// queues the HUD text; Render fills the instance and overlay arenas via the
|
|
|
|
|
// b3DebugDraw adapter and the sample's own Draw* calls.
|
|
|
|
|
SetTransparentDynamic( s_context.transparentDynamic );
|
|
|
|
|
s_context.sample->ResetText();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
s_context.sample->Step();
|
|
|
|
|
s_context.sample->Render();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
FrameInput fi{};
|
|
|
|
|
fi.view = camera.View();
|
|
|
|
|
fi.viewInv = camera.ViewInverse();
|
|
|
|
|
fi.proj = camera.Proj();
|
|
|
|
|
fi.projInv = camera.ProjInverse();
|
|
|
|
|
fi.cameraPosition = camera.Position();
|
2026-06-18 20:51:16 -07:00
|
|
|
// Read back the origin Render actually shifted to. A follow-cam sample can
|
|
|
|
|
// move it during Step/Render, so reuse the live value rather than the eye.
|
|
|
|
|
b3Pos drawOrigin = GetDrawOrigin();
|
|
|
|
|
fi.drawOrigin = b3ToVec3( drawOrigin );
|
|
|
|
|
// Wrap the origin to the grid period in double, before it narrows to float.
|
|
|
|
|
// A float can't resolve a 1 m cell at 1e7 m, so feeding the raw origin to
|
|
|
|
|
// the grid would shatter the lines. The pattern repeats every 10 cells, so
|
|
|
|
|
// the wrapped offset draws identical lines at any distance.
|
|
|
|
|
double gridPeriod = 10.0 * BOX3D_GROUND_GRID_CELL_SIZE;
|
|
|
|
|
fi.gridWrap.x = (float)fmod( (double)drawOrigin.x, gridPeriod );
|
|
|
|
|
fi.gridWrap.y = (float)fmod( (double)drawOrigin.z, gridPeriod );
|
2026-06-06 10:06:05 -07:00
|
|
|
fi.time = (float)sapp_frame_count() / 60.0f;
|
|
|
|
|
fi.debugMode = s_context.debugView;
|
|
|
|
|
fi.disableShadows = !s_context.enableShadows;
|
|
|
|
|
fi.disableAmbientOcclusion = !s_context.enableGtao;
|
2026-06-26 21:10:10 -07:00
|
|
|
fi.zUp = s_context.viewZUp;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
const sg_swapchain sc = sglue_swapchain();
|
|
|
|
|
RenderFrame( &sc, &fi );
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// StartUIFrame runs after RenderFrame: it drains the text arena with the
|
|
|
|
|
// camera state RenderFrame just latched and runs the UI draw callback.
|
|
|
|
|
StartUIFrame( dt );
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
RenderUI( &sc );
|
|
|
|
|
sg_commit();
|
|
|
|
|
++s_frame;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
if ( s_frameLimit < 0 )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
LimitFrameRate( frameStart );
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
static void OnCleanup( void )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
// Destroy the sample first because it will destroy debug shapes.
|
|
|
|
|
delete s_context.sample;
|
|
|
|
|
s_context.sample = nullptr;
|
|
|
|
|
s_context.Save();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
ShutdownUI();
|
|
|
|
|
ShutdownRenderer();
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
const int errors = GetRenderErrorCount();
|
|
|
|
|
fprintf( stderr, "samples: %d frames, %d sokol errors\n", s_frame, errors );
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
#if defined( _WIN32 )
|
|
|
|
|
timeEndPeriod( 1 );
|
2026-05-10 13:36:52 -07:00
|
|
|
#endif
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
exit( errors == 0 ? 0 : 1 );
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-07-01 23:19:23 -07:00
|
|
|
static void OnAppLog( const char* tag, uint32_t logLevel, uint32_t logItemId, const char* message, uint32_t lineNumber,
|
|
|
|
|
const char* filename, void* userData )
|
|
|
|
|
{
|
|
|
|
|
(void)tag;
|
|
|
|
|
(void)logItemId;
|
|
|
|
|
(void)filename;
|
|
|
|
|
(void)userData;
|
|
|
|
|
(void)lineNumber;
|
|
|
|
|
|
|
|
|
|
const char* level = ( logLevel == 0 ) ? "panic" : ( logLevel == 1 ) ? "error" : ( logLevel == 2 ) ? "warn" : "info";
|
|
|
|
|
fprintf( stderr, "sokol(level %s) %s\n", level, message ? message : "(no message)" );
|
|
|
|
|
|
|
|
|
|
if ( logLevel == 0 )
|
|
|
|
|
{
|
|
|
|
|
fprintf( stderr, "Ensure you have OpenGL 4.5 if on Linux" );
|
|
|
|
|
exit( 1 );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
sapp_desc sokol_main( int argc, char** argv )
|
|
|
|
|
{
|
|
|
|
|
for ( int i = 1; i < argc; ++i )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
if ( strcmp( argv[i], "--frames" ) == 0 && i + 1 < argc )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
s_frameLimit = atoi( argv[++i] );
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
2026-06-06 10:06:05 -07:00
|
|
|
else if ( strcmp( argv[i], "--sample" ) == 0 && i + 1 < argc )
|
2026-05-10 13:36:52 -07:00
|
|
|
{
|
2026-06-06 10:06:05 -07:00
|
|
|
s_sampleOverride = atoi( argv[++i] );
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
2026-07-03 17:15:03 -07:00
|
|
|
else if ( strcmp( argv[i], "--replay" ) == 0 && i + 1 < argc )
|
|
|
|
|
{
|
|
|
|
|
const char* path = argv[++i];
|
|
|
|
|
|
|
|
|
|
if ( g_replayIndex >= 0 )
|
|
|
|
|
{
|
|
|
|
|
snprintf( s_context.replayFile, sizeof( s_context.replayFile ), "%s", path );
|
|
|
|
|
s_sampleOverride = g_replayIndex;
|
|
|
|
|
}
|
|
|
|
|
}
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|
|
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
sapp_desc desc{};
|
|
|
|
|
desc.init_cb = OnInit;
|
|
|
|
|
desc.frame_cb = OnFrame;
|
|
|
|
|
desc.event_cb = OnEvent;
|
|
|
|
|
desc.cleanup_cb = OnCleanup;
|
2026-07-01 23:19:23 -07:00
|
|
|
desc.logger.func = OnAppLog;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// GL 4.5 for glClipControl (reverse-Z). Ignored on D3D11 / Metal.
|
|
|
|
|
desc.gl.major_version = 4;
|
|
|
|
|
desc.gl.minor_version = 5;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
desc.width = 1920;
|
|
|
|
|
desc.height = 1080;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
// No swap-chain MSAA. The renderer runs MSAA in its own scene target.
|
|
|
|
|
desc.sample_count = 1;
|
|
|
|
|
|
2026-06-18 20:51:16 -07:00
|
|
|
// Static so the pointer outlives sokol_main; sokol keeps it for the window lifetime.
|
|
|
|
|
b3Version version = b3GetVersion();
|
|
|
|
|
static char title[64];
|
|
|
|
|
snprintf( title, sizeof( title ), "Box3D %d.%d.%d - %s precision", version.major, version.minor,
|
|
|
|
|
version.revision, b3IsDoublePrecision() ? "double" : "single" );
|
|
|
|
|
desc.window_title = title;
|
2026-06-06 10:06:05 -07:00
|
|
|
|
|
|
|
|
// Vsync off: the software limiter in OnFrame owns the cadence. A hard 60 Hz
|
|
|
|
|
// cap under vsync would beat against a non-60 display and pace to the wrong rate.
|
|
|
|
|
desc.swap_interval = 0;
|
|
|
|
|
desc.high_dpi = true;
|
2026-05-10 13:36:52 -07:00
|
|
|
|
2026-06-06 10:06:05 -07:00
|
|
|
return desc;
|
2026-05-10 13:36:52 -07:00
|
|
|
}
|