Skip to content

FaceFilterPlugin

Face filter plugin

Simple plugin filtering a list of detected faces by the provided predicate. Useful when application may need to ignore certain head poses, for example when rotation angle is too big for virtual try-on.

Extends

Constructors

new FaceFilterPlugin()

new FaceFilterPlugin(predicate): FaceFilterPlugin

Constructor

Parameters

predicate

Predicate of face filter

Returns

FaceFilterPlugin

Overrides

Plugin.constructor

Properties

loaded

loaded: boolean

Loaded state

Inherited from

Plugin.loaded


ordinal

ordinal: number

Ordinal number

Inherited from

Plugin.ordinal


predicate()

protected predicate: (f) => boolean

Predicate of face filter

Parameters

f: Face

Returns

boolean


renderer?

protected optional renderer: Renderer<FaceResult>

Renderer loaded the plugin

Inherited from

Plugin.renderer

Methods

dispose()

dispose(): void

Dispose video plugin

Returns

void

Inherited from

Plugin.dispose


load()

load(renderer): Promise<void>

Initialize plugin

Initializes resources/instances needed by plugin. Overridden by derived classes for particular task.

Parameters

renderer: Renderer<FaceResult>

Renderer this plugin is attached to

Returns

Promise<void>

Promise resolving when initialization is finished

Inherited from

Plugin.load


setupCamera()

setupCamera(ratio, angle): void

Set camera parameters

Could be overridden to adjust plugin’s pipeline.

Parameters

ratio: number

Aspect ration of input video

angle: number

Vertical field of view in radians

Returns

void

Inherited from

Plugin.setupCamera


setupVideo()

setupVideo(size): void

Set video size

Could be overridden to adjust plugin’s pipeline.

Parameters

size: Size

Resolution of input video

Returns

void

Inherited from

Plugin.setupVideo


unload()

unload(): void

Reset plugin

Releases all resources/instances created in load(). Overridden by derived classes for particular task.

Returns

void

Inherited from

Plugin.unload


update()

update(result, stream): Promise<void>

Update

Override filters detected faces in place using predicate provided to constructor.

Parameters

result: FaceResult

Results of face detection

stream: HTMLCanvasElement

Captured video frame

Returns

Promise<void>

Promise resolving when update is finished

Overrides

Plugin.update