Skip to main content

Class: PoseProcessor

@geenee/bodyprocessors.PoseProcessor

Pose processor

Pose processor estimates 33 2D and 3D pose keypoints, it locates the person / pose region-of-interest (ROI) and predicts the pose keypoints providing smooth, stable and accurate pose estimation. 2D pixel pose keypoints - points in the screen coordinate space. X and Y coordinates are normalized screen coordinates (scaled by width and height of the input image), while the Z coordinate is depth within orthographic projection space, it has the same scale as X coordinate (normalized by image width) and 0 is at the center of hips. These points can be used for 2D pose overlays or when using orthographic projection. Estimation of Z coordinate is not very accurate and we recommend to use only XY for 2D effects. 3D metric points - points within 3D space of perspective camera located at the space origin and pointed in the negative direction of the Z-axis. These points can be used for 3D avatar overlays or virtual try-on. Rigged and skinned models can be rendered on top of the pose aligning skeleton/armature joints with 3D keypoints. 3D and 2D points are perfectly aligned, projections of 3D points coincide with 2D pixel coordinates within the perspective camera.

Hierarchy

Constructors

constructor

new PoseProcessor()

Constructor

Overrides

Processor.constructor

Properties

cameraAngle

cameraAngle: number

Camera vertical angle in radians

Inherited from

Processor.cameraAngle


cameraAngleBase

Readonly cameraAngleBase: number

View angle of perspective camera along smallest side


cameraRatio

cameraRatio: number

Camera aspect ratio

Inherited from

Processor.cameraRatio


optimalSize

optimalSize: number

Recommended maximum size of input

Inherited from

Processor.optimalSize


params

Protected params: Partial<PoseParams>

Processor parameters

Inherited from

Processor.params


videoRatio

Protected videoRatio: number

Aspect ratio of input video

Inherited from

Processor.videoRatio


videoSize

Protected videoSize: Size

Resolution of input video

Inherited from

Processor.videoSize

Methods

addListener

addListener<E>(event, listener): PoseProcessor

Adds the listener function to the end of the listeners array

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.addListener


dispose

dispose(): void

Dispose processor object

Releases resources and instances allocated by processor. Processor object cannot be used after calling dispose().

Returns

void

Overrides

Processor.dispose


emit

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

Synchronously calls each of the listeners registered for the event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
...argsArgs<ProcessorEvents[E]>Arguments passed to the listeners

Returns

boolean

True if the event had listeners, False otherwise

Inherited from

Processor.emit


eventNames

eventNames(): (string | symbol)[]

List of emitter's events

Returns

(string | symbol)[]

List of emitter's events

Inherited from

Processor.eventNames


getMaxListeners

getMaxListeners(): number

Maximum number of listeners per event

Returns

number

Maximum number of listeners per event

Inherited from

Processor.getMaxListeners


init

init(params, size?, ratio?): Promise<boolean>

Initialize processor

Prepares all resources required for pose estimation.

Parameters

NameTypeDescription
paramsPoseParamsProcessor parameters
size?SizeResolution of input video
ratio?numberAspect ration of input video

Returns

Promise<boolean>

Status of initialization

Overrides

Processor.init


listenerCount

listenerCount<E>(event): number

The number of listeners listening to the event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event

Returns

number

Number of listeners

Inherited from

Processor.listenerCount


listeners

listeners<E>(event): Function[]

Copy of the array of listeners for the event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event

Returns

Function[]

Copy of the listeners array

Inherited from

Processor.listeners


off

off<E>(event, listener): PoseProcessor

Removes the listener from the listener array for the event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.off


on

on<E>(event, listener): PoseProcessor

Adds the listener function to the event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.on


once

once<E>(event, listener): PoseProcessor

Adds a one-time listener function for the event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.once


prependListener

prependListener<E>(event, listener): PoseProcessor

Adds the listener function to the beginning of the listeners array

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.prependListener


prependOnceListener

prependOnceListener<E>(event, listener): PoseProcessor

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

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

Inherited from

Processor.prependOnceListener


process

process(input, timestamp?): Promise<PoseResult>

Process the image

Pose processor detects pose and predicts pose keypoints.

Parameters

NameTypeDescription
inputImageInputImage
timestamp?number-

Returns

Promise<PoseResult>

Poses estimation

Overrides

Processor.process


rawListeners

rawListeners<E>(event): Function[]

Copy of the array of listeners for the event including wrappers

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event

Returns

Function[]

Copy of the listeners array

Inherited from

Processor.rawListeners


removeAllListeners

removeAllListeners<E>(event?): PoseProcessor

Removes all listeners, or those of the specified event

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
event?EThe name of the event

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.removeAllListeners


removeListener

removeListener<E>(event, listener): PoseProcessor

Removes the specified listener from the listener array

Type parameters

NameType
Eextends keyof ProcessorEvents

Parameters

NameTypeDescription
eventEThe name of the event
listenerProcessorEvents[E]The callback function

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.removeListener


reset

reset(): void

Reset processor

Resets all processing instances to the initial state.

Returns

void

Overrides

Processor.reset


setMaxListeners

setMaxListeners(n): PoseProcessor

Sets maximum number of listeners per event

Parameters

NameTypeDescription
nnumberMaximum number of listeners

Returns

PoseProcessor

This EventEmitter

Inherited from

Processor.setMaxListeners


setupVideo

setupVideo(size, ratio?): void

Set resolution of the input video

Defines view angle according to resolution and aspect ratio. Pose processor fixes FoV for more accurate pose alignment.

Parameters

NameTypeDescription
sizeSizeResolution of input video
ratio?numberAspect ration of input video

Returns

void

Overrides

Processor.setupVideo