Web Blender 用户手册

UM-1.0.0 · 2026-11-13 · Blender 5.2.0 LTS

Web Blender 用户手册

本手册对标当前 Web Blender(?ui=web)的实际功能,按真实界面和真实操作步骤编写。工程保存、重开和恢复使用浏览器 OPFS;需要本地文件时使用独立的“下载”动作。手册不宣称完整桌面 Blender parity,未实现项在支持矩阵和限制章节中如实列出。

存储规则
  • 顶栏“保存项目”、Ctrl+S、文件 → 保存到浏览器 OPFS、另存为、自动恢复点只写浏览器存储。
  • 需要本地 .blend 时,手动使用顶栏“下载 .blend”或文件 → 下载 .blend 到本地。
  • PNG、GLB、CSV、诊断报告等下载都是独立的手动动作。
  • 清除站点数据会删除 OPFS 工程、最近项目索引和偏好设置。

第 1 章 · 入门 · Layout

快速开始:首次加载、打开工程与第一次保存

从浏览器打开 Web Blender,等待 WASM 就绪,载入练习工程并把工程保存到 OPFS。

本章目标

  • 识别 WASM 首次加载状态
  • 打开 .blend 并确认 SceneIR
  • 完成一次 OPFS 保存
  1. 1. 打开 Web 界面

    在 Chromium 访问 /?ui=web,等待底栏显示 WASM 就绪与 Engine: SceneIR。远端首次加载需要下载约 79 MB wasm,页面会显示进度。

    Web Blender 顶栏、工作区标签、视口、大纲与属性面板
    图 1.1 打开 Web 界面
  2. 2. 载入练习工程

    点击顶栏“打开 .blend”,选择课程工程 studio.blend(绝对路径:/home/mes123456/workinf_Blender_Wasm/web/app/public/tutorial/pbr/studio.blend),等待对象数变为 6。

    文件菜单与打开 .blend 入口
    图 1.2 载入练习工程
  3. 3. 保存到 OPFS

    点击顶栏“保存项目”。状态栏显示 SUCCEEDED 后,工程已写入浏览器 OPFS;此动作不会下载文件。

    保存项目按钮与保存成功状态
    图 1.3 保存到 OPFS

完成检查

  • 底栏 Engine 显示 SceneIR
  • 对象数与工程文件一致
  • 保存状态为 SUCCEEDED

提示

  • 用 F3 搜索“打开”“保存到浏览器 OPFS”也可以执行同一入口。

限制 / 不支持

  • 本地文件不会自动出现;需要时使用“下载 .blend”。

相关链接

第 2 章 · 入门 · Layout

界面总览:工作区、编辑器、状态栏与命令搜索

认识 11 个工作区、区域、状态栏和 F3 操作搜索,知道在哪里找命令与反馈。

前置:第 1 章

本章目标

  • 切换工作区
  • 识别状态栏反馈
  • 用 F3 搜索并执行命令
  1. 1. 认识工作区

    顶部工作区标签包括 Layout、Modeling、Sculpting、UV Editing、Texture Paint、Shading、Animation、Rendering、Compositing、Geometry Nodes、Scripting;每个工作区有固定的默认区域布局。

    顶部工作区标签与整体界面
    图 2.1 认识工作区
  2. 2. 使用状态栏

    底栏显示活动对象、对象/顶点/面数量、WASM 与 Engine 状态、存储预算和版本;操作失败时先看 Engine 状态。

    底部状态栏和保存状态
    图 2.2 使用状态栏
  3. 3. F3 命令搜索

    按 F3,输入命令名(如“移动”“Export GLB”),选择带执行位置标签的条目。原生命令可能显示 DESKTOP/SERVER_NATIVE;浏览器等价命令显示 BROWSER。

    F3 操作搜索面板与命令结果
    图 2.3 F3 命令搜索

完成检查

  • 11 个工作区标签齐全
  • F3 能搜索到命令
  • 状态栏能看到 Engine/存储状态

提示

  • F3 搜索是找隐藏入口的首选,不必先猜菜单位置。

限制 / 不支持

  • 灰色菜单项或带 unavailable 标记的命令尚未实现等价入口。

第 3 章 · 入门 · Layout

文件与工程:新建、打开、最近项目、另存为与保存副本

掌握当前 Web 版的工程文件入口,理解另存为写 OPFS、保存副本才下载本地副本。

前置:第 1 章

本章目标

  • 新建/打开工程
  • 使用最近项目
  • 区分另存为与保存副本
  1. 1. 新建与打开

    文件 → 新建 → 常规创建默认场景;文件 → 打开或顶栏“打开 .blend”载入工程。打开期间状态栏显示读取进度,可取消。

    文件菜单中的新建与打开入口
    图 3.1 新建与打开
  2. 2. 最近项目

    顶栏“最近项目”下拉或文件 → 最近打开列出显式保存过的工程;条目损坏时会提示“项目内容缺失/校验失败”,可移除引用。

    最近项目菜单与工程条目
    图 3.2 最近项目
  3. 3. 另存为与保存副本

    另存为在 OPFS 创建并切换到新工程,不下载;保存副本下载本地 .blend,且不改变当前工程。需要本地工程时也可用顶栏“下载 .blend”。

    顶栏保存与下载入口
    图 3.3 另存为与保存副本

完成检查

  • 最近项目能重开已保存工程
  • 另存为后工程名/项目切换
  • 保存副本产生下载文件

提示

  • 同名 .blend 会映射到同一个 OPFS 项目;需要隔离时使用另存为。

限制 / 不支持

  • “另存为会下载”是过时说明;当前只写 OPFS。

第 4 章 · 入门 · Layout

浏览器存储:OPFS 保存、重开与手动本地下载

理解 OPFS 工程布局、最近项目索引、恢复点与手动下载的边界。

前置:第 1 章、第 3 章

本章目标

  • 说明 OPFS/IndexedDB 分工
  • 保存并重开工程
  • 手动下载 .blend
  1. 1. 保存到 OPFS

    保存项目写入 projects/<projectId>/scene.blend 及元数据;快照、资源与恢复点也在同一项目目录下。工程不会出现在浏览器下载目录。

    保存到 OPFS 后的状态栏反馈
    图 4.1 保存到 OPFS
  2. 2. 刷新并重开

    刷新页面后,在最近项目中选择刚保存的工程;若询问是否保存当前修改,选择“不保存,继续”。对象、材质、UV/节点等 Main 数据应恢复。

    刷新后从最近项目重开工程
    图 4.2 刷新并重开
  3. 3. 手动下载 .blend

    顶栏“下载 .blend”或文件 → 下载 .blend 到本地会先把工程提交到 OPFS,再下载 <工程名>.blend。外部未打包资源不会自动包含。

    手动下载 .blend 的顶栏入口
    图 4.3 手动下载 .blend

完成检查

  • 重开后对象数一致
  • 本地下载只在手动动作后出现
  • 状态栏显示 OPFS 保存成功

提示

  • 课程与测试的重开流程都使用最近项目/OPFS,不依赖自动下载。

限制 / 不支持

  • 清除站点数据会删除 OPFS 工程与最近项目索引;本地 .blend 是持久备份。

第 5 章 · 入门 · Layout

撤销、自动恢复点、恢复与诊断

使用撤销/重做、浏览器自动恢复点、最近项目修复和诊断报告处理错误。

前置:第 4 章

本章目标

  • 撤销/重做 Main 编辑
  • 恢复自动恢复点
  • 导出诊断报告
  1. 1. 撤销与重做

    编辑 → 撤销/重做,或 Ctrl+Z/Ctrl+Y;撤销历史列出可回退的 Main 版本。工作区切换不会产生 Main 撤销步。

    自动恢复点对话框
    图 5.1 撤销与重做
  2. 2. 恢复自动恢复点

    文件 → 恢复 → 恢复浏览器恢复点,选择项目和恢复点后点“恢复选中版本”。自动恢复点不标记工程已保存,也不更新最近项目。

    选择项目和恢复点的恢复对话框
    图 5.2 恢复自动恢复点
  3. 3. 诊断与修复

    最近项目损坏时可按条目移除引用;失败操作可点击顶栏“!”或帮助 → 导出诊断报告,生成 blender-web-diagnostics.json。

    恢复与诊断入口所在对话框
    图 5.3 诊断与修复

完成检查

  • 撤销后数据回到上一版本
  • 恢复点能载入指定 revision
  • 诊断 JSON 可下载

提示

  • 恢复点只保留最近数份;重要节点前先保存 OPFS 工程。

限制 / 不支持

  • 恢复点是浏览器存储,不替代本地备份;原生 autosave 是另一套入口。

第 6 章 · 入门 · Layout

工作区与 Area 布局:切换、⋮ 菜单、分割与持久化

用区域右上角选择器切换编辑器,用 ⋮ 菜单分割/合并/交换/最大化区域,并保存布局。

前置:第 2 章

本章目标

  • 切换区域编辑器
  • 分割和合并区域
  • 重开后恢复布局
  1. 1. 切换编辑器

    每个区域右上角有编辑器选择器,可切换为 3D Viewport、Outliner、Properties、Spreadsheet、节点编辑器、Image Editor、Text Editor、Python Console、Timeline/Graph 等。

    区域右上角编辑器选择器与 ⋮ 菜单
    图 6.1 切换编辑器
  2. 2. 分割与合并

    打开区域 ⋮ → 水平/垂直分割;合并/停靠选择相邻方向;交换编辑器、复制区域、最大化/聚焦、关闭和重置布局也在同一菜单。首次操作会把当前工作区切换为自定义布局。

    分割后的双属性区域与区域菜单
    图 6.2 分割与合并
  3. 3. 布局持久化

    布局、编辑器覆盖和每视口相机锁定写入 OPFS settings/web-interface.json;刷新页面后恢复。选择“重置工作区布局”回到默认 CSS 布局。

    自定义区域布局
    图 6.3 布局持久化

完成检查

  • 区域可切换编辑器
  • 分割/合并后区域数量正确
  • 刷新后布局保留
  • 重置恢复默认

提示

  • 区域头部的 ⋮ 与右上角浮动 ⋮ 打开同一个菜单。

限制 / 不支持

  • 复制区域用拆分承载,不创建新浏览器窗口;暂无拖拽分隔条 resize。

第 7 章 · 基础 · Layout

3D 视口:导航、选择、变换与相机视图

使用鼠标与键盘导航视口,选择对象/网格元素,执行变换并进入相机视图或锁定相机。

前置:第 6 章

本章目标

  • 旋转/平移/缩放视口
  • 选择对象与网格元素
  • 切换相机视图并锁定
  1. 1. 导航

    中键拖动旋转,Shift+中键平移,滚轮缩放;小键盘 1/3/7 切换轴视图,5 切换透视/正交,Home 显示全部,Numpad . 框显所选。

    Layout 工作区 3D 视口与导航工具栏
    图 7.1 导航
  2. 2. 选择与变换

    左键选择对象,Ctrl/Shift 追加/范围选择;G/R/S 进入移动/旋转/缩放。编辑模式支持顶点/边/面选择(快捷栏 1/2/3)。

    编辑模式网格元素选择
    图 7.2 选择与变换
  3. 3. 相机视图与锁定

    按 Numpad0 或工具栏“相机视图”对齐场景相机;再次触发恢复上一视图。未锁定时 orbit 被拒绝,pan/zoom 只做取景;“锁定相机”(Camera to View)允许导航并把相机 pose 写回对象,Ctrl+Alt+Numpad0 对齐相机到当前视图。

    相机视图按钮与锁定按钮状态
    图 7.3 相机视图与锁定

完成检查

  • 轴视图与透视切换正常
  • 编辑模式选择模式可切换
  • Numpad0 进入/退出相机视图
  • 锁定后导航改变相机并可撤销

提示

  • 相机锁定按视口保存,刷新后保留。

限制 / 不支持

  • 未实现 object-as-camera、自动关键帧/约束/父级 lock 分支。

相关链接

第 8 章 · 基础 · Layout

Outliner:层级、选择、可见性、重命名与拖放

在大纲视图中选择对象、展开层级、切换可见性、重命名、remap 数据和拖放父子/集合。

前置:第 7 章

本章目标

  • 选择与展开层级
  • 重命名/可见性
  • 拖放建立父子或移动集合
  1. 1. 选择与层级

    单击对象行选中;Ctrl 追加,Shift 范围选择;展开按钮或左右方向键展开/折叠,Home/End 与上下键导航。

    大纲视图对象选择与层级
    图 8.1 选择与层级
  2. 2. 重命名与可见性

    双击名称或 F2 行内重命名;眼睛按钮切换可见性。链接库对象/数据不可重命名或 remap。

    大纲视图对象行、可见性与重命名
    图 8.2 重命名与可见性
  3. 3. 拖放与 Remap

    对象拖到对象行建立父子(Shift 允许,Alt 保持变换);拖到集合移动/链接(Ctrl 链接);右键/Shift+F10 打开数据菜单执行 Rename/Remap Users。

    大纲视图拖放与数据菜单入口
    图 8.3 拖放与 Remap

完成检查

  • 选择与范围选择正确
  • 重命名进入 Main
  • 拖放后父子/集合关系正确

提示

  • 大纲头部提供全选/清除/反选/切换与刷新。

限制 / 不支持

  • 原生 outliner 上下文不可用时使用简化树;搜索过滤只在简化树可用。

第 9 章 · 基础 · Layout

Properties:对象、修改器、材质与场景属性

使用右侧属性面板查看和编辑变换、层级、修改器、材质、相机、灯光、世界、渲染和物理设置。

前置:第 7 章、第 8 章

本章目标

  • 找到属性分组
  • 用标签跳转
  • 编辑并提交属性
  1. 1. 属性分组

    属性面板按 Object & Hierarchy、Modifier Stack、Material Slots、Camera/Light/World、Scene/Render、Physics、View Layer 等分组纵向排列;修改后写入 Main 并可撤销。

    属性面板中的变换与对象分组
    图 9.1 属性分组
  2. 2. 对象/修改器/材质标签

    左侧三个标签分别跳转到对象变换、Modifier Stack、Material Slots。标签会更新选中状态并滚动到目标段落。

    属性面板三个跳转标签与修改器段落
    图 9.2 对象/修改器/材质标签
  3. 3. 编辑与只读状态

    数值/下拉/按钮直接提交;链接对象、相机、集合和材质显示只读提示。相机属性要求单用户数据块。

    修改器栈与参数编辑
    图 9.3 编辑与只读状态

完成检查

  • 标签能跳转并选中
  • 修改属性后视口更新
  • 只读链接数据不能编辑

提示

  • F3 搜索属性名可快速定位命令,例如 Modifier/Decimate。

限制 / 不支持

  • 不是完整 RNA 属性浏览器;部分场景/渲染字段以离散按钮呈现。

第 10 章 · 基础 · Modeling

对象模式:创建、复制、重命名、父子与 Join

创建基础体、复制/链接复制、重命名、删除、父子关系和 Join 合并。

前置:第 7 章

本章目标

  • 创建对象
  • 复制与清理
  • 建立父子/Join
  1. 1. 创建对象

    Modeling 快捷栏的 Add CUBE/PLANE/UV SPHERE/MONKEY 或菜单“添加”创建对象;也可 F3 使用原生 primitive 操作。

    Modeling 工作区与对象添加快捷栏
    图 10.1 创建对象
  2. 2. 复制、重命名、删除

    Shift+D 复制,Alt+D 链接复制,F2 重命名,Delete 删除;删除与取消都可撤销。

    对象模式快捷工具
    图 10.2 复制、重命名、删除
  3. 3. 父子与 Join

    选中多个对象后 Parent/Unparent 设置或清除父级;Join 合并为一个对象。父级操作可保留或清除变换。

    对象模式下的父级与合并按钮
    图 10.3 父子与 Join

完成检查

  • 新对象出现在 Outliner
  • 复制/删除后对象数正确
  • Join 后活动对象网格包含其他对象

提示

  • 活动对象决定 Join 后的名称和数据。

限制 / 不支持

  • 部分高级对象/集合操作仅在菜单或 F3 中提供。

第 11 章 · 基础 · Modeling

网格编辑与雕刻范围

进入编辑模式执行选择/挤出/倒角/环切/细分,并在雕刻模式使用有限的笔刷与重构。

前置:第 10 章

本章目标

  • 进入编辑模式
  • 执行常用拓扑操作
  • 使用雕刻笔刷/面组
  1. 1. 进入编辑模式

    Modeling 工作区点击模式按钮选择编辑模式;快捷栏切换 Vertex/Edge/Face,Select All 后执行 MERGE/DISSOLVE/EXTRUDE/INSET/BEVEL/LOOP_CUT/SUBDIVIDE 等。

    编辑模式下的网格与元素选择
    图 11.1 进入编辑模式
  2. 2. 常用操作

    面模式可 TRIANGULATE/Recalculate Normals;边模式可 BRIDGE_LOOPS;操作失败时先确认选择模式与元素数量。

    网格元素全选与拓扑操作按钮
    图 11.2 常用操作
  3. 3. 雕刻范围

    Sculpting 工作区属性面板提供 Draw/Inflate/Grab/Smooth、半径/强度/压力/对称、遮罩、面组和 Voxel Remesh;笔刷从属性面板应用到当前网格,不是连续笔触。

    属性面板中的雕刻与网格设置
    图 11.3 雕刻范围

完成检查

  • 编辑模式可切换选择模式
  • 拓扑操作后网格更新
  • 雕刻参数/遮罩写入属性

提示

  • 破坏性操作后可用撤销恢复;高面数操作注意存储/性能。

限制 / 不支持

  • 无完整建模工具箱、框选/套索网格选择与连续雕刻笔触;高级操作依赖菜单/F3。

相关链接

第 12 章 · 基础 · Modeling

修改器栈:添加、排序、参数、可见性与应用

在 Modifier Stack 中添加 Bevel/Boolean/Mirror/Array 等修改器并管理堆栈。

前置:第 9 章

本章目标

  • 添加修改器
  • 调整参数/顺序
  • 应用或移除
  1. 1. 添加修改器

    Properties → Modifier Stack 输入修改器类型并 Add;列表显示名称、类型、参数和 V/R/E/C 可见性。

    Modifier Stack 与修改器参数
    图 12.1 添加修改器
  2. 2. 排序与参数

    用 ↑/↓、Move to First/Last 调整求值顺序;编辑参数后视口更新。Decimate 提供 Collapse/Un-Subdivide/Dissolve Planar、比例/目标三角面与预览/应用。

    修改器排序和 Decimate 参数
    图 12.2 排序与参数
  3. 3. 应用、复制、移除

    Apply 写入网格并移除修改器;可存为形态键、复制到选中、按名称移除;R 列控制渲染可见性。

    属性面板中的修改器与对象设置
    图 12.3 应用、复制、移除

完成检查

  • 修改器按顺序求值
  • 参数变化视口更新
  • Apply 后网格变化

提示

  • Boolean 需要封闭网格;Mirror/Array 依赖原点与间距。

限制 / 不支持

  • 仅支持已接线的修改器类型;参数以类型元数据生成。

第 13 章 · 基础 · Modeling

非网格对象:曲线、曲面、文本、字体、融球与 Grease Pencil

从添加菜单创建曲线/文本/融球/Grease Pencil,编辑控制点或文本,导入本地字体。

前置:第 10 章

本章目标

  • 创建非网格对象
  • 编辑曲线/文本
  • 导入 TTF/OTF/PFB
  1. 1. 创建非网格

    添加菜单包含 Bezier/NURBS 曲线、曲面、文本、骨架、融球、体积、晶格、点云、毛发、Grease Pencil 与力场。

    Modeling 工作区与添加入口
    图 13.1 创建非网格
  2. 2. 曲线/文本编辑

    编辑模式下曲线菜单提供挤出、复制、循环、手柄类型、样条类型、分离、细分、平滑、反向等;文本属性可编辑正文与布局。

    编辑模式与对象编辑界面
    图 13.2 曲线/文本编辑
  3. 3. 导入字体

    文本属性 → Import TTF/OTF/PFB 选择本地字体(绝对路径任选);字体写入 OPFS 资源并打包进 Main,可设置 Regular/Bold/Italic 链接。

    属性面板中的字体/数据设置
    图 13.3 导入字体

完成检查

  • 非网格对象出现在 Outliner
  • 曲线控制点可编辑
  • 字体导入后文本外观变化

提示

  • 字体文件会进入当前工程资源;保存 OPFS 后重开仍可用。

限制 / 不支持

  • 非网格数据的高级编辑受当前 Web 能力矩阵限制;部分操作仅原生/F3。

第 14 章 · 进阶 · UV Editing

UV 编辑:选择、展开、打包、变换与缝合

进入可写 UV 区域,全选/变换/展开/打包/缝合 UV,并保存重开。

前置:第 11 章

本章目标

  • 进入 UV 编辑
  • 展开并打包
  • 保存重开 UV
  1. 1. 进入可写 UV 区域

    选中网格,切换到 UV Editing;桌面 Blender 要求 OB_MODE_EDIT,点击“编辑模式”进入。左侧 UV 编辑器显示原生 UV 选择。

    UV Editing 工作区与原生 UV 编辑器
    图 14.1 进入可写 UV 区域
  2. 2. 选择与展开

    点击“全选 UV”,等待“UV 选择已提交”,再点“展开所选 UV”;可选择角度/共形/最小拉伸、边距、UDIM 目标与自定义区域。

    展开后的 UV 岛与选择状态
    图 14.2 选择与展开
  3. 3. 打包、变换、缝合

    “打包 UV 岛”设置间距;变换控件执行移动/旋转/缩放;缝合控件使用缝合模式/距离。保存 OPFS 后重开,UV 与选择仍保留。

    UV 展开结果与控件
    图 14.3 打包、变换、缝合

完成检查

  • UV 选择提交成功
  • 展开/打包改变 UV 布局
  • 保存重开后 UV 不变

提示

  • 展开前标记缝合线可得到更整齐的 UV 岛。

限制 / 不支持

  • 编辑依赖可写原生 UV 区域;无完整 UV sculpt/高级工具。

相关链接

第 15 章 · 进阶 · Shading

材质与 Shader Editor:Principled、图像与预览

创建/分配材质,在节点画布编辑 Principled 与图像节点,预览并打包外部贴图。

前置:第 9 章

本章目标

  • 分配材质
  • 编辑节点/连接
  • 设置图像节点
  1. 1. 选择材质

    Shading 工作区上方选择材质;Properties → Material Slots 添加/分配材质。链接材质显示只读。

    Shading 工作区、材质槽与节点编辑器
    图 15.1 选择材质
  2. 2. 节点画布

    启用默认节点生成 Principled + Material Output;添加节点、拖拽节点、连接 socket、重命名、删除、编辑 socket 值和属性。支持 RGB/Value/Mix/Math/Mapping/坐标/UV/分离颜色/对象信息/图像/法线/凹凸/Principled/Output 14 类。

    Shader Editor 节点与材质预览
    图 15.2 节点画布
  3. 3. 图像与预览

    Image Texture 选择 packed 图像或色彩空间;外部图片通过“外部贴图”入口导入 OPFS 后打包;右侧材质球显示预览,可保存缩略图。

    材质预览与资产库材质卡片
    图 15.3 图像与预览

完成检查

  • 材质槽分配成功
  • 节点连接后预览变化
  • 图像节点使用正确贴图

提示

  • Principled 的 Base Color/Roughness/Metallic 会直接影响 PBR 渲染。

限制 / 不支持

  • 仅 14 类节点;未知节点会显示不支持并阻止图验证。

相关链接

第 16 章 · 进阶 · Shading

PBR/RE 资产库、Append/Link 与 packed 图像

从 PBR/RE 资产库加载模型/材质,理解 Append/Link 与 packed 资源。

前置:第 15 章

本章目标

  • 筛选/搜索资产
  • 双击添加/分配
  • 修复资产库
  1. 1. 选择资产源

    Shading 左下 PBR 资产库可选择 pbr-library、re-pbr 或 HQ 源,按类型/目录/来源筛选,搜索资产名。

    PBR 资产库搜索、筛选与资产卡片
    图 16.1 选择资产源
  2. 2. 添加或分配

    双击模型添加到场景,双击材质分配到当前材质槽;也可用“添加到场景”“分配到材质槽”。资产库元数据与预览存 OPFS/IndexedDB。

    RE PBR 材质卡片与分配结果
    图 16.2 添加或分配
  3. 3. packed 与修复

    材质贴图以 packed 图像进入工程,Properties → Resources 显示 packed 资源;缺失时点“修复资产库”重建。库链接图像绘制前需在 Texture Paint “设为本地”。

    纹理绘制中的 packed 图像与绘制结果
    图 16.3 packed 与修复

完成检查

  • 资产卡可见/可筛选
  • 双击材质改变材质槽
  • packed 图在重开后仍存在

提示

  • RE 5000PBR 有 6 张材质;HQ 源提供 2048 贴图。

限制 / 不支持

  • 库链接对象/材质只读;仅图像有 Make Local 绘制路径。

相关链接

第 17 章 · 进阶 · Texture Paint

Texture Paint:画笔、撤销/重做、Make Local 与 OPFS

在 packed 图像上绘制,一次笔画一次提交,撤销/重做并保存重开;库链接图先本地化。

前置:第 15 章、第 16 章

本章目标

  • 选择图像
  • 绘制/擦除
  • 撤销/重做与持久化
  1. 1. 选择纹理图像

    Texture Paint 顶部“纹理图像”只列出 packed 图像;没有图像时先在 Shading 分配带 Base Color 图的材质。

    Texture Paint 图像选择与画布
    图 17.1 选择纹理图像
  2. 2. 绘制笔画

    选择绘制/擦除、颜色、大小、强度,在画布按住拖动;松开后显示“笔画已提交”,一次笔画一个 Main revision。

    在贴图上绘制白色笔画后的结果
    图 17.2 绘制笔画
  3. 3. 本地化与恢复

    库链接图像先选择“库链接图像”并点“设为本地”,再绘制;可撤销/重做笔画,保存 OPFS 后重开像素仍保留。

    纹理绘制撤销/重做与保存状态
    图 17.3 本地化与恢复

完成检查

  • 画布像素变化
  • 撤销恢复原图
  • 重开后笔画仍在

提示

  • 图像越大 PNG 编码越慢;课程使用 1024×1024。

限制 / 不支持

  • 仅二维 packed 图像;不做 UDIM/投影/4K 生产级绘制。

第 18 章 · 进阶 · Geometry Nodes

Geometry Nodes 与 Spreadsheet

在画布中添加 allowlist 节点、连线、编辑 socket、提交图,并在 Spreadsheet 检查数据。

前置:第 11 章

本章目标

  • 添加/连线节点
  • 提交 GN 图
  • 检查 Spreadsheet 数据
  1. 1. 打开 GN 画布

    选中网格,切换到 Geometry Nodes;画布显示当前图,检查器显示节点/socket 属性。

    Geometry Nodes 画布与检查器
    图 18.1 打开 GN 画布
  2. 2. 添加与连线

    选择 allowlist 节点(Group Input/Output、Transform、Set Position、Join/Separate Geometry、Realize Instances、Store Named Attribute、输入/比较/数学、Object/Collection/Image Info 等),拖拽端口连线,修改 socket 默认值。

    添加 Transform 节点并连接后的 GN 画布
    图 18.2 添加与连线
  3. 3. 提交与检查

    点击“提交图”写入原生节点树;下方 Spreadsheet 切换对象/顶点/边/面/UV/属性,过滤/列/CSV。

    Spreadsheet 顶点表与过滤
    图 18.3 提交与检查

完成检查

  • 节点/连线/属性提交成功
  • 几何随图更新
  • Spreadsheet 行数据正确

提示

  • 保存重开会保留节点、连线与位置。

限制 / 不支持

  • 仅 16 类 allowlist 节点;无 Simulation Zone;Spreadsheet 只读当前网格缓冲。

相关链接

第 19 章 · 基础 · Animation

Timeline、Dope Sheet 与关键帧动画

跳帧、插入/删除 Loc/Rot/Scale 关键帧、播放并管理 Action。

前置:第 7 章

本章目标

  • 跳帧与播放
  • 插入关键帧
  • 管理 Action/插值
  1. 1. 时间线

    Animation 底部 Timeline 可跳到首/末帧、上一/下一帧、播放/暂停;当前帧输入框可直接跳转。

    Animation 工作区时间线与 Dope Sheet
    图 19.1 时间线
  2. 2. 关键帧

    选中对象,在目标帧点击 Loc/Rot/Scale 插入关键帧,Del Key 删除当前帧;Dope Sheet 显示关键点与当前帧。

    Dope Sheet 关键帧与时间线
    图 19.2 关键帧
  3. 3. Action 与插值

    Action name/New Action/Remove Action/活动 Action 管理动画;F-Curve 插值可选 Constant/Linear/Bezier;Fake User 防止 Action 被清理。

    Action 与关键帧插值控件
    图 19.3 Action 与插值

完成检查

  • 关键帧出现在当前帧
  • 播放推进帧号
  • Action 切换生效

提示

  • Web 播放是本地帧步进,不是原生动画求值/音频播放。

限制 / 不支持

  • 无完整原生播放/音频;部分多通道编辑器只暴露首条曲线。

相关链接

第 20 章 · 进阶 · Animation

Graph Editor、NLA 与驱动器

在 Graph Editor 查看/拖动关键帧、切换插值;用 NLA 表单管理轨道/条带和驱动器表达式。

前置:第 19 章

本章目标

  • Graph 查看/拖动关键帧
  • 插入/删除关键帧
  • NLA/驱动器入口
  1. 1. Graph 曲线

    Animation 工作区 Graph Editor 列出通道,显示曲线与关键点;勾选通道显隐,滚轮缩放,按钮框显全部。

    Animation 工作区中的 Graph Editor 区域
    图 20.1 Graph 曲线
  2. 2. 编辑关键帧

    点击关键点选中并拖动;插入/删除关键帧;插值选择 Bezier/Linear/Constant。拖动提交一条 F-Curve 命令。

    Graph Editor 关键帧与插值
    图 20.2 编辑关键帧
  3. 3. NLA 与驱动器

    Timeline 的 NLA 区可选择 Track/Strip,编辑起止、重复、Blend In/Out、Extrapolation 并提交;驱动器表达式/关键帧编辑器在动画属性区。

    NLA 与动画属性区域
    图 20.3 NLA 与驱动器

完成检查

  • Graph 曲线显示正确
  • 拖动改变关键帧
  • NLA 提交生效

提示

  • Graph 是简化 SVG 编辑器;复杂曲线/驱动器使用原生/F3。

限制 / 不支持

  • NLA 是表单式而非完整通道编辑器;驱动器变量/目标未完整暴露。

第 21 章 · 进阶 · Layout

物理、粒子、点缓存与模拟限制

查看并编辑 Soft Body/Rigid Body/Cloth/Fluid/Particle 设置,理解 Web 播放与求解限制。

前置:第 9 章

本章目标

  • 找到物理设置
  • 编辑参数
  • 理解播放/求解边界
  1. 1. 物理工作台

    Properties → Physics 选择 Rigid Body/Soft Body/Cloth/Fluid/Particle,编辑质量、摩擦、弹性、碰撞、缓存等参数。

    属性面板中的物理设置与缓存选项
    图 21.1 物理工作台
  2. 2. 点缓存

    Point Cache 可 Bake All/Free Bake All;在 localOnly/native 路径可执行缓存操作,Web 路径受能力门控。

    属性面板与物理/缓存入口
    图 21.2 点缓存
  3. 3. 模拟播放

    物理求解依赖已校验的桌面/服务器实现;Web 本地播放未接通时状态会返回 PHYSICS_CACHE_PLAYBACK_UNAVAILABLE/PHYSICS_SOLVER_UNAVAILABLE。

    物理设置和运行限制提示
    图 21.3 模拟播放

完成检查

  • 物理类型可切换
  • 参数进入 Main
  • 不支持时明确显示能力码

提示

  • 需要真实求解时使用原生会话/服务器渲染路径。

限制 / 不支持

  • Web 本地模拟播放/求解未接通;仅参数编辑与缓存入口。

第 22 章 · 进阶 · Rendering

相机、灯光、世界与渲染属性

编辑相机镜头/DoF、灯光类型/能量、世界环境、色彩管理和渲染输出。

前置:第 9 章

本章目标

  • 编辑相机/灯光
  • 设置世界/色彩
  • 配置分辨率与输出
  1. 1. 相机

    选中相机,Properties 编辑投影、焦距、near/far、全景/鱼眼与景深(焦点对象/距离/F-stop)。

    Rendering 工作区与相机/渲染面板
    图 22.1 相机
  2. 2. 灯光与世界

    灯光属性编辑类型、形状、diffuse/specular/transmission/volume 因子、衰减/阴影;世界属性编辑曝光、环境强度、AO 与探针分辨率。

    PBR 渲染面板与灯光/世界参数
    图 22.2 灯光与世界
  3. 3. 输出设置

    Scene Render/Output 设置分辨率、百分比、帧范围、输出格式;色彩管理选择 display/view transform/look/exposure/gamma。

    分辨率、相机与视图设置
    图 22.3 输出设置

完成检查

  • 相机/灯光修改影响渲染
  • 世界/色彩设置保存
  • 分辨率与输出格式正确

提示

  • PBR 练习面板提供场景相机对齐与常用参数预设。

限制 / 不支持

  • 部分场景/渲染字段为离散按钮;完整 RNA 字段未全部暴露。

第 23 章 · 进阶 · Rendering

PBR 渲染、Render Result 与手动 PNG 下载

设置分辨率/相机/曝光/位移,执行浏览器 PBR 渲染,检查结果并手动下载 PNG。

前置:第 15 章、第 16 章、第 22 章

本章目标

  • 执行一次 PBR 渲染
  • 检查结果/OPFS
  • 手动下载 PNG
  1. 1. 渲染参数

    Rendering 的 PBR 面板设置视角预设、位移强度、视图(Final/Base Color/Normal/Roughness)、曝光、分辨率 256/512/1024/2048、相机 Viewport/Scene。

    PBR 渲染参数面板
    图 23.1 渲染参数
  2. 2. 执行渲染

    点击“渲染 PBR”,等待纹理/环境就绪并输出结果;结果显示尺寸、字节数和 OPFS hash。浏览器渲染器是 three.js WebGL2 physical-v1,不是 Cycles/EEVEE。

    PBR 渲染结果与 OPFS 信息
    图 23.2 执行渲染
  3. 3. 手动下载/原生渲染

    点击“下载 PNG”保存本地 pbr-<width>.png;Rendering 页面还提供可选的“桌面 EEVEE 渲染”,需原生服务,产物链接需手动点击下载。

    下载 PNG 与渲染结果区域
    图 23.3 手动下载/原生渲染

完成检查

  • 渲染结果尺寸符合设置
  • 结果写入 OPFS
  • PNG 仅在点击下载后保存

提示

  • 深色材质先切 Base Color/Roughness 诊断,避免只凭整体亮度判断。

限制 / 不支持

  • 浏览器 PBR 为简化渲染器;原生渲染依赖服务器/桌面服务。

第 24 章 · 进阶 · Compositing

Compositor:节点画布、执行与保存

创建 RGB/Exposure/Blur/Mix/Alpha Over/Transform/Viewer/Composite 节点,执行 CPU 合成并提交。

前置:第 23 章

本章目标

  • 添加/连线节点
  • 执行合成/Viewer
  • 保存重开图
  1. 1. 节点画布

    Compositing 工作区画布默认包含 Composite;添加节点类型,拖拽端口连接,右侧检查器编辑属性/颜色/图像来源。

    Compositor 画布与默认 Composite 节点
    图 24.1 节点画布
  2. 2. 执行合成

    点击“执行合成”,CPU 求值器显示 Viewer 或 Composite 结果;RGB/Exposure/Invert/Blur/Mix/Alpha Over/Transform 等可用,IMAGE 使用 packed 图,Render Layer 使用最近 PBR 渲染。

    Compositor 执行结果预览
    图 24.2 执行合成
  3. 3. 提交与限制

    点击“提交图”写入原生 CompositorNodeTree;不支持的节点会阻止提交并显示“当前图含无法持久化的节点”。保存 OPFS 后重开保留节点/连线/属性/资源。

    添加 RGB/Exposure 节点并连线
    图 24.3 提交与限制

完成检查

  • 节点/连线/属性提交
  • 执行结果显示
  • 重开后图保留

提示

  • 先执行再提交,便于发现资源/节点限制。

限制 / 不支持

  • 9 类节点;WebGPU allowlist 4 类;Alpha Over factor 不持久化,MIX 仅 RGBA。

第 25 章 · 进阶 · Layout

导入导出矩阵:GLB/GLTF/OBJ/STL/PLY、原生导出与 CSV

按可用性导入/导出模型与数据,明确浏览器本地、原生/F3、不可用三种路径。

前置:第 3 章

本章目标

  • 导入本地模型
  • 导出 GLB/CSV
  • 识别不可用格式
  1. 1. 导入模型/图像/字体

    顶栏“打开 .blend”文件选择器接受 .blend、.gltf、.glb、.obj、.stl、.ply;材质图片、VFont 在对应属性面板导入;资源写入 OPFS。

    文件菜单导入子菜单与格式
    图 25.1 导入模型/图像/字体
  2. 2. 导出

    顶栏“导出 GLB”生成 blender-web.glb;文件 → 导出提供 GLB/GLTF/FBX/OBJ/STL/PLY/USD/ALEMBIC 的原生面板(需服务);浏览器本地仅 GLB/OBJ 可用,其余显示“浏览器导出尚未移植”。

    文件菜单导出子菜单与格式状态
    图 25.2 导出
  3. 3. CSV/诊断

    Spreadsheet“导出 CSV”导出当前过滤/可见列;帮助/顶栏导出诊断 JSON。所有下载均为显式手动动作。

    Spreadsheet 过滤与 CSV 导出入口
    图 25.3 CSV/诊断

完成检查

  • 导入后对象数增加
  • GLB/CSV 仅在点击导出后下载
  • 不可用格式不被承诺

提示

  • GLTF 外部 .bin/纹理不在单文件导入范围;优先使用 GLB。

限制 / 不支持

  • USD/Alembic/FBX 当前依赖原生服务;浏览器本地导出仅部分格式。

第 26 章 · 进阶 · Scripting

脚本:Text Editor、Python Console 与 Info

编辑/运行文本脚本,使用原生 Python 控制台与 Info 状态,理解脚本策略。

前置:第 4 章

本章目标

  • 编辑/应用文本
  • 运行 Python
  • 查看 Info/诊断
  1. 1. Text Editor

    Scripting 上方 Text Editor 选择/创建文本,打开 .py/.txt(≤1 MiB),编辑后必须 Apply 才写入 Main;可下载或运行原生 Python。

    Scripting 工作区文本编辑器与控制台
    图 26.1 Text Editor
  2. 2. Python Console

    Web 模式使用原生会话面板连接/执行/撤销 Main/应用到场景;输出与命令历史可见。脚本受信任/权限/沙箱策略约束。

    Python Console 与 Info 区域
    图 26.2 Python Console
  3. 3. Info 与策略

    Info 显示 Engine 状态与活动场景,不是完整 Blender 操作日志;敏感脚本需显式允许/恢复脚本策略。

    Info 状态与脚本运行结果
    图 26.3 Info 与策略

完成检查

  • 文本 Apply 后执行
  • 控制台执行结果可见
  • 未 Apply 草稿阻止保存

提示

  • 运行前保存 OPFS 工程;脚本可修改 Main。

限制 / 不支持

  • Web 控制台依赖原生会话;Info 不是操作历史;脚本能力受策略/沙箱限制。

相关链接

第 27 章 · 基础 · Layout

Preferences、Keymap、快捷栏与启动工作区

使用分栏偏好设置、OPFS 保存、可改键位、快捷栏显隐和启动工作区。

前置:第 4 章

本章目标

  • 修改并保存偏好
  • 改键/冲突处理
  • 控制快捷栏与启动工作区
  1. 1. 偏好分栏

    编辑 → 偏好设置打开 Web 偏好窗口;界面/视口/动画/输入导航/键位/保存加载/文件/主题/系统分栏,支持项真实生效,不支持项显示“Web 不支持”和桌面来源。

    Web 偏好设置分栏与设置项
    图 27.1 偏好分栏
  2. 2. 键位

    键位页列出 17 个顶层动作;点“录制”按组合键,冲突会被拒绝并提示;保存后写入 OPFS,旧键位失效。

    键位表、录制按钮与冲突提示
    图 27.2 键位
  3. 3. 快捷栏/启动工作区

    界面页控制状态栏、快捷操作栏、区域切换器、启动工作区;保存偏好后刷新,快捷栏显隐与启动工作区生效。

    界面偏好中的快捷栏与启动工作区设置
    图 27.3 快捷栏/启动工作区

完成检查

  • 偏好刷新后保持
  • 键位冲突被拒绝
  • 快捷栏可隐藏
  • 启动工作区生效

提示

  • OPFS 是偏好权威存储,localStorage 只是镜像。

限制 / 不支持

  • 主题/系统/完整键位配置未实现;部分视口/自动保存项标注不支持。

第 28 章 · 进阶 · Layout

故障排查、能力边界与离线/版本说明

按状态栏/诊断/支持矩阵定位问题,理解 OPFS、浏览器、原生服务和格式限制。

前置:第 4 章

本章目标

  • 定位常见失败
  • 导出诊断
  • 查阅限制
  1. 1. 先看状态栏

    失败时查看 Engine 状态、存储状态和诊断计数;打开操作失败会显示读取/取消阶段,Worker 停止可点“重启并恢复”。

    帮助菜单与诊断/手册入口
    图 28.1 先看状态栏
  2. 2. 恢复与备份

    优先从最近项目/自动恢复点重开;损坏引用可移除。重要工程另存并定期手动下载 .blend;清除站点数据会删除 OPFS。

    最近项目恢复入口
    图 28.2 恢复与备份
  3. 3. 能力边界

    支持矩阵区分可用/部分/仅原生/不可用。明确限制包括:本地模拟求解、部分 IO 格式、完整主题/键位、UDIM/投影纹理、Compositor/Shader/GN 节点目录。不要把手册当桌面 parity 证书。

    帮助菜单与支持信息
    图 28.3 能力边界

完成检查

  • 能从状态栏定位失败阶段
  • 能恢复或导出诊断
  • 限制与支持矩阵一致

提示

  • 首次远端加载 154–193 秒属正常,等待进度完成再操作。

限制 / 不支持

  • 本手册只验证 Chromium + RTX 4060;其他浏览器未验证。

相关链接

附录 B:能力支持矩阵

可在当前 Web UI 完成;可用但有明确范围/限制;需要原生桌面/服务器会话;当前 Web 版不支持。

区域功能状态说明章节
Layout3D 视口导航/选择/变换/相机视图可在当前 Web UI 完成ch07
LayoutOutliner 选择/重命名/拖放/可见性可在当前 Web UI 完成ch08
LayoutProperties 对象/修改器/材质/场景可在当前 Web UI 完成ch09
LayoutTimeline 跳帧/关键帧可在当前 Web UI 完成ch19
Modeling网格编辑/快捷拓扑操作可用但有明确范围/限制无完整建模工具箱/框选ch11
SculptingDraw/Inflate/Grab/Smooth、遮罩/面组/Remesh 入口可用但有明确范围/限制笔刷从属性应用,非连续雕刻ch11
UV Editing选择/变换/展开/打包/缝合可用但有明确范围/限制需要可写原生 UV 区域ch14
Texture Paint2D packed 图像绘制/撤销/重做/Make Local可用但有明确范围/限制不支持 UDIM/投影/4K 生产级ch17
Shading材质/Principled/14 类 Shader 节点/预览可用但有明确范围/限制仅 allowlist 节点ch15
ShadingPBR/RE 资产库/Append/Link/packed 图可在当前 Web UI 完成ch16
AnimationTimeline/Dope Sheet/关键帧/Action可在当前 Web UI 完成ch19
AnimationGraph Editor/NLA/驱动器可用但有明确范围/限制Graph 简化 SVG;NLA 表单ch20
AnimationWeb 播放/音频可用但有明确范围/限制本地帧步进,非原生求值ch19
RenderingPBR 渲染/诊断视图/PNG 手动下载可在当前 Web UI 完成ch23
Rendering原生 EEVEE/Cycles 渲染需要原生桌面/服务器会话需要原生/服务器后端ch23
Compositing9 类节点/连线/执行/Viewer/提交可用但有明确范围/限制节点目录受限;资源/属性有限制ch24
Geometry Nodes16 类 allowlist 节点/连线/提交可用但有明确范围/限制无 Simulation Zone/任意节点ch18
Geometry NodesSpreadsheet 对象/顶点/边/面/UV/属性/CSV可用但有明确范围/限制只读、250k 行上限ch18
ScriptingText Editor/Python Console/Info可用但有明确范围/限制Web 控制台依赖原生会话ch26
Files新建/打开/最近项目/恢复/撤销可在当前 Web UI 完成ch03
Files保存到 OPFS/下载 .blend/另存为/副本可在当前 Web UI 完成ch04
Files自动恢复点/诊断报告可在当前 Web UI 完成ch05
IOGLTF/GLB/OBJ/STL/PLY 导入可用但有明确范围/限制GLTF 仅嵌入资源;OBJ 不含 MTL 文件夹流程ch25
IO浏览器 GLB/OBJ 导出可用但有明确范围/限制GLB 本地;OBJ 本地/原生ch25
IOUSD/Alembic/FBX 导出需要原生桌面/服务器会话运行时 receipt 可能未注册ch25
IO图像/VFont/URDF 导入可在当前 Web UI 完成ch25
SettingsPreferences/Keymap/区域布局/相机锁定持久化可在当前 Web UI 完成ch27
Settings主题/系统/Add-ons/完整键位当前 Web 版不支持ch27
Simulation物理参数/缓存入口可用但有明确范围/限制本地播放/求解未接通ch21
SequencerStrip 表单/原生媒体传输可用但有明确范围/限制Web 最终导出依赖服务器;无本地媒体选择器ch25
CameraNumpad0/Camera to View/锁定持久化可用但有明确范围/限制无 object-as-camera/自动关键帧/约束分支ch07

附录 A:常用快捷键与 F3 命令

Ctrl+S保存到浏览器 OPFS(不下载)
Ctrl+O打开 .blend
Ctrl+Z / Ctrl+Y撤销 / 重做
F3操作搜索
F2重命名活动项/Outliner 行
G / R / S移动 / 旋转 / 缩放
Shift+D / Alt+D复制 / 链接复制
Numpad0相机视图切换
Ctrl+Alt+Numpad0对齐相机到视图
Home / Numpad .显示全部 / 框显所选
Numpad 1/3/7, 5轴视图 / 透视正交

附录 C:OPFS 与本地文件位置

projects/<id>/scene.blend工程主文件(OPFS)
projects/<id>/snapshots/<revision>.blend恢复点快照
projects/<id>/assets/sha256/...打包/内容资源
settings/web-interface.json偏好、键位、布局、相机锁定
最近项目IndexedDB blender-web-metadata/setting/recent-projects:v1
手动下载顶栏“下载 .blend”、PNG/GLB/CSV 导出

附录 D:术语与缩略语

OPFSOrigin Private File System,浏览器私有文件系统
SceneIRWebEngine 输出的场景只读描述
Main原生 Blender 主数据库,编辑与撤销的真实来源
Packed 图像数据打包在工程内的图像,可在纹理绘制中编辑
Make Local把库链接图像复制为本地可编辑数据
Camera to View锁定相机视图时导航会写回相机对象