xl-public-utils 1.0.5 → 1.0.7

package/index.d.ts

@@ -1,283 +1,918 @@
-import vtkRenderer from "@kitware/vtk.js/Rendering/Core/Renderer";
-declare module "xl-public-utils" {
-  export interface QrCodeOptions {
-    /** 二维码类型，具体支持请查看文档 */
-    bcid?: string; // 默认值 'qrcode'
-
-    /** 最终图片宽度 */
-    width?: number; // 默认值 1056
-
-    /** 最终图片高度 */
-    height?: number; // 默认值 342
-
-    /** 二维码宽度 */
-    qrcodeW?: number; // 默认值 300
-
-    /** 二维码高度 */
-    qrcodeH?: number; // 默认值 300
-
-    /** 是否在右侧添加文字 */
-    addText?: boolean; // 默认值 true
-
-    /** 顶部距离 */
-    top?: number; // 默认值 10
-
-    /** 左侧距离 */
-    left?: number; // 默认值 10
-
-    /** 文字行高，换行后下一行文字的 y 位置计算为 fontSize * lineHeight */
-    lineHeight?: number; // 默认值 1
-
-    /** 文字大小 */
-    fontSize?: number; // 默认值 60
-
-    /** 字体类型 */
-    fontFamily?: string; // 默认值 '黑体'
-
-    /** 背景颜色 */
-    bgColor?: string; // 默认值 '#fff'
-
-    /** 文字距离二维码间隔 */
-    textLeftMargin?: number; // 默认值 20
-
-    /** 字体加粗 */
-    fontWeight?: boolean; // 默认值 700
-
-    /** 字体颜色 */
-    textColor?: string; // 默认值 '#000'
-
-    /** 右侧文字内容 */
-    textContent?: string;
-  }
-
-  export namespace vtk {
-    /**
-     * 计算屏幕坐标到三维坐标
-     * @param {vtkRenderer} renderer vtkRenderer
-     * @param {number} x display x position
-     * @param {number} y display y position
-     * @param {number} z display z position
-     * @returns {[number, number, number]} 三维坐标
-     */
-    export function computeDisplayToWorld(
-      renderer: vtkRenderer,
-      x: number,
-      y: number,
-      z: number
-    ): [number, number, number];
-
-    /**
-     * 计算三维坐标到屏幕坐标
-     * @param {vtkRenderer} renderer vtkRenderer
-     * @param {number} x 三维坐标 x值
-     * @param {number} y 三维坐标 y值
-     * @param {number} z 三维坐标 z值
-     * @returns {[number, number, number]} 屏幕坐标
-     */
-    export function computeWorldToDisplay(
-      renderer: vtkRenderer,
-      x: number,
-      y: number,
-      z: number
-    ): [number, number, number];
-  }
-
-  export namespace public {
-    /**
-     * 获取当前屏幕分辨率(百分制,默认100)
-     * @returns {number} 当前屏幕分辨率
-     */
-    export function getRatio(): number;
-
-    /**
-     * 获取当前屏幕分辨率(百分制,默认100)
-     * @returns {number} 当前屏幕分辨率
-     */
-    export function detectZoom(): number;
-  }
-  export namespace qrcode {
-    /**
-     * 生成一个二维码图片，可以在二维码右侧添加二维码文字内容信息
-     * @param {string} content 二维码内容
-     * @param {QrCodeOptions} options 图片参数
-     * @returns {string} 返回图片的base64
-     */
-    export function generateQRCodeWithText(
-      content: string,
-      options?: QrCodeOptions
-    ): string | false;
-  }
-
-  export namespace BwipJs {
-    export interface BwippOptions {
-      includecheck?: boolean | undefined;
-      includecheckintext?: boolean | undefined;
-
-      parse?: boolean | undefined;
-      parsefnc?: boolean | undefined;
-
-      height?: number | undefined;
-      width?: number | undefined;
-
-      inkspread?: number | undefined;
-      inkspreadh?: number | undefined;
-      inkspreadv?: number | undefined;
-      dotty?: boolean | undefined;
-
-      binarytext?: boolean | undefined; // really a bwip-js option but better positioned here
-      includetext?: boolean | undefined;
-      textfont?: string | undefined;
-      textsize?: number | undefined;
-      textgaps?: number | undefined;
-      alttext?: string | undefined;
-
-      textxalign?:
-        | "offleft"
-        | "left"
-        | "center"
-        | "right"
-        | "offright"
-        | "justify"
-        | undefined;
-      textyalign?: "below" | "center" | "above" | undefined;
-      textxoffset?: number | undefined;
-      textyoffset?: number | undefined;
-
-      showborder?: boolean | undefined;
-      borderwidth?: number | undefined;
-      borderleft?: number | undefined;
-      borderright?: number | undefined;
-      bordertop?: number | undefined;
-      boraderbottom?: number | undefined;
-
-      barcolor?: string | undefined;
-      backgroundcolor?: string | undefined;
-      bordercolor?: string | undefined;
-      textcolor?: string | undefined;
-
-      addontextxoffset?: number | undefined;
-      addontextyoffset?: number | undefined;
-      addontextfont?: string | undefined;
-      addontextsize?: number | undefined;
-
-      guardwhitespace?: boolean | undefined;
-      guardwidth?: number | undefined;
-      guardheight?: number | undefined;
-      guardleftpos?: number | undefined;
-      guardrightpos?: number | undefined;
-      guardleftypos?: number | undefined;
-      guardrightypos?: number | undefined;
-    }
-    export interface RenderOptions extends BwippOptions {
-      bcid: string;
-      text: string;
-
-      scaleX?: number | undefined;
-      scaleY?: number | undefined;
-      scale?: number | undefined;
-
-      rotate?: "N" | "R" | "L" | "I" | undefined;
-
-      paddingwidth?: number | undefined;
-      paddingheight?: number | undefined;
-
-      paddingleft?: number | undefined;
-      paddingright?: number | undefined;
-      paddingtop?: number | undefined;
-      paddingbottom?: number | undefined;
-
-      monochrome?: boolean | undefined;
-      sizelimit?: number | undefined;
-    }
-    export interface RawOptions extends BwippOptions {
-      bcid: string;
-      text: string;
-    }
-    export interface DrawingContext<T> {
-      setopts?(options: RenderOptions): void;
-      scale(sx: number, sy: number): [number, number] | null;
-      measure(
-          str: string,
-          font: string,
-          fwidth: number,
-          fheight: number,
-      ): { width: number; ascent: number; descent: number };
-      init(width: number, height: number): void;
-      line(x0: number, y0: number, x1: number, y1: number, lw: number, rgb: string): void;
-      polygon(pts: Array<[number, number]>): void;
-      hexagon(pts: [[number, number], [number, number], [number, number], [number, number], [number, number]]): void;
-      ellipse(x: number, y: number, rx: number, ry: number, ccw: boolean): void;
-      fill(rgb: string): void;
-      text(x: number, y: number, str: string, rgb: string, font: { name: string; width: number; height: number; dx: number },): void;
-      end(): T;
-    }
-    
-    export function toSVG(opts: RenderOptions): string;
-    export function drawingSVG(): DrawingContext<string>;
-
-    // platform-specific exports
-    export function toCanvas(canvas: string | HTMLCanvasElement, opts: RenderOptions): HTMLCanvasElement;
-    export function drawingCanvas(canvas: string | HTMLCanvasElement): DrawingContext<HTMLCanvasElement>;
-    
-    export function datamatrix(canvas: string | HTMLCanvasElement, opts: RenderOptions): HTMLCanvasElement;
-    export function datamatrix<T>(opts: RenderOptions, drawing: DrawingContext<Promise<T>>): Promise<T>;
-    export function datamatrix<T>(opts: RenderOptions, drawing: DrawingContext<T>): T;
-
-    
-    export function qrcode(canvas: string | HTMLCanvasElement, opts: RenderOptions): HTMLCanvasElement;
-    export function qrcode<T>(opts: RenderOptions, drawing: DrawingContext<Promise<T>>): Promise<T>;
-    export function qrcode<T>(opts: RenderOptions, drawing: DrawingContext<T>): T;
-    export function render<T>(params: RenderOptions, drawing: DrawingContext<T>): T;
-    export function raw(
-      bcid: string,
-      text: string,
-      opts?: BwippOptions,
-    ):
-      | Array<{ bbs: number[]; bhs: number[]; sbs: number[] }>
-      | Array<{ pixs: number[]; pixx: number; pixy: number; height: number; width: number }>;
-    }
-    export const BWIPP_VERSION: string;
-    export const BWIPJS_VERSION: string;
-
-    // wrapper around FontLib.loadFont()
-    export function loadFont(name: string, data: string | Uint8Array): void;
-    export function loadFont(name: string, mult: number, data: string | Uint8Array): void;
-    export function loadFont(name: string, multy: number, multx: number, data: string | Uint8Array): void;
-
-    export namespace FontLib {
-      export interface PathData
-          extends Array<
-              | { type: 'M'; x: number; y: number }
-              | { type: 'L'; x: number; y: number }
-              | { type: 'Q'; x: number; y: number; cx: number; cy: number }
-              | { type: 'C'; x: number; y: number; cx1: number; cy1: number; cx2: number; cy2: number }
-          > {
-          ascent: number;
-          descent: number;
-          advance: number;
-      }
-      export function lookup(font: string): number;
-      export function monochrome(mono: boolean): void;
-      export function getglyph(
-          fontid: number,
-          charcode: number,
-          width: number,
-          height: number,
-      ): {
-          glyph: number;
-          top: number;
-          left: number;
-          width: number;
-          height: number;
-          advance: number;
-          pixels: Uint8Array;
-          bytes: Uint8Array;
-          cachekey: string;
-          offset: number;
-      };
-      export function getpaths(fontid: number, charcode: number, width: number, height: number): PathData;
-      export function loadFont(name: string, data: string | Uint8Array): void;
-      export function loadFont(name: string, mult: number, data: string | Uint8Array): void;
-      export function loadFont(name: string, multy: number, multx: number, data: string | Uint8Array): void;
-    }
-}
+declare module "xl-public-utils" {
+  export interface QrCodeOptions {
+    /** 二维码类型，具体支持请查看文档 */
+    bcid?: string; // 默认值 'qrcode'
+
+    /** 最终图片宽度 */
+    width?: number; // 默认值 1056
+
+    /** 最终图片高度 */
+    height?: number; // 默认值 342
+
+    /** 二维码宽度 */
+    qrcodeW?: number; // 默认值 300
+
+    /** 二维码高度 */
+    qrcodeH?: number; // 默认值 300
+
+    /** 是否在右侧添加文字 */
+    addText?: boolean; // 默认值 true
+
+    /** 顶部距离 */
+    top?: number; // 默认值 10
+
+    /** 左侧距离 */
+    left?: number; // 默认值 10
+
+    /** 文字行高，换行后下一行文字的 y 位置计算为 fontSize * lineHeight */
+    lineHeight?: number; // 默认值 1
+
+    /** 文字大小 */
+    fontSize?: number; // 默认值 60
+
+    /** 字体类型 */
+    fontFamily?: string; // 默认值 '黑体'
+
+    /** 背景颜色 */
+    bgColor?: string; // 默认值 '#fff'
+
+    /** 文字距离二维码间隔 */
+    textLeftMargin?: number; // 默认值 20
+
+    /** 字体加粗 */
+    fontWeight?: boolean; // 默认值 700
+
+    /** 字体颜色 */
+    textColor?: string; // 默认值 '#000'
+
+    /** 右侧文字内容 */
+    textContent?: string;
+  }
+
+  export namespace vtkUtils {
+    /**
+     * 计算屏幕坐标到三维坐标
+     * @param {vtkRenderer} renderer vtkRenderer
+     * @param {number} x display x position
+     * @param {number} y display y position
+     * @param {number} z display z position
+     * @returns {[number, number, number]} 三维坐标
+     */
+    export function computeDisplayToWorld(
+      renderer: vtkRenderer,
+      x: number,
+      y: number,
+      z: number
+    ): [number, number, number];
+    /**
+     * 计算三维坐标到屏幕坐标
+     * @param {vtkRenderer} renderer vtkRenderer
+     * @param {number} x 三维坐标 x值
+     * @param {number} y 三维坐标 y值
+     * @param {number} z 三维坐标 z值
+     * @returns {[number, number, number]} 屏幕坐标
+     */
+    export function computeWorldToDisplay(
+      renderer: vtkRenderer,
+      x: number,
+      y: number,
+      z: number
+    ): [number, number, number];
+    /**
+     * 计算 w2l(word 2 local, word to local) 的变换矩阵
+     * @param {vec3} center 中心点
+     * @param {vec3} xaxis x轴
+     * @param {vec3} yaxis y轴
+     * @param {vec3} zaxis z轴
+     * @returns { mat4 } 变换矩阵
+     */
+    export function getW2LMatrix(
+      center: vec3,
+      xaxis: vec3,
+      yaxis: vec3,
+      zaxis: vec3
+    ): mat4;
+    /**
+     * 计算 l2w(local 2 word, local to word) 的变换矩阵
+     * @param {vec3} center 中心点
+     * @param {vec3} xaxis x轴
+     * @param {vec3} yaxis y轴
+     * @param {vec3} zaxis z轴
+     * @returns { mat4 } 变换矩阵
+     */
+    export function getL2WMatrix(
+      center: vec3,
+      xaxis: vec3,
+      yaxis: vec3,
+      zaxis: vec3
+    ): mat4;
+    /**
+     * 返回交互的interactorStyle
+     * @returns {vtkInteractorStyleManipulator} 交互的interactorStyle
+     */
+    export function make3DInteractorStyle(): vtkInteractorStyleManipulator;
+    /**
+     * 移除并返回当前renderWindow的所有鼠标交互设定
+     * @param {vtkRenderWindowInteractor} interactor vtkRenderWindowInteractor
+     * @returns {any[]} 当前鼠标的所有交互Manipulators
+     */
+    export function removeMouseInteraction(
+      interactor: vtkRenderWindowInteractor
+    ): any[];
+    /**
+     * 给当前窗口设置交互Maintainers
+     * @param {vtkRenderWindowInteractor} interactor vtkRenderWindowInteractor
+     * @param {any[]} mm 所有的交互Maintainers
+     * @returns {void}
+     */
+    export function resetAllMouseMaintainers(
+      interactor: vtkRenderWindowInteractor,
+      mm: any[]
+    ): void;
+    /**
+     * 将点投影到平面上
+     * @param {vec3} point 需要投影的点
+     * @param {vec3} origin 平面中心点
+     * @param {vec3} normal 平面法向量
+     * @returns {vec3} 投影到平面之后的点
+     */
+    export function projectPointToPlane(
+      point: vec3,
+      origin: vec3,
+      normal: vec3
+    ): vec3;
+    /**
+     * 将向量投影到面上
+     *
+     * @param {vec3} vec - The vector to project.
+     * @param {vec3} norm - The normal vector of the plane (assumed to be normalized).
+     * @returns {vec3} - The projected vector on the plane.
+     */
+    export function projectVecToPlane(vec: vec3, norm: vec3): vec3;
+    /**
+     * 将直线外一点投影到直线(两个点)上
+     * @param {vec3} point 直线外一点
+     * @param {vec3} begin 直线开始点
+     * @param {vec3} end 直线结束点
+     * @returns {vec3} 投影后的点
+     */
+    export function projectPointOnPoints(
+      point: vec3,
+      begin: vec3,
+      end: vec3
+    ): vec3;
+    /**
+     * 将点投影到直线(point+dir)上
+     * @param {vec3} point 直线外的点
+     * @param {vec3} linePoint 直线任意一点
+     * @param {vec3} lineDir 直线方向
+     * @returns {vec3} 投影到直线上后的点
+     */
+    export function projectPointToLine(
+      point: vec3,
+      linePoint: vec3,
+      lineDir: vec3
+    ): vec3;
+    /**
+     * 获取曲线外一点到曲线最近点的索引
+     * @param {vec3} point 曲线外一点
+     * @param {vec3[]} points 曲线
+     * @returns {number} 返回离点最近的曲线点索引
+     */
+    export function getPointToPointsMinIndex(
+      point: vec3,
+      points: vec3[]
+    ): number;
+    /**
+     * 获取点到曲线的最近距离
+     * @param {vec3} point 曲线外一点
+     * @param {vec3[]} points 曲线
+     * @returns {number} 返回点到曲线的最近距离
+     */
+    export function getPointToPointsMinDist(
+      point: vec3,
+      points: vec3[]
+    ): number;
+    /**
+     * 获取点到曲线的最近点
+     * @param {vec3} point 曲线外一点
+     * @param {vec3[]} points 曲线
+     * @returns {vec3} 返回点到曲线的最近点
+     */
+    export function getPointToPointsMinPoint(point: vec3, points: vec3[]): vec3;
+    /**
+     * 获取直线外一点到直线的距离
+     * @param {vec3} point 直线外一点
+     * @param {vec3} begin 直线开始点
+     * @param {vec3} end 直线结束点
+     * @returns {number} 点到直线的距离
+     */
+    export function getPointToLineDist(
+      point: vec3,
+      begin: vec3,
+      end: vec3
+    ): number;
+    /**
+     * 计算点到平面的距离
+     * @param {vec3} point 任意一点
+     * @param {vec3} origin 平面上一点
+     * @param {vec3} normal 平面法向量，要求单位化
+     * @returns {number}
+     */
+    export function getPointToPlaneDist(
+      point: vec3,
+      origin: vec3,
+      normal: vec3
+    ): number;
+    /**
+     * 对一个polydata应用矩阵变化，直接改变点位置
+     * @param {mat4} mt4 变换矩阵
+     * @param {vtkPolyData} data 需要应用变换的polydata
+     */
+    export function pointsApplyMat4(mt4: mat4, data: vtkPolyData): void;
+    /**
+     * 将点应用矩阵变换
+     * @param {vec3} point 三维点
+     * @param {mat4} matrix 变换矩阵
+     * @returns {vec3} 应用矩阵变换之后的点
+     */
+    export function pointTransformByMat4(point: vec3, matrix: mat4): vec3;
+    /**
+     * 将向量应用矩阵变换
+     * @param {vec3} vec 向量
+     * @param {mat4} matrix 变换矩阵
+     * @returns {vec3} 应用矩阵变换之后的向量
+     */
+    export function vecTransfromByMat4(vec: vec3, matrix: mat4): vec3;
+    /**
+     * 获取mesh的ply文件Blob
+     * @param {vtkPolyData} mesh 网格polydata
+     * @param {'ascii' | 'binary'} [format='ascii'] format 导出文件格式
+     * @returns {Blob} 网格的ply文件Blob
+     */
+    export function createPlyBlob(
+      mesh: vtkPolyData,
+      format?: "ascii" | "binary"
+    ): Blob;
+    /**
+     * 获取mesh的stl文件Blob，由于STL文件过大，只使用Binary格式
+     * @param {vtkPolyData} mesh 网格polydata
+     * @returns {Blob} 网格的BinarySTL文件Blob
+     */
+    export function createStlBlob(mesh: vtkPolyData): Blob;
+    /**
+     * 将网格压缩为drc文件，导出drc需要先加载draco_encode.js，并调用initDrcCoder初始化
+     * @param {vtkPolyData} mesh 网格文件
+     * @returns {Blob} drc文件
+     */
+    export function createDrcBlob(mesh: vtkPolyData): Blob;
+    /**
+     * 将网格输出为对应类型的Blob,均采用默认参数，导出drc需要先加载draco_encode.js，并调用initDrcCoder初始化
+     * @param {vtkPolyData} mesh 网格文件
+     * @param {'ply' | 'stl' | 'drc' } type 输出类型
+     * @returns {Blob} 对应类型的Blob
+     */
+    export function createMeshTypeBlob(
+      mesh: vtkPolyData,
+      type: "ply" | "stl" | "drc"
+    ): Blob;
+    /**
+     * 计算一组三维点的中心点
+     * @param {vec3[]} points 三维点数组
+     * @returns {vec3} 中心点
+     */
+    export function getPointsCenter(points: vec3[]): vec3;
+    /**
+     * @typedef Position
+     * @property {number} x 对应vtk坐标系的x值
+     * @property {number} y 对应vtk坐标系的y值
+     * @property {number} z 0
+     */
+    /**
+     * 计算js事件对应vtk事件的position
+     * @param {HTMLElement} el vtkViewDom
+     * @param {MouseEvent} event 二维鼠标事件
+     * @returns {Position} 对应vtk坐标系的xyz值
+     */
+    export function getScreenEventPositionFor(
+      el: HTMLElement,
+      event: MouseEvent
+    ): Position;
+    /**
+     * 将数值数组转换为vec3数组
+     * @param {number[] | Float32Array} dataList
+     * @returns {vec3[]} 格式化之后的数组
+     */
+    export function formatNumberArrayToVec3Array(
+      dataList: number[] | Float32Array
+    ): vec3[];
+    /**
+     * 简单的数值平均插值
+     * @param {number} from 开始数值
+     * @param {number} to 结束数值
+     * @param {number} step 步长
+     * @returns {number[]} 插值的数值
+     */
+    export function calculateSimpleLerp(
+      from: number,
+      to: number,
+      step: number
+    ): number[];
+    /**
+     * 将 mat3 解析为 3 个自由度的 欧拉角(Eular)(弧度)
+     * @param {mat3} rmat 3 * 3的矩阵
+     * @param {[number, number, number]} eular 输出的欧拉角度数(弧度)
+     * @returns {[number, number, number]} 3个自由度的欧拉角
+     * @example
+     * const mt4: mat4;
+     * const mt3 = mat3.fromMat4(mt3, mt4);
+     * mat3.transpose(mt3, mt3);
+     * let eular = [0, 0, 0];
+     * convMatrix2EularZYX(mt3, eular);
+     */
+    export function convMatrix2EularZYX(
+      rmat: mat3,
+      eular: [number, number, number]
+    ): [number, number, number];
+    /**
+     * 将欧拉角(Eular)转换为mat3
+     * @param {mat3} rmat 变换矩阵
+     * @param {number} xangle 对应欧拉角x 弧度
+     * @param {number} yangle 对应欧拉角y 弧度
+     * @param {number} zangle 对应欧拉加z 弧度
+     * @returns {mat3} 对应变换矩阵
+     * @example
+     * const rotateX = 0.5;
+     * const rotateY = 0.5;
+     * const rotateZ = 0.5;
+     * const mt3 = mat3.create();
+     * convEular2matrixZYX(mt3, [rotateX, rotateY, rotateZ])
+     */
+    export function convEular2matrixZYX(
+      rmat: mat3,
+      xangle: number,
+      yangle: number,
+      zangle: number
+    ): mat3;
+    /**
+     * 将drc
+     * @param {vtkPolyData} mesh 网格polyData
+     * @param {mat4} [matrix] 变换矩阵
+     * @returns {string} drc压缩之后的网格base64
+     */
+    export function enCodeMeshToBase64(
+      mesh: vtkPolyData,
+      matrix?: mat4
+    ): string;
+    /**
+     * 将一圈有序点按指定size进行平滑
+     * @param {vec3[]} points 一圈有序点
+     * @param {number} smaSize=3 平滑点的数量通常值为奇数
+     * @returns {vec3[]} 平滑之后的点
+     */
+    export function smaPoint(points: vec3[], smaSize?: number): vec3[];
+    /**
+     * 将一段有序点按指定size进行平滑
+     * @param {vec3[]} points 一段有序点
+     * @param {number} smaSize=3 平滑点的数量通常值为奇数
+     * @returns {vec3[]} 平滑之后的点
+     */
+    export function smaPointNotRound(points: vec3[], smaSize?: number): vec3[];
+    /**
+     * 表示一个包含三个轴向的对象
+     * @typedef {Object} AxisObject
+     * @property {vec3} x - x轴
+     * @property {vec3} y - y轴
+     * @property {vec3} z - z轴
+     */
+    /**
+     * 获取一个矩阵的三个轴向
+     * @param {mat4} matrix 4 * 4 的矩阵
+     * @returns {AxisObject} 三个轴向
+     */
+    export function getAxisFormMat4(matrix: mat4): AxisObject;
+    /**
+     * 计算 w2l(word 2 local, word to local) 的变换矩阵
+     * @param {vec3} center 中心点
+     * @param {vec3} xaxis x轴
+     * @param {vec3} yaxis y轴
+     * @param {vec3} zaxis z轴
+     * @returns { mat4 } 变换矩阵
+     */
+    export function getmatw2l(
+      center: vec3,
+      xaxis: vec3,
+      yaxis: vec3,
+      zaxis: vec3
+    ): mat4;
+    /**
+     * 计算 l2w(local 2 word, local to word) 的变换矩阵
+     * @param {vec3} center 中心点
+     * @param {vec3} xaxis x轴
+     * @param {vec3} yaxis y轴
+     * @param {vec3} zaxis z轴
+     * @returns { mat4 } 变换矩阵
+     */
+    export function getmatofl2w(
+      center: vec3,
+      xaxis: vec3,
+      yaxis: vec3,
+      zaxis: vec3
+    ): mat4;
+    /**
+     * vtkPolyData的顶点去重 用于3倍顶点的stl和老版本的vtkMarchingCube
+     * @param {vtkPolyData} data 网格的vtkPolyData
+     * @returns {vtkPolyData} 去重之后的vtkPolyData
+     */
+    export function deduplicatePolyData(data: vtkPolyData): vtkPolyData;
+    /**
+     * 判断一个矩阵是否是正交矩阵
+     * @param {mat4} matrix 矩阵
+     * @returns {boolean} 是否是正交矩阵
+     */
+    export function isRotationMatrix(matrix: mat4): boolean;
+    /**
+     * 将vtkPolyData进行三角化
+     * @param {vtkPolyData} _polydata 需要三角化的vtkPolydata
+     * @returns {vtkPolyData} 三角化之后的vtkPolydata
+     */
+    export function trianglePolys(_polydata: vtkPolyData): vtkPolyData;
+    /**
+     * 加载网格
+     * @param {string | File | Blob} file 文件或者文件链接
+     * @param {'drc' | 'stl' | 'ply'} [type] 文件类型，当file为string | File的时候可以不传根据文件后缀自动获取，drc需要先进行初始化
+     * @param {boolean} [process] 是否需要预先对数据进行处理,stl默认(去重)
+     * @returns {Promise<vtkPolyData>} vtkPolyData
+     */
+    export function loadMeshData(file: string | File | Blob, type?: "drc" | "stl" | "ply", process?: boolean): Promise<vtkPolyData>;
+    export type Position = {
+      /**
+       * 对应vtk坐标系的x值
+       */
+      x: number;
+      /**
+       * 对应vtk坐标系的y值
+       */
+      y: number;
+      /**
+       * 0
+       */
+      z: number;
+    };
+    /**
+     * 表示一个包含三个轴向的对象
+     */
+    export type AxisObject = {
+      /**
+       * - x轴
+       */
+      x: vec3;
+      /**
+       * - y轴
+       */
+      y: vec3;
+      /**
+       * - z轴
+       */
+      z: vec3;
+    };
+  }
+  export namespace drcUtils {
+    export type AttrOption = {
+      /**
+       * 颜色数组
+       */
+      colors?: number[];
+      /**
+       * 属性数组
+       */
+      generics?: number[];
+      /**
+       * 法向量数组
+       */
+      normals?: number[];
+    };
+    export type DrcMeshData = {
+      /**
+       * 网格面数组
+       */
+      faces: Uint32Array;
+      /**
+       * 网格点数组
+       */
+      vertices: Float32Array;
+      /**
+       * 颜色数组
+       */
+      colors?: Float32Array;
+      /**
+       * 属性数组
+       */
+      generics?: Float32Array;
+      /**
+       * 法向量数组
+       */
+      normals?: Float32Array;
+    };
+    export type Decoder = any;
+    export type Mesh = {
+      /**
+       * 点信息
+       */
+      vertices: number[][];
+      /**
+       * 面信息
+       */
+      faces: number[][];
+    };
+    /**
+     * @typedef {Object} AttrOption
+     * @property {number[]} [colors] 颜色数组
+     * @property {number[]} [generics] 属性数组
+     * @property {number[]} [normals] 法向量数组
+     */
+    /**
+     * 将数据进行压缩
+     * @param {number[]} vertices 网格点
+     * @param {number[]} faces 网格面，必须是三角化之后的面，每连续的三个点索引标识一个面
+     * @param {number} byteLength=14 byteLength 压缩率
+     * @param {AttrOption} [attr] 其他需要压缩的属性
+     * @returns {Int8Array} 压缩之后的DRC数据
+     */
+    export function enCodeMeshByVF(
+      vertices: number[],
+      faces: number[],
+      byteLength?: number,
+      attr?: AttrOption
+    ): Int8Array;
+    /**
+     * 使用drc压缩点
+     * @param {vec3[] | number[]} points 点数组
+     * @returns {Int8Array} 压缩之后的drc data
+     */
+    export function enCodePointCloud(points: vec3[] | number[]): Int8Array;
+    /**
+     * 解压drc格式的点云数据
+     * @param {ArrayBuffer} byteArray drc点数据
+     * @returns {Float32Array} 点数组
+     */
+    export function decodePointCloud(byteArray: ArrayBuffer): Float32Array;
+    /**
+     * @typedef {Object} DrcMeshData
+     * @property {Uint32Array} faces 网格面数组
+     * @property {Float32Array} vertices 网格点数组
+     * @property {Float32Array} [colors] 颜色数组
+     * @property {Float32Array} [generics] 属性数组
+     * @property {Float32Array} [normals] 法向量数组
+     */
+    /**
+     * 解压drc格式的网格数据
+     * @param {ArrayBuffer} byteArray drc网格数据
+     * @returns {DrcMeshData} 网格数据
+     */
+    export function decodeDrcBufferArray(byteArray: ArrayBuffer): DrcMeshData;
+    /**
+     * @typedef {Object} Decoder
+     */
+    /**
+     * 输入一个Drc数据，反会对应的解压器
+     * @param {ArrayBuffer} arrayBuffer 输入的数据
+     * @returns {Decoder} drc解压类
+     */
+    export function decodeBuffer(arrayBuffer: ArrayBuffer): Decoder;
+    /**
+     * 获取decoder中的属性
+     * @param {Decoder} dracoGeometry DRC Decoder
+     * @param {number} attributeId 需要获取的属性id
+     * @returns {Float32Array} 对应decoder中的属性
+     */
+    export function getDracoAttributeAsFloat32Array(
+      dracoGeometry: Decoder,
+      attributeId: number
+    ): Float32Array;
+    /**
+     * 将点数据使用drc压缩处理为 base64 string
+     * @param {vec3[] | number[]} points 点数据
+     * @returns {string} drc压缩之后的base64数据
+     */
+    export function enCloudPointTobase64(points: vec3[] | number[]): string;
+    /**
+     * @typedef {Object} Mesh
+     * @property {number[][]} vertices 点信息
+     * @property {number[][]} faces 面信息
+     */
+    /**
+     * 使用drc压缩网格信息
+     * @param {Mesh | vtkPolyData} mesh
+     * @param {number} byteLength=14  压缩率
+     * @param {AttrOption} [attr] 其他需要压缩的属性
+     * @returns {Int8Array} 压缩之后的DRC数据
+     */
+    export function enCodeMesh(
+      mesh: Mesh | vtkPolyData,
+      byteLength?: number,
+      attr?: AttrOption
+    ): Int8Array;
+    /**
+     * 初始化Draco文件
+     */
+    export function initDrcCoder(): void;
+  }
+
+  export namespace utils {
+    /**
+     * 获取当前屏幕分辨率(百分制,默认100)
+     * @returns {number} 当前屏幕分辨率
+     */
+    export function getRatio(): number;
+    /**
+     * 将Base64转换为ArrayBuffer
+     * @param {string} base64String
+     * @returns {ArrayBuffer} base64的ArrayBuffer
+     */
+    export function base64ToArrayBuffer(base64String: string): ArrayBuffer;
+    /**
+     * 将Int8Array转换为Base64格式的字符串
+     * @param {Int8Array} int8
+     * @returns {string} base64格式的字符串
+     */
+    export function int8ArrayToBase64(int8: Int8Array): string;
+    /**
+     * 将ArrayBuffer转换为Base64格式的字符串
+     * @param {ArrayBuffer} outputBuffer
+     * @returns {string} base64格式的字符串
+     */
+    export function arrayBufferToBase64(outputBuffer: ArrayBuffer): string;
+    /**
+     * 获取当前屏幕分辨率(百分制,默认100)
+     * @returns {number} 当前屏幕分辨率
+     */
+    export function detectZoom(): number;
+  }
+  export namespace qrcode {
+    /**
+     * 生成一个二维码图片，可以在二维码右侧添加二维码文字内容信息
+     * @param {string} content 二维码内容
+     * @param {QrCodeOptions} options 图片参数
+     * @returns {string} 返回图片的base64
+     */
+    export function generateQRCodeWithText(
+      content: string,
+      options?: QrCodeOptions
+    ): string | false;
+  }
+
+  export namespace BwipJs {
+    export interface BwippOptions {
+      includecheck?: boolean | undefined;
+      includecheckintext?: boolean | undefined;
+
+      parse?: boolean | undefined;
+      parsefnc?: boolean | undefined;
+
+      height?: number | undefined;
+      width?: number | undefined;
+
+      inkspread?: number | undefined;
+      inkspreadh?: number | undefined;
+      inkspreadv?: number | undefined;
+      dotty?: boolean | undefined;
+
+      binarytext?: boolean | undefined; // really a bwip-js option but better positioned here
+      includetext?: boolean | undefined;
+      textfont?: string | undefined;
+      textsize?: number | undefined;
+      textgaps?: number | undefined;
+      alttext?: string | undefined;
+
+      textxalign?:
+        | "offleft"
+        | "left"
+        | "center"
+        | "right"
+        | "offright"
+        | "justify"
+        | undefined;
+      textyalign?: "below" | "center" | "above" | undefined;
+      textxoffset?: number | undefined;
+      textyoffset?: number | undefined;
+
+      showborder?: boolean | undefined;
+      borderwidth?: number | undefined;
+      borderleft?: number | undefined;
+      borderright?: number | undefined;
+      bordertop?: number | undefined;
+      boraderbottom?: number | undefined;
+
+      barcolor?: string | undefined;
+      backgroundcolor?: string | undefined;
+      bordercolor?: string | undefined;
+      textcolor?: string | undefined;
+
+      addontextxoffset?: number | undefined;
+      addontextyoffset?: number | undefined;
+      addontextfont?: string | undefined;
+      addontextsize?: number | undefined;
+
+      guardwhitespace?: boolean | undefined;
+      guardwidth?: number | undefined;
+      guardheight?: number | undefined;
+      guardleftpos?: number | undefined;
+      guardrightpos?: number | undefined;
+      guardleftypos?: number | undefined;
+      guardrightypos?: number | undefined;
+    }
+    export interface RenderOptions extends BwippOptions {
+      bcid: string;
+      text: string;
+
+      scaleX?: number | undefined;
+      scaleY?: number | undefined;
+      scale?: number | undefined;
+
+      rotate?: "N" | "R" | "L" | "I" | undefined;
+
+      paddingwidth?: number | undefined;
+      paddingheight?: number | undefined;
+
+      paddingleft?: number | undefined;
+      paddingright?: number | undefined;
+      paddingtop?: number | undefined;
+      paddingbottom?: number | undefined;
+
+      monochrome?: boolean | undefined;
+      sizelimit?: number | undefined;
+    }
+    export interface RawOptions extends BwippOptions {
+      bcid: string;
+      text: string;
+    }
+    export interface DrawingContext<T> {
+      setopts?(options: RenderOptions): void;
+      scale(sx: number, sy: number): [number, number] | null;
+      measure(
+        str: string,
+        font: string,
+        fwidth: number,
+        fheight: number
+      ): { width: number; ascent: number; descent: number };
+      init(width: number, height: number): void;
+      line(
+        x0: number,
+        y0: number,
+        x1: number,
+        y1: number,
+        lw: number,
+        rgb: string
+      ): void;
+      polygon(pts: Array<[number, number]>): void;
+      hexagon(
+        pts: [
+          [number, number],
+          [number, number],
+          [number, number],
+          [number, number],
+          [number, number]
+        ]
+      ): void;
+      ellipse(x: number, y: number, rx: number, ry: number, ccw: boolean): void;
+      fill(rgb: string): void;
+      text(
+        x: number,
+        y: number,
+        str: string,
+        rgb: string,
+        font: { name: string; width: number; height: number; dx: number }
+      ): void;
+      end(): T;
+    }
+
+    export function toSVG(opts: RenderOptions): string;
+    export function drawingSVG(): DrawingContext<string>;
+
+    export function toCanvas(
+      canvas: string | HTMLCanvasElement,
+      opts: RenderOptions
+    ): HTMLCanvasElement;
+    export function drawingCanvas(
+      canvas: string | HTMLCanvasElement
+    ): DrawingContext<HTMLCanvasElement>;
+
+    export function datamatrix(
+      canvas: string | HTMLCanvasElement,
+      opts: RenderOptions
+    ): HTMLCanvasElement;
+    export function datamatrix<T>(
+      opts: RenderOptions,
+      drawing: DrawingContext<Promise<T>>
+    ): Promise<T>;
+    export function datamatrix<T>(
+      opts: RenderOptions,
+      drawing: DrawingContext<T>
+    ): T;
+
+    export function qrcode(
+      canvas: string | HTMLCanvasElement,
+      opts: RenderOptions
+    ): HTMLCanvasElement;
+    export function qrcode<T>(
+      opts: RenderOptions,
+      drawing: DrawingContext<Promise<T>>
+    ): Promise<T>;
+    export function qrcode<T>(
+      opts: RenderOptions,
+      drawing: DrawingContext<T>
+    ): T;
+    export function render<T>(
+      params: RenderOptions,
+      drawing: DrawingContext<T>
+    ): T;
+    export function raw(
+      bcid: string,
+      text: string,
+      opts?: BwippOptions
+    ):
+      | Array<{ bbs: number[]; bhs: number[]; sbs: number[] }>
+      | Array<{
+          pixs: number[];
+          pixx: number;
+          pixy: number;
+          height: number;
+          width: number;
+        }>;
+    export const BWIPP_VERSION: string;
+    export const BWIPJS_VERSION: string;
+
+    export function loadFont(name: string, data: string | Uint8Array): void;
+    export function loadFont(
+      name: string,
+      mult: number,
+      data: string | Uint8Array
+    ): void;
+    export function loadFont(
+      name: string,
+      multy: number,
+      multx: number,
+      data: string | Uint8Array
+    ): void;
+
+    export namespace FontLib {
+      export interface PathData
+        extends Array<
+          | { type: "M"; x: number; y: number }
+          | { type: "L"; x: number; y: number }
+          | { type: "Q"; x: number; y: number; cx: number; cy: number }
+          | {
+              type: "C";
+              x: number;
+              y: number;
+              cx1: number;
+              cy1: number;
+              cx2: number;
+              cy2: number;
+            }
+        > {
+        ascent: number;
+        descent: number;
+        advance: number;
+      }
+      export function lookup(font: string): number;
+      export function monochrome(mono: boolean): void;
+      export function getglyph(
+        fontid: number,
+        charcode: number,
+        width: number,
+        height: number
+      ): {
+        glyph: number;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        advance: number;
+        pixels: Uint8Array;
+        bytes: Uint8Array;
+        cachekey: string;
+        offset: number;
+      };
+      export function getpaths(
+        fontid: number,
+        charcode: number,
+        width: number,
+        height: number
+      ): PathData;
+      export function loadFont(name: string, data: string | Uint8Array): void;
+      export function loadFont(
+        name: string,
+        mult: number,
+        data: string | Uint8Array
+      ): void;
+      export function loadFont(
+        name: string,
+        multy: number,
+        multx: number,
+        data: string | Uint8Array
+      ): void;
+    }
+  }
+}