42 lines
2.3 KiB
Markdown
42 lines
2.3 KiB
Markdown
# 剪贴板图片
|
||
|
||
剪贴板图片从 `Ctrl/Cmd + V` 开始，把操作系统中的图片变成 Packed Blender Image，并放到当前编辑器支持的位置。
|
||
|
||
## 执行过程
|
||
|
||
```mermaid
|
||
flowchart TD
|
||
Paste["Ctrl/Cmd + V"] --> Priority{"刚执行过 Blender Copy？"}
|
||
Priority -- "是" --> Native["交回原生 Paste"]
|
||
Priority -- "否" --> Read["读取系统图片"]
|
||
Read --> Image["复用或创建 Packed Image"]
|
||
Image --> Target{"当前编辑器"}
|
||
Target --> View["Reference / Plane"]
|
||
Target --> Node["Image Node"]
|
||
Target --> Paint["Brush Texture"]
|
||
```
|
||
|
||
Windows 快捷键优先处理 Blender 自己的 Copy/Paste，系统剪贴板出现新的图片内容时 AnyImage 接管粘贴；macOS 和 Linux 没有系统剪贴板序列号，始终由 AnyImage 处理粘贴。
|
||
|
||
## 节点说明
|
||
|
||
### 判断是否交给 Blender
|
||
|
||
`operators/clipboard_image/operators.py` 定义 `TrackNativeCopy`、`PasteClipboardImage` 和 3D View、Node Editor 快捷键。`TrackNativeCopy` 记录 Blender Copy 时的系统剪贴板序列号；粘贴时若序列号没有变化，`PasteClipboardImage` 返回 `PASS_THROUGH`，让 Blender 继续处理对象或节点粘贴。
|
||
|
||
同一文件随后调用 `actions.target_for_context()` 判断当前编辑器是否支持图片落点。
|
||
|
||
### 读取系统图片
|
||
|
||
`clipboard.py` 负责平台差异。Windows 依次尝试 PNG、DIBV5 和 DIB，DIB 补成 BMP；macOS 通过 `osascript` 导出 PNG；Linux 依次尝试 `wl-paste` 和 `xclip` 提供的图片格式。各平台输出统一为图片字节和扩展名，再交给后续步骤。
|
||
|
||
### 创建或复用 Packed Image
|
||
|
||
`actions.py` 对图片内容计算 SHA-256。相同内容已经粘贴过时会复用现有 Packed Image，否则创建新 Image 并 Pack 到当前 `.blend`，避免依赖临时剪贴板文件。
|
||
|
||
### 放到当前编辑器
|
||
|
||
落点仍在 `actions.py` 中完成：3D View 创建 Reference 或 Plane，Node Editor 创建与当前节点树匹配的 Image 节点，绘制模式把 Image 配置为当前画笔的 Texture。鼠标位置和视图位置也在这里换算。
|
||
|
||
Plane 路径调用 `convert_to_plane/image_plane.py` 创建中心原点基础网格，并从节点资产加载 `O Image Plane`。`actions.py` 创建图像材质并放入 Mesh 第 `0` 个材质槽，节点组只生成几何。
|