LineChart API

Import

import { LineChart } from "@sixtyfold/line";

Verwenden Sie den oben gezeigten öffentlichen Einstiegspunkt. Reine Typimporte werden aus dem Anwendungs-JavaScript entfernt.

`ChartOverlayError`

Fehler, der gemeldet wird, wenn eine oder mehrere deklarative Overlay-Quellen nicht angewendet werden können.

Import @sixtyfold/lineclass

class ChartOverlayError extends Error

Member	Definition	Beschreibung
`cause?`	`Error \| undefined`	Ursache für Chart-Overlay-Fehler.
`message`	`string`	Meldungstext.
`name`	`"ChartOverlayError"`	Anzeigename für diesen Chart-Overlay-Fehler.
`sources`	`readonly string[]`	Quellen für Chart-Overlay-Fehler.
`stack?`	`string \| undefined`	Stapeltext.

`ChartRendererError`

Fehler, der gemeldet wird, wenn ein Chart-Renderer beim Start oder späterer Nutzung ausfällt.

Import @sixtyfold/lineclass

class ChartRendererError extends Error

Member	Definition	Beschreibung
`cause?`	`Error \| undefined`	Ursache für einen Fehler im Chart-Renderer.
`message`	`string`	Nachrichtentext.
`name`	`"ChartRendererError"`	Anzeigename für diesen Chart-Renderer-Fehler.
`phase`	`RendererFailurePhase`	Phase für Chart-Renderer-Fehler.
`stack?`	`string \| undefined`	Stack-Text.

`LineChart`

Imperatives Browser-Chart für Line-, Step-, Range-, Scatter-, Bar- und Stacked-Area-Serien.

Import @sixtyfold/lineclass

class LineChart

Mitglied	Definition	Beschreibung
`addVector`	`(timestamp: number, values: number[]) => void`	Hängt für jede Serie einen Zeitstempel und einen Wert an den Streaming-Puffer an.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	Hängt ausgerichtete Zeitstempel- und Serien-Spalten an den Streaming-Puffer an.
`batch`	`(fn: () => void) => void`	Fasst synchrone Appearance- und Viewport-Änderungen in einem Update zusammen. Verschachtelte Batches werden kombiniert; Datenladeaufrufe laufen sofort.
`destroy`	`() => void`	Gibt das Diagramm und seine zugehörigen Ressourcen frei.
`getAppearance`	`() => DeepReadonly<LineAppearanceOptions>`	Gibt einen schreibgeschützten Snapshot der veränderlichen Erscheinungs-Teilmenge zurück.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	Gibt einen vollständig normalisierten, schreibgeschützten Snapshot aller Optionen zurück (Konstruktion + aktuelle Erscheinung).
`getRenderMode`	`() => "worker" \| "main"`	Gibt den aufgelösten Render-Modus zurück ("Worker" oder "Hauptthread").
`getSeriesVisibility`	`() => boolean[]`	Gibt die Sichtbarkeit der Serie zurück.
`getViewport`	`() => Viewport`	Gibt einen Snapshot des aktuellen Viewports zurück.
`initialize`	`() => Promise<void>`	Warten, bis der Renderer für Daten- und Laufzeitbefehle bereit ist. Der beim Erstellen laufende Initialisierungs-Wachhund verwirft dieses Promise mit einer `ChartRendererError`, wenn der Worker- oder Hauptthread-Fallback im konfigurierten Intervall nicht bereit wird. Anwendungen sollten diese Methode abwarten, bevor sie ihren ersten Datensatz installieren.
`initStreaming`	`(seriesCount: number, maxPoints?: number) => void`	Reserviert einen Streaming-Puffer mit fester Kapazität für die konfigurierte Anzahl von Serien.
`reset`	`(options?: { animated?: boolean; }) => void`	Setzt die Ansicht (Viewport) auf die vollständige Datenextent zurück.
`resize`	`() => void`	Synchronisiert das Rendering mit der Canvas-Größe.
`setData`	`(data: TimeSeriesData, options?: LineDataUpdateOptions) => number`	Lädt eine Serie und übergibt dem Renderer die Eigentümerschaft an ihren Typed Arrays. Im Worker-Modus werden die Buffer übertragen und abgetrennt; im Main-Thread-Modus behält der Renderer Referenzen. Gibt die Datengeneration zurück.
`setKeyboardAnnouncements`	`(messages: false \| KeyboardAnnouncementMessages) => void`	Ersetzen oder deaktivieren Sie zur Laufzeit die lokalisierten Tastatur-Aktionsansagen. Ausstehende Ansagen werden abgebrochen.
`setLabels`	`(labels: ChartLabels) => void`	Aktualisieren Sie Diagramm-Beschriftungen zur Laufzeit. Wird in bestehende Beschriftungen zusammengeführt (gleiche Semantik wie updateAppearance). Wirft: TypeError bei fehlerhaften Beschriftungen oder spärlichen/nicht-Objekt-`custom`-Einträgen.
`setLODOptions`	`(patch: LineLODOptions) => void`	Wenden Sie ein Teil-Update für Modus, Dichte, Rebase-Verhältnis oder Rasterquantisierung an, ohne das Diagramm neu zu erstellen oder dessen Hierarchie neu aufzubauen.
`setMultiSeriesData`	`(data: MultiSeriesData, options?: LineDataUpdateOptions) => number`	Lädt ausgerichtete Serien mit einer gemeinsamen X-Spalte und übergibt dem Renderer die Eigentümerschaft an ihren Typed Arrays. Im Worker-Modus werden die Buffer übertragen und abgetrennt; im Main-Thread-Modus behält der Renderer Referenzen. Gibt die Datengeneration zurück.
`setOverlay`	`(overlay: OverlayOptions) => Promise<void>`	Aktualisiere deklarative Overlay-Primitiven zur Laufzeit. Gültige Primitiven und erfolgreich dekodierte Bilder werden installiert, selbst wenn ein anderes Bild fehlschlägt. Wenn jedes angeforderte Element fehlschlägt, bleibt das zuvor gerenderte Overlay installiert. Auflösungs- und Renderer-Zustellungsfehler lehnen mit `ChartOverlayError` ab; registriere `setOverlayErrorCallback`, wenn die Anwendung außerdem asynchrone Benachrichtigung benötigt. Wenn der Aufruf erfolgt, bevor der Lazy-Renderer bereit ist, enthält dieses Promise die Wartezeit auf die Bereitschaft. Überholte Updates und Chart-Zerstörung sind routinemäßige Abbrüche und lösen auf, ohne zu installieren.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	Registriere einen Callback für nicht-fatale Overlay-Auflösungs- oder Zustellungsfehler. Erfolgreiche Overlay-Elemente werden weiterhin installiert. Dasselbe zugehörige Promise `setOverlay` wird ebenfalls mit demselben Fehler abgelehnt.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	Registriere einen einmaligen Renderer-Fehler-Callback. Wird einmalig vor dem Teardown für Initialisierungs- oder Laufzeitfehler aufgerufen. Ohne Callback verwenden Fehler `console.error`. Übergebe `null`, um ihn zu stornieren; Aufrufe von `destroy` rufen ihn nicht auf.
`setSeriesVisibilityCallback`	`(callback: ((event: SeriesVisibilityChangeEvent) => void) \| null) => void`	Empfängt Sichtbarkeitsänderungen, die über die API oder die interaktive Legende vorgenommen werden.
`setSeriesVisible`	`(index: number, visible: boolean) => void`	Zeigt eine Serie nach Index an oder blendet sie aus.
`setStatsCallback`	`(callback: ((stats: LineChartStats) => void) \| null, options?: LineChartStatsOptions) => void`	Aktiviert Renderer‑Statistiken und empfängt gedrosselte Schnappschüsse. Übergebe `null`, um sie zu deaktivieren.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Setze den Viewport‑Bereich programmatisch. Es müssen nur `xMin` und/oder `xMax` angegeben werden; ausgelassene Felder behalten die aktuellen Werte.
`setVisibleSeries`	`(indices: number[]) => void`	Zeigt nur die aufgelisteten Serienindizes an.
`toggleSeriesVisibility`	`(index: number) => void`	Schaltet die Sichtbarkeit der Reihen um.
`updateAppearance`	`(patch: DeepPartial<LineAppearanceOptions>) => void`	Patcht zur Laufzeit änderbare Erscheinungsoptionen. Wirft: TypeError bei fehlerhaften Labels oder spärlichen/nicht-Objekt-`custom`-Einträgen.
`updateSeriesAppearance`	`(index: number, patch: DeepPartial<SeriesAppearanceOptions>) => void`	Patcht die visuelle Konfiguration für eine einzelne Serie nach Index.