DWG文件在线预览时字体缺失如何解决？

Question

在使用Web端工具在线预览DWG文件时，常因缺少与CAD设计匹配的SHX或TTF字体文件，导致文字显示为问号、乱码或空白。该问题源于服务器未部署相应字体库，或浏览器无法加载本地AutoCAD字体。如何在不依赖用户安装字体的前提下，确保DWG预览时文字正确渲染？这是当前基于Forge Viewer、CAD Exchanger等技术方案中亟需解决的关键兼容性难题。

Answer 1

一、问题背景与技术挑战

在建筑、制造和工程领域，DWG文件作为AutoCAD的核心数据格式，广泛用于设计与协作。随着云协同平台的兴起，Web端在线预览DWG文件成为常态。然而，当使用如Autodesk Forge Viewer或CAD Exchanger SDK等工具进行渲染时，常出现文字显示异常的问题。

这类问题的根本原因在于：DWG中引用的SHX（Shape Font）或TTF（TrueType Font）字体未被Web环境正确识别或加载。由于浏览器沙箱机制限制，无法访问用户本地的AutoCAD字体目录；同时，服务器若未预置对应字体库，也无法完成字体映射。

更复杂的是，不同企业使用的自定义字体（如HZTXT.SHX）不具备通用性，进一步加剧了跨平台兼容性难题。

二、分层解析：从现象到本质

1. 表现层：DWG中的文本显示为“???”, “□□”或空白。
2. 传输层：模型通过SVF/SVF2格式转换后丢失字体元数据。
3. 服务层：Forge引擎或Exchanger转换器未绑定字体搜索路径。
4. 资源层：缺少授权或合法来源的字体文件（尤其是商业/专有SHX）。
5. 安全策略层：CORS、CSP策略阻止字体资源跨域加载。

三、主流Web可视化方案中的字体处理机制对比

工具	字体支持方式	是否支持SHX	是否支持TTF嵌入	可配置字体路径	云端字体托管能力
Autodesk Forge Viewer	依赖转换服务预处理	有限（需上传）	是（需授权）	否（仅API级扩展）	部分支持（需开发者部署）
CAD Exchanger Cloud	转换时绑定字体包	支持（指定目录）	支持	是	支持私有字体仓库
LibreDWG + WebAssembly	客户端解析+字体替换	否	通过JS注入	是	无
Teigha File Converter (ODA)	批量转PDF/SVG保留文字轮廓	转为路径	转为路径	是	不涉及

四、解决方案演进路径

解决该问题需结合前端、后端与转换流程优化，以下为递进式技术路线：

1. 方案一：字体预注册与服务器部署（基础）

在模型转换前，将常用SHX/TTF字体文件部署至转换服务所在服务器，并配置字体搜索路径。例如，在ODA Teigha或CAD Exchanger CLI中设置：

# 示例：CAD Exchanger 设置字体目录
converter.setFontDirectories([
  "/fonts/standard",
  "/fonts/custom"
]);

// 转换时自动匹配 DWG 中的 FONTNAME
scene.load(dwgPath, conversionParams);
    

2. 方案二：字体轮廓化（Text to Path）

在转换阶段将所有文本对象转换为多段线（Polyline）或路径（Path），彻底规避字体缺失问题。适用于只读预览场景。

• 优点：100%兼容，无需管理字体
• 缺点：文本不可编辑、搜索、选择；文件体积增大
• 适用工具：ODA Drawings SDK、Aspose.CAD

3. 方案三：动态字体代理服务（进阶）

构建内部字体资源中心，配合Forge Derivative API或自研转换微服务，实现：

• 提取DWG中TEXTSTYLE表的字体名称
• 比对内建字体数据库
• 自动注入匹配的TTF/SHX至转换上下文

五、基于Forge Viewer的增强型字体处理架构

针对Autodesk Forge生态，提出如下集成方案：

// Step 1: 提取原始DWG字体需求
const fontRequests = await extractFontNamesFromDwgMetadata(urn);

// Step 2: 查询企业字体CDN
const availableFonts = await queryInternalFontApi(fontRequests);

// Step 3: 启动转换任务时注入参数
await derivative.translate({
  modelUrn,
  options: {
    fonts: availableFonts.map(f => f.url), // 自定义字体URL
    textAsGeometry: false // 控制是否转为几何体
  }
});
    

六、Mermaid 流程图：完整字体渲染决策流

graph TD
            A[接收到DWG文件] --> B{是否已知字体?}
            B -- 是 --> C[加载预注册字体]
            B -- 否 --> D[尝试匹配默认替代字体]
            C --> E[执行SVF转换]
            D --> E
            E --> F{转换成功?}
            F -- 是 --> G[生成Viewer可读模型]
            F -- 否 --> H[启用Text-to-Path回退模式]
            H --> I[重新转换为路径文本]
            I --> G
            G --> J[前端渲染正常文字]

七、最佳实践建议

• 建立企业级CAD字体资产库，统一管理SHX/TTF文件。
• 在CI/CD流水线中集成字体合规性检查，避免版权风险。
• 对敏感项目启用自动轮廓化策略，牺牲可编辑性换取稳定性。
• 利用Web Worker在客户端做轻量级字体模拟（如用Arial替代simplex.shx）。
• 监控日志中MissingFont事件，持续优化字体覆盖率。
• 与法务团队协作，确保使用的替代字体符合开源或商业许可。
• 在Viewer初始化时注入globalOffset和fontOptions提升渲染一致性。
• 采用SVG输出+CSS字体声明实现高保真打印预览。
• 探索WASM版Open Design Alliance SDK实现本地字体解析。
• 推动行业标准，呼吁AutoCAD开放核心SHX的公共授权版本。