@chocozhang/three-model-render 1.0.1

package/dist/camera/index.mjs

@@ -0,0 +1,265 @@
+import * as THREE from 'three';
+
+// src/utils/followModels.ts - 优化版
+// ✨ 使用 WeakMap 跟踪动画，支持取消
+const _animationMap = new WeakMap();
+/**
+ * 推荐角度枚举，便于快速选取常见视角
+ */
+const FOLLOW_ANGLES = {
+    /** 等距斜视（默认视角）- 适合建筑、机械设备展示 */
+    ISOMETRIC: { azimuth: Math.PI / 4, elevation: Math.PI / 4 },
+    /** 正前视角 - 适合正面展示、UI 对齐 */
+    FRONT: { azimuth: 0, elevation: 0 },
+    /** 右侧视角 - 适合机械剖面、侧视检查 */
+    RIGHT: { azimuth: Math.PI / 2, elevation: 0 },
+    /** 左侧视角 */
+    LEFT: { azimuth: -Math.PI / 2, elevation: 0 },
+    /** 后视角 */
+    BACK: { azimuth: Math.PI, elevation: 0 },
+    /** 顶视图 - 适合地图、平面布局展示 */
+    TOP: { azimuth: 0, elevation: Math.PI / 2 },
+    /** 低角度俯视 - 适合车辆、人物等近地物体 */
+    LOW_ANGLE: { azimuth: Math.PI / 4, elevation: Math.PI / 6 },
+    /** 高角度俯视 - 适合鸟瞰、全景浏览 */
+    HIGH_ANGLE: { azimuth: Math.PI / 4, elevation: Math.PI / 3 }
+};
+/**
+ * 缓动函数集合
+ */
+const EASING_FUNCTIONS = {
+    linear: (t) => t,
+    easeInOut: (t) => t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2,
+    easeOut: (t) => 1 - Math.pow(1 - t, 3),
+    easeIn: (t) => t * t * t
+};
+/**
+ * 自动将相机移到目标的斜上角位置，并保证目标在可视范围内（平滑过渡）- 优化版
+ *
+ * ✨ 优化内容：
+ * - 支持多种缓动函数
+ * - 添加进度回调
+ * - 支持取消动画
+ * - WeakMap 跟踪防止泄漏
+ * - 完善错误处理
+ */
+function followModels(camera, targets, options = {}) {
+    var _a, _b, _c, _d, _e, _f;
+    // ✨ 取消之前的动画
+    cancelFollow(camera);
+    // ✨ 边界检查
+    const arr = [];
+    if (!targets)
+        return Promise.resolve();
+    if (Array.isArray(targets))
+        arr.push(...targets.filter(Boolean));
+    else
+        arr.push(targets);
+    if (arr.length === 0) {
+        console.warn('followModels: 目标对象为空');
+        return Promise.resolve();
+    }
+    try {
+        const box = new THREE.Box3();
+        arr.forEach((o) => box.expandByObject(o));
+        // ✨ 检查包围盒有效性
+        if (!isFinite(box.min.x) || !isFinite(box.max.x)) {
+            console.warn('followModels: 包围盒计算失败');
+            return Promise.resolve();
+        }
+        const sphere = new THREE.Sphere();
+        box.getBoundingSphere(sphere);
+        const center = sphere.center.clone();
+        const radiusBase = Math.max(0.001, sphere.radius);
+        const duration = (_a = options.duration) !== null && _a !== void 0 ? _a : 700;
+        const padding = (_b = options.padding) !== null && _b !== void 0 ? _b : 1.0;
+        const minDistance = options.minDistance;
+        const maxDistance = options.maxDistance;
+        const controls = (_c = options.controls) !== null && _c !== void 0 ? _c : null;
+        const azimuth = (_d = options.azimuth) !== null && _d !== void 0 ? _d : Math.PI / 4;
+        const elevation = (_e = options.elevation) !== null && _e !== void 0 ? _e : Math.PI / 4;
+        const easing = (_f = options.easing) !== null && _f !== void 0 ? _f : 'easeOut';
+        const onProgress = options.onProgress;
+        // ✨ 获取缓动函数
+        const easingFn = EASING_FUNCTIONS[easing] || EASING_FUNCTIONS.easeOut;
+        let distance = 10;
+        if (camera.isPerspectiveCamera) {
+            const cam = camera;
+            const halfV = THREE.MathUtils.degToRad(cam.fov * 0.5);
+            const halfH = Math.atan(Math.tan(halfV) * cam.aspect);
+            const halfMin = Math.min(halfV, halfH);
+            distance = (radiusBase * padding) / Math.sin(halfMin);
+            if (minDistance != null)
+                distance = Math.max(distance, minDistance);
+            if (maxDistance != null)
+                distance = Math.min(distance, maxDistance);
+        }
+        else if (camera.isOrthographicCamera) {
+            distance = camera.position.distanceTo(center);
+        }
+        else {
+            distance = camera.position.distanceTo(center);
+        }
+        // 根据 azimuth / elevation 计算方向
+        const hx = Math.sin(azimuth);
+        const hz = Math.cos(azimuth);
+        const dir = new THREE.Vector3(hx * Math.cos(elevation), Math.sin(elevation), hz * Math.cos(elevation)).normalize();
+        const desiredPos = center.clone().add(dir.multiplyScalar(distance));
+        const startPos = camera.position.clone();
+        const startTarget = controls && controls.target
+            ? controls.target.clone()
+            : camera.position.clone().add(camera.getWorldDirection(new THREE.Vector3()).multiplyScalar(1));
+        const endTarget = center.clone();
+        const startTime = performance.now();
+        return new Promise((resolve) => {
+            const step = (now) => {
+                var _a;
+                const elapsed = now - startTime;
+                const t = Math.min(1, duration > 0 ? elapsed / duration : 1);
+                const k = easingFn(t);
+                camera.position.lerpVectors(startPos, desiredPos, k);
+                if (controls && controls.target) {
+                    const newTarget = new THREE.Vector3().lerpVectors(startTarget, endTarget, k);
+                    controls.target.copy(newTarget);
+                    if (typeof controls.update === 'function')
+                        controls.update();
+                }
+                else {
+                    camera.lookAt(endTarget);
+                }
+                (_a = camera.updateProjectionMatrix) === null || _a === void 0 ? void 0 : _a.call(camera);
+                // ✨ 调用进度回调
+                if (onProgress) {
+                    try {
+                        onProgress(t);
+                    }
+                    catch (error) {
+                        console.error('followModels: 进度回调错误', error);
+                    }
+                }
+                if (t < 1) {
+                    const rafId = requestAnimationFrame(step);
+                    _animationMap.set(camera, rafId);
+                }
+                else {
+                    _animationMap.delete(camera);
+                    camera.position.copy(desiredPos);
+                    if (controls && controls.target) {
+                        controls.target.copy(endTarget);
+                        if (typeof controls.update === 'function')
+                            controls.update();
+                    }
+                    else {
+                        camera.lookAt(endTarget);
+                    }
+                    resolve();
+                }
+            };
+            const rafId = requestAnimationFrame(step);
+            _animationMap.set(camera, rafId);
+        });
+    }
+    catch (error) {
+        console.error('followModels: 执行失败', error);
+        return Promise.reject(error);
+    }
+}
+/**
+ * ✨ 取消相机的跟随动画
+ */
+function cancelFollow(camera) {
+    const rafId = _animationMap.get(camera);
+    if (rafId !== undefined) {
+        cancelAnimationFrame(rafId);
+        _animationMap.delete(camera);
+    }
+}
+
+// src/utils/setView.ts - 优化版
+/**
+ * 平滑切换相机到模型的最佳视角 - 优化版
+ *
+ * ✨ 优化内容：
+ * - 复用 followModels 逻辑，避免代码重复
+ * - 支持更多视角
+ * - 配置选项增强
+ * - 返回 Promise 支持链式调用
+ * - 支持取消动画
+ *
+ * @param camera       THREE.PerspectiveCamera 相机实例
+ * @param controls     OrbitControls 控制器实例
+ * @param targetObj    THREE.Object3D 模型对象
+ * @param position     视角位置
+ * @param options      配置选项
+ * @returns Promise<void>
+ */
+function setView(camera, controls, targetObj, position = 'front', options = {}) {
+    const { distanceFactor = 0.8, duration = 1000, easing = 'easeInOut', onProgress } = options;
+    // ✨ 边界检查
+    if (!targetObj) {
+        console.warn('setView: 目标对象为空');
+        return Promise.reject(new Error('Target object is required'));
+    }
+    try {
+        // 计算包围盒
+        const box = new THREE.Box3().setFromObject(targetObj);
+        if (!isFinite(box.min.x)) {
+            console.warn('setView: 包围盒计算失败');
+            return Promise.reject(new Error('Invalid bounding box'));
+        }
+        const center = box.getCenter(new THREE.Vector3());
+        const size = box.getSize(new THREE.Vector3());
+        const maxSize = Math.max(size.x, size.y, size.z);
+        // ✨ 使用映射表简化视角计算
+        const viewAngles = {
+            'front': { azimuth: 0, elevation: 0 },
+            'back': { azimuth: Math.PI, elevation: 0 },
+            'left': { azimuth: -Math.PI / 2, elevation: 0 },
+            'right': { azimuth: Math.PI / 2, elevation: 0 },
+            'top': { azimuth: 0, elevation: Math.PI / 2 },
+            'bottom': { azimuth: 0, elevation: -Math.PI / 2 },
+            'iso': { azimuth: Math.PI / 4, elevation: Math.PI / 4 }
+        };
+        const angle = viewAngles[position] || viewAngles.front;
+        // ✨ 复用 followModels，避免代码重复
+        return followModels(camera, targetObj, {
+            duration,
+            padding: distanceFactor,
+            controls,
+            azimuth: angle.azimuth,
+            elevation: angle.elevation,
+            easing,
+            onProgress
+        });
+    }
+    catch (error) {
+        console.error('setView: 执行失败', error);
+        return Promise.reject(error);
+    }
+}
+/**
+ * ✨ 取消视角切换动画
+ */
+function cancelSetView(camera) {
+    cancelFollow(camera);
+}
+/**
+ * ✨ 预设视角快捷方法
+ */
+const ViewPresets = {
+    /**
+     * 前视图
+     */
+    front: (camera, controls, target, options) => setView(camera, controls, target, 'front', options),
+    /**
+     * 等距视图
+     */
+    isometric: (camera, controls, target, options) => setView(camera, controls, target, 'iso', options),
+    /**
+     * 顶视图
+     */
+    top: (camera, controls, target, options) => setView(camera, controls, target, 'top', options)
+};
+
+export { FOLLOW_ANGLES, ViewPresets, cancelFollow, cancelSetView, followModels, setView };
+//# sourceMappingURL=index.mjs.map

package/dist/camera/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../src/camera/followModels.ts","../../src/camera/setView.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/core/index.d.ts

@@ -0,0 +1,102 @@
+import * as THREE from 'three';
+import { OutlinePass } from 'three/examples/jsm/postprocessing/OutlinePass';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer';
+
+interface LabelOptions {
+    fontSize?: string;
+    color?: string;
+    background?: string;
+    padding?: string;
+    borderRadius?: string;
+    updateInterval?: number;
+    enableCache?: boolean;
+}
+interface LabelManager {
+    pause: () => void;
+    resume: () => void;
+    dispose: () => void;
+    isRunning: () => boolean;
+}
+/**
+ * 给子模型添加头顶标签（支持 Mesh 和 Group）- 优化版
+ *
+ * ✨ 性能优化：
+ * - 缓存包围盒，避免每帧重复计算
+ * - 支持暂停/恢复更新
+ * - 可配置更新间隔，降低 CPU 占用
+ * - 只在可见时更新，隐藏时自动暂停
+ *
+ * @param camera THREE.Camera - 场景摄像机
+ * @param renderer THREE.WebGLRenderer - 渲染器，用于屏幕尺寸
+ * @param parentModel THREE.Object3D - FBX 根节点或 Group
+ * @param modelLabelsMap Record<string,string> - 模型 name → 标签文字 映射表
+ * @param options LabelOptions - 可选标签样式配置
+ * @returns LabelManager - 包含 pause/resume/dispose 的管理接口
+ */
+declare function addChildModelLabels(camera: THREE.Camera, renderer: THREE.WebGLRenderer, parentModel: THREE.Object3D, modelLabelsMap: Record<string, string>, options?: LabelOptions): LabelManager;
+
+type HoverBreathOptions = {
+    camera: THREE.Camera;
+    scene: THREE.Scene;
+    renderer: THREE.WebGLRenderer;
+    outlinePass: OutlinePass;
+    highlightNames?: string[] | null;
+    minStrength?: number;
+    maxStrength?: number;
+    speed?: number;
+    throttleDelay?: number;
+};
+/**
+ * 创建单例高亮器 —— 推荐在 mounted 时创建一次
+ * 返回 { updateHighlightNames, dispose, getHoveredName } 接口
+ *
+ * ✨ 性能优化：
+ * - 无 hover 对象时自动暂停动画
+ * - mousemove 节流处理，避免过度计算
+ * - 使用 passive 事件监听器提升滚动性能
+ */
+declare function enableHoverBreath(opts: HoverBreathOptions): {
+    updateHighlightNames: (names: string[] | null) => void;
+    dispose: () => void;
+    refreshSelection: () => void;
+    getHoveredName: () => string | null;
+};
+
+/**
+ * 后期处理配置选项
+ */
+interface PostProcessingOptions {
+    edgeStrength?: number;
+    edgeGlow?: number;
+    edgeThickness?: number;
+    visibleEdgeColor?: string;
+    hiddenEdgeColor?: string;
+    resolutionScale?: number;
+}
+/**
+ * 后期处理管理接口
+ */
+interface PostProcessingManager {
+    composer: EffectComposer;
+    outlinePass: OutlinePass;
+    resize: (width?: number, height?: number) => void;
+    dispose: () => void;
+}
+/**
+ * 初始化描边相关信息（包含 OutlinePass）- 优化版
+ *
+ * ✨ 功能增强：
+ * - 支持窗口 resize 自动更新
+ * - 可配置分辨率缩放提升性能
+ * - 完善的资源释放管理
+ *
+ * @param renderer THREE.WebGLRenderer
+ * @param scene THREE.Scene
+ * @param camera THREE.Camera
+ * @param options PostProcessingOptions - 可选配置
+ * @returns PostProcessingManager - 包含 composer/outlinePass/resize/dispose 的管理接口
+ */
+declare function initPostProcessing(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, options?: PostProcessingOptions): PostProcessingManager;
+
+export { addChildModelLabels, enableHoverBreath, initPostProcessing };
+export type { HoverBreathOptions, PostProcessingManager, PostProcessingOptions };