@file-viewer/renderer-cad
Flyfish File Viewer 的独立 CAD renderer 包。它基于 @flyfish-dev/cad-viewer 提供 DWG、DXF、DWF、DWFx 和 XPS 的浏览器端预览，并通过 File Viewer 统一的 asset manifest 解析 wasm / worker 路径，适合企业内网和离线部署。
用法
import FileViewer from '@file-viewer/vue3'
import { cadRenderer } from '@file-viewer/renderer-cad'
const options = {
rendererMode: 'replace',
renderers: cadRenderer,
}
也可以和其他 renderer 一起组合：
import { cadRenderer } from '@file-viewer/renderer-cad'
import { pdfRenderer } from '@file-viewer/renderer-pdf'
const options = {
rendererMode: 'replace',
renderers: [pdfRenderer, cadRenderer],
}
能力边界
- 支持
.dwg、.dxf、.dwf、.dwfx、.xps。 - DWG 使用 Worker + LibreDWG WASM 按需解析，避免阻塞主线程。
- DXF 使用 JavaScript parser 并归一化为统一 CAD document。
- DWF / DWFx / XPS 使用 native renderer，并通过
dwfv-render.wasm提供高性能 raster / WebGL fallback。 - 支持图层显示切换、结构统计、适配视图、缩放、全局 toolbar zoom provider 和 resize observer。
离线资产
默认会从 viewer assets 下读取：
wasm/cad/wasm/cad/dwg-worker.jswasm/cad/dwfv-render.wasmwasm/cad/libredwg-web.jswasm/cad/libredwg-web.wasm
私有化部署时可以通过 options.cad.wasmPath、options.cad.workerUrl、options.cad.dwfWasmUrl 覆盖。
迁移说明
CAD 预览已经从 @file-viewer/core 中彻底移出，core 只保留资产 manifest、类型和兼容错误提示，不再默认安装 @flyfish-dev/cad-viewer。完整 CAD 能力请安装本包并传入 renderers，或直接使用 @file-viewer/preset-all。
黑白出图模式
cad.colorMode 可设为 source 或 monochrome。黑白模式通过 CAD 引擎的实体颜色策略实现，不使用 CSS 滤镜，因此 Canvas、WebGL、文字覆盖层及原生 DWF 渲染可保持一致，同时保留透明度、线型、线宽和源文件数据。
默认原色模式使用深色背景，黑白模式使用白纸黑线。自适应对比度会提高与背景过近的线条和文字的可见性；要求严格显示源颜色时可设 cad.canvasOptions.contrastMode: 'preserve'。显式设置的 cad.canvasOptions.background / cad.dwfBackground 不会被模式切换覆盖。
{
cad: {
colorMode: 'monochrome',
monochromeColor: '#000000',
showColorModeToggle: true,
},
}
图片、打印与离线 HTML
先选择原色或黑白模式，再使用统一工具栏的“打印”或“HTML”。输出会重新绘制并立即捕获当前视图，包含 WebGL 线条和文字覆盖层，不含图层面板或工具栏。HTML 内嵌 PNG，不依赖临时 blob 地址；打印窗口可使用浏览器的“另存为 PDF”，并保留 File Viewer 的权限检查、水印和遮罩。
CAD 工具栏的 PNG、JPEG 按钮下载同一视图，并保留配置的文本或图片水印。toolbar.permissions.download 与 toolbar.permissions['export-html'] 都必须允许；捕获前由所属组件执行既有 beforeOperation、工具栏 beforeOperation 和 beforeDownload 钩子。取消操作、切换文档或撤销权限后不会下载旧快照。cad.showImageExport: false 可隐藏这两个格式专用按钮。水印资源不可读时明确失败，预览仍保持可用。打印遮罩仅作用于打印，不作用于图片下载。
这里输出的是当前相机视图 / 当前 DWF 页的栅格快照，不是整个 CAD 文件的矢量转换，也不会自动批量打印其他图纸页。需要完整图纸时先点击“适配”。原文件下载始终保持输入字节不变。