@openheart/tavio-renderer 2.3.30-with-wasm → 2.5.0

package/build/esm/types/viewer/driver/iCoreDriver.d.ts

@@ -0,0 +1,224 @@
+import { default as EventEmitter } from 'eventemitter3';
+import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iVectorLike, iSelectorInfo, iPickingInfo, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iCollisionTarget } from '../../worker/tavioWorker';
+import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
+import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
+import { iCameraSelectorOption } from '../../editor/selector/cameraSelector';
+import { MeshStandardMaterialParameters } from 'three';
+import { iLatitudeLongitude } from '../../camera/flightControls';
+import { WorkerElementAdapter } from './workerElementAdapter';
+import { CameraPath } from '../../camera/cameraPath';
+export interface iCoreDriver extends EventEmitter {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    viewerOption: iViewerOption;
+    getElementAdapter(): HTMLCanvasElement | OffscreenCanvas | WorkerElementAdapter;
+    init(canvas: HTMLCanvasElement | OffscreenCanvas, materialOption?: iViewerMaterialOption): void;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    resize(width?: number, height?: number, start?: boolean): void;
+    dispose(): void;
+    addAmbientLight(color: number, intensity: number): void;
+    addSpotLight(position: iVectorLike, target: iVectorLike, color: number, intensity: number, distance: number, angle: number, penumbra: number, decay: number, castShadow?: boolean, isDebug?: boolean): void;
+    addWhiteCube(position?: iVectorLike, scale?: iVectorLike, receiveShadow?: boolean, materialOption?: MeshStandardMaterialParameters): void;
+    setAmbientLightIntensity(intensity: number): void;
+    setSpotLightPosition(position: iVectorLike): void;
+    setSpotLightTargetPosition(target: iVectorLike): void;
+    setSpotLightIntensity(intensity: number): void;
+    setSpotLightDistance(distance: number): void;
+    setSpotLightAngle(angle: number): void;
+    setSpotLightPenumbra(penumbra: number): void;
+    setSpotLightDecay(decay: number): void;
+    renderShadow(): void;
+    loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    concatTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    concatPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    concatSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    concatImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    concatCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    saveSplatWasm(name: string, fileName?: string): Promise<any>;
+    savePlyWasm(name: string, fileName?: string): Promise<any>;
+    saveSpzWasm(name: string, fileName?: string): Promise<any>;
+    saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
+    exportTavioWasm(name: string, options?: any): Promise<any>;
+    addTavioMesh(name: string): void;
+    removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
+    removeTavioMeshAllRenderView(name: string): void;
+    disposeTavioMesh(name: string): void;
+    setVisibilityTavioMesh(name: string, visibility: boolean): void;
+    setVisibilityPoints(name: string, visibility: boolean): void;
+    setBackgroundOpacity(opacity: number): void;
+    setBackgroundByTavioMesh(name: string): void;
+    getFirstMeshName(): Promise<string | null> | string | null;
+    createRenderView(name: string | Symbol): void;
+    setRenderView(name?: string | Symbol | null): void;
+    getCurrentRenderViewName(): Promise<string | null> | string | null;
+    getRenderViewCount(): Promise<number> | number;
+    setRenderViewSize(renderViewName?: string | Symbol, x?: number, y?: number, width?: number, height?: number, start?: boolean): void;
+    getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null> | iPickingInfo | null;
+    setUniforms(uniforms: Record<string, tUniformValue>): void;
+    setPointUniforms(uniforms: Record<string, tUniformValue>): void;
+    setCustomDefines(defines: tCustomDefines): void;
+    setCustomUniforms(uniforms: tCustomUniforms): void;
+    setGaussianScale(scale: number): void;
+    setOpacityAdditive(opacity: number): void;
+    setOpacityMultiplier(multiplier: number): void;
+    setOpacityPoints(opacity: number): void;
+    setSphericalHarmonicsIntensity(intensity: number): void;
+    setUsingSphericalHarmonics(isUsing: boolean): void;
+    setColorBlur(blur: number): void;
+    setColorSharpness(sharpness: number): void;
+    setColorTemperature(temperature: number): void;
+    setColorTint(tint: number): void;
+    setColorContrast(contrast: number): void;
+    setHSVColor(hsv: iVectorLike): void;
+    setColorRGB(rgb: iVectorLike): void;
+    setClippingEnabled(enabled: boolean): void;
+    setClippingSphere(position: iVectorLike, scale: iVectorLike): void;
+    setOutsideClipPointSize(size: number): void;
+    setOutsideClipOpacity(opacity: number): void;
+    setEffectMinimumScale(value: number): void;
+    setEffectDistanceBase(value: number): void;
+    setEffectDistanceRange(value: number): void;
+    setWorldOrigin(x: number, y: number, z: number): void;
+    setEffectDistancePoints(value: number): void;
+    setEffectDistanceNearPoints(value: number): void;
+    setEffectSonar(value: number): void;
+    setEffectSonarRange(value: number): void;
+    startBloomPoints(duration?: number): void;
+    startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
+    startSonarWave(duration?: number): void;
+    animatePath(name?: string, duration?: number): void;
+    startFadeInBackground(duration?: number): void;
+    startFadeOutBackground(duration?: number): void;
+    setOrbitCursorAutoDisplay(enabled: boolean): void;
+    isOrbitCursorAutoDisplayEnabled(): Promise<boolean> | boolean;
+    setOrbitCursorDisplay(enabled: boolean): void;
+    isOrbitCursorDisplay(): Promise<boolean> | boolean;
+    setOrbitCursorScale(scale: number): void;
+    setAxisVisible(visible: boolean): void;
+    isAxisVisible(): Promise<boolean> | boolean;
+    applyLocalTransformToSelected(name: string, translation: iVectorLike, rotation: iVectorLike, scale: iVectorLike): void;
+    resetLocalTransformOfSelected(name: string): void;
+    resetAllLocalTransforms(name: string): void;
+    setLocalTransformGizmoEnabled(enabled: boolean): void;
+    setLocalTransformGizmoMode(mode: "translate" | "rotate" | "scale"): void;
+    setDropShadow(enabled: boolean): void;
+    setModelTransform(name: string, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    getModelTransform(name: string): Promise<iTransform | null> | iTransform | null;
+    setTransform(name: string, index: number, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    getTransform(name: string, index: number): Promise<iTransform | null> | iTransform | null;
+    setBillboard(name: string, index: number, flag: boolean): void;
+    setCameraParameter(position?: number[] | iVectorLike, target?: number[] | iVectorLike, fov?: number): void;
+    getCameraParameter(): Promise<iCameraParameter> | iCameraParameter;
+    setCameraColliderEnabled(enabled: boolean): void;
+    setCameraColliderSelector(selectorNames?: string[]): void;
+    getCameraColliderEnabled(): Promise<boolean> | boolean;
+    setInteractiveMode(interactive: boolean): void;
+    getInteractiveMode(): Promise<boolean> | boolean;
+    setControlsType(controlsType: string): void;
+    getControlsType(): Promise<tControlsType> | tControlsType;
+    setControlsAttenuation(attenuation: number): void;
+    selectCameraPath(name: string): void;
+    updateCameraPath(time?: number): void;
+    createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): CameraPath | void;
+    /** times: 各制御点に対応する時刻（0.0 ～ 1.0）。省略時は等間隔 */
+    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
+    removeCameraPath(name: string): void;
+    /** 名前を指定してカメラパスのデバッグ可視化(補間曲線と制御点)の表示/非表示を切り替える */
+    setCameraPathDebugVisible(name: string, visible: boolean): void;
+    getPathNames(): Promise<string[]> | string[];
+    getActiveCameraPathName(): Promise<string | null> | string | null;
+    getCameraPathByTime(name?: string, time?: number): Promise<{
+        position: iVectorLike;
+        target: iVectorLike;
+    } | null> | {
+        position: iVectorLike;
+        target: iVectorLike;
+    } | null;
+    getCameraPathTime(): Promise<number> | number;
+    setCameraPathOption(option: iCameraPathOption): void;
+    setCameraPathCollisionRadius(radius: number): void;
+    setCameraPathInteraction(x: number, y: number): void;
+    setOrbitPointerDown(isDown: boolean): void;
+    setOrbitRelativeRotateLeft(value: number): void;
+    setOrbitRelativeRotateUp(value: number): void;
+    setOrbitRelativeTranslateLeft(value: number): void;
+    setOrbitRelativeTranslateUp(value: number): void;
+    setOrbitRelativeDollyOut(value: number): void;
+    getOrbitDistance(): Promise<number> | number;
+    setOrbitDistance(distance: number): void;
+    setOrbitRotation(pitch: number, yaw: number, isForce?: boolean): void;
+    setOrbitRelativeRotation(pitch: number, yaw: number): void;
+    setOrbitEnableZoom(enable: boolean): void;
+    setOrbitEnablePan(enable: boolean): void;
+    setOrbitEnableLimit(enable: boolean): void;
+    setOrbitEnableZoomLimit(enable: boolean): void;
+    setOrbitOverflow(value: number): void;
+    setOrbitUpLimit(value: number): void;
+    setOrbitDownLimit(value: number): void;
+    setOrbitLeftLimit(value: number): void;
+    setOrbitRightLimit(value: number): void;
+    setOrbitZoomInLimit(value: number): void;
+    setOrbitZoomOutLimit(value: number): void;
+    setTransferPosition(position: iVectorLike): void;
+    setTransferRelativePosition(position: iVectorLike, isForce?: boolean): void;
+    moveTransferByDirection(offset: iVectorLike, scale: number, isForce?: boolean): void;
+    moveTransferByHorizontalDirection(x: number, y: number, scale: number, isForce?: boolean): void;
+    moveTransferToTop(scale: number, isForce?: boolean): void;
+    moveTransferToBottom(scale: number, isForce?: boolean): void;
+    setTransferFov(fov: number): void;
+    getFlightParameter(): Promise<iLatitudeLongitude | null> | iLatitudeLongitude | null;
+    setFlightLongitude(longitude: number): void;
+    setFlightLatitude(latitude: number): void;
+    setFlightRelativeLatitude(latitude: number, isForce?: boolean): void;
+    setFlightRelativeLongitude(longitude: number, isForce?: boolean): void;
+    selectSplatByScreenArea(minX: number, minY: number, maxX: number, maxY: number, mode?: tSelectionMode, maskCanvas?: tMaskSource | {
+        width: number;
+        height: number;
+        data: ArrayBuffer;
+    }): void;
+    setFrameRateLimit(fps: number): void;
+    setDevicePixelRatio(value: number): void;
+    getDevicePixelRatio(): number | null;
+    getHeaderInfo(name: string): Promise<iHeaderInfo | null> | iHeaderInfo | null;
+    setCollisionReversed(reversed: boolean): void;
+    deleteSelectedGaussian(): void;
+    undoDeletedGaussian(): void;
+    resetDeletedGaussian(): void;
+    resetCollision(): void;
+    setCollision(collision: iCollisionTarget | iCollisionTarget[], mode?: tSelectionMode): void;
+    checkCollisionBySelector(name: string, mode?: tSelectionMode): void;
+    checkCollisionBySelectors(names: string[], mode?: tSelectionMode): void;
+    checkCollisionByAllSelectors(mode?: tSelectionMode): void;
+    getAllSelectorInfo(): Promise<iSelectorInfo[]> | iSelectorInfo[];
+    setSelectorVisible(name: string, visible: boolean): void;
+    setSelectorModeTranslate(name: string): void;
+    setSelectorModeScale(name: string): void;
+    setSelectorModeRotate(name: string): void;
+    setSelectorPosition(name: string, position: iVectorLike): void;
+    setSelectorRotation(name: string, rotation: iVectorLike): void;
+    /** 指定したセレクターを、targetの方向へ向ける(現在位置からの相対方向) */
+    setSelectorLookAt(name: string, target: iVectorLike): void;
+    /** 指定したセレクターの操作用ギズモだけの表示・操作可否を設定する(本体の表示はそのまま) */
+    setSelectorGizmoVisible(name: string, visible: boolean): void;
+    /** 指定したセレクター本体の色を設定する */
+    setSelectorColor(name: string, color: number): void;
+    /** 2点を結ぶ編集用のガイド線を追加・更新する */
+    setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
+    /** 編集用のガイド線を削除する */
+    removeGuideLine(name: string): void;
+    /** 画面上の位置(正規化デバイス座標)にある、表示中のセレクターの名前を返す(無ければnull) */
+    pickSelector(ndcX: number, ndcY: number): Promise<string | null> | string | null;
+    setSelectorScale(name: string, scale: iVectorLike): void;
+    deleteSelector(name: string): void;
+    addSphereSelector(name: string, option?: iSphereSelectorOption): void;
+    addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    /** カメラを模した四角錐アイコンのセレクターを追加する(カメラのposition編集用ポイントハンドル) */
+    addCameraSelector(name: string, option?: iCameraSelectorOption): void;
+}

package/build/esm/types/viewer/driver/offscreenDriver.d.ts

@@ -0,0 +1,231 @@
+import { default as EventEmitter } from 'eventemitter3';
+import { iCoreDriver } from './iCoreDriver';
+import { iViewerOption, iViewerMaterialOption, iLoadingOption, iHeaderInfo, iTransform, iVectorLike, iSelectorInfo, iPickingInfo, iCameraPathOption, iCameraParameter, tSelectionMode, tMaskSource, tControlsType, tUniformValue, tCustomDefines, tCustomUniforms } from '../types';
+import { iCollisionTarget } from '../../worker/tavioWorker';
+import { iLatitudeLongitude } from '../../camera/flightControls';
+import { iSphereSelectorOption } from '../../editor/selector/sphereSelector';
+import { iBoxSelectorOption } from '../../editor/selector/boxSelector';
+import { iCameraSelectorOption } from '../../editor/selector/cameraSelector';
+import { MeshStandardMaterialParameters } from 'three';
+import { WorkerElementAdapter } from './workerElementAdapter';
+/**
+ * # OffscreenDriver (Main-Thread RPC Proxy)
+ *
+ * ## 役割と背景
+ * メインスレッド側に位置し、`iCoreDriver` インターフェースを 100% 透過的に実装する RPC プロキシ。
+ * アプリケーション（demo/main.ts 等）からの公開 API 呼び出しを受け取ると、
+ * `postRpc` を通じて Worker スレッド上の `renderingWorker.ts`（CoreDriver）へ処理を委譲し、
+ * Worker 側から発生した描画・更新イベントをメインスレッドのリスナーへバブリング（中継）します。
+ */
+export declare class OffscreenDriver extends EventEmitter implements iCoreDriver {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    viewerOption: iViewerOption;
+    getElementAdapter(): HTMLCanvasElement | OffscreenCanvas | WorkerElementAdapter;
+    private worker;
+    private reqIdCounter;
+    private rpcResolvers;
+    private isInitialized;
+    constructor(viewerOption?: iViewerOption);
+    init(canvas: HTMLCanvasElement | OffscreenCanvas, materialOption?: iViewerMaterialOption): void;
+    private bindDomEvents;
+    private handleWorkerMessage;
+    postCommand(method: string, args?: any[], transferables?: Transferable[]): void;
+    private postRpc;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    resize(width?: number, height?: number, start?: boolean): void;
+    dispose(): void;
+    setUniforms(uniforms: Record<string, tUniformValue>): void;
+    setPointUniforms(uniforms: Record<string, tUniformValue>): void;
+    setColorTemperature(temperature: number): void;
+    setColorTint(tint: number): void;
+    setColorContrast(contrast: number): void;
+    setHSVColor(hsv: iVectorLike): void;
+    setColorRGB(rgb: iVectorLike): void;
+    setClippingEnabled(enabled: boolean): void;
+    setClippingSphere(position: iVectorLike, scale: iVectorLike): void;
+    setOutsideClipPointSize(size: number): void;
+    setOutsideClipOpacity(opacity: number): void;
+    setEffectMinimumScale(value: number): void;
+    setEffectDistanceBase(value: number): void;
+    setEffectDistanceRange(value: number): void;
+    setWorldOrigin(x: number, y: number, z: number): void;
+    setEffectDistancePoints(value: number): void;
+    setEffectDistanceNearPoints(value: number): void;
+    setEffectSonar(value: number): void;
+    setEffectSonarRange(value: number): void;
+    startBloomPoints(duration?: number): void;
+    startDissolveToGaussian(duration?: number, backgroundFadeInDelay?: number, backgroundFadeInDuration?: number): void;
+    startSonarWave(duration?: number): void;
+    animatePath(name?: string, duration?: number): void;
+    startFadeInBackground(duration?: number): void;
+    startFadeOutBackground(duration?: number): void;
+    applyLocalTransformToSelected(name: string, translation: iVectorLike, rotation: iVectorLike, scale: iVectorLike): void;
+    resetLocalTransformOfSelected(name: string): void;
+    resetAllLocalTransforms(name: string): void;
+    setLocalTransformGizmoEnabled(enabled: boolean): void;
+    setLocalTransformGizmoMode(mode: "translate" | "rotate" | "scale"): void;
+    setOrbitCursorAutoDisplay(enabled: boolean): void;
+    isOrbitCursorAutoDisplayEnabled(): Promise<boolean> | boolean;
+    setOrbitCursorDisplay(enabled: boolean): void;
+    isOrbitCursorDisplay(): Promise<boolean> | boolean;
+    setOrbitCursorScale(scale: number): void;
+    setAxisVisible(visible: boolean): void;
+    isAxisVisible(): Promise<boolean> | boolean;
+    private resolveSource;
+    renderShadow(): void;
+    loadTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadTavioWasm(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    loadImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    loadCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    concatTavio(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    concatPly(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    concatSplat(name: string, source: string | Blob | ArrayBuffer, option?: iLoadingOption): Promise<void>;
+    concatImage(name: string, source: string | Blob | ArrayBuffer | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    concatCanvas(name: string, canvas: HTMLCanvasElement | OffscreenCanvas | ImageBitmap, option?: iLoadingOption): Promise<void>;
+    disposeTavioMesh(name: string): void;
+    setVisibilityTavioMesh(name: string, visibility: boolean): void;
+    setVisibilityPoints(name: string, visibility: boolean): void;
+    setBackgroundOpacity(opacity: number): void;
+    setBackgroundByTavioMesh(name: string): void;
+    setModelTransform(name: string, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    getModelTransform(name: string): Promise<iTransform | null>;
+    setTransform(name: string, index: number, translation: iVectorLike, rotation: iVectorLike, scale: number): void;
+    getTransform(name: string, index: number): Promise<iTransform | null>;
+    setBillboard(name: string, index: number, flag: boolean): void;
+    setCameraParameter(position?: number[] | iVectorLike, target?: number[] | iVectorLike, fov?: number): void;
+    setControlsType(controlsType: string): void;
+    getControlsType(): Promise<tControlsType>;
+    selectCameraPath(name: string): void;
+    updateCameraPath(time?: number): void;
+    setOrbitPointerDown(isDown: boolean): void;
+    setOrbitRelativeRotateLeft(value: number): void;
+    setOrbitRelativeRotateUp(value: number): void;
+    setOrbitRelativeTranslateLeft(value: number): void;
+    setOrbitRelativeTranslateUp(value: number): void;
+    setOrbitRelativeDollyOut(value: number): void;
+    getOrbitDistance(): Promise<number>;
+    setOrbitDistance(distance: number): void;
+    setOrbitRotation(pitch: number, yaw: number, isForce?: boolean): void;
+    setOrbitRelativeRotation(pitch: number, yaw: number): void;
+    setOrbitEnableZoom(enable: boolean): void;
+    setOrbitEnablePan(enable: boolean): void;
+    setOrbitEnableLimit(enable: boolean): void;
+    setOrbitEnableZoomLimit(enable: boolean): void;
+    addAmbientLight(color: number, intensity: number): void;
+    setAmbientLightIntensity(intensity: number): void;
+    setSpotLightPosition(position: iVectorLike): void;
+    setSpotLightTargetPosition(target: iVectorLike): void;
+    setSpotLightIntensity(intensity: number): void;
+    setSpotLightDistance(distance: number): void;
+    setSpotLightAngle(angle: number): void;
+    setSpotLightPenumbra(penumbra: number): void;
+    setSpotLightDecay(decay: number): void;
+    addSpotLight(position: iVectorLike, target: iVectorLike, color: number, intensity: number, distance: number, angle: number, penumbra: number, decay: number, castShadow?: boolean, isDebug?: boolean): void;
+    addWhiteCube(position?: iVectorLike, scale?: iVectorLike, receiveShadow?: boolean, materialOption?: MeshStandardMaterialParameters): void;
+    saveSplatWasm(name: string, fileName?: string): Promise<any>;
+    savePlyWasm(name: string, fileName?: string): Promise<any>;
+    saveSpzWasm(name: string, fileName?: string): Promise<any>;
+    saveTavioWasm(name: string, fileName?: string, options?: any): Promise<any>;
+    exportTavioWasm(name: string, options?: any): Promise<any>;
+    addTavioMesh(name: string): void;
+    getFirstMeshName(): Promise<string | null>;
+    createRenderView(name: string | Symbol): void;
+    setRenderView(name?: string | Symbol | null): void;
+    getCurrentRenderViewName(): Promise<string | null>;
+    setRenderViewSize(renderViewName?: string | Symbol, x?: number, y?: number, width?: number, height?: number, start?: boolean): void;
+    getWorldPositionByRenderView(x: number, y: number, isDebug?: boolean): Promise<iPickingInfo | null>;
+    setCustomDefines(defines: tCustomDefines): void;
+    setCustomUniforms(uniforms: tCustomUniforms): void;
+    setGaussianScale(scale: number): void;
+    setOpacityAdditive(opacity: number): void;
+    setOpacityMultiplier(multiplier: number): void;
+    setOpacityPoints(opacity: number): void;
+    setSphericalHarmonicsIntensity(intensity: number): void;
+    setColorBlur(blur: number): void;
+    setColorSharpness(sharpness: number): void;
+    getCameraParameter(): Promise<iCameraParameter>;
+    setCameraColliderEnabled(enabled: boolean): void;
+    setCameraColliderSelector(selectorNames?: string[]): void;
+    setInteractiveMode(interactive: boolean): void;
+    getInteractiveMode(): Promise<boolean>;
+    createCameraPath(position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
+    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean, times?: number[] | null): void;
+    removeCameraPath(name: string): void;
+    setCameraPathDebugVisible(name: string, visible: boolean): void;
+    getPathNames(): Promise<string[]>;
+    getActiveCameraPathName(): Promise<string | null>;
+    getCameraPathByTime(name?: string, time?: number): Promise<{
+        position: iVectorLike;
+        target: iVectorLike;
+    } | null>;
+    getCameraPathTime(): Promise<number>;
+    setCameraPathOption(option: iCameraPathOption): void;
+    setCameraPathCollisionRadius(radius: number): void;
+    setCameraPathInteraction(x: number, y: number): void;
+    setTransferPosition(position: iVectorLike): void;
+    moveTransferByDirection(offset: iVectorLike, scale: number, isForce?: boolean): void;
+    setTransferFov(fov: number): void;
+    getFlightParameter(): Promise<iLatitudeLongitude | null>;
+    setFlightLongitude(longitude: number): void;
+    setFlightLatitude(latitude: number): void;
+    setOrbitOverflow(value: number): void;
+    setOrbitUpLimit(value: number): void;
+    setOrbitDownLimit(value: number): void;
+    setOrbitLeftLimit(value: number): void;
+    setOrbitRightLimit(value: number): void;
+    setOrbitZoomInLimit(value: number): void;
+    setOrbitZoomOutLimit(value: number): void;
+    selectSplatByScreenArea(minX: number, minY: number, maxX: number, maxY: number, mode?: tSelectionMode, maskCanvas?: tMaskSource | {
+        width: number;
+        height: number;
+        data: ArrayBuffer;
+    }): void;
+    removeTavioMesh(name: string, renderViewName?: string | Symbol): void;
+    removeTavioMeshAllRenderView(name: string): void;
+    setUsingSphericalHarmonics(isUsing: boolean): void;
+    setDropShadow(enabled: boolean): void;
+    setControlsAttenuation(attenuation: number): void;
+    setFlightRelativeLatitude(latitude: number, isForce?: boolean): void;
+    setFlightRelativeLongitude(longitude: number, isForce?: boolean): void;
+    setTransferRelativePosition(position: iVectorLike, isForce?: boolean): void;
+    moveTransferByHorizontalDirection(x: number, y: number, scale: number, isForce?: boolean): void;
+    moveTransferToTop(scale: number, isForce?: boolean): void;
+    moveTransferToBottom(scale: number, isForce?: boolean): void;
+    getCameraColliderEnabled(): Promise<boolean>;
+    getRenderViewCount(): Promise<number>;
+    setFrameRateLimit(fps: number): void;
+    setDevicePixelRatio(value: number): void;
+    getDevicePixelRatio(): number | null;
+    getHeaderInfo(name: string): Promise<iHeaderInfo | null>;
+    setCollisionReversed(reversed: boolean): void;
+    deleteSelectedGaussian(): void;
+    undoDeletedGaussian(): void;
+    resetDeletedGaussian(): void;
+    resetCollision(): void;
+    setCollision(collision: iCollisionTarget | iCollisionTarget[], mode?: tSelectionMode): void;
+    checkCollisionBySelector(name: string, mode?: tSelectionMode): void;
+    checkCollisionBySelectors(names: string[], mode?: tSelectionMode): void;
+    checkCollisionByAllSelectors(mode?: tSelectionMode): void;
+    getAllSelectorInfo(): Promise<iSelectorInfo[]>;
+    setSelectorVisible(name: string, visible: boolean): void;
+    setSelectorModeTranslate(name: string): void;
+    setSelectorModeScale(name: string): void;
+    setSelectorModeRotate(name: string): void;
+    setSelectorPosition(name: string, position: iVectorLike): void;
+    setSelectorRotation(name: string, rotation: iVectorLike): void;
+    setSelectorLookAt(name: string, target: iVectorLike): void;
+    setSelectorGizmoVisible(name: string, visible: boolean): void;
+    setSelectorColor(name: string, color: number): void;
+    setGuideLine(name: string, from: iVectorLike, to: iVectorLike, color?: number): void;
+    removeGuideLine(name: string): void;
+    pickSelector(ndcX: number, ndcY: number): Promise<string | null>;
+    setSelectorScale(name: string, scale: iVectorLike): void;
+    deleteSelector(name: string): void;
+    addSphereSelector(name: string, option?: iSphereSelectorOption): void;
+    addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+    addCameraSelector(name: string, option?: iCameraSelectorOption): void;
+}

package/build/esm/types/viewer/driver/rpcBridge.d.ts

@@ -0,0 +1,39 @@
+/**
+ * # RPC / Event Message Protocol for Offscreen Worker
+ *
+ * ## 役割と背景
+ * Offscreen Worker モードにおいて、メインスレッドと Worker スレッド間で型安全な
+ * 非同期メソッド呼び出し（RPC）および双方向イベント伝播（Event Bubbling）を行うためのプロトコル定義。
+ */
+export interface WorkerCmdMessage {
+    type: "cmd";
+    method: string;
+    args: any[];
+}
+export interface WorkerRpcMessage {
+    type: "rpc";
+    reqId: number;
+    method: string;
+    args: any[];
+}
+export interface WorkerRpcReplyMessage {
+    type: "rpc:reply";
+    reqId: number;
+    result?: any;
+    error?: string;
+}
+export interface WorkerEventMessage {
+    type: "event";
+    name: string;
+    payload?: any;
+}
+export type WorkerMessage = WorkerCmdMessage | WorkerRpcMessage | WorkerRpcReplyMessage | WorkerEventMessage;
+/**
+ * 転送不可なオブジェクトや DOM 依存オブジェクトをメッセージパラメータ用に安全にクリーンアップする
+ *
+ * ## 役割と背景
+ * postMessage は HTMLCanvasElement や関数などのクローン不可能なオブジェクトを送信すると
+ * DataCloneError を発生させます。本関数は引数配列を事前走査し、安全に転送可能な
+ * プレーンデータ / ArrayBuffer / TypedArray / Blob のみを抽出・サニタイズします。
+ */
+export declare function sanitizeArgsForMessage(args: any[]): any[];

package/build/esm/types/viewer/driver/workerElementAdapter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * # Worker Element Adapter (DOM Emulator in Worker)
+ *
+ * ## 役割と背景
+ * Web Worker 環境には `document` や `window` や `HTMLCanvasElement` が存在しません。
+ * 本クラスは、メインスレッド側でキャッチされた pointerdown / pointermove / wheel などの DOM イベントを
+ * Worker 内で受領し、Three.js の Controls（OrbitControls / TransferControls など）が
+ * あたかも本物の DOM 要素からイベントを受け取っているかのようにエミュレートするアダプターです。
+ */
+export interface SyntheticPointerEventInit {
+    type: string;
+    pointerId?: number;
+    pointerType?: string;
+    clientX?: number;
+    clientY?: number;
+    offsetX?: number;
+    offsetY?: number;
+    button?: number;
+    buttons?: number;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    deltaX?: number;
+    deltaY?: number;
+    boundingLeft?: number;
+    boundingTop?: number;
+    boundingWidth?: number;
+    boundingHeight?: number;
+}
+export declare class WorkerElementAdapter {
+    width: number;
+    height: number;
+    clientWidth: number;
+    clientHeight: number;
+    boundingLeft: number;
+    boundingTop: number;
+    style: Record<string, string>;
+    private ownerListeners;
+    ownerDocument: any;
+    private listeners;
+    constructor(width?: number, height?: number);
+    setSize(width: number, height: number): void;
+    addEventListener(type: string, listener: (evt: any) => void): void;
+    removeEventListener(type: string, listener: (evt: any) => void): void;
+    dispatchEvent(event: any): boolean;
+    /**
+     * メインスレッドから転送されたイベント情報をもとに合成イベントを作成して一括配信する
+     */
+    dispatchTransferredEvent(init: SyntheticPointerEventInit): void;
+    getContext(): null;
+    getBoundingClientRect(): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        right: number;
+        bottom: number;
+        x: number;
+        y: number;
+    };
+    setPointerCapture(): void;
+    releasePointerCapture(): void;
+    focus(): void;
+    blur(): void;
+}

package/build/esm/types/viewer/materialGenerator.d.ts

@@ -1,36 +1,20 @@
 import { RawShaderMaterial } from 'three';
-/**
- * MaterialGenerator は原則として static なメソッドのみで実装しステートを持たない。
- *
- * ビューアの基本機能については src/shaderChunk 以下にシェーダのチャンクとなる各部品を置く。
- * src/shaderChunk/common 以下にあるシェーダは 3DGS を描画するのみで色もつかない、最もシンプルな形。
- * src/shaderChunk/viewer は直流成分および交流成分の計算など、ビューアの基本機能を拡張する。
- * src/shaderChunk/editor はカラーグレーディングなどのエディタ用機能。
- * src/shaderChunk/picking は座標をレンダリングするピッキング用のシェーダ。
- *
- * 独自に拡張する場合は、iMaterialOption 単体またはその配列を定義し MaterialGenerator.generate() に渡す。
- * iMaterialOption.target で、ベーシックやピッキングなどのシェーダを結合する対象を（CHUNK_TARGET の論理和で）指定する。
- * iMaterialOption.uniforms で拡張部分で用いる uniform 変数を定義。
- * iMaterialOption.vertex / fragment でシェーダのチャンク情報を iShaderChunk 単体または配列で指定する。
- *
- * iShaderChunk.stage は SHADER_STAGE で定義されているシェーダ内のステージの指定。
- * iShaderChunk.source はシェーダのソースコード。
- *
- * このファイル内で定義されているシェーダのチャンクは src/shaderChunk/common 以下にあるもののみ。
- * それ以外のチャンクは canvas.ts など、ビューア実装側で付与する。
- */
+import { tCustomUniforms, tCustomDefines, tUniformValue } from './types';
 /**
  * チャンクをどのシェーダに反映するかを表す
  * これらの値は論理和を用いて組み合わせて指定できる
  */
 export declare const CHUNK_TARGET: {
     readonly ANY: 0;
-    readonly BASIC: 1;
-    readonly PICKING: 2;
-    readonly SHADOWING: 4;
-    readonly INDEX_SELECTION: 8;
+    readonly ANY_SPLAT: 1;
+    readonly BASIC: 2;
+    readonly PICKING: 4;
+    readonly SHADOWING: 8;
+    readonly INDEX_SELECTION: 16;
+    readonly POINTS: 32;
 };
-export type tChunkTarget = typeof CHUNK_TARGET[keyof typeof CHUNK_TARGET];
+export type tChunkTargetValue = typeof CHUNK_TARGET[keyof typeof CHUNK_TARGET];
+export type tChunkTarget = tChunkTargetValue | (number & {});
 /**
  * チャンクがどのステージにあたるかを表す
  * 指定されたステージの末尾に処理が追加される
@@ -69,6 +53,7 @@ export interface iMaterials {
     picking: RawShaderMaterial;
     shadowing: RawShaderMaterial;
     indexSelection: RawShaderMaterial;
+    points: RawShaderMaterial;
 }
 /**
  * マテリアル生成に使われるシェーダチャンク
@@ -82,8 +67,8 @@ export interface iShaderChunk {
  */
 export interface iMaterialOption {
     target: tChunkTarget;
-    uniforms?: any;
-    defines?: any;
+    uniforms?: tCustomUniforms | Record<string, tUniformValue>;
+    defines?: tCustomDefines;
     vertex?: iShaderChunk | iShaderChunk[];
     fragment?: iShaderChunk | iShaderChunk[];
 }
@@ -99,6 +84,18 @@ export declare class MaterialGenerator {
      * shaderChunk/common に含まれるフラグメントシェーダのチャンクをセットした Map オブジェクトを生成する
      */
     private static _createFragmentMap;
+    /**
+     * shaderChunk/points に含まれる頂点シェーダのチャンクをセットした Map オブジェクトを生成する
+     */
+    private static _createPointsVertexMap;
+    /**
+     * shaderChunk/points に含まれるフラグメントシェーダのチャンクをセットした Map オブジェクトを生成する
+     */
+    private static _createPointsFragmentMap;
+    /**
+     * 点描画マテリアル用 uniform 変数の初期値を生成する
+     */
+    private static _createPointsUniforms;
     /**
      * シェーダチャンクに iMaterialOption.vertex / fragment に含まれるソースコードを結合する
      * @param option - シェーダチャンクを含むマテリアルオプション

package/build/esm/types/viewer/renderView.d.ts

@@ -1,5 +1,5 @@
-import { Group, SpotLight, PerspectiveCamera, Quaternion, Scene, Vector3, AmbientLight, CameraHelper } from 'three';
-import { tControlInstance, tControlsType } from './canvas';
+import { AxesHelper, Group, SpotLight, PerspectiveCamera, Quaternion, Scene, Vector3, AmbientLight, CameraHelper } from 'three';
+import { tControlInstance, tControlsType } from './types';
 import { CameraCollider } from '../camera/cameraCollider';
 import { TransferControls } from '../camera/transferControls';
 import { CameraPathManager } from '../camera/cameraPathManager';
@@ -43,9 +43,10 @@ export declare class RenderView {
     previousRotation: Quaternion;
     previousFov: number;
     orbitCursor: Group;
-    previousOrbitTarget: Vector3;
     orbitCursorAutoDisplay: boolean;
     orbitCursorDisplay: boolean;
+    previousOrbitTarget: Vector3;
+    axesHelper?: AxesHelper;
     /**
      * @param name - レンダービューの名前
      */