LineChart API

Importar

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

Use o ponto de entrada público acima. As importações apenas de tipos são removidas do JavaScript da aplicação.

`ChartOverlayError`

Erro reportado quando uma ou mais fontes de sobreposição declarativa não podem ser aplicadas.

Importar @sixtyfold/lineclasse

class ChartOverlayError extends Error

Membro	Definição	Descrição
`cause?`	`Error \| undefined`	Causa de erro de sobreposição do gráfico.
`message`	`string`	Texto da mensagem.
`name`	`"ChartOverlayError"`	Nome de apresentação deste erro de sobreposição do gráfico.
`sources`	`readonly string[]`	Fontes do erro de sobreposição do gráfico.
`stack?`	`string \| undefined`	Texto da pilha.

`ChartRendererError`

Erro reportado quando o renderer do gráfico falha durante a inicialização ou uso posterior.

Import @sixtyfold/lineclass

class ChartRendererError extends Error

Member	Definition	Description
`cause?`	`Error \| undefined`	Causa do erro do renderer do gráfico.
`message`	`string`	Texto da mensagem.
`name`	`"ChartRendererError"`	Nome de apresentação para este erro do renderer de gráfico.
`phase`	`RendererFailurePhase`	Fase do erro do renderer de gráfico.
`stack?`	`string \| undefined`	Texto da stack.

`LineChart`

Gráfico imperativo no browser para séries do tipo line, step, range, scatter, bar e stacked-area.

Import @sixtyfold/lineclasse

class LineChart

Membro	Definição	Descrição
`addVector`	`(timestamp: number, values: number[]) => void`	Enfileira um carimbo temporal finito e um valor por série configurada. Copia os valores antes de enfileirar para que o chamador possa reutilizar o array escalar; chamadas escalares e em lote válidas mantêm a sua ordem.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	Valida colunas alinhadas de carimbo temporal Float64Array e séries com carimbos temporais finitos antes de descarregar amostras escalares enfileiradas. Falhas de validação preservam a fila e os buffers do chamador; anexos em modo worker válidos transferem e destacam os buffers. Lança: Error se as colunas estiverem malformadas ou qualquer carimbo temporal for não finito.
`batch`	`(fn: () => void) => void`	Agrupa alterações síncronas de aparência e viewport numa atualização. Batches aninhados são combinados; o carregamento de dados continua imediato.
`destroy`	`() => void`	Liberta o gráfico e os recursos que possui.
`getAppearance`	`() => DeepReadonly<LineAppearanceOptions>`	Retorna uma captura de estado somente de leitura do subconjunto de aparência mutável.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	Retorna uma captura de estado normalizada e somente de leitura completa de todas as opções (construção + aparência atual).
`getRenderMode`	`() => "worker" \| "main"`	Retorna o modo de renderização resolvido ("worker" ou "thread principal").
`getSeriesVisibility`	`() => boolean[]`	Retorna a visibilidade da série.
`getViewport`	`() => Viewport`	Retorna uma captura do viewport atual.
`initialize`	`() => Promise<void>`	Aguarde até o renderer estar pronto para dados e comandos em runtime. O watchdog de inicialização em tempo de construção rejeita esta promessa com um `ChartRendererError` quando o worker ou o fallback em thread principal não ficam prontos no intervalo configurado. As aplicações devem aguardar este método antes de instalar o seu primeiro conjunto de dados.
`initStreaming`	`(seriesCount: number, maxPoints?: number) => void`	Aloca um buffer de streaming de capacidade fixa usando um número de séries e uma capacidade inteiros positivos. Descarta as amostras enfileiradas do fluxo anterior e cancela a sua animação de viewport pendente.
`reset`	`(options?: { animated?: boolean; }) => void`	Repõe o viewport para a extensão completa dos dados.
`resize`	`() => void`	Sincroniza o renderer com o tamanho do canvas.
`setData`	`(data: TimeSeriesData, options?: LineDataUpdateOptions) => number`	Carrega uma série e entrega ao renderer a propriedade dos typed arrays. Em modo worker, os buffers são transferidos e destacados; na thread principal, o renderer mantém referências. Devolve a geração dos dados.
`setKeyboardAnnouncements`	`(messages: false \| KeyboardAnnouncementMessages) => void`	Substitua ou desative os anúncios localizados de ações do teclado em tempo de execução. Os anúncios pendentes existentes são cancelados.
`setLabels`	`(labels: ChartLabels) => void`	Atualize os rótulos do gráfico em tempo de execução. Faz merge nos rótulos existentes (mesma semântica que updateAppearance). Lança: TypeError para rótulos malformados ou entradas esparsas/não-objeto `custom`.
`setLODOptions`	`(patch: LineLODOptions) => void`	Aplique uma atualização parcial a mode, density, rebase ratio ou grid quantization sem recriar o gráfico nem reconstruir a sua hierarquia.
`setMultiSeriesData`	`(data: MultiSeriesData, options?: LineDataUpdateOptions) => number`	Carrega séries alinhadas com uma coluna X partilhada e entrega ao renderer a propriedade dos typed arrays. Em modo worker, os buffers são transferidos e destacados; na thread principal, o renderer mantém referências. Devolve a geração dos dados.
`setOverlay`	`(overlay: OverlayOptions) => Promise<void>`	Atualize primitivas de sobreposição declarativas em tempo de execução. Primitivas válidas e imagens decodificadas com sucesso são instaladas mesmo quando outra imagem falha. Se todos os itens pedidos falharem, a sobreposição renderizada anteriormente permanece instalada. Falhas de resolução e de entrega do renderer rejeitam com `ChartOverlayError`; registe `setOverlayErrorCallback` quando a aplicação também necessitar de notificação assíncrona. Quando chamado antes do renderer lazy estar pronto, esta promessa inclui a espera pela prontidão. Atualizações suplantadas e destruição do gráfico são cancelamento rotineiro e resolvem sem instalar.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	Registe um callback para falhas não fatais de resolução ou entrega de sobreposição. Itens de sobreposição bem-sucedidos são ainda instalados. A promessa correspondente `setOverlay` também rejeita com o mesmo erro.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	Registe um callback de falha do renderer de execução única. Chamado uma vez antes do teardown para falhas de inicialização ou de runtime. Sem um callback, os erros usam `console.error`. Passe `null` para o cancelar; chamadas `destroy` não o invocam.
`setSeriesVisibilityCallback`	`(callback: ((event: SeriesVisibilityChangeEvent) => void) \| null) => void`	Recebe alterações de visibilidade efetuadas através da API ou da legenda interactiva.
`setSeriesVisible`	`(index: number, visible: boolean) => void`	Mostra ou oculta uma série pelo índice.
`setStatsCallback`	`(callback: ((stats: LineChartStats) => void) \| null, options?: LineChartStatsOptions) => void`	Activa estatísticas do renderizador e recebe instantâneos com throttling. Passe `null` para as desactivar.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Defina programaticamente o intervalo da viewport. Só é necessário fornecer `xMin` e/ou `xMax`; os campos omitidos mantêm os valores actuais.
`setVisibleSeries`	`(indices: number[]) => void`	Mostra apenas os índices de séries listados.
`toggleSeriesVisibility`	`(index: number) => void`	Alterna a visibilidade das séries.
`updateAppearance`	`(patch: DeepPartial<LineAppearanceOptions>) => void`	Altera (patch) as opções de aparência mutáveis em tempo de execução. Lança: TypeError para rótulos malformados ou entradas `custom` escassas/não-objeto.
`updateSeriesAppearance`	`(index: number, patch: DeepPartial<SeriesAppearanceOptions>) => void`	Altera (patch) a configuração visual de uma única série pelo índice.