xl-public-utils 1.0.6 → 1.0.8

package/types/{vtkUtils.d.mts → vtkUtils.d.ts}

@@ -1,9 +1,3 @@
-
-import vtkInteractorStyleManipulator from "@kitware/vtk.js/Interaction/Style/InteractorStyleManipulator"
-import { vec3, mat4, mat3 } from 'gl-matrix';
-import vtkRenderer from "@kitware/vtk.js/Rendering/Core/Renderer";
-import vtkRenderWindowInteractor from "@kitware/vtk.js/Rendering/Core/RenderWindowInteractor";
-import vtkPolyData from "@kitware/vtk.js/Common/DataModel/PolyData";
 /**
  * 计算屏幕坐标到三维坐标
  * @param {vtkRenderer} renderer vtkRenderer
@@ -160,12 +154,18 @@ export function createPlyBlob(mesh: vtkPolyData, format?: "ascii" | "binary"): B
  * @returns {Blob} 网格的BinarySTL文件Blob
  */
 export function createStlBlob(mesh: vtkPolyData): Blob;
+/**
+ * @typedef {Object} Mesh
+ * @property {number[][] | vec3[]} vertices 点信息
+ * @property {number[][] | vec3[]} faces 面信息
+ */
 /**
  * 将网格压缩为drc文件，导出drc需要先加载draco_encode.js，并调用initDrcCoder初始化
- * @param {vtkPolyData} mesh 网格文件
+ * @param {vtkPolyData | Mesh} mesh 网格文件
+ * @param {number} byteLength=14  压缩率
  * @returns {Blob} drc文件
  */
-export function createDrcBlob(mesh: vtkPolyData): Blob;
+export function createDrcBlob(mesh: vtkPolyData | Mesh, byteLength?: number): Blob;
 /**
  * 将网格输出为对应类型的Blob,均采用默认参数，导出drc需要先加载draco_encode.js，并调用initDrcCoder初始化
  * @param {vtkPolyData} mesh 网格文件
@@ -173,6 +173,12 @@ export function createDrcBlob(mesh: vtkPolyData): Blob;
  * @returns {Blob} 对应类型的Blob
  */
 export function createMeshTypeBlob(mesh: vtkPolyData, type: "ply" | "stl" | "drc"): Blob;
+/**
+ * vtkPolyData的顶点去重 用于3倍顶点的stl和老版本的vtkMarchingCube
+ * @param {vtkPolyData} data 网格的vtkPolyData
+ * @returns {vtkPolyData} 去重之后的vtkPolyData
+ */
+export function deduplicatePolyData(data: vtkPolyData): vtkPolyData;
 /**
  * 计算一组三维点的中心点
  * @param {vec3[]} points 三维点数组
@@ -235,12 +241,13 @@ export function convMatrix2EularZYX(rmat: mat3, eular: [number, number, number])
  */
 export function convEular2matrixZYX(rmat: mat3, xangle: number, yangle: number, zangle: number): mat3;
 /**
- * 将drc
- * @param {vtkPolyData} mesh 网格polyData
+ * 将polyData转换为Base64string
+ * @param {vtkPolyData | Mesh} mesh 网格数据
  * @param {mat4} [matrix] 变换矩阵
+ * @param {number} byteLength=14  压缩率
  * @returns {string} drc压缩之后的网格base64
  */
-export function enCodeMeshToBase64(mesh: vtkPolyData, matrix?: mat4): string;
+export function enCodeMeshToBase64(mesh: vtkPolyData | Mesh, matrix?: mat4, byteLength?: number): string;
 /**
  * 将一圈有序点按指定size进行平滑
  * @param {vec3[]} points 一圈有序点
@@ -268,6 +275,43 @@ export function smaPointNotRound(points: vec3[], smaSize?: number): vec3[];
  * @returns {AxisObject} 三个轴向
  */
 export function getAxisFormMat4(matrix: mat4): AxisObject;
+/**
+ * 判断一个矩阵是否是正交矩阵
+ * @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>;
+/**
+ * @typedef Plane
+ * @property {vec3} origin 对应vtk坐标系的x值
+ * @property {vec3} normal 对应vtk坐标系的y值
+ */
+/**
+ * 将一组离散的三维点是使用PCA拟合一个平面结果和最小二乘结果近似
+ * @param {vec3[]} points 三维点
+ * @returns {Plane| null} 拟合的平面
+ */
+export function pcaFitPlane(points: vec3[]): Plane | null;
+/**
+ * 计算一组 3D 点的最佳拟合平面（最小二乘法）。
+ * @param {Array<vec3>} points - 3D 点数组，每个点是一个 vec3 向量。
+ * @returns {Plane|null} - 返回平面的 origin（质心）和 normal（法向量），如果点数少于 3 个则返回 null。
+ */
+export function leastSquaresFitPlane(points: Array<vec3>): Plane | null;
 /**
  * 计算 w2l(word 2 local, word to local) 的变换矩阵
  * @param {vec3} center 中心点
@@ -286,7 +330,16 @@ export function getmatw2l(center: vec3, xaxis: vec3, yaxis: vec3, zaxis: vec3):
  * @returns { mat4 } 变换矩阵
  */
 export function getmatofl2w(center: vec3, xaxis: vec3, yaxis: vec3, zaxis: vec3): mat4;
-export function deduplicatePolyData(data: vtkPolyData): vtkPolyData;
+export type Mesh = {
+    /**
+     * 点信息
+     */
+    vertices: number[][] | vec3[];
+    /**
+     * 面信息
+     */
+    faces: number[][] | vec3[];
+};
 export type Position = {
     /**
      * 对应vtk坐标系的x值
@@ -318,3 +371,19 @@ export type AxisObject = {
      */
     z: vec3;
 };
+export type Plane = {
+    /**
+     * 对应vtk坐标系的x值
+     */
+    origin: vec3;
+    /**
+     * 对应vtk坐标系的y值
+     */
+    normal: vec3;
+};
+import vtkRenderer from "@kitware/vtk.js/Rendering/Core/Renderer.js";
+import { vec3 } from 'gl-matrix';
+import { mat4 } from 'gl-matrix';
+import vtkRenderWindowInteractor from "@kitware/vtk.js/Rendering/Core/RenderWindowInteractor.js";
+import vtkPolyData from "@kitware/vtk.js/Common/DataModel/PolyData.js";
+import { mat3 } from 'gl-matrix';