`Stage`

class

The scene's own: one is made, to hear the scene; it has all of the stage's.

Syntax

class Stage { … }

Name	Type	Description
`time`property	`readonly number`	The scene's time, seconds.
`width`property	`readonly number`	The scene's width, pixels.
`height`property	`readonly number`	The scene's height, pixels.
`motes`property	`readonly Mote[]`	Every mote.
`stage`property	`readonly MotionStageApi`	The stage itself.
`gravity`property	`readonly Vector3`	The 2D world's gravity, pixels a second a second (y down).

Signature	Description
`new Stage(): Stage`constructor	Made once, by the scene as it starts: don't make one yourself.
`spawn<M extends Mote>(cls: string \| () => M, options?: { location?: Place; rotation?: number \| number[] \| Rotator; scale?: number \| Place; name?: string; properties?: Record<string, unknown>; tags?: string[] }): M`method	Makes a mote of a class.
`destroy(mote: Mote): void`method	Takes a mote out of the scene.
`find<M extends Mote>(cls: string \| () => M): M \| null`method	The first mote of a class.
`findAll<M extends Mote>(cls: string \| () => M): M[]`method	Every mote of a class (its subclasses' too).
`withTag(tag: string): Mote[]`method	Every mote with a tag.
`byId(id: string): Mote \| null`method	A mote by its id.
`byName(name: string): Mote \| null`method	A mote by its name.
`randomPointInView(): Vector3`method	A random point on the scene, its pixels.
`castRay(from: Place, to: Place, options?: { world?: "2d" \| "3d" }): Promise<MotionRayHit \| null>`method	The first mote's body a ray from one point to another meets, next turn.
`setGravity(v: Place, world?: "2d" \| "3d"): void`method	Sets a world's gravity.
`join(a: string \| Mote, b: string \| Mote, joint?: MotionJointSpec): number`method	Joins two motes' bodies.
`unjoin(id: number): void`method	Lets a joint go.
`onStart(): void`method	It started.
`onTick(dt: number): void`method	Each tick.
`onSettingsChanged(props: Record<string, any>): void`method	The wallpaper's settings changed.