Skip to content

Documentation / @ripl/core / Renderer

Class: Renderer ​

Defined in: packages/core/src/core/renderer.ts:140

Drives the animation loop via requestAnimationFrame, managing per-element transitions and rendering the scene each frame.

Extends ​

Constructors ​

Constructor ​

new Renderer(scene, options?): Renderer

Defined in: packages/core/src/core/renderer.ts:162

Parameters ​

ParameterType
sceneScene
options?RendererOptions

Returns ​

Renderer

Overrides ​

EventBus.constructor

Properties ​

PropertyModifierTypeDefault valueInherited fromDefined in
autoStartpublicbooleantrue-packages/core/src/core/renderer.ts:154
autoStoppublicbooleantrue-packages/core/src/core/renderer.ts:155
parent?publicEventBus<RendererEventMap>undefinedEventBus.parentpackages/core/src/core/event-bus.ts:79
defaultKeyreadonlytypeof defaultKeyundefinedEventBus.defaultKeypackages/core/src/core/disposer.ts:10

Accessors ​

isBusy ​

Get Signature ​

get isBusy(): boolean

Defined in: packages/core/src/core/renderer.ts:158

Whether there are any active transitions in progress.

Returns ​

boolean

Methods ​

destroy() ​

destroy(): void

Defined in: packages/core/src/core/renderer.ts:536

Stops the renderer and destroys all event subscriptions.

Returns ​

void

Overrides ​

EventBus.destroy


dispose() ​

protected dispose(key?): void

Defined in: packages/core/src/core/disposer.ts:24

Disposes all resources under the given key, or all resources if no key is provided.

Parameters ​

ParameterType
key?PropertyKey

Returns ​

void

Inherited from ​

EventBus.dispose


emit() ​

Call Signature ​

emit<TEvent>(event): TEvent

Defined in: packages/core/src/core/event-bus.ts:127

Emits an event, invoking all matching handlers and bubbling to the parent if applicable.

Type Parameters ​
Type ParameterDefault type
TEvent extends Event<undefined>Event<undefined>
Parameters ​
ParameterType
eventTEvent
Returns ​

TEvent

Inherited from ​

EventBus.emit

Call Signature ​

emit<TEvent>(type, data): Event<RendererEventMap[TEvent]>

Defined in: packages/core/src/core/event-bus.ts:128

Emits an event, invoking all matching handlers and bubbling to the parent if applicable.

Type Parameters ​
Type Parameter
TEvent extends keyof RendererEventMap
Parameters ​
ParameterType
typeTEvent
dataRendererEventMap[TEvent]
Returns ​

Event<RendererEventMap[TEvent]>

Inherited from ​

EventBus.emit


has() ​

has(type): boolean

Defined in: packages/core/src/core/event-bus.ts:84

Returns whether there are any listeners registered for the given event type.

Parameters ​

ParameterType
typekeyof RendererEventMap

Returns ​

boolean

Inherited from ​

EventBus.has


off() ​

off<TEvent>(type, handler): void

Defined in: packages/core/src/core/event-bus.ts:102

Removes a previously registered handler for the given event type.

Type Parameters ​

Type Parameter
TEvent extends keyof RendererEventMap

Parameters ​

ParameterType
typeTEvent
handlerEventHandler<RendererEventMap[TEvent]>

Returns ​

void

Inherited from ​

EventBus.off


on() ​

on<TEvent>(type, handler, options?): Disposable

Defined in: packages/core/src/core/event-bus.ts:89

Subscribes a handler to the given event type and returns a disposable for cleanup.

Type Parameters ​

Type Parameter
TEvent extends keyof RendererEventMap

Parameters ​

ParameterType
typeTEvent
handlerEventHandler<RendererEventMap[TEvent]>
options?EventSubscriptionOptions

Returns ​

Disposable

Inherited from ​

EventBus.on


once() ​

once<TEvent>(type, handler, options?): Disposable

Defined in: packages/core/src/core/event-bus.ts:117

Subscribes a handler that is automatically removed after it fires once.

Type Parameters ​

Type Parameter
TEvent extends keyof RendererEventMap

Parameters ​

ParameterType
typeTEvent
handlerEventHandler<RendererEventMap[TEvent]>
options?EventSubscriptionOptions

Returns ​

Disposable

Inherited from ​

EventBus.once


retain() ​

protected retain(value, key?): void

Defined in: packages/core/src/core/disposer.ts:13

Registers a disposable resource under an optional key for later cleanup.

Parameters ​

ParameterTypeDefault value
valueDisposableundefined
keyPropertyKeyDisposer.defaultKey

Returns ​

void

Inherited from ​

EventBus.retain


start() ​

start(): void

Defined in: packages/core/src/core/renderer.ts:346

Starts the animation loop if it is not already running.

Returns ​

void


stop() ​

stop(): void

Defined in: packages/core/src/core/renderer.ts:363

Stops the animation loop, cancels pending frames, and clears all transitions.

Returns ​

void


transition() ​

transition<TElement>(element, options?): Transition

Defined in: packages/core/src/core/renderer.ts:388

Schedules an animated transition for one or more elements, returning a Transition that resolves when all complete.

Type Parameters ​

Type Parameter
TElement extends Element<Partial<BaseState>, ElementEventMap>

Parameters ​

ParameterType
elementOneOrMore<TElement>
options?RendererTransitionOptionsArg<TElement>

Returns ​

Transition