ComfyUI-PascalEditor：在 ComfyUI 中直接构建 3D 建筑，一键截图生成 ControlNet 底图

ComfyUI-PascalEditor 是一款ComfyUI的插件，它将功能强大的 Pascal Editor（全功能 3D 建筑编辑器）无缝集成到了 ComfyUI 的工作流中。

• GitHub：https://github.com/jtydhr88/ComfyUI-PascalEditor
• Pascal Editor：https://github.com/pascalorg/editor

从此，你不再需要切换到 Blender、SketchUp 或其他外部 3D 软件来搭建场景。你可以在 ComfyUI 的节点界面中直接创建墙体、地板、屋顶、门窗，设计好布局后，一键自动截图作为图像输出，直接传递给 ControlNet、img2img 或 IP-Adapter 进行后续的 AI 生成。

这实现了从“3D 白模搭建”到“AI 渲染出图”的全流程闭环，极大地提升了建筑可视化、室内设计及场景概念设计的效率。

核心功能亮点

1. 原生 3D 建筑编辑

无需离开 ComfyUI，即可在节点内嵌的编辑器中进行专业级建模：

• 基础构件：快速绘制墙体、地板、天花板。
• 建筑元素：一键添加门窗、楼梯、屋顶结构。
• 区域划分：定义房间区域和功能分区。
• 实时预览：所见即所得的 3D 视口，支持旋转、缩放、平移。

2. 自动化截图工作流 (杀手级功能)

这是该插件最核心的价值：

• 自动捕获：当工作流运行时，节点会自动捕获当前 3D 视口的画面。
• IMAGE 输出：截图直接作为标准的 IMAGE 信号输出。
• 无缝对接：可直接连接到 ControlNet (Canny/Depth/Lineart)、Preview Image 或 Save Image 节点。
• 意义：彻底解决了“为了跑 ControlNet 还要先去别的软件截个图”的繁琐流程，实现了真正的自动化批量化生产。

3. 智能分辨率控制

• 自定义尺寸：节点提供 width 和 height 输入，可动态控制输出图片的大小。
• 无损缩放：采用 中心裁切 + LANCZOS 算法 进行缩放，确保建筑比例不发生拉伸变形，完美适配 SDXL 或 SD1.5 的不同分辨率需求。

4. 数据持久化与导出

• 场景保存/加载：将复杂的建筑布局保存为 .json 文件，随时在不同工作流或会话中重新加载，方便复用模板。
• 多格式模型导出：通过节点按钮，可将当前场景导出为 GLB (Web/实时渲染)、STL (3D 打印) 或 OBJ (通用交换) 格式。

5. 极致编辑体验

• 全屏模式：点击按钮或顶部菜单，可在独立的全屏对话框中打开编辑器，获得更大的操作空间。
• 灵活 UI：侧边栏和工具栏支持折叠、拖拽，最大化视口面积。
• 快捷访问：ComfyUI 顶部菜单栏新增 Pascal Editor 入口，随时唤起。

安装指南

只需一步，即可将强大的 3D 编辑器带入 ComfyUI：

cd ComfyUI/custom_nodes
git clone https://github.com/pascalorg/ComfyUI-PascalEditor.git

• 安装完成后，重启 ComfyUI。
• 在节点搜索栏输入 Pascal Editor 即可找到该节点（分类在 PascalEditor 下）。

使用方法与工作流示例

基础工作流：从建模到 AI 出图

1. 添加节点：在工作流中放入 Pascal Editor 节点。
2. 设计场景：
   • 点击节点上的 Fullscreen 按钮（或顶部菜单），进入全屏编辑模式。
   • 使用工具栏绘制墙体、添加门窗、铺设地板，搭建一个简单的房间或建筑外观。
   • 调整摄像机角度到你想要的构图。
3. 连接下游：
   • 将节点的 image 输出端口连接到 ControlNet Apply 节点的 image 输入。
   • 选择 ControlNet 模型（如 control_v11p_sd15_canny 或 depth_midas）。
4. 配置参数：
   • 在 Pascal Editor 节点上设置 width (如 1024) 和 height (如 1024)，以匹配你的大模型分辨率。
5. 运行队列：
   • 点击 "Queue Prompt"。
   • 插件会自动截取当前 3D 视图 -> 传给 ControlNet -> 生成最终的 AI 渲染图。

高级玩法

• 批量生成不同视角：结合 Python 脚本或动态提示词，在不同帧自动旋转摄像机，批量生成建筑的多角度效果图。
• 风格测试：保持 3D 白模不变，仅修改 Prompt 和 LoRA，快速测试同一建筑在不同风格（现代、古典、赛博朋克）下的表现。
• 资产库管理：利用 Save Build / Load Build 功能，建立自己的常用户型或建筑组件库（JSON 文件），实现模块化快速搭建。

适用场景

节点功能详解