physics_settings.hpp

Go to the documentation of this file.

 
#pragma once
#include <cstdint>
#include <glm/glm.hpp>
#include <toast/export.hpp>
 
namespace physics {
 
struct Tunables {
  glm::vec3 gravity {0.0f, 0.0f, -9.8f};
  uint32_t solver_iterations = 8;
  float penetration_slop = 0.005f;
  float correction_beta = 0.2f;
  float max_correction = 0.05f;
  float bounce_threshold = 1.0f;
  float sleep_linear_threshold = 0.05f;
  float sleep_angular_threshold = 0.05f;
  float sleep_delay = 0.5f;
  float sleep_drift = 0.05f;
  double frequency = 60.0;
  uint32_t max_substeps = 8;
  double max_burst_seconds = 0.1;
  float broadphase_fat_margin = 0.1f;
  uint32_t max_connectivity_jobs_per_tick = 24;
  uint32_t max_fragment_spawns_per_step = 8;
  uint32_t max_active_fragments = 96;
  uint32_t fragment_pool_headroom = 4096;
  uint32_t min_fragment_voxels = 4;
  uint32_t fragment_despawn_max_voxels = 16;
  uint32_t large_debris_min_voxels = 16;
  float fragment_despawn_settle_seconds = 3.0f;
  float force_sleep_slack = 4.0f;
  float fragment_sleep_scale = 3.0f;
  int32_t max_fragment_extent_bricks = 1;
  float fracture_shell_voxels = 1.0f;
  float fracture_depth_share = 0.5f;
  float fracture_max_depth = 2.0f;
  float fracture_max_overshoot = 2.0f;
  float fracture_bond_cost = 1.0f;
  uint32_t fracture_max_unglue_voxels = 4096;
  float fracture_debris_split_chance = 0.35f;
  uint32_t fracture_max_shatter_cells = 128;
  float fracture_max_shatter_distance = 8.0f;
  uint32_t debris_max_spawns_per_step = 512;
  float debris_speed_scale = 1.0f;
  float debris_lifetime = 60.0f;
  uint32_t debris_max_particles = 16384;
  float debris_restitution = 0.3f;
  float debris_friction = 0.6f;
  float explosion_max_radius = 8.0f;
  float explosion_falloff = 2.0f;
  uint32_t impact_max_hardness = 1;
  uint32_t min_bounds_per_job = 32;
  uint32_t min_candidates_per_job = 2;
  uint32_t min_manifolds_per_job = 4;
  uint32_t min_shapes_per_query_job = 16;
  uint32_t min_bodies_per_job = 64;
  uint32_t min_wave_constraints_for_dispatch = 512;
  uint32_t box_voxel_split_min_voxels = 500000;
  uint32_t voxel_voxel_split_min_voxels = 250000;
  uint32_t voxel_pair_split_regions = 8;
  uint32_t sweep_refine_iterations = 6;
  uint32_t position_iterations = 3;
  float air_density = 1.225f;
  glm::vec3 wind = {0.0f, 0.0f, 0.0f};
  float wind_shelter_distance = 64.0f;
 
  [[nodiscard]]
  auto fixedDelta() const noexcept -> double {
    return frequency > 0.0 ? 1.0 / frequency : 1.0 / 60.0;
  }
};
 
[[nodiscard]]
TOAST_API auto tunables() -> const Tunables&;
 
TOAST_API void registerPhysicsSettings();
 
}