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 declarativas não podem ser aplicadas.

Import @sixtyfold/lineclass

class ChartOverlayError extends Error

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

`ChartRendererError`

Erro reportado quando um renderer de gráfico falha durante a inicialização ou durante a utilização.

Import @sixtyfold/lineclass

class ChartRendererError extends Error

Membro	Definição	Descrição
`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 do gráfico.
`phase`	`RendererFailurePhase`	Fase do erro do renderer do gráfico.
`stack?`	`string \| undefined`	Texto da stack.

`LineChart`

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

Import @sixtyfold/lineclass

class LineChart

Member	Definition	Description
`addVector`	`(timestamp: number, values: number[]) => void`	Acrescenta um carimbo temporal e um valor por série ao buffer de streaming.
`addVectors`	`(timestamps: Float64Array, valuesBySeries: Float64Array[]) => void`	Acrescenta carimbos temporais alinhados e colunas de séries ao buffer de streaming.
`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 leitura apenas do subconjunto mutável da aparência.
`getOptions`	`() => DeepReadonly<LineChartOptions>`	Retorna uma captura completa normalizada de leitura apenas de todas as opções (construção + aparência actual).
`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 um instantâneo do viewport atual.
`initialize`	`() => Promise<void>`	Aguarda até o renderer estar pronto para dados e comandos de runtime. O watchdog de inicialização em tempo de construção rejeita esta promise com uma `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 para o número configurado de séries.
`reset`	`(options?: { animated?: boolean; }) => void`	Repor 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. Mescla com os rótulos existentes (mesma semântica que updateAppearance). Lança: TypeError para rótulos malformados ou entradas `custom` esparsas/não-objeto.
`setLODOptions`	`(patch: LineLODOptions) => void`	Aplique uma atualização parcial a mode, density, rebase ratio ou grid quantization sem recriar o gráfico ou 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 solicitados falharem, a sobreposição previamente renderizada permanece instalada. Falhas de resolução e de entrega do renderer são rejeitadas com `ChartOverlayError`; registe `setOverlayErrorCallback` quando a aplicação também precisar 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 a 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 uso único. Chamado uma vez antes do teardown para falhas de inicialização ou em tempo de execução. 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 feitas através da API ou da legenda interativa.
`setSeriesVisible`	`(index: number, visible: boolean) => void`	Mostra ou oculta uma série pelo índice.
`setStatsCallback`	`(callback: ((stats: LineChartStats) => void) \| null, options?: LineChartStatsOptions) => void`	Ativa estatísticas do renderer e recebe instantâneos com limitação de frequência. Passe `null` para as desativar.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Defina o intervalo de visualização programaticamente. Apenas `xMin` e/ou `xMax` precisam ser fornecidos; campos omitidos mantêm os valores atuais.
`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`	Atualiza em runtime opções de aparência mutáveis. Lança: TypeError para rótulos malformados ou entradas `custom` esparsas/não-objeto.
`updateSeriesAppearance`	`(index: number, patch: DeepPartial<SeriesAppearanceOptions>) => void`	Atualiza a configuração visual de uma única série por índice.