zyf-model-engine 0.0.2 → 0.2.0

package/types/vendor/DXFPaser/TextRenderer.d.ts

@@ -0,0 +1,43 @@
+import { Entity } from './Entity';
+export class TextRenderer {
+  fontFetchers: Function[];
+  fonts: any[];
+  font: any;
+  options: any;
+  shapes: Map;
+  stubShapeLoaded: boolean;
+  stubShape: any;
+  constructor(fontFetchers: Function[], options: any);
+  async FetchFonts(text: string): boolean;
+  get canRender(): boolean;
+
+  *Render(obj: {
+    text: string;
+    startPos: { x: number; y: number };
+    endPos: { x: number; y: number };
+    rotation?: number;
+    widthFactor?: number;
+    hAlign?: number;
+    vAlign?: number;
+    color: any;
+    layer?: string;
+    fontSize: number;
+  }): void;
+
+  *RenderMText(obj: {
+    formattedText: MTextFormatEntity[];
+    position: { x: number; y: number };
+    fontSize: number;
+    width?: number;
+    rotation?: number;
+    direction?: { x: number; y: number };
+    attachment: number;
+    lineSpacing?: number;
+    color: number;
+    layer?: string;
+  }): Generator<Entity>;
+
+  _GetCharShape(char: any): any
+  _CreateCharShape(char: any): any
+  async _FetchFont(fontFetcher: any): Promise<any>
+}

package/types/vendor/DXFPaser/index.d.ts

@@ -0,0 +1,26 @@
+import { Group, Material, PointsMaterial } from 'three';
+import { RBTree } from './RBTree';
+import { DxfWorker } from './DxfWorker';
+
+
+export class DXFGroup extends Group {
+  dxfLayers: Map
+  constructor(): void;
+  GetLayers(): { name: string; color: number; state: boolean }[];
+  ShowLayer(name: string, show: boolean): void;
+}
+
+export class DxfParser {
+  constructor(): void;
+  clearColor: number;
+  scene: DXFGroup;
+  simpleColorMaterial: Material[];
+  simplePointMaterial: PointsMaterial[];
+  materials: RBTree;
+  layers: Map;
+  blocks: Map;
+  worker: DxfWorker | null;
+
+  async Load(object: { url: string; fonts?: string[]; progressCbk?: (phase: any, processedSize: number, totalSize: number) => void; workerFactory?: any }): Promise<DXFGroup>;
+  SetupWorker(): void;
+}

package/types/vendor/controls/BaseArrow.d.ts

@@ -0,0 +1,20 @@
+import { ArrowHelper, Camera, Color, Object3D, Vector3 } from 'three';
+import { ArrowControls } from './ArrowControls';
+declare class BaseArrow {
+    direction: Vector3;
+    origin: Vector3;
+    color: Color | number | string;
+    group: Object3D;
+    arrowHelper: ArrowHelper;
+    controls: ArrowControls;
+    camera: Camera | undefined;
+    constructor(origin: Vector3, direction: Vector3, group: Object3D, camera?: Camera, color?: Color | number | string, length?: number);
+    init(length?: number): void;
+    bindControls(dom: any, initialPoint: Vector3, drag?: (data: any) => void, end?: (data: any) => void): void;
+    setDirection(direction: Vector3): void;
+    setPosition(length: number): void;
+    setOrigin(origin: Vector3): void;
+    dispose(): void;
+    visible(flag: boolean): void;
+}
+export { BaseArrow };

package/types/vendor/controls/FirstPersonControls.d.ts

@@ -0,0 +1,32 @@
+import { Camera, Mesh, Object3D, Vector3, EventDispatcher } from 'three';
+
+
+export class FirstPersonControls extends EventDispatcher {
+  constructor(object: Object3D, camera: Camera, domElement?: HTMLElement);
+
+  object: Object3D;
+  camera: Camera;
+  domElement: HTMLElement | HTMLDocument;
+
+  enabled: boolean;
+  movementSpeed: number;
+  lookSpeed: number;
+  lookVertical: boolean;
+  autoForward: boolean;
+  activeLook: boolean;
+  heightSpeed: boolean;
+  heightCoef: number;
+  heightMin: number;
+  heightMax: number;
+  constrainVertical: boolean;
+  verticalMin: number;
+  verticalMax: number;
+  mouseDragOn: boolean;
+  meshs: Array<Mesh>;
+  target: Vector3;
+
+  handleResize(): void;
+  lookAt(x: number | Vector3, y: number, z: number): this;
+  update(delta: number): this;
+  dispose(): void;
+}

package/types/vendor/controls/FlyControls.d.ts

@@ -0,0 +1,18 @@
+import { Camera, EventDispatcher } from 'three';
+
+
+export class FlyControls extends EventDispatcher {
+  constructor(object: Camera, domElement?: HTMLElement);
+
+  object: Camera;
+  domElement: HTMLElement | HTMLDocument;
+
+  movementSpeed: number;
+  rollSpeed: number;
+  dragToLook: boolean;
+  autoForward: boolean;
+  enabled: boolean;
+
+  update(delta: number): void;
+  dispose(): void;
+}

package/types/vendor/controls/OrbitControls.d.ts

@@ -0,0 +1,75 @@
+import { Camera, MOUSE, TOUCH, Vector3 } from 'three';
+
+
+export class OrbitControls {
+  constructor(object: Camera, domElement?: HTMLElement);
+
+  object: Camera;
+  domElement: HTMLElement | HTMLDocument;
+
+  // API
+  enabled: boolean;
+  target: Vector3;
+
+  // deprecated
+  center: Vector3;
+
+  minDistance: number;
+  maxDistance: number;
+
+  minZoom: number;
+  maxZoom: number;
+
+  minPolarAngle: number;
+  maxPolarAngle: number;
+
+  minAzimuthAngle: number;
+  maxAzimuthAngle: number;
+
+  enableDamping: boolean;
+  dampingFactor: number;
+
+  enableZoom: boolean;
+  zoomSpeed: number;
+
+  enableRotate: boolean;
+  rotateSpeed: number;
+
+  enablePan: boolean;
+  panSpeed: number;
+  screenSpacePanning: boolean;
+  keyPanSpeed: number;
+
+  autoRotate: boolean;
+  autoRotateSpeed: number;
+
+  enableKeys: boolean;
+  keys: { LEFT: number; UP: number; RIGHT: number; BOTTOM: number };
+  mouseButtons: { LEFT?: MOUSE; MIDDLE?: MOUSE; RIGHT?: MOUSE };
+  touches: { ONE: TOUCH; TWO: TOUCH };
+
+  update(): boolean;
+
+  saveState(): void;
+
+  reset(): void;
+
+  dispose(): void;
+
+  getPolarAngle(): number;
+
+  getAzimuthalAngle(): number;
+
+  // EventDispatcher mixins
+  addEventListener(type: string, listener: (event: any) => void): void;
+
+  hasEventListener(type: string, listener: (event: any) => void): boolean;
+
+  removeEventListener(type: string, listener: (event: any) => void): void;
+
+  dispatchEvent(event: { type: string; target: any }): void;
+}
+
+export class MapControls extends OrbitControls {
+  constructor(object: Camera, domElement?: HTMLElement);
+}

package/types/vendor/controls/TransformControls.d.ts

@@ -0,0 +1,41 @@
+import { Object3D, Camera, MOUSE } from 'three';
+
+
+export class TransformControls extends Object3D {
+  constructor(object: Camera, domElement?: HTMLElement);
+
+  domElement: HTMLElement;
+
+  // API
+
+  camera: Camera;
+  object: Object3D | undefined;
+  enabled: boolean;
+  axis: string | null;
+  mode: string;
+  translationSnap: number | null;
+  rotationSnap: number | null;
+  space: string;
+  size: number;
+  dragging: boolean;
+  showX: boolean;
+  showY: boolean;
+  showZ: boolean;
+  readonly isTransformControls: true;
+  mouseButtons: {
+    LEFT: MOUSE;
+    MIDDLE: MOUSE;
+    RIGHT: MOUSE;
+  };
+
+  attach(object: Object3D): this;
+  detach(): this;
+  getMode(): string;
+  setMode(mode: string): void;
+  setTranslationSnap(translationSnap: number | null): void;
+  setRotationSnap(rotationSnap: number | null): void;
+  setScaleSnap(scaleSnap: number | null): void;
+  setSize(size: number): void;
+  setSpace(space: string): void;
+  dispose(): void;
+}

package/types/vendor/controls/directionControls.d.ts

@@ -0,0 +1,26 @@
+import { Camera, EventDispatcher, Mesh } from 'three';
+declare class DirectionControls extends EventDispatcher {
+    private _plane;
+    private _raycaster;
+    private _mouse;
+    private _offset;
+    private _intersection;
+    private _worldPosition;
+    private _inverseMatrix;
+    private origin;
+    private direction;
+    private _selected;
+    private _hovered;
+    enabled: boolean;
+    private events;
+    private element;
+    private camera;
+    private objects;
+    constructor(objects: Mesh[], camera: Camera, domElement: HTMLElement);
+    private activate;
+    dispose(): void;
+    private onDocumentMouseMove;
+    private onDocumentMouseDown;
+    private onDocumentMouseCancel;
+}
+export { DirectionControls };

package/types/vendor/loaders/GLTFLoader.d.ts

@@ -0,0 +1,71 @@
+import { AnimationClip, Camera, Group, Loader, LoadingManager, Mesh, Object3D, Material, SkinnedMesh, Texture } from 'three';
+import { DRACOLoader } from './DRACOLoader';
+import { DDSLoader } from './DDSLoader';
+import { KTX2Loader } from './KTX2Loader';
+
+
+export interface GLTF {
+  animations: AnimationClip[];
+  scene: Group;
+  scenes: Group[];
+  cameras: Camera[];
+  asset: {
+    copyright?: string;
+    generator?: string;
+    version?: string;
+    minVersion?: string;
+    extensions?: any;
+    extras?: any;
+  };
+  parser: GLTFParser;
+  userData: any;
+}
+
+export class GLTFLoader extends Loader {
+  constructor(manager?: LoadingManager);
+  dracoLoader: DRACOLoader | null;
+  ddsLoader: DDSLoader | null;
+  imageJson: { [k: string]: string } | null;
+
+  load(
+    url: string,
+    onLoad: (gltf: GLTF) => void,
+    onProgress?: (event: ProgressEvent) => void,
+    onError?: (event: ErrorEvent) => void
+  ): void;
+  setDRACOLoader(dracoLoader: DRACOLoader): GLTFLoader;
+  setDDSLoader(ddsLoader: DDSLoader): GLTFLoader;
+
+  register(callback: (parser: GLTFParser) => GLTFLoaderPlugin): GLTFLoader;
+  unregister(callback: (parser: GLTFParser) => GLTFLoaderPlugin): GLTFLoader;
+
+  setKTX2Loader(ktx2Loader: KTX2Loader): GLTFLoader;
+  setMeshoptDecoder(meshoptDecoder: /* MeshoptDecoder */ any): GLTFLoader;
+  setImageJson(json: { [k: string]: string } | null): GLTFLoader;
+
+  parse(data: ArrayBuffer | string, path: string, onLoad: (gltf: GLTF) => void, onError?: (event: ErrorEvent) => void): void;
+}
+
+export interface GLTFReference {
+  type: "materials" | "nodes" | "textures";
+  index: number;
+}
+
+export class GLTFParser {
+  json: any;
+
+  associations: Map<Object3D | Material | Texture, GLTFReference>;
+
+  getDependency: (type: string, index: number) => Promise<any>;
+  getDependencies: (type: string) => Promise<any[]>;
+}
+
+export interface GLTFLoaderPlugin {
+  loadMesh?: (meshIndex: number) => Promise<Group | Mesh | SkinnedMesh> | null;
+  loadBufferView?: (bufferViewIndex: number) => Promise<ArrayBuffer> | null;
+  loadMaterial?: (materialIndex: number) => Promise<Material> | null;
+  loadTexture?: (textureIndex: number) => Promise<Texture> | null;
+  getMaterialType?: (materialIndex: number) => typeof Material | null;
+  extendMaterialParams?: (materialIndex: number, materialParams: { [key: string]: any }) => Promise<any> | null;
+  createNodeAttachment?: (nodeIndex: number) => Promise<Object3D> | null;
+}

package/types/workbench/DxfViewer.d.ts

@@ -0,0 +1,16 @@
+import { default as Viewer } from '..';
+/**
+ * @description DXF 专用 Viewer 子类，基于 Viewer 基类自动进入 2D 正交模式
+ * —— 禁用轨道旋转、切换为正交相机、相机位于 Y 轴正方向俯视，
+ * 适合 CAD/DXF 这类平面图形的浏览场景
+ */
+export declare class DxfViewer extends Viewer {
+    /**
+     * @param dom 承载渲染的 HTMLCanvasElement
+     * @param background 背景色（默认 0x000000 黑色）
+     */
+    constructor(dom: HTMLCanvasElement, background?: number);
+    private _Toggle2DMode;
+    centerView(padding?: number): void;
+    private fitView;
+}

package/types/workbench/clickInfo.d.ts

@@ -0,0 +1,24 @@
+import { default as Viewer } from '..';
+import { blankMethod } from '../libs/types';
+/**
+ * @description 点击构件信息拾取：在 viewer 上注册 pointerdown 射线，
+ * 命中 mesh 后高亮并把 mesh 的自定义属性通过 callback 回调出去
+ */
+export declare class information {
+    private cameraInfo;
+    private raysInfo;
+    private elementInfo;
+    private raycaster;
+    private funDes;
+    private objectMesh;
+    private newMesh;
+    private resultBack;
+    constructor(viewer: Viewer, params: {
+        color?: number;
+        opacity?: number;
+        callback: blankMethod;
+    });
+    private mouseClick;
+    private initEvents;
+    destory(): void;
+}

package/types/workbench/clipping.d.ts

@@ -0,0 +1,62 @@
+import { Group } from 'three';
+import { DirectionControls } from '../vendor/controls/directionControls';
+import { blankMethod } from '../libs/types';
+import { TransformControls } from '../vendor/controls/TransformControls';
+import { default as Viewer } from '..';
+/**
+ * @description 剖切管理器，支持两种模式：
+ * - global 全局剖切：用 Box 包围盒的 6 个平面裁切 scene；
+ * - local 局部剖切：用 XY / XZ / YZ 轴平面裁切指定 group。
+ * 配合 DirectionControls / TransformControls 让用户拖动交互剖切平面
+ */
+export declare class Clipping {
+    private renderer;
+    private element;
+    private camera;
+    private globalPlanes;
+    private localPlanes;
+    private boxVertices;
+    private planes;
+    private boxMeshs;
+    private localMesh;
+    private meshs;
+    private objects;
+    control: any;
+    group: Group;
+    dragControl: DirectionControls;
+    transControl: TransformControls;
+    clippingType: "global" | "local" | "";
+    callBack?: blankMethod;
+    setParam?: blankMethod;
+    constructor(base: Viewer, params: {
+        callBackFun?: blankMethod;
+        set?: blankMethod;
+    });
+    setClippingType(type: "global" | "local" | ""): void;
+    private setLocalClipping;
+    /**
+     * 盒剖切
+     */
+    private computedClippingPlane;
+    private setGlobalMesh;
+    private createMesh;
+    private createLine;
+    private injectMeshsAndLine;
+    private updateMeshsAndLine;
+    changeBoxCutting(param: {
+        x: number[];
+        y: number[];
+        z: number[];
+    }, type: string): void;
+    /**
+     * 初始化controls控件 并且注册好事件  dragstart  开始拖拽  dragend  拖拽结束   drag  拖拽过程中
+     * 初始化 transformControl 处理事件
+     */
+    private initEvents;
+    /**
+     * 重置所有的材质透明度
+     */
+    private resetMaterial;
+    private updateLocalPlane;
+    detory(): void;
+}

package/types/workbench/dxfMeasure.d.ts

@@ -0,0 +1,92 @@
+import { default as Viewer } from '..';
+/**
+ * @description DXF 测量核心类：基于 Raycaster 的射线拾取实现距离/角度/面积三种测量模式。
+ * 距离模式在两点拾取后自动完成；角度模式三点自动完成；面积模式支持左键持续加点 + 双击闭合，
+ * 右键 / ESC 取消当前测量。测量完成后创建 Line / Polygon 实体并挂到 scene。
+ */
+export declare class DXFMeasure {
+    private rays;
+    private step;
+    private state;
+    private element;
+    private raycaster;
+    private camera;
+    private point;
+    private currentObj;
+    private group;
+    private points;
+    private curr_line;
+    private down;
+    private pointMesh;
+    private callback?;
+    private viewer;
+    private start;
+    private end;
+    private events;
+    private plane;
+    private lastClickPos;
+    private lastClickTime;
+    UNIT: {
+        unit: string;
+        precision: string;
+    };
+    constructor(viewer: Viewer, params: {
+        callback?: (param: any) => void;
+    });
+    /**
+     * 初始化所有的点击  移动事件
+     */
+    private initEvents;
+    /**
+     * move事件
+     * @param event MouseEvent
+     * @returns Undefind
+     */
+    private mouseMoveEvent;
+    /**
+     * 鼠标抬起事件
+     * @param event MouseEvent
+     * @returns Undefind
+     */
+    private upEvent;
+    /**
+     * 取消当前测量，清理临时状态但保留已有测量实体
+     */
+    private cancelMeasure;
+    /**
+     * 鼠标按下事件
+     */
+    private downEvent;
+    /**
+     * 键盘事件：ESC 取消当前测量
+     */
+    private handleKeyDown;
+    private computeScale;
+    /**
+     * 创建距离测量线
+     * @param points 点的数组
+     * @returns
+     */
+    private createDistanceLine;
+    /**
+     * 创建角度测量线
+     * @param points 点的数组
+     * @returns
+     */
+    private createAngleLine;
+    /**
+     * 创建面积测量
+     * @param points 点的数组
+     * @returns
+     */
+    private createAreaLine;
+    adjustSetting(param: {
+        unit: string;
+        precision: string;
+    }): void;
+    judeUnit(unit: string, height: number, precision: number): string;
+    judeAreaUnit(unit: string, num: number, precision: number): string;
+    setType(type: "distance" | "angle" | "area" | ""): void;
+    destory(): void;
+    clearAll(): void;
+}

package/types/workbench/dxfTools.d.ts

@@ -0,0 +1,88 @@
+import { ComponentConfig } from '../libs/types';
+import { DxfViewer } from './DxfViewer';
+import { DXFMeasure } from './dxfMeasure';
+/**
+ * @description DXF 工具面板容器（命令式 DOM），根据 ComponentConfig 配置
+ * 动态挂载 FitView（缩放至适应）、HandleLayers（图层显隐）、dxfMeasure（测量）、
+ * 全屏、颜色反转等子工具栏
+ */
+export declare class DxfTools {
+    viewer: DxfViewer;
+    content: any;
+    classWrapper: {
+        [k: string]: any;
+    };
+    /**
+     * @param view DxfViewer 实例
+     * @param options ComponentConfig 配置对象，通过布尔开关决定挂载哪些子工具栏
+     */
+    constructor(view: DxfViewer, options: ComponentConfig);
+    private _init;
+}
+/** @description 「适应视图」按钮，点击后正交相机自动缩放把 DXF 图形完整呈现在画布内 */
+export declare class FitView {
+    dom: HTMLDivElement;
+    /**
+     * @param viewer DxfViewer 实例
+     * @param obj { img? 自定义按钮图标, text? 按钮文字, padding? 边距比例（默认 0.1） }
+     */
+    constructor(viewer: DxfViewer, obj: {
+        img?: string;
+        text?: string;
+        padding?: number;
+    });
+}
+/** @description DXF 图层面板，解析 DXFGroup 的图层元数据生成勾选列表，控制每个图层的显隐 */
+export declare class HandleLayers {
+    private _layerShow;
+    dom: HTMLDivElement;
+    layerElement: HTMLDivElement;
+    viewer: DxfViewer;
+    time: number;
+    constructor(viewer: DxfViewer, img?: string, text?: string);
+    private _initLayerUI;
+    appendStretch(): HTMLDivElement;
+    handleLayers(): void;
+    createCheckBox(): HTMLDivElement;
+}
+/**
+ * @description DXF 测量面板（命令式 DOM），内嵌一个 DXFMeasure 实例处理实际的
+ * 距离/角度/面积射线拾取与多边形绘制逻辑；自身只负责渲染 UI tab 切换、
+ * 结果展示、清空、设置等 DOM 交互
+ */
+export declare class dxfMeasure {
+    dom: HTMLDivElement;
+    viewer: DxfViewer;
+    measure: DXFMeasure;
+    toolsWrapper: HTMLDivElement;
+    /**
+     * @param {DxfViewer} viewer
+     * @param {?String} img
+     * @param {?String} text
+     */
+    constructor(viewer: DxfViewer, img?: string, text?: string);
+    private _initToolsWrapper;
+    private _unitAccuracy;
+    private _meaCallBack;
+    private _distanceIcon;
+    private _angleIcon;
+    private _areaIcon;
+    private _elementEvent;
+    destory(): void;
+}
+/**
+ * @description 全屏切换按钮。由 DxfTools 传入 DXF 画布容器（.viewer-box）作为全屏目标，
+ * 只让 viewer 自身撑满视口，避免整个宿主文档进入全屏引发宿主应用整体 resize。
+ * fullFlag 通过 fullscreenchange 事件同步，ESC 退出后状态不错乱
+ */
+export declare class fullScreen {
+    dom: any;
+    fullFlag: any;
+    private target;
+    /**
+     * @param img 自定义按钮图标
+     * @param text 按钮悬浮提示文字
+     * @param target 全屏目标元素；缺省为 document.documentElement（整页全屏，保持旧行为）
+     */
+    constructor(img?: string, text?: string, target?: HTMLElement);
+}