Class PhysicsScene

constructor

• new PhysicsScene(engine: Engine, world: PhysicsWorld): PhysicsScene

  Parameters

  • engine: Engine
  • world: PhysicsWorld

  Returns PhysicsScene

Readonlyworld

Readonlydevice

bodyCount

• get bodyCount(): number

  Number of dynamic bodies currently simulated (for HUD readouts).

  Returns number

material

• material(color: RGB, roughness?: number, metallic?: number): PbrMaterial

  Cached PBR material keyed by color + roughness + metallic.

  Parameters

  • color: RGB
  • roughness: number = 0.55
  • metallic: number = 0

  Returns PbrMaterial

spawnBox

• spawnBox(half: Vec3, pos: Vec3, opts?: SpawnOptions): Body

  Spawns a box. half is the half-extent on each axis. Returns the Jolt body.

  Parameters

  • half: Vec3
  • pos: Vec3
  • opts: SpawnOptions = {}

  Returns Body

spawnSphere

• spawnSphere(radius: number, pos: Vec3, opts?: SpawnOptions): Body

  Spawns a sphere. Returns the Jolt body.

  Parameters

  • radius: number
  • pos: Vec3
  • opts: SpawnOptions = {}

  Returns Body

addGround

• addGround(size?: number, color?: RGB): Body

  Adds a large static ground slab (a thin box) plus its visual. The top surface sits at y = 0.

  Parameters

  • size: number = 60
  • color: RGB = ...

  Returns Body

addStaticBox

• addStaticBox(half: Vec3, pos: Vec3, opts?: SpawnOptions): Body

  Convenience for an immovable box (walls, ramps, anchors).

  Parameters

  • half: Vec3
  • pos: Vec3
  • opts: SpawnOptions = {}

  Returns Body

adopt

• adopt(mesh: Mesh): Mesh

  Takes ownership of a demo-built mesh so it's destroyed on the next clear. Returns the mesh for convenient inline use.

  Parameters

  • mesh: Mesh

  Returns Mesh

addStaticMesh

• addStaticMesh(
      renderMesh: Mesh,
      positions: Float32Array,
      indices: Uint32Array,
      opts?: SpawnOptions,
  ): void

  Adds a static triangle-mesh collider (MeshShape) for arbitrary geometry — renderMesh is drawn, positions/indices are the same triangles handed to Jolt. Used for the wavy/ramp surface demo.

  Parameters

  • renderMesh: Mesh
  • positions: Float32Array
  • indices: Uint32Array
  • opts: SpawnOptions = {}

  Returns void

addHeightField

• addHeightField(
      renderMesh: Mesh,
      heights: Float32Array,
      sampleCount: number,
      cellSize: number,
      originX: number,
      originZ: number,
      opts?: SpawnOptions,
  ): void

  Adds a static height-field collider (HeightFieldShape) — the fast terrain path. renderMesh and the height grid come from the same generator.

  Parameters

  • renderMesh: Mesh
  • heights: Float32Array
  • sampleCount: number
  • cellSize: number
  • originX: number
  • originZ: number
  • opts: SpawnOptions = {}

  Returns void

spawnConvexHull

• spawnConvexHull(
      renderMesh: Mesh,
      hull: Vec3[],
      pos: Vec3,
      opts?: SpawnOptions,
  ): Body

  Spawns a dynamic convex-hull body (ConvexHullShape). hull is the point cloud; renderMesh is the matching solid.

  Parameters

  • renderMesh: Mesh
  • hull: Vec3[]
  • pos: Vec3
  • opts: SpawnOptions = {}

  Returns Body

pointLink

• pointLink(body1: Body, body2: Body, worldPivot: Vec3): void

  Links two bodies with a point (ball-and-socket) constraint anchored at a shared world-space pivot. The bread-and-butter joint for chains/pendulums.

  Parameters

  • body1: Body
  • body2: Body
  • worldPivot: Vec3

  Returns void

sync

• sync(): void

  Copies each dynamic body's transform onto its GameObject. Call per frame.

  Returns void

clear

• clear(): void

  Tears the demo down: removes every GameObject and clears the physics world.

  Returns void