四类交付物如何服务机房工勘与机房设计的不同角色：PNG、DXF、CSV 与 3D 全景的生成逻辑

摘要：同一份工勘成果，甲方、设计院、造价与决策者要看的形态并不相同。DCDesigner 提供四类交付物：2D 平面图 PNG、DXF 图纸、CSV 工程量清单、3D 整机全景——全部由同一份数据生成，因此天然一致。本文说明每种格式的生成参数、服务对象与使用方式，并给出一份交付前自查清单。
一、交付物的分工：格式服务于场景

先说一个常见误区：「把所有格式都导一遍」并不等于交付完整。真正的问题是谁读它、读到什么：

交付物服务对象读法关键要求2D 平面图 PNG甲方、运维、现场施工打印/看图软件直接看完整入画、尺寸与标注可读、有比例尺与落款DXF 图纸设计院、深化设计、CAD 使用者AutoCAD/中望/浩辰等打开1:1 毫米、图层分明、可继续编辑CSV 工程量清单造价、采购、项目管理Excel/WPS 打开数量可算、规格可查、设备可溯源3D 整机全景决策者、评审、方案汇报看图/PPT体量与空间关系直观、可印刷清晰度

DCDesigner 的顶栏「导出」是一个合并入口：一个下载图标 + 下拉菜单（PNG 图片 / DXF 图纸 / CSV 清单），三个导出动作与工勘向导第 4 步完全等价；菜单在导出后、再点按钮、点菜单外或按 Esc 时自动收起。

二、2D 平面图 PNG：给「看的人」

导出的是完整平面图，与当前屏幕缩放/平移的可见范围无关：

  • 自动取景：按全部对象（墙/桥架含半宽、旋转矩形四角、门窗按挂墙洞口）的世界包围盒取景，全图白底入画，四周留白 800mm；
  • 固定模数网格：随图绘制 600×600 地板模数网格，不随导出比例自适应降级——大机房导出仍是 600 网格；
  • 观感一致：先按「屏幕适合窗口」的逻辑比例布局（文字/线宽观感与屏幕一致），再把画布整体超采样放大（矢量重绘，文字与线宽同步放大，不糊不虚）；
  • 输出规格：长边基准8192px、总像素预算32M（超过浏览器画布上限时自动降档重试）；
  • 落款与比例尺：左下角比例尺、右下角机房名/勘测人/日期随超采样同步放大；
  • 导出无副作用：文件名自动加-平面图后缀，导出过程不影响当前屏幕视图。

这一项最适合作为交付封面、打印张贴、微信/邮件传达的主图。

三、DXF 图纸：给「画的人」

DXF 导出面向 CAD 工具链，按建筑制图惯例组织：

  • 格式与单位：AC1009/R12 最简结构，AutoCAD、中望、浩辰、BricsCAD、LibreCAD 及各类看图软件均可打开；毫米单位 1:1 真实尺寸，坐标与画布一致（西南角原点、X 东 Y 北）；
  • 图层：按对象类型分17 个英文图层IDC-WALLIDC-DOORIDC-WINDOWIDC-GRILLEIDC-COLUMNIDC-BEAMIDC-CABINETIDC-PDUIDC-ACIDC-UPSIDC-BATTERYIDC-EXTIDC-VENTIDC-AISLEIDC-TRAYIDC-DIMIDC-TEXT），ACI 索引色，灭火器为消防红，通道带用 DASHED 虚线、冷蓝热红；
  • 图元表达：墙体按厚度画双线并自动开洞（门=门扇 90° 全开 + 1/4 开启弧、窗=洞口双线、格栅=45° 百叶片且送风蓝/回风绿）；机柜/列头柜/UPS/蓄电池带正面填充色条标识朝向（UPS 带电池组符号、蓄电池带三并排电池单元符号）；灭火器带瓶体 + 压把/喷管符号；空调带风扇圆 + 送风箭头；桥架带菱形交叉网格；框架梁画双边线 + 中线点划并标注编号截面；通道带标注「冷/热通道（封闭）+ 宽度」；
  • 标注：墙长、桥架规格沿构件自动标注；右下角带机房名/勘测人/日期落款；文件名自动加-平面图后缀；
  • 中文兼容：中文全部转义为\U+XXXX（文件纯 ASCII，跨语言环境打开不乱码），文字样式指定宋体（simsun.ttf）保证中文正常显示。

这一项的价值在于可进 CAD 继续深化：设计院拿到的不是一张图片，而是毫米级、分图层、可量可改的图纸底稿。

四、CSV 工程量清单：给「算账的人」

CSV 清单（UTF-8 带 BOM + CRLF 换行，Excel/WPS 双击直接打开、中文不乱码）分三部分：

① 项目信息：项目名称 / 勘测人 / 勘测日期。

② 工程量汇总：按「类别 + 规格」自动聚合：

类别聚合口径举例机房由墙体包围盒反推内空尺寸与面积（矩形精确 / 异形近似）墙体中心线总长（m），与图面墙长标注一致门 / 窗 / 格栅樘/个，带门扇形式、朝向、窗台高等特征柱子 / 框架梁根数；框架梁按类型×截面×混凝土强度×梁顶标高聚合，备注总长机柜台数，备注总功率列头柜台数，含输入电压/电流UPS台数，含容量/后备时间蓄电池台数，规格含电池类型/单只容量，备注只数合计与组电压灭火器具数，规格含类型/充装量空调台数，规格含制冷量地板出风口个数，备注合计风量桥架总长（m），按类型×宽度×距地高度冷/热通道条数，封闭/不封闭；封闭通道含高度与端门配置

③ 设备明细：机柜/列头柜/UPS/蓄电池/灭火器/空调/风口逐台列出——编号、规格、距西/距南位置、电气参数（机柜含功率/RPDU/电压电流/接口配置；UPS 含机型/容量/输出功率/后备时间/冗余；蓄电池含类型/单只容量/只数/组电压；灭火器含类型/充装量；空调含制冷量/风量/送风温度/送风方式），可溯源到每台设备。

含逗号、引号的字段按 RFC 4180 规范转义；清单内容固定中文（属性值本身以中文存储，与界面语言无关），文件名自动加-工程量清单后缀。汇总用于报价与采购数量，明细用于设备对位与进场清点。

五、3D 整机全景：给「做判断的人」

3D 状态下的「PNG 图片」导出的是整机全景图：

  • 取景跟随当前视角（方位/俯仰），透视相机与屏幕同一投影方式、同一 45° 垂直视场角；按模型包围盒自动取景、全模型完整入画（未旋转时即默认的东南上方约 49° 俯视）；
  • 白底、去雾、8192px 基准长边，瓦片分块渲染（单瓦片 ≤4096px）保证低端显卡可导出；程序化纹理同步 4× 密度重制，阴影贴图临时提升至 8192 避免发糊；
  • 左下角比例尺、右下角落款，样式与 2D 导出一致；
  • 支持实景与素模（BIM）两种风格导出——素模导出即白底浅色画面，适合放入方案汇报材料。

与 2D 平面图组合使用：平面图说明「在哪里、多少」，3D 全景说明「长什么样、空间关系如何」。

六、交付前自查清单（8 项）

基于工具能力，建议在导出/提交前按以下清单核对：

  1. 数量核对：向导第 4 步或属性面板汇总的机柜数、门窗数、设备台数是否与现场一致；
  2. 功率与容量：机柜总功率、房间总供电容量、UPS 容量与冗余是否已填写（否则电力类自检无法给出有效结论）；
  3. 合规自检：运行一次自检，确认无 error 级问题；未解决的 warn/info 项记录原因；
  4. 编号连续性：机柜编号是否连续、是否有重号或空洞（可用「重排本排序号」或「检测空位补插」处理）；
  5. 机房信息：机房名称、园区/楼宇、勘测人、日期是否填写（影响落款与 CSV 表头）；
  6. 导出物命名与完整性：PNG/DXF 文件名后缀、CSV 三部分内容是否齐全；
  7. 平台前置条件：如要回传 nVisual Studio，目标视图节点必须为空（平台防覆盖守卫）；
  8. 留档：项目 JSON、导出物与自检报告一并归档，形成可追溯的交付记录。
七、边界
  • PNG 与 DXF 是工勘记录与平面交付级图纸：DXF 可进 CAD 深化，但不含施工节点详图、系统图与计算书；
  • CSV 清单内容固定中文，含逗号字段按 RFC 4180 转义；这是为「清单作为工程文件」做的一致性取舍；
  • 2D 平面图导出使用固定 600mm 模数网格，不含其他网格体系；
  • 3D 全景的取景角度依赖导出时的当前视角，若需固定视角，请先调整相机再导出（界面状态按标签页会话记忆，刷新不丢）。

附：事实来源与核验方式

  • 2D PNG：README.md「2D 平面图全景高清 PNG 导出」；实现见public/js/render.js（导出分支）/public/js/main.js；回归node tests/png-grid.cdp.mjs
  • DXF：README.md「DXF 图纸导出」；实现见public/js/dxf.jsLAYERS共 17 个）；单测node tests/dxf.test.mjs
  • CSV：README.md「CSV 工程量清单导出」；实现见public/js/csv.jsbuildBOQ）；单测node tests/csv.test.mjs
  • 3D 全景：README.md「整机 3D 全景导出」；实现见public/js/3d/export3d.js
  • 导出合并入口：public/js/exportmenu.js；回归node tests/export-menu.cdp.mjs
  • 可复现核验：

node tests/dxf.test.mjsnode tests/csv.test.mjsnode tests/png-grid.cdp.mjsnode tests/export-menu.cdp.mjs