Skip to content

HandRenderer

Abstract renderer for @geenee/bodyprocessors!HandProcessor

Specializes BabylonUniRenderer generic for @geenee/bodyprocessors!HandResult.This is abstract renderer that doesn’t implement any logic.

Extends

Constructors

new HandRenderer()

new HandRenderer(container, mode?, mirror?): HandRenderer

Constructor

Parameters

container: HTMLElement

Container of @geenee/armature!ResponsiveCanvas

mode?: CanvasMode

Fitting mode

mirror?: boolean

Mirror the output

Returns

HandRenderer

Inherited from

BabylonUniRenderer.constructor

Properties

camera

protected camera: UniversalCamera

Camera instance

Inherited from

BabylonUniRenderer.camera


cameraAngle

protected cameraAngle: number

Camera vertical angle in radians

Inherited from

BabylonUniRenderer.cameraAngle


cameraRatio

protected cameraRatio: number

Camera aspect ratio

Inherited from

BabylonUniRenderer.cameraRatio


canvas

canvas: ResponsiveCanvas

Responsive canvas

Inherited from

BabylonUniRenderer.canvas


current

current: null | WebGLTexture

Current image texture

Inherited from

BabylonUniRenderer.current


input?

optional input: ImageTexture

Input image texture

Inherited from

BabylonUniRenderer.input


layer

protected layer: Layer

Video layer

Inherited from

BabylonUniRenderer.layer


loaded

protected loaded: boolean

Loaded state

Inherited from

BabylonUniRenderer.loaded


padCtx

protected padCtx: [null | CanvasRenderingContext2D, null | CanvasRenderingContext2D]

Drawing context of padding canvases

Inherited from

BabylonUniRenderer.padCtx


plugins

protected plugins: Plugin<HandResult>[]

Attached plugins

Inherited from

BabylonUniRenderer.plugins


renderer

protected renderer: Engine

Rendering engine

Inherited from

BabylonUniRenderer.renderer


scene?

optional scene: Scene

Renderer scene

Inherited from

BabylonUniRenderer.scene


setupPadding()

protected setupPadding: () => void

Setup padding canvases

Callback sets up size of padding canvases.

Returns

void

Inherited from

BabylonUniRenderer.setupPadding


shader?

protected optional shader: ShaderProgram

Rendering shader

Inherited from

BabylonUniRenderer.shader


shaderCtx

shaderCtx: null | WebGL2RenderingContext

Context of the video canvas layer

Inherited from

BabylonUniRenderer.shaderCtx


videoRatio

protected videoRatio: number

Aspect ratio of input video

Inherited from

BabylonUniRenderer.videoRatio


videoSize

protected videoSize: Size

Resolution of input video

Inherited from

BabylonUniRenderer.videoSize

Methods

addListener()

addListener<E>(event, listener): this

Adds the listener function to the end of the listeners array

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.addListener


addPlugin()

addPlugin(plugin): Promise<void>

Add render plugin

Initializes the plugin if it’s not loaded yet but renderer is ready. Renderer takes ownership of the plugin instance meaning it will release it when plugin is detached or renderer is disposed itself.

Parameters

plugin: Plugin<HandResult>

Returns

Promise<void>

Inherited from

BabylonUniRenderer.addPlugin


dispose()

dispose(): void

Dispose renderer object

Extended to dispose scene and engine.

Returns

void

Inherited from

BabylonUniRenderer.dispose


emit()

emit<E>(event, …args): boolean

Synchronously calls each of the listeners registered for the event

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

• …args: Args<RendererEvents[E]>

Arguments passed to the listeners

Returns

boolean

True if the event had listeners, False otherwise

Inherited from

BabylonUniRenderer.emit


eventNames()

eventNames(): (string | symbol)[]

List of emitter’s events

Returns

(string | symbol)[]

List of emitter’s events

Inherited from

BabylonUniRenderer.eventNames


getMaxListeners()

getMaxListeners(): number

Maximum number of listeners per event

Returns

number

Maximum number of listeners per event

Inherited from

BabylonUniRenderer.getMaxListeners


listenerCount()

listenerCount<E>(event): number

The number of listeners listening to the event

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

Returns

number

Number of listeners

Inherited from

BabylonUniRenderer.listenerCount


listeners()

listeners<E>(event): Function[]

Copy of the array of listeners for the event

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

Returns

Function[]

Copy of the listeners array

Inherited from

BabylonUniRenderer.listeners


load()

load(): Promise<void>

Initialize renderer

Initializes rendering context, shader program and buffers.

Returns

Promise<void>

Promise resolving when initialization is finished

Inherited from

BabylonUniRenderer.load


off()

off<E>(event, listener): this

Removes the listener from the listener array for the event

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.off


on()

on<E>(event, listener): this

Adds the listener function to the event

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.on


once()

once<E>(event, listener): this

Adds a one-time listener function for the event

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.once


prependListener()

prependListener<E>(event, listener): this

Adds the listener function to the beginning of the listeners array

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.prependListener


prependOnceListener()

prependOnceListener<E>(event, listener): this

Adds a one-time listener function to the beginning of the listeners array

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

Inherited from

BabylonUniRenderer.prependOnceListener


rawListeners()

rawListeners<E>(event): Function[]

Copy of the array of listeners for the event including wrappers

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

Returns

Function[]

Copy of the listeners array

Inherited from

BabylonUniRenderer.rawListeners


removeAllListeners()

removeAllListeners<E>(event?): this

Removes all listeners, or those of the specified event

Type Parameters

E extends keyof RendererEvents

Parameters

event?: E

The name of the event

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.removeAllListeners


removeAllPlugins()

removeAllPlugins(): void

Remove all render plugins

Renderer will dispose all plugins before detaching them.

Returns

void

Inherited from

BabylonUniRenderer.removeAllPlugins


removeListener()

removeListener<E>(event, listener): this

Removes the specified listener from the listener array

Type Parameters

E extends keyof RendererEvents

Parameters

event: E

The name of the event

listener: RendererEvents[E]

The callback function

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.removeListener


removePlugin()

removePlugin(plugin): void

Remove render plugin

Renderer will dispose the plugin before detaching it.

Parameters

plugin: Plugin<HandResult>

Returns

void

Inherited from

BabylonUniRenderer.removePlugin


setMaxListeners()

setMaxListeners(n): this

Sets maximum number of listeners per event

Parameters

n: number

Maximum number of listeners

Returns

this

This EventEmitter

Inherited from

BabylonUniRenderer.setMaxListeners


setMirror()

setMirror(mirror): void

Set mirror mode

CanvasRenderer sets mirror mode of ResponsiveCanvas.

Parameters

mirror: boolean

Mirror the output

Returns

void

Inherited from

BabylonUniRenderer.setMirror


setMode()

setMode(mode): void

Set fitting mode

CanvasRenderer sets fitting mode of ResponsiveCanvas.

Parameters

mode: CanvasMode

Fitting mode

Returns

void

Inherited from

BabylonUniRenderer.setMode


setupCamera()

setupCamera(ratio, angle): void

Set camera parameters

Setups BabylonRenderer#camera instance according to parameters provided by @geenee/armature!Processor.

Parameters

ratio: number

Aspect ration of input video

angle: number

Vertical field of view in radians

Returns

void

Inherited from

BabylonUniRenderer.setupCamera


setupVideo()

setupVideo(size, ratio?): void

Set video parameters

Resizes video texture and rendering shader.

Parameters

size: Size

Resolution of input video

ratio?: number

Aspect ration of input video

Returns

void

Inherited from

BabylonUniRenderer.setupVideo


unload()

unload(): void

Reset renderer

Releases all resources and instances created in load(). Releases rendering context, shader program and buffers.

Returns

void

Inherited from

BabylonUniRenderer.unload


update()

update(result, stream): Promise<void>

Update the scene

Renderers input video frame on corresponding canvas layer.

Parameters

result: HandResult

Results of video processing

stream: HTMLCanvasElement

Captured video frame

Returns

Promise<void>

Promise resolving when update is finished

Inherited from

BabylonUniRenderer.update


updatePads()

protected updatePads(stream): void

Update padding canvases

Updates padding canvases using portions of video frame.

Parameters

stream: HTMLCanvasElement

Captured video frame

Returns

void

Inherited from

BabylonUniRenderer.updatePads


updatePlugins()

protected updatePlugins(result, stream): Promise<void>

Update attached plugins

Calls update() of all attached plugins.

Parameters

result: HandResult

Results of video processing

stream: HTMLCanvasElement

Captured video frame

Returns

Promise<void>

Promise resolving when update is finished

Inherited from

BabylonUniRenderer.updatePlugins


updateScene()

protected updateScene(): void

Update and render the scene

Virtual method updating and rendering 3D scene. For babylon.js engine calls this.scene.render().

Returns

void

Inherited from

BabylonUniRenderer.updateScene


updateVideo()

protected updateVideo(stream): void

Update the video layer

Renders processed frame to texture of video layer.

Parameters

stream: HTMLCanvasElement

Captured video frame

Returns

void

Inherited from

BabylonUniRenderer.updateVideo