LineChart API

가져오기

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

위에 표시된 공개 진입점을 사용하세요. 타입 전용 가져오기는 애플리케이션 JavaScript에서 제거됩니다.

`ChartOverlayError`

하나 이상의 선언형 오버레이 소스를 적용할 수 없을 때 보고되는 오류.

가져오기 @sixtyfold/line클래스

class ChartOverlayError extends Error

멤버	정의	설명
`cause?`	`Error \| undefined`	차트 오버레이 오류의 원인.
`message`	`string`	메시지 텍스트.
`name`	`"ChartOverlayError"`	이 차트 오버레이 오류의 표시 이름입니다.
`sources`	`readonly string[]`	차트 오버레이 오류의 출처입니다.
`stack?`	`string \| undefined`	스택 텍스트입니다.

`ChartRendererError`

차트 렌더러가 시작 중이거나 이후 사용 중에 실패했을 때 보고되는 오류입니다.

가져오기 @sixtyfold/line클래스

class ChartRendererError extends Error

멤버	정의	설명
`cause?`	`Error \| undefined`	차트 렌더러 오류의 원인.
`message`	`string`	메시지 텍스트.
`name`	`"ChartRendererError"`	이 차트 렌더러 오류의 표시 이름입니다.
`phase`	`RendererFailurePhase`	차트 렌더러 오류의 단계입니다.
`stack?`	`string \| undefined`	스택 텍스트입니다.

`LineChart`

라인, 스텝, 범위, 산점도, 막대 및 스택형 영역 시리즈용 명령형 브라우저 차트입니다.

가져오기 @sixtyfold/line클래스

class LineChart

멤버	정의	설명
`addVector`	`(timestamp: number, values: number[]) => void`	각 시리즈에 타임스탬프 하나와 값 하나를 스트리밍 버퍼에 추가합니다.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	정렬된 타임스탬프와 시리즈 열을 스트리밍 버퍼에 추가합니다.
`batch`	`(fn: () => void) => void`	동기식 표시 및 뷰포트 변경을 하나의 업데이트로 그룹화합니다. 중첩된 배치는 결합되며; 데이터 로딩 호출은 여전히 즉시 실행됩니다.
`destroy`	`() => void`	차트와 그가 소유한 리소스를 해제합니다.
`getAppearance`	`() => DeepReadonly<LineAppearanceOptions>`	변경 가능한 표시 하위 집합의 읽기 전용 스냅샷을 반환합니다.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	모든 옵션(구성 + 현재 표시)의 정규화된 전체 읽기 전용 스냅샷을 반환합니다.
`getRenderMode`	`() => "worker" \| "main"`	해결된 렌더링 모드("Worker" 또는 "메인 스레드")를 반환합니다.
`getSeriesVisibility`	`() => boolean[]`	시리즈의 가시성을 반환합니다.
`getViewport`	`() => Viewport`	현재 뷰포트의 스냅샷을 반환합니다.
`initialize`	`() => Promise<void>`	렌더러가 데이터 및 런타임 명령을 처리할 준비가 될 때까지 대기합니다. 생성 시 초기화 감시자는 구성된 시간 내에 Worker 또는 메인 스레드 폴백이 준비되지 않으면 이 프라미스를 `ChartRendererError`로 거부합니다. 애플리케이션은 첫 데이터셋을 설치하기 전에 이 메서드를 await해야 합니다.
`initStreaming`	`(seriesCount: number, maxPoints?: number) => void`	구성된 시리즈 수에 대해 고정 용량 스트리밍 버퍼를 할당합니다.
`reset`	`(options?: { animated?: boolean; }) => void`	뷰포트를 전체 데이터 범위로 재설정합니다.
`resize`	`() => void`	렌더러를 캔버스 크기와 동기화합니다.
`setData`	`(data: TimeSeriesData, options?: LineDataUpdateOptions) => number`	하나의 시리즈를 로드하고 해당 타입화된 배열의 소유권을 렌더러에 전달합니다. Worker 모드에서는 버퍼를 전송하고 분리(detach)하며; 메인 스레드 모드에서는 배열을 참조로 유지합니다. 데이터 생성 번호를 반환합니다. 타입화 배열 열 또는 선언된 길이가 잘못되었거나 정렬되지 않은 경우 TypeError 또는 RangeError 를 throw합니다.
`setKeyboardAnnouncements`	`(messages: false \| KeyboardAnnouncementMessages) => void`	런타임에 로컬화된 키보드 동작 알림을 교체하거나 비활성화합니다. 기존 대기 중인 알림은 취소됩니다.
`setLabels`	`(labels: ChartLabels) => void`	런타임에 차트 레이블을 업데이트합니다. 기존 레이블에 병합됩니다(updateAppearance와 동일한 의미). 잘못된 레이블이나 희소/객체가 아닌 `custom` 항목에 대해 TypeError을 던집니다.
`setLODOptions`	`(patch: LineLODOptions) => void`	차트를 재생성하거나 계층 구조를 재구축하지 않고 모드, 밀도, 리베이스 비율 또는 그리드 양자화에 부분 업데이트를 적용합니다.
`setMultiSeriesData`	`(data: MultiSeriesData, options?: LineDataUpdateOptions) => number`	하나의 공유 X 열을 가진 정렬된 시리즈를 로드하고 렌더러에 해당 타입화 배열의 소유권을 부여합니다. Worker 모드에서는 버퍼를 전송하고 분리하며; 메인 스레드 모드에서는 배열을 참조로 유지합니다. 데이터 생성 번호를 반환합니다. 타입화된 배열 열, 시리즈 메타데이터 또는 선언된 길이가 잘못되었거나 정렬되지 않은 경우 TypeError 또는 RangeError를 던집니다.
`setOverlay`	`(overlay: OverlayOptions) => Promise<void>`	런타임에 선언적 오버레이 프리미티브를 업데이트합니다. 유효한 프리미티브와 성공적으로 디코드된 이미지는 다른 이미지가 실패하더라도 설치됩니다. 요청한 항목이 모두 실패하면 이전에 렌더된 오버레이가 유지됩니다. 해상도 및 렌더러 전달 실패는 `ChartOverlayError`로 거부되며, 애플리케이션이 비동기 알림도 필요하면 `setOverlayErrorCallback`을 등록하세요. 지연 렌더러가 준비되기 전에 호출되면 이 프라미스에는 준비 대기가 포함됩니다. 대체된 업데이트와 차트 파괴는 일반적인 취소로 간주되어 설치 없이 해결됩니다.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	비치명적(비치명적인) 오버레이 해상도 또는 전달 실패에 대한 콜백을 등록합니다. 성공한 오버레이 항목은 여전히 설치됩니다. 일치하는 `setOverlay` 프라미스도 동일한 오류로 거부됩니다.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	일회성 렌더러 실패 콜백을 등록합니다. 초기화 또는 런타임 실패가 있을 때 종료 전에 한 번 호출됩니다. 콜백이 없으면 오류는 `console.error`를 사용합니다. 취소하려면 `null`을 전달하세요; `destroy` 호출은 이를 호출하지 않습니다.
`setSeriesVisibilityCallback`	`(callback: ((event: SeriesVisibilityChangeEvent) => void) \| null) => void`	API 또는 대화형 범례를 통해 이루어진 가시성 변경을 수신합니다.
`setSeriesVisible`	`(index: number, visible: boolean) => void`	인덱스로 하나의 시리즈를 표시하거나 숨깁니다.
`setStatsCallback`	`(callback: ((stats: LineChartStats) => void) \| null, options?: LineChartStatsOptions) => void`	렌더러 통계를 활성화하고 스로틀된 스냅샷을 수신합니다. 비활성화하려면 `null`를 전달하세요.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	뷰포트 범위를 프로그래밍 방식으로 설정합니다. `xMin` 및/또는 `xMax`만 제공하면 되며; 생략된 필드는 현재 값을 유지합니다.
`setVisibleSeries`	`(indices: number[]) => void`	나열된 시리즈 인덱스만 표시합니다.
`toggleSeriesVisibility`	`(index: number) => void`	시리즈 가시성을 전환합니다.
`updateAppearance`	`(patch: DeepPartial<LineAppearanceOptions>) => void`	런타임에 변경 가능한 appearance 옵션을 패치합니다. 잘못된 레이블 또는 희박/비객체 `custom` 항목에 대해 TypeError를 던집니다.
`updateSeriesAppearance`	`(index: number, patch: DeepPartial<SeriesAppearanceOptions>) => void`	인덱스로 단일 시리즈의 시각적 구성을 패치합니다.