Worker, 메인 스레드 및 렌더링
Sixtyfold의 공유 Canvas2D 렌더링 경로를 선택하고 운영하십시오.
Sixtyfold에는 세 가지 호스트를 갖춘 단일 TypeScript 렌더링 설계가 있습니다: OffscreenCanvas Worker, 비동기식 메인 스레드 어댑터, 그리고 서버 측 렌더링 진입점. 그래픽 백엔드는 Canvas2D만 지원됩니다.
렌더러 선택은 LineChartOptions 및 StockChartOptions의 일부입니다. 해결된 모드는 chart.getRenderMode()에서 확인할 수 있습니다.
자동 선택
renderMode: "auto"는 브라우저가 Worker, OffscreenCanvas 및 캔버스 전송을 지원하면 Worker를 선호합니다. 이러한 기능이 없거나 Worker 생성이 동기적으로 차단될 때(엄격한 콘텐츠 보안 정책에 의해 차단되는 경우 포함) 메인 스레드로 대체됩니다.
const chart = new LineChart(canvas, { renderMode: "auto" });
await chart.initialize();
console.log(chart.getRenderMode()); // "worker" or "main"renderMode: "worker"는 약속이 아니라 선호를 표현합니다; Worker 렌더링을 시작할 수 없을 때는 여전히 대체됩니다. 텔레메트리 및 지원 정보를 위해 getRenderMode()을 사용하십시오.
Worker 모드
Worker 모드는 캔버스와 대용량 타입화 배열 버퍼의 제어를 이전합니다. 계층 구성, 컬링, 레이아웃 및 렌더링이 브라우저의 UI 작업을 차지하지 않기 때문에 수백만 포인트의 대화형 차트에 권장되는 경로입니다.
사용자 정의 툴팁 렌더링과 같은 메인-스레드 콜백은 워커 상태에 대한 직접 접근 대신 컴팩트한 렌더러 메시지를 수신합니다. 콜백은 결정적이고 빠르게 유지하십시오.
메인-스레드 모드
테스트 환경, 전달 가능한 캔버스가 없는 브라우저, 워커를 금지하는 엄격한 호스트, 또는 UI-스레드 분리보다 간단한 통합이 더 중요한 작은 정적 차트의 경우 renderMode: "main"을 사용하십시오.
메인 스레드 어댑터는 렌더러 메시지를 의도적으로 비동기적으로 전달합니다. setData를 호출했다고 첫 프레임이 동기적으로 완료되었다고 가정하지 마십시오; 프레임 완료가 중요할 경우 통계나 애플리케이션 수준의 준비 UI를 사용하십시오.
릴리스 검사에서는 Line과 Stock을 Chromium, Firefox 및 WebKit의 메인 스레드 경로와 프로덕션 기본 auto 경로를 통해 모두 실행합니다. 지원되는 엔진에서는 auto이 OffscreenCanvas Worker로 해석됩니다. 강제 Worker 계약도 Chromium에서 실행됩니다. 이는 장치 독립적 프레임레이트 보장이 아니라 호환성 검증입니다.
크기 조정 및 DPR
캔버스의 CSS 너비와 높이는 레이아웃을 통해 설정하십시오. Sixtyfold Charts는 요소 크기와 디바이스 픽셀 비율 변경을 관찰한 후 백킹 스토어와 렌더러 레이아웃을 업데이트합니다. resize()는 호스트가 즉시 관찰할 수 없는 방식으로 레이아웃을 변경할 때에도 계속 사용 가능합니다.
응답형 차트에는 캔버스의 width 및 height 속성만 설정하지 마십시오. 해당 속성들은 백킹-스토어 값이며, Sixtyfold Charts의 공개 크기 및 스타일 필드는 CSS 픽셀을 사용합니다.
콘텐츠 보안 정책
제한적인 운영 정책은 일반적으로 다음을 요구합니다:
default-src 'self';
script-src 'self';
worker-src 'self';
img-src 'self' data: blob:;
connect-src 'self';이 예시는 그대로 복사하기보다 애플리케이션에 맞게 조정하십시오. 원격 오버레이 이미지는 img-src에 해당하는 출처와 호환되는 CORS 응답 헤더가 필요합니다.
가시성 및 정리
브라우저 차트는 보이지 않을 때 불필요한 작업을 일시 중지하거나 회피합니다. 선택적 Safari 유지-활성 간격은 기본적으로 비활성화되어 있으며, 대상 Safari 버전에서 리소스 회수 동작을 재현한 후에만 활성화해야 합니다.
캔버스를 영구적으로 폐기하기 전에 항상 destroy()를 호출하십시오. 단일 페이지 애플리케이션에서는 프레임워크의 정리 훅이 올바른 위치입니다.
프레임워크 준비 콜백은 초기화와 초기 prop 설정의 성공을 확인할 뿐, 페인트된 캔버스 프레임을 보장하지 않습니다. React 19.2+의 Activity 숨기기는 마운트된 렌더러와 그 메모리를 실제 언마운트 시점까지 유지하므로 Worker 폐기의 경계가 아닙니다. 숨겨진 ref, 지연 콜백 및 오류 복구에 대해서는 adapter lifecycle contract를 참조하십시오.