MeshGradientRenderer
This content is not available in your language yet.
Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:676
Fileoverview
Section titled “Fileoverview”一个播放歌词的组件
Author
Section titled “Author”SteveXMH
Extends
Section titled “Extends”Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new MeshGradientRenderer(canvas): MeshGradientRenderer;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1085
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
canvas |
HTMLCanvasElement |
Returns
Section titled “Returns”MeshGradientRenderer
Overrides
Section titled “Overrides”Properties
Section titled “Properties”| Property | Modifier | Type | Default value | Inherited from | Defined in |
|---|---|---|---|---|---|
canvas |
protected |
HTMLCanvasElement |
undefined |
BaseRenderer.canvas |
packages/core/src/bg-render/base.ts:75 |
currerntRenderScale |
protected |
number |
0.75 |
BaseRenderer.currerntRenderScale |
packages/core/src/bg-render/base.ts:74 |
flowSpeed |
protected |
number |
1 |
BaseRenderer.flowSpeed |
packages/core/src/bg-render/base.ts:73 |
Methods
Section titled “Methods”disconnectResizeObserver()
Section titled “disconnectResizeObserver()”protected disconnectResizeObserver(): void;Defined in: packages/core/src/bg-render/base.ts:148
停止监听画板尺寸,供构造失败等尚未接管画板所有权的路径清理
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”BaseRenderer.disconnectResizeObserver
dispose()
Section titled “dispose()”dispose(): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1290
销毁实现了该接口的对象实例,释放占用的资源
一般情况下,调用本函数后就不可以再调用对象的任何函数了
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”enablePerformanceMonitor()
Section titled “enablePerformanceMonitor()”enablePerformanceMonitor(enable): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1314
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
enable |
boolean |
Returns
Section titled “Returns”void
getControlPoint()
Section titled “getControlPoint()”getControlPoint(x, y): ControlPoint | undefined;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:850
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
x |
number |
y |
number |
Returns
Section titled “Returns”ControlPoint | undefined
getCurrentFPS()
Section titled “getCurrentFPS()”getCurrentFPS(): number;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1322
Returns
Section titled “Returns”number
getElement()
Section titled “getElement()”getElement(): HTMLElement;Defined in: packages/core/src/bg-render/base.ts:155
获取这个类所对应的 HTML 元素实例
Returns
Section titled “Returns”HTMLElement
Inherited from
Section titled “Inherited from”onResize()
Section titled “onResize()”protected onResize(width, height): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1098
当画板元素大小发生变化时此函数会被调用 可以在此处重设和渲染器相关的尺寸设置 考虑到初始化的时候元素不一定在文档中或出于某些特殊样式状态,尺寸长宽有可能会为 0,请注意进行特判处理
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
width |
number |
画板元素实际的物理像素宽度,有可能为 0 |
height |
number |
画板元素实际的物理像素高度,有可能为 0 |
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”pause()
Section titled “pause()”pause(): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1112
暂停背景动画,画面即便是更新了图片也不会发生变化
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”resetSubdivition()
Section titled “resetSubdivition()”resetSubdivition(subDivisions): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:864
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
subDivisions |
number |
Returns
Section titled “Returns”void
resizeControlPoints()
Section titled “resizeControlPoints()”resizeControlPoints(width, height): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:857
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
width |
number |
height |
number |
Returns
Section titled “Returns”void
resume()
Section titled “resume()”resume(): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1119
恢复播放背景动画
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setAlbum()
Section titled “setAlbum()”setAlbum(albumSource?, isVideo?): Promise<void>;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1123
设置背景专辑资源,纹理加载并设置完成后会返回
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
albumSource? |
string | HTMLImageElement | HTMLVideoElement |
专辑的资源链接,可以是图片或视频链接,抑或是任意 img/video 元素,如果提供字符串链接且为视频则需要指定第二个参数 |
isVideo? |
boolean |
- |
Returns
Section titled “Returns”Promise<void>
Overrides
Section titled “Overrides”setFlowSpeed()
Section titled “setFlowSpeed()”setFlowSpeed(speed): void;Defined in: packages/core/src/bg-render/base.ts:116
修改背景的流动速度,数字越大越快,默认为 1
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
speed |
number |
背景的流动速度,默认为 1 |
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”setFPS()
Section titled “setFPS()”setFPS(fps): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1109
修改背景动画帧率,默认是 30 FPS
如果设置成 0 则会停止动画
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
fps |
number |
目标帧率,默认 30 FPS |
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setHasLyric()
Section titled “setHasLyric()”setHasLyric(_hasLyric): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1286
设置背景是否根据“是否有歌词”这个特征调整自身效果,例如有歌词时会变得更加活跃
部分渲染器会根据这个特征调整自身效果
如果不确定是否需要赋值或无法知晓是否包含歌词,请传入 true 或不做任何处理(默认值为 true)
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
_hasLyric |
boolean |
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setLowFreqVolume()
Section titled “setLowFreqVolume()”setLowFreqVolume(volume): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1283
设置低频的音量大小,范围在 80hz-120hz 之间为宜,取值范围在 [0.0-1.0] 之间
部分渲染器会根据音量大小调整背景效果(例如根据鼓点跳动)
如果无法获取到类似的数据,请传入 1.0 作为默认值,或不做任何处理(默认值即 1.0)
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
volume |
number |
低频的音量大小,范围在 50hz-120hz 之间为宜,取值范围在 [0.0-1.0] 之间 |
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setManualControl()
Section titled “setManualControl()”setManualControl(enable): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:840
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
enable |
boolean |
Returns
Section titled “Returns”void
setRenderScale()
Section titled “setRenderScale()”setRenderScale(scale): void;Defined in: packages/core/src/bg-render/base.ts:90
修改背景的渲染比例,默认是 0.5
一般情况下这个程度既没有明显瑕疵也不会特别吃性能
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
scale |
number |
背景的渲染比例 |
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”setStaticMode()
Section titled “setStaticMode()”setStaticMode(enable): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1104
是否启用静态模式,即图片在更换后就会保持静止状态并禁用更新,以节省性能
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
enable |
boolean |
是否启用静态模式 |
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setWireFrame()
Section titled “setWireFrame()”setWireFrame(enable): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:844
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
enable |
boolean |
Returns
Section titled “Returns”void
isSupported()
Section titled “isSupported()”static isSupported(): boolean;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:680
当前环境是否支持此渲染器
Returns
Section titled “Returns”boolean