Skip to main content

Class: BodyPatchPlugin

@geenee/bodyrenderers-babylon.BodyPatchPlugin

Body patch plugin

Plugin patches (inpaints/erases) foreground region of image defined by body segmentation mask from @geenee/bodyprocessors!PoseProcessor. It can be used in avatar virtual try to remove parts of a user's body that stick out (not covered). Evaluation of body segmentation must be enabled in init() method enabling @geenee/bodyprocessors!PoseParams#mask flag.

Hierarchy

Constructors

constructor

new BodyPatchPlugin()

Constructor

Overrides

ShaderPlugin.constructor

Properties

fragSrc

Protected Optional fragSrc: string

Code of fragment shader (copy shader by default)

Inherited from

ShaderPlugin.fragSrc


inputs

Protected Optional inputs: string[]

Shader texture inputs (names of sampler uniforms)

Inherited from

ShaderPlugin.inputs


loaded

loaded: boolean

Loaded state

Inherited from

ShaderPlugin.loaded


ordinal

ordinal: number

Ordinal number

Inherited from

ShaderPlugin.ordinal


renderer

Protected Optional renderer: Renderer<PoseResult>

Renderer loaded the plugin

Inherited from

ShaderPlugin.renderer


shader

Protected Optional shader: ShaderProgram

Rendering shader

Inherited from

ShaderPlugin.shader


size

Protected size: Size

Image size

Inherited from

ShaderPlugin.size


uniforms

Protected Optional uniforms: Object

Shader uniforms as name-type map object

Index signature

▪ [key: string]: UniformType

Inherited from

ShaderPlugin.uniforms


vertSrc

Protected Optional vertSrc: string

Vertex shader source (copy shader by default)

Inherited from

ShaderPlugin.vertSrc

Methods

dispose

dispose(): void

Dispose video plugin

Returns

void

Inherited from

ShaderPlugin.dispose


load

load(renderer): Promise<void>

Initialize plugin

Initializes resources required for shader effect.

Parameters

NameTypeDescription
rendererRenderer<PoseResult>Renderer this plugin is attached to

Returns

Promise<void>

Promise resolving when initialization is finished

Overrides

ShaderPlugin.load


process

process(result, input): Promise<boolean>

Process the image

Patches (inpaints) foreground image pixels according to provided segmentation mask.

Parameters

NameTypeDescription
resultPoseResultResults of video processing
inputWebGLTextureCurrent image texture

Returns

Promise<boolean>

True on success, false otherwise

Overrides

ShaderPlugin.process


setupCamera

setupCamera(ratio, angle): void

Set camera parameters

Could be overridden to adjust plugin's pipeline.

Parameters

NameTypeDescription
rationumberAspect ration of input video
anglenumberVertical field of view in radians

Returns

void

Inherited from

ShaderPlugin.setupCamera


setupVideo

setupVideo(size): void

Set video size

Adjusts shader and texture to a new size.

Parameters

NameType
sizeSize

Returns

void

Inherited from

ShaderPlugin.setupVideo


unload

unload(): void

Reset plugin

Releases all resources and instances created in load().

Returns

void

Overrides

ShaderPlugin.unload


update

update(result, stream): Promise<void>

Update the image

Main method implementing webgl shader effect or filter. ShaderRenderer has current image texture that will be rendered. ShaderPlugin uses current texture as input and writes results to ShaderPlugin#output. ShaderPlugin#output becomes new current texture of ShaderRenderer. This way all ShaderPlugins attached to renderer organize a chain of effects applied on top of each other. Method process() implements shader effect itself, it's intended to be overridden by effect authors.

Parameters

NameTypeDescription
resultPoseResultResults of video processing
streamHTMLCanvasElementCaptured video frame

Returns

Promise<void>

Promise resolving when update is finished

Inherited from

ShaderPlugin.update