Chunk Render

Add-on Description:

Chunk Render is a tile rendering add-on for Blender that splits the final image into multiple regions (tiles), renders them one by one, and automatically stitches them back into a full image after rendering is complete. It supports standard image formats and multi-layer EXR.

It is suitable for large scenes, long render times, recovery from unstable rendering tasks, and workflows that require flexible control over local output regions.

When OpenImageIO (OIIO) is available in the current Blender environment, this add-on supports merging multi-layer EXR files. Blender ships with the OIIO library by default, so in theory the add-on is completely self‑contained and does not require any third‑party libraries or tools.

Features:

• Supports tile rendering using preset levels or manually specified rows/columns
• Supports tile rendering only within the current Render Border region
• Supports snapping the render border to integer pixel boundaries to reduce tile alignment errors
• Supports real‑time tile overlay display in the camera view for easy preview and checking
• Supports Bleed Pixels to minimise seam issues between tiles
• Supports rendering all tiles, or only tiles with specific indices
• Supports automatically merging tiles into the final full image after rendering
• Supports automatically deleting tile files after a successful merge
• Supports re‑merging tile files already existing on disk
• Supports saving, restoring, and managing frequently used render border regions
• Supports both standard image output and Compositor File Output node output
• Supports multi‑layer EXR merging and re‑merging via OIIO when available
• Supports debug log output to help troubleshoot rendering and merging issues

Instructions:

1. Open the Output Properties and find the Render Region panel.
2. Under Step 1, choose your tiling method: use preset Levels, or manually set Rows and Columns.
3. If needed, enable Use Render Border to tile only within the current render border; you can also enable Snap Render Border (Integer Pixels) for cleaner boundaries.
4. Optionally enable Show Overlay Grid to preview tile divisions in the camera view, and adjust Bleed Pixels as desired.
5. Under Step 2, click Start Render. The add‑on will render tiles one by one in order.
6. To automatically generate the full image after rendering finishes, check Auto Merge Final Image.
7. To clean up temporary tile files after a successful merge, check Delete Tiles After Merge.
8. In Advanced Options, use Manual Tile Selection to render only a subset of tiles.
9. In Advanced Options, use Saved Borders to save and restore frequently used render borders.
10. To re‑merge existing tiles, select the tile folder under Re‑merge Existing Tiles and click Re‑Merge Tiles.

Important Notes:

1. The add‑on requires a valid output path. If the main output path is unusable, use the Compositor File Output node for output.
2. Use Render Border requires you to first manually draw a render border with Ctrl+B.
3. Support for multi‑layer EXR in Auto Merge Final Image and Re‑Merge Tiles depends on OpenImageIO (OIIO) being available in the current Blender environment. If OIIO is missing, multi‑layer EXR merging will not work. However, Blender ships with the OIIO library by default, so the add‑on should be fully self‑contained in theory.
4. Re‑merging multi‑layer EXR files tries to preserve channel structure and metadata, but in some cases it is still difficult to achieve 100% lossless restoration of all channel information.
5. For very high resolutions or multi‑layer EXR files with many channels, merging may consume a large amount of system memory. The add‑on will estimate memory usage before merging and abort the operation for safety if the risk is too high.
6. During rendering and merging, the add‑on creates tile files, task directories, and temporary configuration files for collecting, merging, and restoring results.
7. The add‑on aims to improve the stability and flexibility of large‑image rendering, but final performance still depends on scene complexity, output format, and system resources.

插件介绍：

Chunk Render 是一个用于 Blender 的分块渲染插件，可将最终图像拆分为多个区域逐块渲染，并在渲染完成后自动拼接为完整图像。支持常规图像格式和多层exr。

它适用于大场景、长时间渲染、不稳定任务恢复，以及需要灵活控制局部区域输出的工作流。

该插件在当前 Blender 环境提供 OpenImageIO（OIIO） 时对多层 EXR 的拼接支持，目前Blender内部自带了OIIO库，所以理论上插件完全可以自给自足不需要第三方库或工具。。

功能介绍：

• 支持使用预设等级或手动行列数进行分块渲染
• 支持仅对当前 渲染框（Render Border） 区域进行分块
• 支持将渲染框对齐到整数像素边界，减少分块误差
• 支持在相机视图中实时显示分块叠加层，便于预览和检查
• 支持设置 出血像素（Bleed Pixels），减少分块边缘接缝问题
• 支持渲染全部分块，也支持仅渲染指定索引分块
• 支持渲染完成后自动拼接最终全图
• 支持拼接成功后自动删除分块文件
• 支持对磁盘中已有的分块文件重新拼接
• 支持保存、恢复和管理常用渲染框区域
• 支持普通图像输出与 合成器 File Output 输出
• 在可用时支持基于 OIIO 的多层 EXR 拼接与重新拼接
• 支持输出调试日志，便于排查渲染和拼接问题

使用说明：

1. 打开 输出属性（Output Properties），找到 Render Region 面板。
2. 在 步骤 1 中选择分块方式：可使用预设 等级（Levels），也可手动设置 行数（Rows） 和 列数（Columns）。
3. 如有需要，可启用 使用渲染框分块（Use Render Border），仅对当前渲染框区域进行分块；也可使用 对齐渲染框（整数像素） 让边界更规整。
4. 可选启用 显示叠加网格（Show Overlay Grid） 在相机视图中预览分块范围，并根据需要调整 出血像素（Bleed Pixels）。
5. 在 步骤 2 中点击 开始渲染（Start Render），插件将按分块顺序逐块执行渲染。
6. 如需在渲染完成后自动生成整图，可勾选 自动拼接最终全图（Auto Merge Final Image）。
7. 如需在拼接成功后清理临时分块文件，可勾选 拼接后删除分块（Delete Tiles After Merge）。
8. 在 高级选项（Advanced Options） 中，可通过 手动控制渲染范围（Manual Tile Selection） 指定只渲染部分分块。
9. 在 高级选项 中，可通过 记录历史（Saved Borders） 保存并恢复常用渲染框。
10. 如需对已有分块重新拼接，可在 重新拼接已有分块 中选择分块文件夹，然后点击 重新拼接分块（Re-Merge Tiles）。

注意事项：

1. 插件需要有效的输出路径。如果主输出路径不可用，请使用 合成器文件输出 节点输出。
2. 使用渲染框分块 需要先Ctrl+B手动框选渲染框后可用。
3. 自动拼接最终全图 与 重新拼接分块 对多层 EXR 的支持依赖当前 Blender 环境中的 OpenImageIO（OIIO）。如果缺少 OIIO，多层 EXR 合并功能将不可用，但目前Blender内部自带了OIIO库，所以理论上是完全可以插件自给自足不需要第三方库或工具。
4. 多层 EXR 的重新拼接会尽量保留通道结构与元数据，但在某些情况下，仍然很难做到对所有通道信息 100% 无损还原。
5. 对于超大分辨率或通道数量较多的多层 EXR，拼接时可能占用大量系统内存。插件会在拼接前进行内存预估，并在风险过高时出于安全原因停止操作。
6. 渲染与拼接过程中，插件会创建分块文件、任务目录及临时配置文件，用于收集、拼接和恢复结果。
7. 插件旨在提升大图渲染的稳定性和灵活性，但最终性能仍取决于场景复杂度、输出格式以及系统资源。