API 참조

데이터 Figure

typeplot 또는 typeplot/data에서 가져옵니다. 두 진입점 모두 컴파일러 없이 TypeShade 런타임을 포함합니다. Figure 핸들은 동기적으로 생성합니다. 첫 GPU 프레임은 fig.ready를 기다리고 초기화 오류를 처리하십시오.

• plot(y, options?)배열 인덱스를 x 좌표로 사용하는 Figure를 만듭니다.
• plot(x, yOrFunction, options?)배열, typed array 또는 JavaScript 함수로 그래프를 그립니다.
• subplots(rows?, cols?, options?){ fig, axes }를 반환합니다. axes는 항상 행 우선의 1차원 배열입니다.
• figure(options?)빈 Figure를 만듭니다. fig.axes[0]에서 그래프를 추가합니다.
• linspace(start, stop, count = 50)양 끝점을 포함하는 Float64Array를 반환합니다.
• ax.plot / scatter / bar / histogram계열을 추가합니다. histogram은 { counts, bins, series }를 반환합니다.
• ax.set(options)title, xLabel, yLabel, grid, legend, 축 범위와 축 종류를 설정합니다.
• ax.setXLimits / setYLimits축 범위를 고정합니다. autoscale()로 자동 범위로 돌아갑니다.
• series.setData / remove계열 데이터를 교체하거나 계열을 제거합니다.
• fig.saveImage / toBlob / destroyPNG 다운로드, PNG Blob 생성, 리소스 해제를 수행합니다.

계열 스타일과 축 옵션

계열에는 label, color, lineWidth, lineStyle, marker, markerSize, alpha를 지정합니다. 절차형 대시는 곡선 매개변수 좌표에서 반복하며 parameter(auto/x/index), dashPeriod, dashOffset으로 기준·주기·위상을 조절합니다. 선 종류는 -, --, :, none이며, 마커는 o, s, none입니다. xScale/yScale은 linear 또는 log이고 xLimits/yLimits로 범위를 고정합니다.

ax.plot(x, y, {
  label: "Measurements", color: "#1677ff",
  lineWidth: 2, lineStyle: "--", marker: "o", markerSize: 3,
});
ax.set({ xScale: "log", xLimits: [1, 100], grid: true });

히스토그램

bins에는 1부터 10000까지의 구간 수 또는 유한하고 엄격히 증가하는 경계 배열을 전달합니다. 마지막 구간은 오른쪽 끝점을 포함합니다. density: true는 막대 전체 넓이를 1로 맞춥니다. NaN과 무한대는 무시합니다. 구간을 바꾸려면 기존 히스토그램을 제거한 뒤 다시 만드십시오.

GPU 프로그램

typeplot/compiler나 Vite 플러그인으로 컴파일하고 createPlot(canvas, program, options)으로 연결합니다. 기존 plot(canvas, program, options) 형식도 지원합니다.

• compilePlot(source, options)스칼라 또는 매개변수 콜백을 빌드 때 컴파일합니다.
• createPlot(canvas, program, options)실제 백엔드를 포함한 Promise<Plot>을 반환합니다.
• plot.setParameters(values)선언된 유한 f32 매개변수를 갱신합니다. 알 수 없는 이름은 거부합니다.
• plot.setMode / setProjection / setProbe / bounds2D/3D 모드, Perspective/Orthographic 투영, 프로브와 현재 범위를 관리합니다.
• plot.setStyle(style)카메라를 초기화하지 않고 CSS px 단위의 굵기와 글자 크기, 격자·라벨 표시를 설정합니다.
• plot.reset / redraw / destroy초기 설정 복원, 프레임 요청, 리소스 해제를 수행합니다.

내보내기와 수명

Figure.toBlob()은 PNG Blob을 반환하고 saveImage()는 다운로드를 시작합니다. 저장 크기는 화면 표시 크기와 독립적입니다. 전체 1600만 픽셀, 한 변 16384픽셀 제한이 있습니다. destroy()는 여러 번 호출해도 안전하며 관찰자·이벤트·예약 프레임·DOM을 해제합니다.