@maqiuyao/dxf-viewer 0.2.17 → 0.2.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +184 -182
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,182 +1,184 @@
|
|
|
1
|
-
# @maqiuyao/dxf-viewer
|
|
2
|
-
|
|
3
|
-
基于 [three.js](https://threejs.org) 的 DXF 图纸查看与对比库,支持 2D/3D 渲染、字体解析、图纸 diff 对比。
|
|
4
|
-
|
|
5
|
-
## 安装
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
npm install @maqiuyao/dxf-viewer three
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
> `three` 是 peerDependency,请自行安装(建议 `>=0.160`)。
|
|
12
|
-
|
|
13
|
-
## 引入样式
|
|
14
|
-
|
|
15
|
-
```ts
|
|
16
|
-
import "@maqiuyao/dxf-viewer/style.css";
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
## 单图查看
|
|
20
|
-
|
|
21
|
-
```ts
|
|
22
|
-
import { Viewer2d } from "@maqiuyao/dxf-viewer";
|
|
23
|
-
|
|
24
|
-
const viewer = new Viewer2d({
|
|
25
|
-
containerId: "dxf-container", // 页面中已存在的容器 div id
|
|
26
|
-
language: "cn",
|
|
27
|
-
enableLayoutBar: true,
|
|
28
|
-
});
|
|
29
|
-
|
|
30
|
-
// 加载 SHX/TTF 字体(URL 由使用方自行提供,见下方"字体资源")
|
|
31
|
-
await viewer.setFont(["/fonts/hztxt.shx", "/fonts/simplex.shx"]);
|
|
32
|
-
|
|
33
|
-
await viewer.loadModel(
|
|
34
|
-
{
|
|
35
|
-
modelId: "demo",
|
|
36
|
-
name: "demo.dxf",
|
|
37
|
-
src: "/files/demo.dxf",
|
|
38
|
-
encoding: "utf-8",
|
|
39
|
-
},
|
|
40
|
-
(event) => console.log("progress:", event.loaded)
|
|
41
|
-
);
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
## 双图对比
|
|
45
|
-
|
|
46
|
-
```ts
|
|
47
|
-
import { DxfCompareHelper } from "@maqiuyao/dxf-viewer";
|
|
48
|
-
|
|
49
|
-
const helper = new DxfCompareHelper(
|
|
50
|
-
{ containerId: "left-container", language: "cn" },
|
|
51
|
-
{ containerId: "right-container", language: "cn" }
|
|
52
|
-
);
|
|
53
|
-
|
|
54
|
-
await helper.setFont(["/fonts/hztxt.shx", "/fonts/simplex.shx"]);
|
|
55
|
-
|
|
56
|
-
await helper.compare(
|
|
57
|
-
{ src: "/files/a.dxf", modelId: "a", encoding: "utf-8" },
|
|
58
|
-
{ src: "/files/b.dxf", modelId: "b", encoding: "utf-8" },
|
|
59
|
-
undefined, // DxfCompareConfig,可选
|
|
60
|
-
(p) => console.log("progress:", p.loaded)
|
|
61
|
-
);
|
|
62
|
-
|
|
63
|
-
// 变动列表:helper.getChanges(),每项含 type(新增/删除/修改)、handle、box
|
|
64
|
-
helper.enableSyncCamera(true); // 左右相机同步
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
对比结果会在左右两个视口上用**修订云线框 + 半透明填充**标出每处变动(新增绿 / 删除红 / 修改黄),框与内容间自动留隙。
|
|
68
|
-
|
|
69
|
-
## 文本搜索
|
|
70
|
-
|
|
71
|
-
```ts
|
|
72
|
-
// mode: "fuzzy"(模糊:子串/跳字匹配,默认)| "exact"(精准:整条文字完全相等)
|
|
73
|
-
const results = viewer.searchText("松口", { mode: "fuzzy" });
|
|
74
|
-
// 每项含 text、layer、handle、box(世界坐标包围盒)
|
|
75
|
-
|
|
76
|
-
viewer.focusText(results[0]); // 相机定位并高亮该文字
|
|
77
|
-
viewer.clearTextHighlight();
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
支持 TEXT / MTEXT / ATTRIB 全部文字实体(含块内属性),中文按图纸编码自动解码。
|
|
81
|
-
|
|
82
|
-
## 实体点击事件
|
|
83
|
-
|
|
84
|
-
```ts
|
|
85
|
-
import { ViewerEvent, type MouseClickInfo } from "@maqiuyao/dxf-viewer";
|
|
86
|
-
|
|
87
|
-
viewer.addEventListener(ViewerEvent.MouseClick, (info: MouseClickInfo) => {
|
|
88
|
-
if (!info.handle) return; // 点击空白处
|
|
89
|
-
const ud = info.userData;
|
|
90
|
-
console.log(ud.dxfType, ud.layerName, ud.textContent, ud.xdata);
|
|
91
|
-
});
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
拾取自动跳过背景平面;合并渲染架构下按命中游标反查实体,`userData` 携带 `handle` / `dxfType` / `layerName` / `textContent` / `xdata`。
|
|
95
|
-
|
|
96
|
-
### 扩展数据(XDATA,组码 1000)
|
|
97
|
-
|
|
98
|
-
INSERT/ATTRIB 实体上的 `HLXSYSTEM_DATA` 等扩展数据已解析为 JSON 挂在 `userData.xdata`,点击即可读取业务字段(iconid / id / rid / shapeguid 等)。
|
|
99
|
-
|
|
100
|
-
### 点击高亮
|
|
101
|
-
|
|
102
|
-
```ts
|
|
103
|
-
viewer.enableClickHighlight = true; // 默认 false;开启后点击实体绘制云线框
|
|
104
|
-
viewer.clearClickHighlight(); // 主动清除
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
## 图纸打印
|
|
108
|
-
|
|
109
|
-
```ts
|
|
110
|
-
await viewer.print({
|
|
111
|
-
area: "view", // "view" 当前视图(所见即所得,默认)| "extents" 全图
|
|
112
|
-
paperSize: "A3", // A4 | A3 | A2 | A1 | A0 | Letter(默认 A4)
|
|
113
|
-
orientation: "auto", // auto | landscape | portrait(auto 按图片宽高自动选)
|
|
114
|
-
invertColors: true, // 白底打印:深色 CAD 背景转白、墨迹保留原色相(默认 false)
|
|
115
|
-
margins: 10, // 页边距 mm(默认 10)
|
|
116
|
-
title: "站场平面图", // 打印文档标题
|
|
117
|
-
});
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
实现要点:
|
|
121
|
-
- 打印瞬间临时以最高分辨率(至 GPU 纹理上限)重渲染并合成叠加层,打印后自动恢复相机/渲染状态
|
|
122
|
-
- `extents` 全图模式自动裁剪到图纸包围盒(无空白边距),并强制显示低缩放下被隐藏的图符/文字
|
|
123
|
-
- `invertColors` 采用像素级处理(背景色距离判背景 + HSL 明度反转 + 墨迹膨胀加粗),线条/文字在纸上实心清晰,蓝色等彩色实体**色相不变**
|
|
124
|
-
- 输出经隐藏 iframe + `@page` 规则调起浏览器打印对话框,单页不溢出
|
|
125
|
-
|
|
126
|
-
## 请求认证(Token / 自定义请求头)
|
|
127
|
-
|
|
128
|
-
当 DXF 文件存放在需要鉴权的服务上时,可为 `loadModel` 的 `src` 下载请求配置 HTTP 请求头(如 `Authorization`)。两种方式:
|
|
129
|
-
|
|
130
|
-
**按次配置**(仅本次加载生效):
|
|
131
|
-
|
|
132
|
-
```ts
|
|
133
|
-
await viewer.loadModel({
|
|
134
|
-
modelId: "a",
|
|
135
|
-
src: "https://host/a.dxf",
|
|
136
|
-
headers: { Authorization: "Bearer " + token },
|
|
137
|
-
});
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
**全局默认**(对后续所有加载生效,按次 `headers` 优先级更高):
|
|
141
|
-
|
|
142
|
-
```ts
|
|
143
|
-
viewer.setRequestHeaders({ Authorization: "Bearer " + token });
|
|
144
|
-
await viewer.loadModel({ modelId: "a", src: "https://host/a.dxf" });
|
|
145
|
-
viewer.setRequestHeaders(undefined); // 清除
|
|
146
|
-
```
|
|
147
|
-
|
|
148
|
-
注意:请求头仅作用于 DXF 主文件下载,字体文件(`setFont`)与图纸对比(`compare`)的请求不附带。跨域服务需允许对应的自定义头(CORS `Access-Control-Allow-Headers`)。
|
|
149
|
-
|
|
150
|
-
## 优化与完善(0.2.x)
|
|
151
|
-
|
|
152
|
-
- 0.2.
|
|
153
|
-
- 0.2.
|
|
154
|
-
- 0.2.
|
|
155
|
-
- 0.2.
|
|
156
|
-
- 0.2.
|
|
157
|
-
- 0.2.
|
|
158
|
-
- 0.2.
|
|
159
|
-
- 0.2.
|
|
160
|
-
- 0.2.
|
|
161
|
-
- 0.2.
|
|
162
|
-
- 0.2.
|
|
163
|
-
- 0.2.
|
|
164
|
-
- 0.2.
|
|
165
|
-
-
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
-
|
|
170
|
-
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
1
|
+
# @maqiuyao/dxf-viewer
|
|
2
|
+
|
|
3
|
+
基于 [three.js](https://threejs.org) 的 DXF 图纸查看与对比库,支持 2D/3D 渲染、字体解析、图纸 diff 对比。
|
|
4
|
+
|
|
5
|
+
## 安装
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
npm install @maqiuyao/dxf-viewer three
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
> `three` 是 peerDependency,请自行安装(建议 `>=0.160`)。
|
|
12
|
+
|
|
13
|
+
## 引入样式
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import "@maqiuyao/dxf-viewer/style.css";
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## 单图查看
|
|
20
|
+
|
|
21
|
+
```ts
|
|
22
|
+
import { Viewer2d } from "@maqiuyao/dxf-viewer";
|
|
23
|
+
|
|
24
|
+
const viewer = new Viewer2d({
|
|
25
|
+
containerId: "dxf-container", // 页面中已存在的容器 div id
|
|
26
|
+
language: "cn",
|
|
27
|
+
enableLayoutBar: true,
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
// 加载 SHX/TTF 字体(URL 由使用方自行提供,见下方"字体资源")
|
|
31
|
+
await viewer.setFont(["/fonts/hztxt.shx", "/fonts/simplex.shx"]);
|
|
32
|
+
|
|
33
|
+
await viewer.loadModel(
|
|
34
|
+
{
|
|
35
|
+
modelId: "demo",
|
|
36
|
+
name: "demo.dxf",
|
|
37
|
+
src: "/files/demo.dxf",
|
|
38
|
+
encoding: "utf-8",
|
|
39
|
+
},
|
|
40
|
+
(event) => console.log("progress:", event.loaded)
|
|
41
|
+
);
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## 双图对比
|
|
45
|
+
|
|
46
|
+
```ts
|
|
47
|
+
import { DxfCompareHelper } from "@maqiuyao/dxf-viewer";
|
|
48
|
+
|
|
49
|
+
const helper = new DxfCompareHelper(
|
|
50
|
+
{ containerId: "left-container", language: "cn" },
|
|
51
|
+
{ containerId: "right-container", language: "cn" }
|
|
52
|
+
);
|
|
53
|
+
|
|
54
|
+
await helper.setFont(["/fonts/hztxt.shx", "/fonts/simplex.shx"]);
|
|
55
|
+
|
|
56
|
+
await helper.compare(
|
|
57
|
+
{ src: "/files/a.dxf", modelId: "a", encoding: "utf-8" },
|
|
58
|
+
{ src: "/files/b.dxf", modelId: "b", encoding: "utf-8" },
|
|
59
|
+
undefined, // DxfCompareConfig,可选
|
|
60
|
+
(p) => console.log("progress:", p.loaded)
|
|
61
|
+
);
|
|
62
|
+
|
|
63
|
+
// 变动列表:helper.getChanges(),每项含 type(新增/删除/修改)、handle、box
|
|
64
|
+
helper.enableSyncCamera(true); // 左右相机同步
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
对比结果会在左右两个视口上用**修订云线框 + 半透明填充**标出每处变动(新增绿 / 删除红 / 修改黄),框与内容间自动留隙。
|
|
68
|
+
|
|
69
|
+
## 文本搜索
|
|
70
|
+
|
|
71
|
+
```ts
|
|
72
|
+
// mode: "fuzzy"(模糊:子串/跳字匹配,默认)| "exact"(精准:整条文字完全相等)
|
|
73
|
+
const results = viewer.searchText("松口", { mode: "fuzzy" });
|
|
74
|
+
// 每项含 text、layer、handle、box(世界坐标包围盒)
|
|
75
|
+
|
|
76
|
+
viewer.focusText(results[0]); // 相机定位并高亮该文字
|
|
77
|
+
viewer.clearTextHighlight();
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
支持 TEXT / MTEXT / ATTRIB 全部文字实体(含块内属性),中文按图纸编码自动解码。
|
|
81
|
+
|
|
82
|
+
## 实体点击事件
|
|
83
|
+
|
|
84
|
+
```ts
|
|
85
|
+
import { ViewerEvent, type MouseClickInfo } from "@maqiuyao/dxf-viewer";
|
|
86
|
+
|
|
87
|
+
viewer.addEventListener(ViewerEvent.MouseClick, (info: MouseClickInfo) => {
|
|
88
|
+
if (!info.handle) return; // 点击空白处
|
|
89
|
+
const ud = info.userData;
|
|
90
|
+
console.log(ud.dxfType, ud.layerName, ud.textContent, ud.xdata);
|
|
91
|
+
});
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
拾取自动跳过背景平面;合并渲染架构下按命中游标反查实体,`userData` 携带 `handle` / `dxfType` / `layerName` / `textContent` / `xdata`。
|
|
95
|
+
|
|
96
|
+
### 扩展数据(XDATA,组码 1000)
|
|
97
|
+
|
|
98
|
+
INSERT/ATTRIB 实体上的 `HLXSYSTEM_DATA` 等扩展数据已解析为 JSON 挂在 `userData.xdata`,点击即可读取业务字段(iconid / id / rid / shapeguid 等)。
|
|
99
|
+
|
|
100
|
+
### 点击高亮
|
|
101
|
+
|
|
102
|
+
```ts
|
|
103
|
+
viewer.enableClickHighlight = true; // 默认 false;开启后点击实体绘制云线框
|
|
104
|
+
viewer.clearClickHighlight(); // 主动清除
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## 图纸打印
|
|
108
|
+
|
|
109
|
+
```ts
|
|
110
|
+
await viewer.print({
|
|
111
|
+
area: "view", // "view" 当前视图(所见即所得,默认)| "extents" 全图
|
|
112
|
+
paperSize: "A3", // A4 | A3 | A2 | A1 | A0 | Letter(默认 A4)
|
|
113
|
+
orientation: "auto", // auto | landscape | portrait(auto 按图片宽高自动选)
|
|
114
|
+
invertColors: true, // 白底打印:深色 CAD 背景转白、墨迹保留原色相(默认 false)
|
|
115
|
+
margins: 10, // 页边距 mm(默认 10)
|
|
116
|
+
title: "站场平面图", // 打印文档标题
|
|
117
|
+
});
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
实现要点:
|
|
121
|
+
- 打印瞬间临时以最高分辨率(至 GPU 纹理上限)重渲染并合成叠加层,打印后自动恢复相机/渲染状态
|
|
122
|
+
- `extents` 全图模式自动裁剪到图纸包围盒(无空白边距),并强制显示低缩放下被隐藏的图符/文字
|
|
123
|
+
- `invertColors` 采用像素级处理(背景色距离判背景 + HSL 明度反转 + 墨迹膨胀加粗),线条/文字在纸上实心清晰,蓝色等彩色实体**色相不变**
|
|
124
|
+
- 输出经隐藏 iframe + `@page` 规则调起浏览器打印对话框,单页不溢出
|
|
125
|
+
|
|
126
|
+
## 请求认证(Token / 自定义请求头)
|
|
127
|
+
|
|
128
|
+
当 DXF 文件存放在需要鉴权的服务上时,可为 `loadModel` 的 `src` 下载请求配置 HTTP 请求头(如 `Authorization`)。两种方式:
|
|
129
|
+
|
|
130
|
+
**按次配置**(仅本次加载生效):
|
|
131
|
+
|
|
132
|
+
```ts
|
|
133
|
+
await viewer.loadModel({
|
|
134
|
+
modelId: "a",
|
|
135
|
+
src: "https://host/a.dxf",
|
|
136
|
+
headers: { Authorization: "Bearer " + token },
|
|
137
|
+
});
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
**全局默认**(对后续所有加载生效,按次 `headers` 优先级更高):
|
|
141
|
+
|
|
142
|
+
```ts
|
|
143
|
+
viewer.setRequestHeaders({ Authorization: "Bearer " + token });
|
|
144
|
+
await viewer.loadModel({ modelId: "a", src: "https://host/a.dxf" });
|
|
145
|
+
viewer.setRequestHeaders(undefined); // 清除
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
注意:请求头仅作用于 DXF 主文件下载,字体文件(`setFont`)与图纸对比(`compare`)的请求不附带。跨域服务需允许对应的自定义头(CORS `Access-Control-Allow-Headers`)。
|
|
149
|
+
|
|
150
|
+
## 优化与完善(0.2.x)
|
|
151
|
+
|
|
152
|
+
- 0.2.18:修复 npm 包 package.json 带 UTF-8 BOM 导致 webpack 项目安装后构建失败——Vue CLI/webpack 解析包内 package.json 时直接 JSON.parse 不剥 BOM,报 `Module not found: SyntaxError ... is not valid JSON`;发布文件改为 UTF-8 无 BOM 编码
|
|
153
|
+
- 0.2.17:修复畸形 MULTILEADER(多重引线)实体导致整图加载崩溃——① 缺少锚点(lastLeaderLinePoint)时仅渲染文字部分、安全跳过引线;② 缺少狗腿向量(doglegVector)时跳过狗腿段;③ 顶点数组缺失/点数不足时跳过该引线;不再抛出 `Cannot read properties of undefined (reading 'x')` 中断图纸加载
|
|
154
|
+
- 0.2.16:修复复用 viewer 切换图纸时的内存泄漏——① removeModel 移除模型后递归释放 GPU 资源(geometry/material 及克隆的材质备份),覆盖 Mesh/Line/Points,实测 GPU 几何体数完全回落;② 文本搜索索引随模型移除失效,释放对旧模型对象的 JS 引用;③ 布局切换条不再随每次模型加载累积 DOM 与事件监听
|
|
155
|
+
- 0.2.15:viewer 支持复用切换图纸——① 新增 viewer.removeModel(modelId) API:从场景移除指定模型而不销毁 viewer,场景清空后自动重置主模型与布局状态,保证后续加载的模型按全新流程初始化;② loadModel 进入时自动中断上一个未完成的加载(快速切换图纸不叠加显示),destroy() 时同样自动中断;③ 每次加载使用独立 DxfLoader 实例,中断仅影响最近一次未完成的加载,已完成模型与后续新加载不受影响
|
|
156
|
+
- 0.2.14:修复加载异常(src 无效/文件缺失/内容非法)时永久 loading 的问题——① Viewer2d/Viewer3d 的 loadModel 失败时立即移除进度条项并向上抛出错误,调用方可 catch 处理;② spinner 计数统一在 finally 中配对释放,异常路径不再卡 loading;③ 双图对比 compare() 的多个早退失败路径同样清理进度条;④ 修复 loadingDxfCount 自初始版本起只有自减无自增导致 releaseFontData 永不触发(字体内存泄漏)的缺陷
|
|
157
|
+
- 0.2.13:修复缩放视图后图符(信号机/道岔图标等)凭空消失——视觉小对象自动隐藏(enableHideVisuallySmallObjects)默认改为关闭:按屏幕像素尺寸隐藏小对象的性能优化导致坐标跨度大的图纸(如站场平面图)初始加载即近半对象被隐藏、缩小后图符持续消失,与 AutoCAD 行为不一致;该配置字段同时补入 Viewer2dConfig 类型(原先未收录),图元数量极大的图纸仍可显式传 true 开启
|
|
158
|
+
- 0.2.12:加固 HATCH 填充与裁剪滤镜的畸形数据防御,修复部分图纸(如室内平面布置图)加载崩溃——① HATCH 自相交检测对缺起止点的非线段边(SPLINE/ARC 等)返回无交点,不再 TypeError 中断整体加载,并修复首边环绕越界(edges[-1]);② convertEdgeToPoints 对 Line/Arc/Ellipse 边补有限性校验,缺必要数据的边产出 NaN 几何("Computed radius is NaN")改为跳过;③ SpatialFilter 缺 invertBlockMatrix 矩阵时警告跳过
|
|
159
|
+
- 0.2.11:修复变宽多段线(箭头/坡度符号)渲染与 TTF 回退文字排版——① LWPOLYLINE 顶点宽度缺省回退(顶点宽度→constantWidth→0),仅写组码 41 的图纸不再产生 NaN 几何;② 渐宽段按段独立构造梯形,往复折线(上下箭头)不再出现多余填充与扭结;③ TTF 回退字形消除留白(bearing)并对齐 MTEXT 列宽居中基准,"〈6‰"等坡度符号位置与间距和 AutoCAD 一致
|
|
160
|
+
- 0.2.10:修复图符被连线遮挡的显示层级问题,与 AutoCAD 一致(图符在上、连线在下)——顶层 INSERT 块分类抬层:纯开放线块压低层并压平带宽度线挤出深度(z→0,消除深度测试绕过 renderOrder),含图符要素(闭合轮廓/CIRCLE/HATCH/POINT)块抬高层确定性绘制在所有连线之上
|
|
161
|
+
- 0.2.9:修复生僻中文字符显示为"缺笔假字"问题——字体回退时校验字形宽度,符号类字体(如 @extfont2.shx)编码与汉字 GBK 码偶合不再误命中,缺字改为显示 ?;建议通过 setFont 追加中文 TTF(如 simsun/华文中宋)补全生僻字覆盖
|
|
162
|
+
- 0.2.8:WebGL 上下文创建失败时自动降级重试(关闭抗锯齿),兼容问题驱动/远程桌面环境;彻底无法创建时显示用户可读提示并抛出可捕获的 WebGLUnavailable 错误;修复英文语言包资源误映射为中文的问题
|
|
163
|
+
- 0.2.7:修复蝴蝶结信号图标渲染(闭合等宽多段线不再错误填充,与 AutoCAD 一致);修复多行 MText 垂直对齐偏低问题(改用文字块实际高度);图纸加载初始视图自适应(校验头部视域范围,几何超出时自动扩展/回退,图纸始终完整可见);poly-extrude 退化顶点噪音报错静默跳过,不再污染控制台
|
|
164
|
+
- 0.2.6:`loadModel` 的 src 下载支持自定义 HTTP 请求头——按次 `modelCfg.headers` 或全局 `viewer.setRequestHeaders()`(用于认证 token);修复请求头此前未实际生效的问题
|
|
165
|
+
- 0.2.5:新增 `viewer.print()` 图纸打印 API(当前视图/全图、A4–A0 纸张、白底保色打印、高分辨率输出)
|
|
166
|
+
- 0.2.4:`three-mesh-bvh` 已编译内联进产物,webpack4/Vue2(Vue CLI)项目无需再配置 `transpileDependencies` 或 alias,直接安装即可(此前会报 `Module parse failed: Unexpected token (18:9)`)
|
|
167
|
+
- 修复 ATTRIB/ATTDEF 对齐组码(72/74)解析:右对齐/居中文字不再与块内图符重叠
|
|
168
|
+
- 中文乱码修复:`\M+XXXX` GBK 转义码正确解码
|
|
169
|
+
- 字体字间距优化,中文渲染更接近 AutoCAD
|
|
170
|
+
- 畸形 SPLINE 实体自动跳过,不再中断整图加载
|
|
171
|
+
- 加载进度以页面中央百分比呈现
|
|
172
|
+
- 文本元数据(textContent/handle/layer/dxfType)下放到叶子网格,合并后仍可搜索、拾取
|
|
173
|
+
|
|
174
|
+
## 字体资源
|
|
175
|
+
|
|
176
|
+
DXF 文本渲染依赖 SHX/TTF 字体文件,本包**不内置**字体(版权原因)。请从你的 AutoCAD 安装目录或公开字体包中获取 `hztxt.shx`、`simplex.shx`、`@extfont2.shx` 等,放到你自己站点的可访问路径,再传给 `viewer.setFont([...])`。
|
|
177
|
+
|
|
178
|
+
## 编码说明
|
|
179
|
+
|
|
180
|
+
多数现代 DXF 为 UTF-8;若图纸中文乱码,可尝试 `encoding: "gbk"` 或 `"gb18030"`。
|
|
181
|
+
|
|
182
|
+
## 许可
|
|
183
|
+
|
|
184
|
+
MIT
|
package/package.json
CHANGED