IWaveformViewer
Waveform viewer canvas controller and peak renderer.
Extends
Section titled “Extends”Properties
Section titled “Properties”| Property | Type | Inherited from |
|---|---|---|
canvasToTimeFrequency? | (x: number, y: number) => object | NavigableViewer.canvasToTimeFrequency |
getFrequencyBounds? | () => FrequencyBounds | NavigableViewer.getFrequencyBounds |
getTimeBounds? | () => TimeBounds | NavigableViewer.getTimeBounds |
timeFrequencyToCanvas? | (time: number, frequency: number) => object | NavigableViewer.timeFrequencyToCanvas |
Methods
Section titled “Methods”canvasToTime()
Section titled “canvasToTime()”canvasToTime(x: number): number;Converts canvas X pixel position to time in seconds.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
x | number |
Returns
Section titled “Returns”number
destroy()
Section titled “destroy()”destroy(): void;Disposes the renderer and event listeners.
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”getCanvas()
Section titled “getCanvas()”getCanvas(): HTMLCanvasElement;Returns the bound HTML canvas element.
Returns
Section titled “Returns”HTMLCanvasElement
Overrides
Section titled “Overrides”getConfig()
Section titled “getConfig()”getConfig(): ResolvedWaveformConfig;Returns the resolved waveform configuration options.
Returns
Section titled “Returns”Overrides
Section titled “Overrides”getRendererKind()
Section titled “getRendererKind()”getRendererKind(): string;Returns the active rendering engine (canvas2d, webgl2, or bars).
Returns
Section titled “Returns”string
getScope()?
Section titled “getScope()?”optional getScope(): object;Returns
Section titled “Returns”object
getDuration()
Section titled “getDuration()”getDuration(): number;Returns
Section titled “Returns”number
getSampleRate()?
Section titled “getSampleRate()?”optional getSampleRate(): number | undefined;Returns
Section titled “Returns”number | undefined
Inherited from
Section titled “Inherited from”getSource()
Section titled “getSource()”getSource(): AudioSource;Returns the active audio source.
Returns
Section titled “Returns”getStatus()
Section titled “getStatus()”getStatus(): WaveformStatus;Returns the current render status.
Returns
Section titled “Returns”getViewport()
Section titled “getViewport()”getViewport(): WaveformViewport;Returns the visible time viewport.
Returns
Section titled “Returns”Overrides
Section titled “Overrides”getViewportController()
Section titled “getViewportController()”getViewportController(): IViewportController;Returns the bound viewport controller.
Returns
Section titled “Returns”on<Name>(name: Name, handler: (event: WaveformEvents[Name]) => void): () => void;Subscribes to waveform events.
Type Parameters
Section titled “Type Parameters”| Type Parameter |
|---|
Name extends keyof WaveformEvents |
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
name | Name |
handler | (event: WaveformEvents[Name]) => void |
Returns
Section titled “Returns”() => void
render()
Section titled “render()”render(): Promise<void>;Renders the current waveform viewport asynchronously.
Returns
Section titled “Returns”Promise<void>
requestRender()
Section titled “requestRender()”requestRender(): void;Schedules a render on the next animation frame.
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setConfig()
Section titled “setConfig()”setConfig(input: Partial<WaveformOptions>): void;Alias for updateConfig.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
input | Partial<WaveformOptions> |
Returns
Section titled “Returns”void
setSource()
Section titled “setSource()”setSource(source: AudioSource): void;Updates the audio source.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
source | AudioSource |
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”setViewport()
Section titled “setViewport()”setViewport(viewport: Partial<ViewportConfig>): void;Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
viewport | Partial<ViewportConfig> |
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”timeToCanvas()
Section titled “timeToCanvas()”timeToCanvas(time: number): number;Converts time in seconds to canvas X pixel position.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
time | number |
Returns
Section titled “Returns”number
updateConfig()
Section titled “updateConfig()”updateConfig(input: Partial<WaveformOptions>): void;Updates configuration options and triggers a re-render.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
input | Partial<WaveformOptions> |
Returns
Section titled “Returns”void