@ue-too/dynamics / index / World

類別: World

定義於: world.ts:65

Main physics world managing rigid body simulation.

備註

The World class is the main entry point for physics simulation. It manages all rigid bodies, runs collision detection and response, enforces constraints, and provides performance optimizations like sleeping and spatial indexing.

Simulation Loop

Call world.step(deltaTime) each frame to advance the simulation. This:

1. Updates sleeping states
2. Detects collisions (broad and narrow phase)
3. Resolves collisions with impulses
4. Enforces constraints
5. Updates body positions and velocities

Performance Tuning

• Choose appropriate spatial index for your use case
• Enable sleeping for better performance with many bodies
• Use collision filtering to reduce collision checks

範例

Basic setup

const world = new World(2000, 2000, 'dynamictree');

// Add bodies
const ball = new Circle({ x: 0, y: 100 }, 20, 0, 10, false);
world.addRigidBody('ball', ball);

// Simulation loop
function update(dt: number) {
  world.step(dt);
}

建構函式

建構函式

new World(maxTransWidth, maxTransHeight, spatialIndexType): World

定義於: world.ts:82

參數

maxTransWidth

number

maxTransHeight

number

spatialIndexType

SpatialIndexType = 'dynamictree'

回傳

World

屬性

_context

_context: CanvasRenderingContext2D | null = null

定義於: world.ts:80

存取器

currentSpatialIndexType

Getter 簽章

get currentSpatialIndexType(): SpatialIndexType

定義於: world.ts:284

回傳

SpatialIndexType

---

resolveCollision

Getter 簽章

get resolveCollision(): boolean

定義於: world.ts:231

回傳

boolean

Setter 簽章

set resolveCollision(resolveCollision): void

定義於: world.ts:235

參數

resolveCollision

boolean

回傳

void

---

sleepingEnabled

Getter 簽章

get sleepingEnabled(): boolean

定義於: world.ts:314

回傳

boolean

Setter 簽章

set sleepingEnabled(enabled): void

定義於: world.ts:318

參數

enabled

boolean

回傳

void

---

useLinearCollisionResolution

Getter 簽章

get useLinearCollisionResolution(): boolean

定義於: world.ts:239

回傳

boolean

Setter 簽章

set useLinearCollisionResolution(value): void

定義於: world.ts:243

參數

value

boolean

回傳

void

方法

addConstraint()

addConstraint(constraint): void

定義於: world.ts:267

參數

constraint

Constraint

回傳

void

---

addPinJoint()

addPinJoint(bodyA, bodyB, anchorA, anchorB): void

定義於: world.ts:275

參數

bodyA

RigidBody

bodyB

RigidBody

anchorA

Point

anchorB

Point

回傳

void

---

addRigidBody()

addRigidBody(ident, body): void

定義於: world.ts:112

參數

ident

string

body

RigidBody

回傳

void

---

getCollisionStats()

getCollisionStats(): object

定義於: world.ts:336

回傳

object

activePairs

activePairs: number

frameNumber

frameNumber: number

sleepingBodies

sleepingBodies: number

totalBodies

totalBodies: number

totalPairs

totalPairs: number

---

getConstraints()

getConstraints(): Constraint[]

定義於: world.ts:271

回傳

Constraint[]

---

getPairManager()

getPairManager(): PairManager

定義於: world.ts:331

回傳

PairManager

---

getRigidBodyList()

getRigidBodyList(): RigidBody[]

定義於: world.ts:247

回傳

RigidBody[]

---

getRigidBodyMap()

getRigidBodyMap(): Map<string, RigidBody>

定義於: world.ts:255

回傳

Map<string, RigidBody>

---

getSpatialIndexStats()

getSpatialIndexStats(): any

定義於: world.ts:301

回傳

any

---

removeRigidBody()

removeRigidBody(ident): void

定義於: world.ts:122

參數

ident

string

回傳

void

---

resolveCollisionPhase()

resolveCollisionPhase(): Point[]

定義於: world.ts:175

回傳

Point[]

---

setMaxTransHeight()

setMaxTransHeight(height): void

定義於: world.ts:259

參數

height

number

回傳

void

---

setMaxTransWidth()

setMaxTransWidth(width): void

定義於: world.ts:263

參數

width

number

回傳

void

---

setSpatialIndexType()

setSpatialIndexType(type): void

定義於: world.ts:288

參數

type

SpatialIndexType

回傳

void

---

step()

step(deltaTime): void

定義於: world.ts:144

參數

deltaTime

number

回傳

void