@openheart/tavio-renderer 2.3.29-with-wasm → 2.4.0

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

@@ -0,0 +1,206 @@
+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 { 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): CameraPath | void;
+    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean): void;
+    removeCameraPath(name: string): 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;
+    setSelectorScale(name: string, scale: iVectorLike): void;
+    deleteSelector(name: string): void;
+    addSphereSelector(name: string, option?: iSphereSelectorOption): void;
+    addBoxSelector(name: string, option?: iBoxSelectorOption): void;
+}

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

@@ -0,0 +1,222 @@
+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 { 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): void;
+    addCameraPath(name: string, position: number[][] | iVectorLike[], target: number[][] | iVectorLike[], debug?: boolean): void;
+    removeCameraPath(name: string): 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;
+    setSelectorScale(name: string, scale: iVectorLike): void;
+    deleteSelector(name: string): void;
+    addSphereSelector(name: string, option?: iSphereSelectorOption): void;
+    addBoxSelector(name: string, option?: iBoxSelectorOption): 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/{src/viewer → viewer}/materialGenerator.d.ts

@@ -1,35 +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 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 & {});
 /**
  * チャンクがどのステージにあたるかを表す
  * 指定されたステージの末尾に処理が追加される
@@ -40,16 +25,17 @@ export declare const SHADER_STAGE: {
     readonly VERTEX_FUNCTION: 2;
     readonly VERTEX_MAIN_BEGIN: 3;
     readonly VERTEX_MAIN_TRANSFORM: 4;
-    readonly VERTEX_MAIN_SIGMA: 5;
-    readonly VERTEX_MAIN_OUT: 6;
-    readonly VERTEX_MAIN_END: 7;
-    readonly FRAGMENT_PRECISION: 8;
-    readonly FRAGMENT_DECLARATION: 9;
-    readonly FRAGMENT_FUNCTION: 10;
-    readonly FRAGMENT_MAIN_BEGIN: 11;
-    readonly FRAGMENT_MAIN_IN: 12;
-    readonly FRAGMENT_MAIN_OUT: 13;
-    readonly FRAGMENT_MAIN_END: 14;
+    readonly VERTEX_MAIN_CLIPPING: 5;
+    readonly VERTEX_MAIN_SIGMA: 6;
+    readonly VERTEX_MAIN_OUT: 7;
+    readonly VERTEX_MAIN_END: 8;
+    readonly FRAGMENT_PRECISION: 9;
+    readonly FRAGMENT_DECLARATION: 10;
+    readonly FRAGMENT_FUNCTION: 11;
+    readonly FRAGMENT_MAIN_BEGIN: 12;
+    readonly FRAGMENT_MAIN_IN: 13;
+    readonly FRAGMENT_MAIN_OUT: 14;
+    readonly FRAGMENT_MAIN_END: 15;
 };
 export type tShaderStage = typeof SHADER_STAGE[keyof typeof SHADER_STAGE];
 /**
@@ -66,6 +52,8 @@ export interface iMaterials {
     basic: RawShaderMaterial;
     picking: RawShaderMaterial;
     shadowing: RawShaderMaterial;
+    indexSelection: RawShaderMaterial;
+    points: RawShaderMaterial;
 }
 /**
  * マテリアル生成に使われるシェーダチャンク
@@ -79,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[];
 }
@@ -96,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 - シェーダチャンクを含むマテリアルオプション