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`	Nachrichtentext.
`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	Description
`cause?`	`Error \| undefined`	Ursache für Renderer-Fehler des Diagramms.
`message`	`string`	Meldungstext.
`name`	`"ChartRendererError"`	Anzeigename für diesen Chart-Renderer-Fehler.
`phase`	`RendererFailurePhase`	Phase des Chart-Renderer-Fehlers.
`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

Member	Definition	Beschreibung
`addVector`	`(timestamp: number, values: number[]) => void`	Fügt für jede konfigurierte Serie jeweils einen endlichen Zeitstempel und einen Wert in die Warteschlange. Kopiert die Werte vor dem Einreihen, damit der Aufrufer das Skalaren-Array wiederverwenden kann; gültige Einzel- und Bulk-Aufrufe behalten ihre Reihenfolge.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	Validiert ausgerichtete Float64Array Zeitstempel- und Serien-Spalten mit endlichen Zeitstempeln, bevor wartende skalare Proben geflusht werden. Validierungsfehler bewahren die Warteschlange und die Aufruferpuffer; gültige Anhänge im Worker-Modus übertragen und trennen die Puffer. Wirft: Error, wenn die Spalten fehlerhaft sind oder ein Zeitstempel nicht endlich ist.
`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 Chart und dessen verwaltete Ressourcen frei.
`getAppearance`	`() => DeepReadonly<LineAppearanceOptions>`	Gibt einen schreibgeschützten Schnappschuss des veränderlichen Erscheinungs-Untersets zurück.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	Gibt einen vollständigen, normalisierten, schreibgeschützten Schnappschuss aller Optionen (Konstruktion + aktuelle Erscheinung) zurück.
`getRenderMode`	`() => "worker" \| "main"`	Gibt den aufgelösten Rendering‑Modus zurück („Worker“ oder „Hauptthread“).
`getSeriesVisibility`	`() => boolean[]`	Gibt die Sichtbarkeit der Serie zurück.
`getViewport`	`() => Viewport`	Liefert einen Schnappschuss des aktuellen Viewports.
`initialize`	`() => Promise<void>`	Warten Sie, bis der Renderer für Daten- und Laufzeitbefehle bereit ist. Der zur Konstruktionzeit wirkende Initialisierungs‑Watchdog weist dieses Promise mit einer `ChartRendererError` zurück, wenn der Worker- oder Hauptthread‑Fallback im konfigurierten Intervall nicht bereit wird. Anwendungen sollten diese Methode abwarten, bevor sie ihren ersten Datensatz setzen.
`initStreaming`	`(seriesCount: number, maxPoints?: number) => void`	Reserviert einen Streaming-Puffer mit fester Kapazität unter Verwendung einer positiven Ganzzahl für Serie und Kapazität. Setzt die für den vorherigen Stream wartenden Samples zurück und bricht dessen ausstehende Viewport-Animation ab.
`reset`	`(options?: { animated?: boolean; }) => void`	Setzt den Viewport auf den vollen Datenbereich zurück.
`resize`	`() => void`	Synchronisiert den Renderer 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 die lokalisierten Ankündigungen von Tastaturaktionen zur Laufzeit. Ausstehende Ankündigungen werden abgebrochen.
`setLabels`	`(labels: ChartLabels) => void`	Aktualisieren Sie Diagrammbezeichnungen zur Laufzeit. Fügt in vorhandene Bezeichnungen zusammen (gleiche Semantik wie updateAppearance). Wirft: TypeError bei fehlerhaften Bezeichnungen oder spärlichen/ nicht-objekt `custom` Einträgen.
`setLODOptions`	`(patch: LineLODOptions) => void`	Wenden Sie ein partielles Update auf Modus, Dichte, Rebase-Verhältnis oder Rasterquantisierung an, ohne das Diagramm neu zu erstellen oder seine 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>`	Aktualisieren Sie deklarative Overlay-Primitiven zur Laufzeit. Gültige Primitiven und erfolgreich decodierte 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‑Lieferfehler lehnen mit `ChartOverlayError` ab; registrieren Sie `setOverlayErrorCallback`, wenn die Anwendung auch asynchrone Benachrichtigung benötigt. Wird vor Bereitschaft des Lazy-Renderers aufgerufen, enthält dieses Promise das Warten auf die Bereitschaft. Veraltete Updates und Chart‑Zerstörung sind routinemäßige Abbrüche und lösen auf, ohne zu installieren.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	Registrieren Sie einen Callback für nicht‑kritische Overlay‑Auflösungs- oder Lieferfehler. Erfolgreiche Overlay‑Elemente werden dennoch installiert. Das zugehörige `setOverlay`‑Promise wird ebenfalls mit demselben Fehler abgelehnt.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	Registrieren Sie einen einmaligen Renderer‑Fehler‑Callback. Wird einmalig vor dem Abbau bei Initialisierungs‑ oder Laufzeitfehlern aufgerufen. Ohne Callback verwenden Fehler `console.error`. Übergeben Sie `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. Übergeben Sie `null`, um sie zu deaktivieren.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Setzen Sie programmatisch den Viewport‑Bereich. Es müssen nur `xMin` und/oder `xMax` angegeben werden; ausgelassene Felder behalten die aktuellen Werte.
`setVisibleSeries`	`(indices: number[]) => void`	Zeigt nur die aufgeführten Serienindizes an.
`toggleSeriesVisibility`	`(index: number) => void`	Schaltet die Sichtbarkeit von Serien um.
`updateAppearance`	`(patch: DeepPartial<LineAppearanceOptions>) => void`	Ändert zur Laufzeit veränderbare Darstellungsoptionen punktuell. Wirft: TypeError bei fehlerhaften Labels oder bei lückenhaften/nicht-objektartigen `custom` Einträgen.
`updateSeriesAppearance`	`(index: number, patch: DeepPartial<SeriesAppearanceOptions>) => void`	Ändert die visuelle Konfiguration für eine einzelne Serie anhand des Index punktuell.