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

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

@@ -0,0 +1,376 @@
+import { Matrix3, Matrix4, Quaternion, Vector2, Vector3, Vector4 } from 'three';
+import { CameraPathControls } from '../camera/cameraPathControls';
+import { FlightControls } from '../camera/flightControls';
+import { OrbitControls } from '../camera/orbitControls';
+import { iMaterialOption } from './materialGenerator';
+import { SELECTION_MODE } from './constants';
+/**
+ * Tavio Viewer のカスタムエラークラス
+ */
+export declare class TavioError extends Error {
+    /** エラーコード */
+    code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * カメラコントロールの種類
+ */
+export type tControlsType = "orbit" | "path" | "flight";
+/**
+ * カメラコントロールの型チェック用定義
+ */
+export type tControlInstance = OrbitControls | CameraPathControls | FlightControls;
+/**
+ * 範囲選択用マスクのソース型 (画面上のマスク形状を表す要素)
+ */
+export type tMaskSource = HTMLCanvasElement | OffscreenCanvas | ImageData;
+/**
+ * Vector3 と同様に外部データを扱うための型定義
+ */
+export interface iVectorLike {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * 外部（デモ層）から渡すことができるプレーンな Uniform 値
+ * ※ Three.js を import することなく、Worker 間でシリアライズ安全に扱える型
+ */
+export type tUniformPlainValue = number | boolean | string | number[] | iVectorLike | {
+    x?: number;
+    y?: number;
+    z?: number;
+    w?: number;
+} | {
+    r?: number;
+    g?: number;
+    b?: number;
+    a?: number;
+} | {
+    elements: number[];
+} | Record<string, unknown> | null | undefined;
+/**
+ * Three.js 準拠の { value: ... } 形式を持つ Custom Uniform
+ */
+export type tCustomUniformValue = {
+    value: tUniformPlainValue;
+};
+/**
+ * 拡張 Uniform オブジェクト全体のマップ型
+ */
+export type tCustomUniforms = Record<string, tCustomUniformValue>;
+/**
+ * MaterialGenerator 等で独自定義された Custom Defines の型定義
+ */
+export type tCustomDefines = Record<string, string | number | boolean | null | undefined>;
+/**
+ * 内部エンジン用 (TavioMesh / CoreDriver 内部で Three.js オブジェクトも許容する Uniform 値)
+ */
+export type tUniformValue = tUniformPlainValue | Vector2 | Vector3 | Vector4 | Quaternion | Matrix3 | Matrix4;
+/**
+ * カメラパスコントロールのオプション
+ */
+export interface iCameraPathOption {
+    attenuation?: number;
+    scaleX?: number;
+    scaleY?: number;
+}
+/**
+ * 汎用カメラパラメータ
+ */
+export interface iCameraParameter {
+    position?: number[];
+    eye?: number[];
+    target?: number[];
+    fov?: number;
+}
+/**
+ * ビューアオプション
+ */
+export interface iViewerOption {
+    disableBackground?: boolean;
+    usingSharedArrayBuffer?: boolean;
+    controlsType?: tControlsType;
+    gaussianScale?: number;
+    opacityPoints?: number;
+    opacityAdditive?: number;
+    opacityMultiplier?: number;
+    colorBlur?: number;
+    colorSharpness?: number;
+    backgroundOpacity?: number;
+    consoleOutput?: boolean;
+    dropShadow?: boolean;
+    shadowMapSize?: number;
+    indexSelectionDivisor?: number;
+    useOffscreen?: boolean;
+    preserveDrawingBuffer?: boolean;
+    powerPreference?: WebGLPowerPreference;
+    enableColorGrading?: boolean;
+    colorTemperature?: number;
+    colorTint?: number;
+    colorContrast?: number;
+    colorHSV?: iVectorLike;
+    colorRGB?: iVectorLike;
+    enableClipping?: boolean;
+    clippingEnabled?: boolean;
+    clippingSpherePosition?: iVectorLike;
+    clippingSphereScale?: iVectorLike;
+    outsidePointSize?: number;
+    outsideOpacity?: number;
+    enableAnimation?: boolean;
+    minimumScale?: number;
+    distanceEffectPoint?: number;
+    distanceEffectPointNear?: number;
+    distanceEffectBase?: number;
+    distanceEffectRange?: number;
+    effectSonar?: number;
+    effectSonarRange?: number;
+    worldOrigin?: iVectorLike;
+    enableLocalTransform?: boolean;
+    enableOrbitCursor?: boolean;
+    orbitCursorAutoDisplay?: boolean;
+    orbitCursorDisplay?: boolean;
+    orbitCursorAlwaysDisplay?: boolean;
+    orbitCursorScale?: number;
+}
+/**
+ * ビューアのマテリアルオプション
+ */
+export interface iViewerMaterialOption {
+    materialOption: iMaterialOption | iMaterialOption[];
+    isDebug?: boolean;
+}
+/**
+ * セレクターの情報
+ */
+export interface iSelectorInfo {
+    name: string;
+    visible: boolean;
+    position?: iVectorLike;
+    rotation?: iVectorLike;
+    scale?: iVectorLike;
+    radius?: number | null;
+    width?: number | null;
+    height?: number | null;
+    depth?: number | null;
+}
+/**
+ * ファイルのロードオプション
+ */
+export interface iLoadingOption {
+    useSphericalHarmonics?: boolean;
+    autoInsert?: boolean;
+    autoBackground?: boolean;
+}
+/**
+ * ファイル内に含まれる 3DGS の原点からの距離と割合
+ */
+export interface iDistanceInfo {
+    per50?: number | null;
+    per70?: number | null;
+    per90?: number | null;
+    per100: number | null;
+}
+/**
+ * ファイル内のヘッダ及び頂点情報
+ */
+export interface iHeaderInfo {
+    majorVersionNumber: number;
+    minorVersionNumber: number;
+    featureBits: any;
+    distance: iDistanceInfo;
+}
+/**
+ * ファイルに対する座標変換情報
+ */
+export interface iTransform {
+    translation: iVectorLike;
+    rotation: iVectorLike;
+    scale: number;
+}
+/**
+ * ピッキングして得られた情報
+ */
+export interface iPickingInfo {
+    name: string;
+    index: number;
+    target: iVectorLike;
+}
+/**
+ * ビューポートや focal の情報
+ */
+export interface iViewportInfo extends Record<string, tUniformValue> {
+    projection: Matrix4;
+    focal: Vector2;
+    inverseViewport: Vector2;
+}
+/**
+ * ローカルトランスフォームの情報
+ */
+export interface iLocalTransformInfo {
+    /** 選択されているスプラットの総数 */
+    count: number;
+    /** ローカル変換を適用する前の初期ワールド中心座標（単一選択時はスプラットの初期座標にインスタンス変換を適用した位置、複数選択時は選択オブジェクトの初期重心） */
+    initialCenter: Vector3;
+    /** ローカル変換（平行移動）適用後の現在のワールド中心座標 */
+    worldCenter: Vector3;
+    /** ギズモの親オブジェクトに設定するワールド姿勢（単一選択時はスプラット初期回転＋インスタンス回転、複数選択時はインスタンス回転のみ） */
+    worldQuaternion: Quaternion;
+    /** 現在スプラットに適用されているローカル平行移動量（複数選択時は null） */
+    localTranslation: Vector3 | null;
+    /** 現在スプラットに適用されているローカル回転（複数選択時は null） */
+    localQuaternion: Quaternion | null;
+    /** 現在スプラットに適用されているローカルスケール（複数選択時は null） */
+    localScale: Vector3 | null;
+    /** スプラット固有の初期回転（単一選択時のみ設定される） */
+    initialQuaternion?: Quaternion;
+    /** スプラットが属するインスタンスのスケール値（単一選択時のみ設定される） */
+    instanceScale?: number;
+}
+/** スプラットの選択モード型 */
+export type tSelectionMode = typeof SELECTION_MODE[keyof typeof SELECTION_MODE];
+/**
+ * 圧縮方式（RAW は非圧縮）
+ */
+export type tEncode = "RAW" | "PNG" | "ZIP";
+/**
+ * tavio 形式の各プロパティにおけるデータのビット深度
+ */
+export type tBitDepth = 8 | 16 | 32;
+/**
+ * 画素情報として扱えるオブジェクト
+ */
+export type tImageSource = HTMLImageElement | HTMLCanvasElement;
+/**
+ * ファイル読み込み時の球面調和関数用型定義（shN）
+ */
+export interface iSphericallInfo {
+    centroid: {
+        encode: tEncode | null;
+        length: number | null;
+        decoded: any;
+    };
+    label: {
+        encode: tEncode | null;
+        length: number | null;
+        decoded: any;
+    };
+    min: number | null;
+    max: number | null;
+    quantize: number | null;
+    cluster: number | null;
+    degree: number | null;
+}
+/**
+ * チャンク内ヘッダ情報用定義
+ */
+export interface iChunkHeaderProperty {
+    type: number;
+    length: number;
+}
+/**
+ * チャンク内ヘッダ情報用定義
+ */
+export interface iChunkHeader {
+    propertyCount: number;
+    properties: iChunkHeaderProperty[];
+}
+/**
+ * チャンク内プロパティ用型定義
+ */
+export interface iPropertyInfo {
+    encode?: tEncode;
+    depth?: tBitDepth;
+    length?: number;
+    decoded: any;
+    channelCount?: number;
+    min?: number[];
+    max?: number[];
+}
+/**
+ * 複数ファイルを扱う場合の、既存データのプロパティ用型定義
+ */
+export interface iPreviousPropertyInfo {
+    min: number[];
+    max: number[];
+}
+/**
+ * すべてのプロパティを保持するための型定義
+ */
+export interface iProperties {
+    position?: iPropertyInfo;
+    scale?: iPropertyInfo;
+    rotation?: iPropertyInfo;
+    alpha?: iPropertyInfo;
+    sh0?: iPropertyInfo;
+    shN?: iSphericallInfo;
+    previousScale?: iPreviousPropertyInfo;
+    previousAlpha?: iPreviousPropertyInfo;
+}
+/**
+ * テクスチャの幅と高さ
+ */
+export interface iTextureWidth {
+    width: number;
+    height: number;
+}
+/**
+ * 読み込んだファイルのプロパティ
+ */
+export interface iSourceProperty {
+    ready: boolean;
+    index: number;
+    type: string;
+    vertexCount: number;
+    vertexOffset: number;
+    featureBits: any;
+    containmentRadius: any;
+    magicNumber: string;
+    majorVersion: number;
+    minorVersion: number;
+    transform: iTransform;
+    billboard: boolean;
+}
+/**
+ * 画像や canvas 要素をパースした結果
+ */
+export interface iSplatSource {
+    count: number;
+    position32: Float32Array;
+    color8: Uint8ClampedArray;
+    converted: Uint8Array;
+    min: {
+        alpha: number;
+        scale: iVectorLike;
+    };
+    max: {
+        alpha: number;
+        scale: iVectorLike;
+    };
+}
+/**
+ * スプラットパーサー（PLY, SPLAT, IMAGE 等）の共通パース結果
+ */
+export interface iParsedSplatData {
+    /** ROW_LENGTH_TAVIO (19 bytes/splat) でパックされたバイナリ */
+    splatBuffer: Uint8ClampedArray | ArrayBuffer;
+    /** スプラット総数 */
+    count: number;
+    /** スケールとアルファの min-max 範囲 */
+    minMax: {
+        scaleMinX: number;
+        scaleMinY: number;
+        scaleMinZ: number;
+        alphaMin: number;
+        scaleMaxX: number;
+        scaleMaxY: number;
+        scaleMaxZ: number;
+        alphaMax: number;
+    };
+    /** 点群表示用の位置・色バッファ */
+    pointsPosition: Float32Array;
+    pointsColor: Uint8ClampedArray;
+    /** 球面調和関数バッファ (存在する場合) */
+    sphericalHarmonicsBuffer?: Float32Array;
+    sphericalHarmonicsDegrees?: number;
+}

package/build/esm/types/worker/renderingWorker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * # Rendering Worker Entrypoint (Dedicated Worker Scope)
+ *
+ * ## 役割と背景
+ * Worker スレッド側で OffscreenCanvas を受容し、実際の Three.js レンダラーおよび
+ * `DirectCoreDriver` を初期化・駆動させるエントリポイント。
+ */
+export {};

package/build/esm/types/{src/worker → worker}/tavioWorker.d.ts

@@ -1,4 +1,4 @@
-import { iVectorLike } from '../viewer/canvas';
+import { iVectorLike } from '../viewer/types';
 export type tCollisionType = "sphere" | "box";
 export interface iSphereCollision {
     radius: number;

package/build/esm/wasm/pkg/no-thread/tavio.d.ts

@@ -66,9 +66,9 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly encodeTavio: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
-    readonly resolveGaussianEdits: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
-    readonly main: () => void;
+    readonly __wbg_intounderlyingbytesource_free: (a: number, b: number) => void;
+    readonly __wbg_intounderlyingsink_free: (a: number, b: number) => void;
+    readonly __wbg_intounderlyingsource_free: (a: number, b: number) => void;
     readonly decodePly: (a: number, b: number, c: number) => number;
     readonly decodeSog: (a: number, b: number, c: number) => number;
     readonly decodeSplat: (a: number, b: number, c: number) => number;
@@ -77,24 +77,24 @@ export interface InitOutput {
     readonly encodePly: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
     readonly encodeSplat: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
     readonly encodeSpz: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number) => void;
-    readonly sort: (a: number, b: number, c: number) => number;
-    readonly registerEventHandler: (a: number) => number;
-    readonly __wbg_intounderlyingsource_free: (a: number, b: number) => void;
-    readonly intounderlyingsource_cancel: (a: number) => void;
-    readonly intounderlyingsource_pull: (a: number, b: number) => number;
-    readonly __wbg_intounderlyingbytesource_free: (a: number, b: number) => void;
+    readonly encodeTavio: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
     readonly intounderlyingbytesource_autoAllocateChunkSize: (a: number) => number;
     readonly intounderlyingbytesource_cancel: (a: number) => void;
     readonly intounderlyingbytesource_pull: (a: number, b: number) => number;
     readonly intounderlyingbytesource_start: (a: number, b: number) => void;
     readonly intounderlyingbytesource_type: (a: number) => number;
-    readonly __wbg_intounderlyingsink_free: (a: number, b: number) => void;
     readonly intounderlyingsink_abort: (a: number, b: number) => number;
     readonly intounderlyingsink_close: (a: number) => number;
     readonly intounderlyingsink_write: (a: number, b: number) => number;
-    readonly __wasm_bindgen_func_elem_2857: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_2859: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_1098: (a: number, b: number, c: number) => void;
+    readonly intounderlyingsource_cancel: (a: number) => void;
+    readonly intounderlyingsource_pull: (a: number, b: number) => number;
+    readonly main: () => void;
+    readonly registerEventHandler: (a: number) => number;
+    readonly resolveGaussianEdits: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
+    readonly sort: (a: number, b: number, c: number) => number;
+    readonly __wasm_bindgen_func_elem_2970: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2972: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_1183: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;