MeshGradientRenderer
Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:779
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:1052
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:71 |
currerntRenderScale | protected | number | 0.75 | BaseRenderer.currerntRenderScale | packages/core/src/bg-render/base.ts:70 |
flowSpeed | protected | number | 1 | BaseRenderer.flowSpeed | packages/core/src/bg-render/base.ts:69 |
Methods
Section titled “Methods”dispose()
Section titled “dispose()”dispose(): void;Defined in: packages/core/src/bg-render/mesh-renderer/index.ts:1310
销毁实现了该接口的对象实例,释放占用的资源
一般情况下,调用本函数后就不可以再调用对象的任何函数了
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:1328
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:822
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:1336
Returns
Section titled “Returns”number
getElement()
Section titled “getElement()”getElement(): HTMLElement;Defined in: packages/core/src/bg-render/base.ts:149
获取这个类所对应的 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:1107
当画板元素大小发生变化时此函数会被调用 可以在此处重设和渲染器相关的尺寸设置 考虑到初始化的时候元素不一定在文档中或出于某些特殊样式状态,尺寸长宽有可能会为 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:1121
暂停背景动画,画面即便是更新了图片也不会发生变化
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:835
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:829
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:1128
恢复播放背景动画
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:1132
设置背景专辑资源,纹理加载并设置完成后会返回
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:114
修改背景的流动速度,数字越大越快,默认为 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:1118
修改背景动画帧率,默认是 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:1306
设置背景是否根据“是否有歌词”这个特征调整自身效果,例如有歌词时会变得更加活跃
部分渲染器会根据这个特征调整自身效果
如果不确定是否需要赋值或无法知晓是否包含歌词,请传入 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:1303
设置低频的音量大小,范围在 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:812
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:88
修改背景的渲染比例,默认是 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:1113
是否启用静态模式,即图片在更换后就会保持静止状态并禁用更新,以节省性能
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:816
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
enable | boolean |
Returns
Section titled “Returns”void