MeshGradientRenderer

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:24

Extends

• BaseRenderer

Constructors

Constructor

new MeshGradientRenderer(canvas): MeshGradientRenderer

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:54

Parameters

Parameter	Type
canvas	HTMLCanvasElement

Returns

MeshGradientRenderer

Overrides

BaseRenderer.constructor

Properties

Property	Modifier	Type	Inherited from	Defined in
canvas	protected	HTMLCanvasElement	BaseRenderer.canvas	core/dist/bg-render/base.d.ts:63
currerntRenderScale	protected	number	BaseRenderer.currerntRenderScale	core/dist/bg-render/base.d.ts:66
flowSpeed	protected	number	BaseRenderer.flowSpeed	core/dist/bg-render/base.d.ts:65

Methods

dispose()

dispose(): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:63

Returns

void

Overrides

BaseRenderer.dispose

---

getControlPoint()

getControlPoint(x, y): undefined | ControlPoint

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:45

Parameters

Parameter	Type
x	number
y	number

Returns

undefined | ControlPoint

---

getElement()

getElement(): HTMLElement

Defined in: core/dist/bg-render/base.d.ts:108

Returns

HTMLElement

Inherited from

BaseRenderer.getElement

---

onResize()

protected onResize(width, height): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:55

当画板元素大小发生变化时此函数会被调用 可以在此处重设和渲染器相关的尺寸设置 考虑到初始化的时候元素不一定在文档中或出于某些特殊样式状态，尺寸长宽有可能会为 0，请注意进行特判处理

Parameters

Parameter	Type	Description
width	number	画板元素实际的物理像素宽度，有可能为 0
height	number	画板元素实际的物理像素高度，有可能为 0

Returns

void

Overrides

BaseRenderer.onResize

---

pause()

pause(): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:58

暂停背景动画，画面即便是更新了图片也不会发生变化

Returns

void

Overrides

BaseRenderer.pause

---

resetSubdivition()

resetSubdivition(subDivisions): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:47

Parameters

Parameter	Type
subDivisions	number

Returns

void

---

resizeControlPoints()

resizeControlPoints(width, height): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:46

Parameters

Parameter	Type
width	number
height	number

Returns

void

---

resume()

resume(): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:59

恢复播放背景动画

Returns

void

Overrides

BaseRenderer.resume

---

setAlbum()

setAlbum(albumSource?, isVideo?): Promise<void>

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:60

设置背景专辑资源，纹理加载并设置完成后会返回

Parameters

Parameter	Type	Description
albumSource?	string | HTMLImageElement | HTMLVideoElement	专辑的资源链接，可以是图片或视频链接，抑或是任意 img/video 元素，如果提供字符串链接且为视频则需要指定第二个参数
isVideo?	boolean	-

Returns

Promise<void>

Overrides

BaseRenderer.setAlbum

---

setFlowSpeed()

setFlowSpeed(speed): void

Defined in: core/dist/bg-render/base.d.ts:81

修改背景的流动速度，数字越大越快，默认为 4

Parameters

Parameter	Type	Description
speed	number	背景的流动速度，默认为 4

Returns

void

Inherited from

BaseRenderer.setFlowSpeed

---

setFPS()

setFPS(fps): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:57

修改背景动画帧率，默认是 30 FPS

如果设置成 0 则会停止动画

Parameters

Parameter	Type	Description
fps	number	目标帧率，默认 30 FPS

Returns

void

Overrides

BaseRenderer.setFPS

---

setHasLyric()

setHasLyric(_hasLyric): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:62

设置背景是否根据“是否有歌词”这个特征调整自身效果，例如有歌词时会变得更加活跃

部分渲染器会根据这个特征调整自身效果

如果不确定是否需要赋值或无法知晓是否包含歌词，请传入 true 或不做任何处理（默认值为 true）

Parameters

Parameter	Type
_hasLyric	boolean

Returns

void

Overrides

BaseRenderer.setHasLyric

---

setLowFreqVolume()

setLowFreqVolume(volume): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:61

设置低频的音量大小，范围在 80hz-120hz 之间为宜，取值范围在 [0.0-1.0] 之间

部分渲染器会根据音量大小调整背景效果（例如根据鼓点跳动）

如果无法获取到类似的数据，请传入 1.0 作为默认值，或不做任何处理（默认值即 1.0）

Parameters

Parameter	Type	Description
volume	number	低频的音量大小，范围在 50hz-120hz 之间为宜，取值范围在 [0.0-1.0] 之间

Returns

void

Overrides

BaseRenderer.setLowFreqVolume

---

setManualControl()

setManualControl(enable): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:43

Parameters

Parameter	Type
enable	boolean

Returns

void

---

setRenderScale()

setRenderScale(scale): void

Defined in: core/dist/bg-render/base.d.ts:68

修改背景的渲染比例，默认是 0.5

一般情况下这个程度既没有明显瑕疵也不会特别吃性能

Parameters

Parameter	Type	Description
scale	number	背景的渲染比例

Returns

void

Inherited from

BaseRenderer.setRenderScale

---

setStaticMode()

setStaticMode(enable): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:56

是否启用静态模式，即图片在更换后就会保持静止状态并禁用更新，以节省性能

Parameters

Parameter	Type	Description
enable	boolean	是否启用静态模式

Returns

void

Overrides

BaseRenderer.setStaticMode

---

setWireFrame()

setWireFrame(enable): void

Defined in: core/dist/bg-render/mesh-renderer/index.d.ts:44

Parameters

Parameter	Type
enable	boolean

Returns

void