Abstract Class: RenderingSurfaceBase

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:25

Abstract class for rendering surfaces.

A rendering surface represents the final destination of the rendered frame.

It is usually backed by an HTML Canvas or an OffscreenCanvas.

It can be split into multiple viewports, each with its own camera and render target. The rendering surface if responsible for holding the viewports and their configurations.

It is finally responsible for drawing the portions of the final frame to its backing element.

Extends

• TypedEventTarget<RenderingSurfaceEvents>

Extended by

• VirtualSurface
• RenderingSurface
• OffscreenSurface

Properties

Property	Modifier	Type	Default value	Description
viewports	readonly	Viewport[]	[]	List of viewports bound to the current surface.
relative_rect	public	RelativeRect	undefined	Normalized dimensions and offset of the surface relative to the remote rendering surface.
_scale	protected	number	1.0	Scale of the surface.

Accessors

scale

Get Signature

get scale(): number;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:49

Scale of the surface.

Returns

number

Set Signature

set scale(scale: number): void;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:56

Set scale of the surface.

Parameters

Parameter	Type
scale	number

Returns

void

---

dimensions

Get Signature

get dimensions(): Vec2;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:71

Dimensions of the surface.

Returns

Vec2

---

width

Get Signature

get abstract width(): number;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:78

Width of the surface.

Returns

number

---

height

Get Signature

get abstract height(): number;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:83

Height of the surface.

Returns

number

Methods

getBoundingRect()

abstract getBoundingRect(): Rect;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:88

Returns the bounding rectangle of the surface.

Returns

Rect

---

release()

release(): void;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:125

Releases the resources associated with the current surface.

Returns

void

---

isValid()

isValid(): boolean;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:135

Returns whether the current surface is valid.

Returns

boolean

---

drawFrame()

drawFrame(params: {
  decoded_frame: DecodedFrame;
}): void;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:146

Draws the portions of the frame associated with the viewports to the backing element. Keeps a reference to the last frame drawn.

Parameters

Parameter	Type	Description
params	{ decoded_frame: DecodedFrame; }
params.decoded_frame	DecodedFrame	The frame to draw.

Returns

void

---

redrawLastFrame()

redrawLastFrame(): void;

Defined in: livelink.js/sources/rendering/surfaces/RenderingSurfaceBase.ts:154

Redraws the last frame.

Returns

void