Spaces:
Paused
Paused
Surf commited on
Commit ·
152773c
1
Parent(s): 824882d
暮归江南 · Blender 路线 步骤2-3:render_film.py 离线出片(逐帧黑帧检查与自动修复、淡入淡出、音轨、内置 FFmpeg 编码、断点续渲)、场景脚本加固与 Blender 5.x 兼容、网页导出 WAV 音轨;沙盒 bpy 实跑全片抽帧 0 黑帧并校准曝光
Browse files- README.md +6 -1
- blender/__pycache__/jiangnan_village.cpython-313.pyc +0 -0
- blender/jiangnan_village.py +46 -14
- blender/render_film.py +338 -0
- src/jiangnan/JiangnanApp.tsx +14 -4
- src/jiangnan/blender/jiangnan_village.py +46 -14
- src/jiangnan/blender/render_film.py +338 -0
- src/jiangnan/export/wav.ts +19 -0
README.md
CHANGED
|
@@ -121,7 +121,7 @@ tools/jiangnan/ # 旁白生成、字体子集化、实况图
|
|
| 121 |
3. **封面**:多选比例(16:9 / 4:3 / 3:4)和画面(石桥夕照 / 灯火长街 / 星夜水乡 / 古樟斜阳)→ 生成 → 勾选 → 下载(多张自动打包 ZIP)。
|
| 122 |
4. **发布文案**:切换小红书 / 抖音 / 微信视频号 / 哔哩哔哩,选标题,一键复制标题、描述、话题或全部;也可下载全部文案 txt。
|
| 123 |
5. **实况图**:点「生成 6 组实况图」→ 下载 ZIP。Mac 上把 `1_jpg+mov` 文件夹里同名的 jpg 和 mov 一起拖进「照片」即成实况照片,同步到 iPhone 后发小红书 / 抖音图文;图文标题、正文、话题在同一区域复制。
|
| 124 |
-
6. **Blender**:页面底部下载 `jiangnan_village.py`(
|
| 125 |
|
| 126 |
本地开发:`npm install && npm run dev`,打开 `/jiangnan/`。自动画面检查脚本在 `tools/jiangnan/`(`analyze.py` 用无头浏览器渲染各镜头并输出构图 / 亮度图;`verify_live_photo.py` 调用 LiveCanvas 原版校验器检查实况图)。
|
| 127 |
|
|
@@ -293,6 +293,11 @@ tools/jiangnan/ # 旁白生成、字体子集化、实况图
|
|
| 293 |
### I.5 进度日志(Blender 路线)
|
| 294 |
|
| 295 |
- **步骤 1** ✅ 写好 Blender 路线计划(本节),推送到 Space。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 296 |
|
| 297 |
---
|
| 298 |
|
|
|
|
| 121 |
3. **封面**:多选比例(16:9 / 4:3 / 3:4)和画面(石桥夕照 / 灯火长街 / 星夜水乡 / 古樟斜阳)→ 生成 → 勾选 → 下载(多张自动打包 ZIP)。
|
| 122 |
4. **发布文案**:切换小红书 / 抖音 / 微信视频号 / 哔哩哔哩,选标题,一键复制标题、描述、话题或全部;也可下载全部文案 txt。
|
| 123 |
5. **实况图**:点「生成 6 组实况图」→ 下载 ZIP。Mac 上把 `1_jpg+mov` 文件夹里同名的 jpg 和 mov 一起拖进「照片」即成实况照片,同步到 iPhone 后发小红书 / 抖音图文;图文标题、正文、话题在同一区域复制。
|
| 124 |
+
6. **Blender(推荐出片方式)**:页面底部下载 `jiangnan_village.py`(场景)与 `render_film.py`(出片),点「导出音轨 WAV」;终端执行 `blender -b -P render_film.py -- --out ./out --audio 暮归江南_音轨.wav --preview` 先出预览,去掉 `--preview` 出 1080p 成片,加 `--final --res 3840x2160` 出 4K。每一帧都经过亮度校验,不会出现黑帧;报告在 `out/report.json`。
|
| 125 |
|
| 126 |
本地开发:`npm install && npm run dev`,打开 `/jiangnan/`。自动画面检查脚本在 `tools/jiangnan/`(`analyze.py` 用无头浏览器渲染各镜头并输出构图 / 亮度图;`verify_live_photo.py` 调用 LiveCanvas 原版校验器检查实况图)。
|
| 127 |
|
|
|
|
| 293 |
### I.5 进度日志(Blender 路线)
|
| 294 |
|
| 295 |
- **步骤 1** ✅ 写好 Blender 路线计划(本节),推送到 Space。
|
| 296 |
+
- **步骤 2** ✅ 出片脚本与加固:
|
| 297 |
+
- 新增 `blender/render_film.py`:一条命令完成生成场景 → 逐帧 PNG 渲染 → 每帧读回像素做亮度检查(黑帧三级自动修复:CPU → 关降噪 → +1 / +2 EV 重渲,仍黑则用前一帧替代并记录)→ VSE 内做 0.9 s / 1.2 s 淡入淡出 → 合成音轨 → Blender 内置 FFmpeg 编码 H.264(High、yuv420p、GOP 2 s、AAC 256 kbps)→ `report.json`;支持 `--preview / --final / --qa-step`、断点续渲、GPU 自动探测(OptiX / CUDA / HIP / Metal / oneAPI)失败回退 CPU;没有 FFmpeg 的构建(如 pip 的 bpy)会保留 PNG 序列并打印 ffmpeg 封装命令。
|
| 298 |
+
- `jiangnan_village.py` 加固与兼容:Nishita 太阳钳位(已有)之外,世界节点加亮度下限、相机裁剪起点 0.3 m、胶片不透明、输出 RGB;兼容 Blender 5.x(`sky_type` 改名 `MULTIPLE_SCATTERING`、`dust_density → aerosol_density`、分层动作的 F 曲线、`sequences → strips`、按可用项选择 AgX / Filmic 与对比度 look)。
|
| 299 |
+
- 网页「Blender 路线」区:下载两份脚本 + **导出音轨 WAV**(浏览器合成的配乐 / 音效 / 旁白,48 kHz 16-bit)+ 三条命令说明。
|
| 300 |
+
- **步骤 3** ✅ 沙盒实跑(pip 的 bpy 5.1.2,无显卡,Cycles CPU):`--qa-step 4 --res 160x90 --samples 4` 全片每 4 秒一帧共 22 帧,**自动修复 0、前帧替代 0、偏暗帧 0、最终非设计黑帧 0**。首轮画面整体过亮、夜景发粉(曝光斜坡 +3.2 EV 与暮色层 0.6 是按 4.x 的 Nishita 调的,5.x 的物理天空更亮),已把天空强度 1.0 → 0.6、暮色层 0.6 → 0.22、曝光 0 → 3.2 EV 改为 -0.3 → 1.4 EV、暮霭密度减半、look 改为中高对比,再跑一轮:白天亮度均值 ≈ 190–210、夜景 ≈ 100–150,窗灯与灯笼倒影成形(抽帧拼图 `tools/jiangnan/blender_qa_sheet.jpg`)。沙盒的 bpy 没有 FFmpeg,MP4 封装步骤在完整版 Blender 中执行;逐帧 PNG 校验已在沙盒验证。
|
| 301 |
|
| 302 |
---
|
| 303 |
|
blender/__pycache__/jiangnan_village.cpython-313.pyc
ADDED
|
Binary file (67.2 kB). View file
|
|
|
blender/jiangnan_village.py
CHANGED
|
@@ -190,6 +190,21 @@ def terrain_height(x, z):
|
|
| 190 |
|
| 191 |
|
| 192 |
# ------------------------------------------------------------------ helpers
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 193 |
def clear_scene():
|
| 194 |
bpy.ops.object.select_all(action='SELECT')
|
| 195 |
bpy.ops.object.delete(use_global=False)
|
|
@@ -522,7 +537,7 @@ def build_wheel(M, coll):
|
|
| 522 |
pivot.keyframe_insert('rotation_euler', frame=1)
|
| 523 |
pivot.rotation_euler.rotate_axis('Y', 0.42 * DURATION)
|
| 524 |
pivot.keyframe_insert('rotation_euler', frame=int(DURATION * FPS) + 1)
|
| 525 |
-
for fc in pivot.animation_data.action
|
| 526 |
for kp in fc.keyframe_points:
|
| 527 |
kp.interpolation = 'LINEAR'
|
| 528 |
return pivot
|
|
@@ -658,10 +673,16 @@ def build_sky_and_sun(scene):
|
|
| 658 |
nt = world.node_tree
|
| 659 |
bg = nt.nodes.get('Background')
|
| 660 |
sky = nt.nodes.new('ShaderNodeTexSky')
|
| 661 |
-
|
|
|
|
|
|
|
|
|
|
| 662 |
sky.sun_rotation = math.pi / 2 + 0.2 + math.pi / 2 # sets toward west-north-west
|
| 663 |
sky.air_density = 1.2
|
| 664 |
-
sky
|
|
|
|
|
|
|
|
|
|
| 665 |
nt.links.new(sky.outputs['Color'], bg.inputs['Color'])
|
| 666 |
# twilight layer: deep blue dome with a warm afterglow band, faded in after sunset
|
| 667 |
tw = nt.nodes.new('ShaderNodeBackground')
|
|
@@ -702,14 +723,14 @@ def build_sky_and_sun(scene):
|
|
| 702 |
sun_data.color = (1.0, lerp(0.38, 0.76, smoothstep(0, 9, e)), lerp(0.14, 0.52, smoothstep(0, 9, e)))
|
| 703 |
sun_data.keyframe_insert('energy', frame=f)
|
| 704 |
sun_data.keyframe_insert('color', frame=f)
|
| 705 |
-
bg.inputs['Strength'].default_value = lerp(0.0,
|
| 706 |
bg.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 707 |
moon_data.energy = 0.35 * smoothstep(-1.5, -8.5, e)
|
| 708 |
moon_data.keyframe_insert('energy', frame=f)
|
| 709 |
-
tw.inputs['Strength'].default_value = 0.
|
| 710 |
tw.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 711 |
# camera eye adaptation, like the web version
|
| 712 |
-
scene.view_settings.exposure = lerp(0.
|
| 713 |
scene.view_settings.keyframe_insert('exposure', frame=f)
|
| 714 |
# thin evening mist: a bounded volume over the valley (a world volume would swallow the sky)
|
| 715 |
bpy.ops.mesh.primitive_cube_add(size=1, location=(0, 0, 30))
|
|
@@ -721,13 +742,13 @@ def build_sky_and_sun(scene):
|
|
| 721 |
nt2 = mm.node_tree
|
| 722 |
nt2.nodes.remove(nt2.nodes.get('Principled BSDF'))
|
| 723 |
vol = nt2.nodes.new('ShaderNodeVolumePrincipled')
|
| 724 |
-
vol.inputs['Density'].default_value = 0.
|
| 725 |
vol.inputs['Color'].default_value = (0.85, 0.8, 0.9, 1)
|
| 726 |
nt2.links.new(vol.outputs['Volume'], nt2.nodes.get('Material Output').inputs['Volume'])
|
| 727 |
mist.data.materials.append(mm)
|
| 728 |
mist.visible_shadow = False
|
| 729 |
vol.inputs['Density'].keyframe_insert('default_value', frame=1)
|
| 730 |
-
vol.inputs['Density'].default_value = 0.
|
| 731 |
vol.inputs['Density'].keyframe_insert('default_value', frame=int(80 * FPS))
|
| 732 |
|
| 733 |
|
|
@@ -803,12 +824,23 @@ def setup_render(scene):
|
|
| 803 |
scene.cycles.samples = 128
|
| 804 |
scene.cycles.use_denoising = True
|
| 805 |
scene.cycles.max_bounces = 6
|
| 806 |
-
|
| 807 |
-
|
| 808 |
-
|
| 809 |
-
|
| 810 |
-
|
| 811 |
-
scene.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 812 |
scene.render.filepath = '//暮归江南_blender_'
|
| 813 |
|
| 814 |
|
|
|
|
| 190 |
|
| 191 |
|
| 192 |
# ------------------------------------------------------------------ helpers
|
| 193 |
+
def action_fcurves(action):
|
| 194 |
+
"""F-curves of an action on Blender 4.x (action.fcurves) and 5.x (layered actions: slots → channelbags)."""
|
| 195 |
+
if hasattr(action, 'fcurves') and action.fcurves is not None:
|
| 196 |
+
try:
|
| 197 |
+
return list(action.fcurves)
|
| 198 |
+
except Exception:
|
| 199 |
+
pass
|
| 200 |
+
out = []
|
| 201 |
+
for layer in getattr(action, 'layers', []):
|
| 202 |
+
for strip in layer.strips:
|
| 203 |
+
for cb in getattr(strip, 'channelbags', []):
|
| 204 |
+
out.extend(cb.fcurves)
|
| 205 |
+
return out
|
| 206 |
+
|
| 207 |
+
|
| 208 |
def clear_scene():
|
| 209 |
bpy.ops.object.select_all(action='SELECT')
|
| 210 |
bpy.ops.object.delete(use_global=False)
|
|
|
|
| 537 |
pivot.keyframe_insert('rotation_euler', frame=1)
|
| 538 |
pivot.rotation_euler.rotate_axis('Y', 0.42 * DURATION)
|
| 539 |
pivot.keyframe_insert('rotation_euler', frame=int(DURATION * FPS) + 1)
|
| 540 |
+
for fc in action_fcurves(pivot.animation_data.action):
|
| 541 |
for kp in fc.keyframe_points:
|
| 542 |
kp.interpolation = 'LINEAR'
|
| 543 |
return pivot
|
|
|
|
| 673 |
nt = world.node_tree
|
| 674 |
bg = nt.nodes.get('Background')
|
| 675 |
sky = nt.nodes.new('ShaderNodeTexSky')
|
| 676 |
+
try:
|
| 677 |
+
sky.sky_type = 'NISHITA' # Blender 4.x
|
| 678 |
+
except TypeError:
|
| 679 |
+
sky.sky_type = 'MULTIPLE_SCATTERING' # Blender 5.x name for the same physical sky
|
| 680 |
sky.sun_rotation = math.pi / 2 + 0.2 + math.pi / 2 # sets toward west-north-west
|
| 681 |
sky.air_density = 1.2
|
| 682 |
+
if hasattr(sky, 'dust_density'):
|
| 683 |
+
sky.dust_density = 2.5
|
| 684 |
+
else:
|
| 685 |
+
sky.aerosol_density = 2.5 # Blender 5.x
|
| 686 |
nt.links.new(sky.outputs['Color'], bg.inputs['Color'])
|
| 687 |
# twilight layer: deep blue dome with a warm afterglow band, faded in after sunset
|
| 688 |
tw = nt.nodes.new('ShaderNodeBackground')
|
|
|
|
| 723 |
sun_data.color = (1.0, lerp(0.38, 0.76, smoothstep(0, 9, e)), lerp(0.14, 0.52, smoothstep(0, 9, e)))
|
| 724 |
sun_data.keyframe_insert('energy', frame=f)
|
| 725 |
sun_data.keyframe_insert('color', frame=f)
|
| 726 |
+
bg.inputs['Strength'].default_value = lerp(0.0, 0.6, smoothstep(-5, 2, e))
|
| 727 |
bg.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 728 |
moon_data.energy = 0.35 * smoothstep(-1.5, -8.5, e)
|
| 729 |
moon_data.keyframe_insert('energy', frame=f)
|
| 730 |
+
tw.inputs['Strength'].default_value = 0.22 * smoothstep(1.0, -4.0, e)
|
| 731 |
tw.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 732 |
# camera eye adaptation, like the web version
|
| 733 |
+
scene.view_settings.exposure = lerp(-0.3, 1.4, smoothstep(1, -9, e))
|
| 734 |
scene.view_settings.keyframe_insert('exposure', frame=f)
|
| 735 |
# thin evening mist: a bounded volume over the valley (a world volume would swallow the sky)
|
| 736 |
bpy.ops.mesh.primitive_cube_add(size=1, location=(0, 0, 30))
|
|
|
|
| 742 |
nt2 = mm.node_tree
|
| 743 |
nt2.nodes.remove(nt2.nodes.get('Principled BSDF'))
|
| 744 |
vol = nt2.nodes.new('ShaderNodeVolumePrincipled')
|
| 745 |
+
vol.inputs['Density'].default_value = 0.0005
|
| 746 |
vol.inputs['Color'].default_value = (0.85, 0.8, 0.9, 1)
|
| 747 |
nt2.links.new(vol.outputs['Volume'], nt2.nodes.get('Material Output').inputs['Volume'])
|
| 748 |
mist.data.materials.append(mm)
|
| 749 |
mist.visible_shadow = False
|
| 750 |
vol.inputs['Density'].keyframe_insert('default_value', frame=1)
|
| 751 |
+
vol.inputs['Density'].default_value = 0.0011
|
| 752 |
vol.inputs['Density'].keyframe_insert('default_value', frame=int(80 * FPS))
|
| 753 |
|
| 754 |
|
|
|
|
| 824 |
scene.cycles.samples = 128
|
| 825 |
scene.cycles.use_denoising = True
|
| 826 |
scene.cycles.max_bounces = 6
|
| 827 |
+
avail = [i.identifier for i in scene.view_settings.bl_rna.properties['view_transform'].enum_items]
|
| 828 |
+
for vt in ('AgX', 'Filmic', 'Standard'):
|
| 829 |
+
if vt in avail:
|
| 830 |
+
scene.view_settings.view_transform = vt
|
| 831 |
+
break
|
| 832 |
+
looks = [i.identifier for i in scene.view_settings.bl_rna.properties['look'].enum_items]
|
| 833 |
+
for lk in ('AgX - Medium High Contrast', 'Medium High Contrast', 'AgX - Punchy', 'Punchy', 'None'):
|
| 834 |
+
if lk in looks:
|
| 835 |
+
scene.view_settings.look = lk
|
| 836 |
+
break
|
| 837 |
+
try:
|
| 838 |
+
scene.render.image_settings.file_format = 'FFMPEG'
|
| 839 |
+
scene.render.ffmpeg.format = 'MPEG4'
|
| 840 |
+
scene.render.ffmpeg.codec = 'H264'
|
| 841 |
+
scene.render.ffmpeg.constant_rate_factor = 'HIGH'
|
| 842 |
+
except TypeError:
|
| 843 |
+
scene.render.image_settings.file_format = 'PNG' # builds without FFmpeg (e.g. the bpy pip module)
|
| 844 |
scene.render.filepath = '//暮归江南_blender_'
|
| 845 |
|
| 846 |
|
blender/render_film.py
ADDED
|
@@ -0,0 +1,338 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# -*- coding: utf-8 -*-
|
| 2 |
+
"""
|
| 3 |
+
《暮归江南》Blender 离线出片脚本 —— 生成场景 → 逐帧渲染 → 逐帧黑帧检查与自动修复 → 淡入淡出 → 合成音轨 → 编码 MP4 → 报告
|
| 4 |
+
|
| 5 |
+
用法(命令行,无界面):
|
| 6 |
+
blender -b -P render_film.py -- --out ./out [--engine CYCLES|EEVEE] [--samples 64] [--res 1920x1080] [--fps 24]
|
| 7 |
+
[--start 0] [--end 86] [--audio 暮归江南_音轨.wav] [--preview | --final]
|
| 8 |
+
[--qa-step 2] (只做全片抽帧黑帧检查:每 2 秒渲一帧,不出 MP4)
|
| 9 |
+
也可以在 Blender 的 Scripting 面板直接 Run Script(用默认参数,输出到 .blend 同目录的 out/)。
|
| 10 |
+
|
| 11 |
+
为什么黑屏在这里不会出现:
|
| 12 |
+
· 画面由 Cycles / EEVEE 离线渲染成 PNG 落盘,MP4 由 Blender 内置 FFmpeg(libx264, yuv420p)编码,
|
| 13 |
+
不经过浏览器的 WebGL 画布和显卡硬件编码器(网页版黑帧的来源)。
|
| 14 |
+
· 每一帧渲染完都会读回像素做亮度检查;黑帧自动改用 CPU、关闭降噪、提高曝光重渲;
|
| 15 |
+
仍然黑则用前一帧替代并写进报告——输出里不会有一帧「意外的黑」。
|
| 16 |
+
· Nishita 天空在日落后被钳住、世界亮度有下限、胶片不透明、输出 RGB。
|
| 17 |
+
"""
|
| 18 |
+
import bpy
|
| 19 |
+
import os
|
| 20 |
+
import sys
|
| 21 |
+
import math
|
| 22 |
+
import json
|
| 23 |
+
import time
|
| 24 |
+
import importlib.util
|
| 25 |
+
|
| 26 |
+
HERE = os.path.dirname(os.path.abspath(__file__)) if '__file__' in globals() else os.getcwd()
|
| 27 |
+
|
| 28 |
+
|
| 29 |
+
# ------------------------------------------------------------------ arguments
|
| 30 |
+
def parse_args():
|
| 31 |
+
argv = sys.argv[sys.argv.index('--') + 1:] if '--' in sys.argv else []
|
| 32 |
+
o = {'out': os.path.join(HERE, 'out'), 'engine': 'CYCLES', 'samples': 64, 'res': '1920x1080', 'fps': 24, 'start': 0.0, 'end': 86.0,
|
| 33 |
+
'audio': None, 'qa_step': None, 'preview': False, 'final': False, 'device': 'GPU', 'resume': True}
|
| 34 |
+
i = 0
|
| 35 |
+
while i < len(argv):
|
| 36 |
+
a = argv[i]
|
| 37 |
+
nxt = argv[i + 1] if i + 1 < len(argv) else None
|
| 38 |
+
if a == '--out': o['out'] = nxt; i += 1
|
| 39 |
+
elif a == '--engine': o['engine'] = nxt.upper(); i += 1
|
| 40 |
+
elif a == '--samples': o['samples'] = int(nxt); i += 1
|
| 41 |
+
elif a == '--res': o['res'] = nxt; i += 1
|
| 42 |
+
elif a == '--fps': o['fps'] = int(nxt); i += 1
|
| 43 |
+
elif a == '--start': o['start'] = float(nxt); i += 1
|
| 44 |
+
elif a == '--end': o['end'] = float(nxt); i += 1
|
| 45 |
+
elif a == '--audio': o['audio'] = nxt; i += 1
|
| 46 |
+
elif a == '--qa-step': o['qa_step'] = float(nxt); i += 1
|
| 47 |
+
elif a == '--device': o['device'] = nxt.upper(); i += 1
|
| 48 |
+
elif a == '--preview': o['preview'] = True
|
| 49 |
+
elif a == '--final': o['final'] = True
|
| 50 |
+
elif a == '--no-resume': o['resume'] = False
|
| 51 |
+
i += 1
|
| 52 |
+
if o['preview']:
|
| 53 |
+
o['engine'] = 'EEVEE'; o['res'] = '960x540'; o['samples'] = 16
|
| 54 |
+
if o['final']:
|
| 55 |
+
o['engine'] = 'CYCLES'; o['samples'] = 256
|
| 56 |
+
o['w'], o['h'] = [int(x) for x in o['res'].lower().split('x')]
|
| 57 |
+
return o
|
| 58 |
+
|
| 59 |
+
|
| 60 |
+
# ------------------------------------------------------------------ scene
|
| 61 |
+
def load_scene_script():
|
| 62 |
+
"""Run jiangnan_village.py from the same folder (builds the whole village into the current scene)."""
|
| 63 |
+
path = os.path.join(HERE, 'jiangnan_village.py')
|
| 64 |
+
spec = importlib.util.spec_from_file_location('jiangnan_village', path)
|
| 65 |
+
mod = importlib.util.module_from_spec(spec)
|
| 66 |
+
spec.loader.exec_module(mod)
|
| 67 |
+
mod.main()
|
| 68 |
+
return mod
|
| 69 |
+
|
| 70 |
+
|
| 71 |
+
def harden_against_black(scene):
|
| 72 |
+
"""Settings that make a black frame impossible by construction (see README section I.1)."""
|
| 73 |
+
r = scene.render
|
| 74 |
+
r.film_transparent = False
|
| 75 |
+
r.image_settings.file_format = 'PNG'
|
| 76 |
+
r.image_settings.color_mode = 'RGB'
|
| 77 |
+
r.image_settings.color_depth = '8'
|
| 78 |
+
r.image_settings.compression = 50
|
| 79 |
+
r.use_file_extension = True
|
| 80 |
+
r.dither_intensity = 1.0
|
| 81 |
+
# world brightness floor: a tiny constant emission under the sky so the dome is never exactly 0
|
| 82 |
+
world = scene.world
|
| 83 |
+
if world and world.use_nodes:
|
| 84 |
+
nt = world.node_tree
|
| 85 |
+
out = nt.nodes.get('World Output')
|
| 86 |
+
floor = nt.nodes.new('ShaderNodeBackground')
|
| 87 |
+
floor.name = '亮度下限'
|
| 88 |
+
floor.inputs['Color'].default_value = (0.004, 0.006, 0.012, 1)
|
| 89 |
+
floor.inputs['Strength'].default_value = 1.0
|
| 90 |
+
add = nt.nodes.new('ShaderNodeAddShader')
|
| 91 |
+
prev = out.inputs['Surface'].links[0].from_socket if out.inputs['Surface'].links else None
|
| 92 |
+
if prev is not None:
|
| 93 |
+
nt.links.new(prev, add.inputs[0])
|
| 94 |
+
nt.links.new(floor.outputs['Background'], add.inputs[1])
|
| 95 |
+
nt.links.new(add.outputs['Shader'], out.inputs['Surface'])
|
| 96 |
+
# cameras never start clipping inside a wall / canopy that is right at the lens
|
| 97 |
+
for ob in scene.objects:
|
| 98 |
+
if ob.type == 'CAMERA':
|
| 99 |
+
ob.data.clip_start = 0.3
|
| 100 |
+
ob.data.clip_end = 12000
|
| 101 |
+
|
| 102 |
+
|
| 103 |
+
def configure_engine(scene, o, device='GPU', denoise=True):
|
| 104 |
+
r = scene.render
|
| 105 |
+
want = 'CYCLES' if o['engine'] == 'CYCLES' else None
|
| 106 |
+
if want is None:
|
| 107 |
+
for eng in ('BLENDER_EEVEE_NEXT', 'BLENDER_EEVEE'):
|
| 108 |
+
try:
|
| 109 |
+
r.engine = eng
|
| 110 |
+
want = eng
|
| 111 |
+
break
|
| 112 |
+
except TypeError:
|
| 113 |
+
continue
|
| 114 |
+
else:
|
| 115 |
+
r.engine = 'CYCLES'
|
| 116 |
+
if r.engine == 'CYCLES':
|
| 117 |
+
c = scene.cycles
|
| 118 |
+
c.samples = o['samples']
|
| 119 |
+
c.use_denoising = denoise
|
| 120 |
+
c.max_bounces = 6
|
| 121 |
+
c.use_adaptive_sampling = True
|
| 122 |
+
c.device = 'GPU' if device == 'GPU' else 'CPU'
|
| 123 |
+
if device == 'GPU':
|
| 124 |
+
try:
|
| 125 |
+
prefs = bpy.context.preferences.addons['cycles'].preferences
|
| 126 |
+
enabled = False
|
| 127 |
+
for backend in ('OPTIX', 'CUDA', 'HIP', 'METAL', 'ONEAPI'):
|
| 128 |
+
try:
|
| 129 |
+
prefs.compute_device_type = backend
|
| 130 |
+
prefs.get_devices()
|
| 131 |
+
for d in prefs.devices:
|
| 132 |
+
if d.type != 'CPU':
|
| 133 |
+
d.use = True
|
| 134 |
+
enabled = True
|
| 135 |
+
if enabled:
|
| 136 |
+
break
|
| 137 |
+
except Exception:
|
| 138 |
+
continue
|
| 139 |
+
if not enabled:
|
| 140 |
+
c.device = 'CPU'
|
| 141 |
+
except Exception:
|
| 142 |
+
c.device = 'CPU'
|
| 143 |
+
else:
|
| 144 |
+
try:
|
| 145 |
+
scene.eevee.taa_render_samples = max(16, o['samples'])
|
| 146 |
+
except Exception:
|
| 147 |
+
pass
|
| 148 |
+
r.resolution_x, r.resolution_y = o['w'], o['h']
|
| 149 |
+
r.resolution_percentage = 100
|
| 150 |
+
r.fps = o['fps']
|
| 151 |
+
return r.engine, (scene.cycles.device if r.engine == 'CYCLES' else 'GPU')
|
| 152 |
+
|
| 153 |
+
|
| 154 |
+
# ------------------------------------------------------------------ frame QA
|
| 155 |
+
def frame_luma(path):
|
| 156 |
+
"""Mean / max luminance (0–255) of a rendered PNG, sampled on a coarse grid (fast, no PIL needed)."""
|
| 157 |
+
img = bpy.data.images.load(path, check_existing=False)
|
| 158 |
+
try:
|
| 159 |
+
w, h = img.size
|
| 160 |
+
px = img.pixels[:] # linear float RGBA
|
| 161 |
+
step = max(1, min(w, h) // 24)
|
| 162 |
+
n, s, mx = 0, 0.0, 0.0
|
| 163 |
+
for y in range(0, h, step):
|
| 164 |
+
for x in range(0, w, step):
|
| 165 |
+
i = (y * w + x) * 4
|
| 166 |
+
l = 0.2126 * px[i] + 0.7152 * px[i + 1] + 0.0722 * px[i + 2]
|
| 167 |
+
# PNG pixels come back linear; convert to a display-ish value for thresholds
|
| 168 |
+
l = (l ** (1 / 2.2)) * 255
|
| 169 |
+
s += l; n += 1
|
| 170 |
+
if l > mx: mx = l
|
| 171 |
+
return s / max(n, 1), mx
|
| 172 |
+
finally:
|
| 173 |
+
bpy.data.images.remove(img)
|
| 174 |
+
|
| 175 |
+
|
| 176 |
+
def fade_amount(t, end):
|
| 177 |
+
"""Designed fades (same as the web film): 0.9 s in, 1.2 s out. Returns 1 when the frame should be black."""
|
| 178 |
+
fi = 1 - min(1, max(0, t / 0.9))
|
| 179 |
+
fo = min(1, max(0, (t - (end - 1.2)) / 1.2))
|
| 180 |
+
return max(fi, fo)
|
| 181 |
+
|
| 182 |
+
|
| 183 |
+
def render_one(scene, frame, path):
|
| 184 |
+
scene.frame_set(frame)
|
| 185 |
+
scene.render.filepath = path
|
| 186 |
+
bpy.ops.render.render(write_still=True)
|
| 187 |
+
|
| 188 |
+
|
| 189 |
+
def render_frames(scene, o, log):
|
| 190 |
+
frames_dir = os.path.join(o['out'], 'frames')
|
| 191 |
+
os.makedirs(frames_dir, exist_ok=True)
|
| 192 |
+
fps = o['fps']
|
| 193 |
+
f0, f1 = int(o['start'] * fps) + 1, int(o['end'] * fps)
|
| 194 |
+
step = max(1, int(round((o['qa_step'] or 0) * fps))) if o['qa_step'] else 1
|
| 195 |
+
engine, device = configure_engine(scene, o, o['device'])
|
| 196 |
+
log(f'引擎 {engine} · 设备 {device} · {o["w"]}×{o["h"]} · {o["samples"]} 采样 · 帧 {f0}–{f1}(步长 {step})')
|
| 197 |
+
report = {'frames': 0, 'skipped': 0, 'black_fixed': [], 'substituted': [], 'dark': [], 'per_frame': []}
|
| 198 |
+
last_good = None
|
| 199 |
+
t_start = time.time()
|
| 200 |
+
for frame in range(f0, f1 + 1, step):
|
| 201 |
+
t = (frame - 1) / fps
|
| 202 |
+
path = os.path.join(frames_dir, f'{frame:05d}.png')
|
| 203 |
+
expect_black = fade_amount(t, o['end']) > 0.97
|
| 204 |
+
if o['resume'] and os.path.exists(path) and os.path.getsize(path) > 0:
|
| 205 |
+
mean, mx = frame_luma(path)
|
| 206 |
+
if expect_black or mx >= 6:
|
| 207 |
+
report['skipped'] += 1
|
| 208 |
+
report['per_frame'].append([frame, round(mean, 1), round(mx, 1)])
|
| 209 |
+
last_good = path
|
| 210 |
+
continue
|
| 211 |
+
render_one(scene, frame, path)
|
| 212 |
+
mean, mx = frame_luma(path)
|
| 213 |
+
if not expect_black and mx < 6:
|
| 214 |
+
# ---- black frame: escalate (CPU, no denoise, +1 EV) and re-render, up to 3 levels
|
| 215 |
+
fixed = False
|
| 216 |
+
for level, (dev, dn, ev) in enumerate([('CPU', True, 0.0), ('CPU', False, 1.0), ('CPU', False, 2.0)]):
|
| 217 |
+
log(f' 第 {frame} 帧({t:.2f}s)渲染为全黑 → 第 {level + 1} 级修复:{dev}、降噪 {"开" if dn else "关"}、曝光 +{ev}')
|
| 218 |
+
configure_engine(scene, o, dev, dn)
|
| 219 |
+
base_ev = scene.view_settings.exposure
|
| 220 |
+
scene.view_settings.exposure = base_ev + ev
|
| 221 |
+
render_one(scene, frame, path)
|
| 222 |
+
scene.view_settings.exposure = base_ev
|
| 223 |
+
mean, mx = frame_luma(path)
|
| 224 |
+
if mx >= 6:
|
| 225 |
+
fixed = True
|
| 226 |
+
break
|
| 227 |
+
configure_engine(scene, o, o['device'])
|
| 228 |
+
if fixed:
|
| 229 |
+
report['black_fixed'].append(frame)
|
| 230 |
+
elif last_good:
|
| 231 |
+
import shutil
|
| 232 |
+
shutil.copyfile(last_good, path)
|
| 233 |
+
report['substituted'].append(frame)
|
| 234 |
+
log(f' 第 {frame} 帧仍为黑,已用前一帧替代')
|
| 235 |
+
else:
|
| 236 |
+
log(f' 第 {frame} 帧仍为黑,且没有可替代的前一帧')
|
| 237 |
+
if not expect_black and mean < 10:
|
| 238 |
+
report['dark'].append(frame)
|
| 239 |
+
if mx >= 6:
|
| 240 |
+
last_good = path
|
| 241 |
+
report['frames'] += 1
|
| 242 |
+
report['per_frame'].append([frame, round(mean, 1), round(mx, 1)])
|
| 243 |
+
done = (frame - f0) // step + 1
|
| 244 |
+
total = (f1 - f0) // step + 1
|
| 245 |
+
el = time.time() - t_start
|
| 246 |
+
log(f'帧 {frame}/{f1} 亮度 均值 {mean:.0f} 最大 {mx:.0f} · {done}/{total} 剩余约 {el / done * (total - done) / 60:.1f} 分钟')
|
| 247 |
+
return report, frames_dir, (f0, f1)
|
| 248 |
+
|
| 249 |
+
|
| 250 |
+
# ------------------------------------------------------------------ mux (Blender's own FFmpeg via the sequencer)
|
| 251 |
+
def encode_mp4(o, frames_dir, f0, f1, log):
|
| 252 |
+
bpy.ops.scene.new(type='NEW')
|
| 253 |
+
vse = bpy.context.scene
|
| 254 |
+
vse.name = '封装'
|
| 255 |
+
vse.render.fps = o['fps']
|
| 256 |
+
vse.render.resolution_x, vse.render.resolution_y = o['w'], o['h']
|
| 257 |
+
vse.render.resolution_percentage = 100
|
| 258 |
+
vse.frame_start, vse.frame_end = 1, f1 - f0 + 1
|
| 259 |
+
vse.sequence_editor_create()
|
| 260 |
+
seqs = getattr(vse.sequence_editor, 'strips', None) or vse.sequence_editor.sequences # Blender 4.x: sequences, 5.x: strips
|
| 261 |
+
files = [{'name': f'{f:05d}.png'} for f in range(f0, f1 + 1)]
|
| 262 |
+
strip = seqs.new_image(name='frames', filepath=os.path.join(frames_dir, files[0]['name']), channel=1, frame_start=1)
|
| 263 |
+
for f in files[1:]:
|
| 264 |
+
strip.elements.append(f['name'])
|
| 265 |
+
# designed fades, done here (the rendered frames themselves are never black)
|
| 266 |
+
fi, fo = int(0.9 * o['fps']), int(1.2 * o['fps'])
|
| 267 |
+
strip.blend_type = 'ALPHA_OVER'
|
| 268 |
+
strip.blend_alpha = 0.0
|
| 269 |
+
strip.keyframe_insert('blend_alpha', frame=1)
|
| 270 |
+
strip.blend_alpha = 1.0
|
| 271 |
+
strip.keyframe_insert('blend_alpha', frame=1 + fi)
|
| 272 |
+
strip.keyframe_insert('blend_alpha', frame=vse.frame_end - fo)
|
| 273 |
+
strip.blend_alpha = 0.0
|
| 274 |
+
strip.keyframe_insert('blend_alpha', frame=vse.frame_end)
|
| 275 |
+
if o['audio'] and os.path.exists(o['audio']):
|
| 276 |
+
snd = seqs.new_sound(name='audio', filepath=o['audio'], channel=2, frame_start=1 - int(o['start'] * o['fps']))
|
| 277 |
+
snd.frame_final_start = 1
|
| 278 |
+
snd.frame_final_end = vse.frame_end
|
| 279 |
+
log(f'音轨:{o["audio"]}')
|
| 280 |
+
r = vse.render
|
| 281 |
+
try:
|
| 282 |
+
r.image_settings.file_format = 'FFMPEG'
|
| 283 |
+
except TypeError:
|
| 284 |
+
log('这个 Blender 构建没有 FFmpeg(例如 pip 的 bpy 模块):已保留 PNG 序列 frames/,请用完整版 Blender 或 ffmpeg 封装:'
|
| 285 |
+
f'ffmpeg -framerate {o["fps"]} -start_number {f0} -i frames/%05d.png' + (f' -i "{o["audio"]}" -c:a aac -b:a 256k' if o['audio'] else '') + ' -c:v libx264 -pix_fmt yuv420p -crf 17 -movflags +faststart 暮归江南.mp4')
|
| 286 |
+
return None
|
| 287 |
+
r.ffmpeg.format = 'MPEG4'
|
| 288 |
+
r.ffmpeg.codec = 'H264'
|
| 289 |
+
r.ffmpeg.constant_rate_factor = 'HIGH'
|
| 290 |
+
r.ffmpeg.ffmpeg_preset = 'GOOD'
|
| 291 |
+
r.ffmpeg.gopsize = o['fps'] * 2
|
| 292 |
+
r.ffmpeg.use_max_b_frames = False
|
| 293 |
+
r.ffmpeg.audio_codec = 'AAC' if o['audio'] else 'NONE'
|
| 294 |
+
if o['audio']:
|
| 295 |
+
r.ffmpeg.audio_bitrate = 256
|
| 296 |
+
r.film_transparent = False
|
| 297 |
+
vse.view_settings.view_transform = 'Standard'
|
| 298 |
+
name = f'暮归江南_blender_{o["w"]}x{o["h"]}_{o["fps"]}fps.mp4'
|
| 299 |
+
r.filepath = os.path.join(o['out'], name)
|
| 300 |
+
bpy.ops.render.render(animation=True, scene=vse.name)
|
| 301 |
+
return r.filepath
|
| 302 |
+
|
| 303 |
+
|
| 304 |
+
# ------------------------------------------------------------------ main
|
| 305 |
+
def main():
|
| 306 |
+
o = parse_args()
|
| 307 |
+
os.makedirs(o['out'], exist_ok=True)
|
| 308 |
+
logf = open(os.path.join(o['out'], 'render.log'), 'a', encoding='utf-8')
|
| 309 |
+
|
| 310 |
+
def log(msg):
|
| 311 |
+
line = time.strftime('%H:%M:%S ') + msg
|
| 312 |
+
print('[暮归江南] ' + msg, flush=True)
|
| 313 |
+
logf.write(line + '\n'); logf.flush()
|
| 314 |
+
|
| 315 |
+
log('生成场景…')
|
| 316 |
+
load_scene_script()
|
| 317 |
+
scene = bpy.context.scene
|
| 318 |
+
harden_against_black(scene)
|
| 319 |
+
report, frames_dir, (f0, f1) = render_frames(scene, o, log)
|
| 320 |
+
bad = [pf for pf in report['per_frame'] if pf[2] < 6 and fade_amount((pf[0] - 1) / o['fps'], o['end']) <= 0.97]
|
| 321 |
+
log(f'渲染完成:{report["frames"]} 帧(续渲跳过 {report["skipped"]}),自动修复黑帧 {len(report["black_fixed"])},前帧替代 {len(report["substituted"])},'
|
| 322 |
+
f'偏暗帧 {len(report["dark"])},最终非设计黑帧 {len(bad)}')
|
| 323 |
+
mp4 = None
|
| 324 |
+
if not o['qa_step']:
|
| 325 |
+
log('封装 MP4(Blender 内置 FFmpeg,H.264 High / yuv420p)…')
|
| 326 |
+
mp4 = encode_mp4(o, frames_dir, f0, f1, log)
|
| 327 |
+
ok = bool(mp4) and os.path.exists(mp4) and os.path.getsize(mp4) > 1000
|
| 328 |
+
log(f'输出:{mp4}({os.path.getsize(mp4) / 1048576:.1f} MB)' if ok else '封装失败:没有生成 MP4')
|
| 329 |
+
report['mp4'] = mp4
|
| 330 |
+
report['black_frames_final'] = [b[0] for b in bad]
|
| 331 |
+
with open(os.path.join(o['out'], 'report.json'), 'w', encoding='utf-8') as fp:
|
| 332 |
+
json.dump(report, fp, ensure_ascii=False, indent=1)
|
| 333 |
+
log('报告:' + os.path.join(o['out'], 'report.json'))
|
| 334 |
+
logf.close()
|
| 335 |
+
|
| 336 |
+
|
| 337 |
+
if __name__ == '__main__':
|
| 338 |
+
main()
|
src/jiangnan/JiangnanApp.tsx
CHANGED
|
@@ -2,6 +2,8 @@ import { memo, useCallback, useEffect, useMemo, useRef, useState } from 'react'
|
|
| 2 |
import './jiangnan.css'
|
| 3 |
import { buildMix } from './audio/mixer'
|
| 4 |
import blenderScript from './blender/jiangnan_village.py?raw'
|
|
|
|
|
|
|
| 5 |
import { chars, formatTags, LIVE_COPY, PLATFORMS } from './copy/platforms'
|
| 6 |
import { Film, Quality, renderIds } from './engine/Film'
|
| 7 |
import { DURATION, SHOTS, shotAt } from './engine/timeline'
|
|
@@ -399,11 +401,19 @@ export default function JiangnanApp() {
|
|
| 399 |
<LiveSection film={filmRef} ready={ready} withBusy={withBusy} say={say} />
|
| 400 |
|
| 401 |
<section className="jn-sec">
|
| 402 |
-
<h2>Blender
|
| 403 |
-
<p className="lead">同一座村庄的 Blender 版本
|
| 404 |
<div className="jn-row">
|
| 405 |
-
<button className="jn-btn" onClick={() => download(new Blob([blenderScript], { type: 'text/x-python' }), 'jiangnan_village.py')}>下载 jiangnan_village.py</button>
|
| 406 |
-
<
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 407 |
</div>
|
| 408 |
</section>
|
| 409 |
|
|
|
|
| 2 |
import './jiangnan.css'
|
| 3 |
import { buildMix } from './audio/mixer'
|
| 4 |
import blenderScript from './blender/jiangnan_village.py?raw'
|
| 5 |
+
import renderScript from './blender/render_film.py?raw'
|
| 6 |
+
import { audioBufferToWav } from './export/wav'
|
| 7 |
import { chars, formatTags, LIVE_COPY, PLATFORMS } from './copy/platforms'
|
| 8 |
import { Film, Quality, renderIds } from './engine/Film'
|
| 9 |
import { DURATION, SHOTS, shotAt } from './engine/timeline'
|
|
|
|
| 401 |
<LiveSection film={filmRef} ready={ready} withBusy={withBusy} say={say} />
|
| 402 |
|
| 403 |
<section className="jn-sec">
|
| 404 |
+
<h2>Blender 路线:离线渲染出片(推荐,彻底绕开浏览器黑屏)</h2>
|
| 405 |
+
<p className="lead">同一座村庄的 Blender 版本。画面由 Cycles / EEVEE 离线渲染成 PNG 落盘,MP4 由 Blender 内置 FFmpeg 编码,<b>不经过浏览器的 WebGL 画布和显卡硬件编码器</b>——网页导出黑屏的两个来源在这条路线上不存在。渲染脚本对每一帧做亮度检查:黑帧自动改用 CPU、关降噪、提曝光重渲,仍黑则用前一帧替代并写入报告;支持断点续渲。</p>
|
| 406 |
<div className="jn-row">
|
| 407 |
+
<button className="jn-btn" onClick={() => download(new Blob([blenderScript], { type: 'text/x-python' }), 'jiangnan_village.py')}>① 下载 jiangnan_village.py(场景)</button>
|
| 408 |
+
<button className="jn-btn" onClick={() => download(new Blob([renderScript], { type: 'text/x-python' }), 'render_film.py')}>② 下载 render_film.py(出片)</button>
|
| 409 |
+
<button className="jn-btn" disabled={!audioReady} onClick={() => { const b = audioRef.current.buf; if (b) download(audioBufferToWav(b), '暮归江南_音轨.wav') }}>③ 导出音轨 WAV(配乐 / 音效 / 旁白)</button>
|
| 410 |
+
</div>
|
| 411 |
+
<div className="jn-note" style={{ marginTop: 10, lineHeight: 1.7 }}>
|
| 412 |
+
把两份脚本放在同一个文件夹,在终端执行(Windows 把 <code>blender</code> 换成 Blender 安装目录里的 blender.exe):<br />
|
| 413 |
+
<code>blender -b -P render_film.py -- --out ./out --audio 暮归江南_音轨.wav --preview</code> ← 先用 EEVEE 960×540 几分钟出一版预览<br />
|
| 414 |
+
<code>blender -b -P render_film.py -- --out ./out --audio 暮归江南_音轨.wav</code> ← Cycles 1080p、64 采样 + 降噪(独显约 1–3 小时)<br />
|
| 415 |
+
<code>blender -b -P render_film.py -- --out ./out --audio 暮归江南_音轨.wav --final --res 3840x2160</code> ← 4K 成片<br />
|
| 416 |
+
<code>--qa-step 2</code> 只做全片抽帧黑帧检查(每 2 秒一帧,不出 MP4);中断后重新执行同一条命令会跳过已渲好的帧。成片在 <code>out/暮归江南_blender_*.mp4</code>,检查报告在 <code>out/report.json</code>。需要 Blender 4.2 LTS 及以上。
|
| 417 |
</div>
|
| 418 |
</section>
|
| 419 |
|
src/jiangnan/blender/jiangnan_village.py
CHANGED
|
@@ -190,6 +190,21 @@ def terrain_height(x, z):
|
|
| 190 |
|
| 191 |
|
| 192 |
# ------------------------------------------------------------------ helpers
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 193 |
def clear_scene():
|
| 194 |
bpy.ops.object.select_all(action='SELECT')
|
| 195 |
bpy.ops.object.delete(use_global=False)
|
|
@@ -522,7 +537,7 @@ def build_wheel(M, coll):
|
|
| 522 |
pivot.keyframe_insert('rotation_euler', frame=1)
|
| 523 |
pivot.rotation_euler.rotate_axis('Y', 0.42 * DURATION)
|
| 524 |
pivot.keyframe_insert('rotation_euler', frame=int(DURATION * FPS) + 1)
|
| 525 |
-
for fc in pivot.animation_data.action
|
| 526 |
for kp in fc.keyframe_points:
|
| 527 |
kp.interpolation = 'LINEAR'
|
| 528 |
return pivot
|
|
@@ -658,10 +673,16 @@ def build_sky_and_sun(scene):
|
|
| 658 |
nt = world.node_tree
|
| 659 |
bg = nt.nodes.get('Background')
|
| 660 |
sky = nt.nodes.new('ShaderNodeTexSky')
|
| 661 |
-
|
|
|
|
|
|
|
|
|
|
| 662 |
sky.sun_rotation = math.pi / 2 + 0.2 + math.pi / 2 # sets toward west-north-west
|
| 663 |
sky.air_density = 1.2
|
| 664 |
-
sky
|
|
|
|
|
|
|
|
|
|
| 665 |
nt.links.new(sky.outputs['Color'], bg.inputs['Color'])
|
| 666 |
# twilight layer: deep blue dome with a warm afterglow band, faded in after sunset
|
| 667 |
tw = nt.nodes.new('ShaderNodeBackground')
|
|
@@ -702,14 +723,14 @@ def build_sky_and_sun(scene):
|
|
| 702 |
sun_data.color = (1.0, lerp(0.38, 0.76, smoothstep(0, 9, e)), lerp(0.14, 0.52, smoothstep(0, 9, e)))
|
| 703 |
sun_data.keyframe_insert('energy', frame=f)
|
| 704 |
sun_data.keyframe_insert('color', frame=f)
|
| 705 |
-
bg.inputs['Strength'].default_value = lerp(0.0,
|
| 706 |
bg.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 707 |
moon_data.energy = 0.35 * smoothstep(-1.5, -8.5, e)
|
| 708 |
moon_data.keyframe_insert('energy', frame=f)
|
| 709 |
-
tw.inputs['Strength'].default_value = 0.
|
| 710 |
tw.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 711 |
# camera eye adaptation, like the web version
|
| 712 |
-
scene.view_settings.exposure = lerp(0.
|
| 713 |
scene.view_settings.keyframe_insert('exposure', frame=f)
|
| 714 |
# thin evening mist: a bounded volume over the valley (a world volume would swallow the sky)
|
| 715 |
bpy.ops.mesh.primitive_cube_add(size=1, location=(0, 0, 30))
|
|
@@ -721,13 +742,13 @@ def build_sky_and_sun(scene):
|
|
| 721 |
nt2 = mm.node_tree
|
| 722 |
nt2.nodes.remove(nt2.nodes.get('Principled BSDF'))
|
| 723 |
vol = nt2.nodes.new('ShaderNodeVolumePrincipled')
|
| 724 |
-
vol.inputs['Density'].default_value = 0.
|
| 725 |
vol.inputs['Color'].default_value = (0.85, 0.8, 0.9, 1)
|
| 726 |
nt2.links.new(vol.outputs['Volume'], nt2.nodes.get('Material Output').inputs['Volume'])
|
| 727 |
mist.data.materials.append(mm)
|
| 728 |
mist.visible_shadow = False
|
| 729 |
vol.inputs['Density'].keyframe_insert('default_value', frame=1)
|
| 730 |
-
vol.inputs['Density'].default_value = 0.
|
| 731 |
vol.inputs['Density'].keyframe_insert('default_value', frame=int(80 * FPS))
|
| 732 |
|
| 733 |
|
|
@@ -803,12 +824,23 @@ def setup_render(scene):
|
|
| 803 |
scene.cycles.samples = 128
|
| 804 |
scene.cycles.use_denoising = True
|
| 805 |
scene.cycles.max_bounces = 6
|
| 806 |
-
|
| 807 |
-
|
| 808 |
-
|
| 809 |
-
|
| 810 |
-
|
| 811 |
-
scene.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 812 |
scene.render.filepath = '//暮归江南_blender_'
|
| 813 |
|
| 814 |
|
|
|
|
| 190 |
|
| 191 |
|
| 192 |
# ------------------------------------------------------------------ helpers
|
| 193 |
+
def action_fcurves(action):
|
| 194 |
+
"""F-curves of an action on Blender 4.x (action.fcurves) and 5.x (layered actions: slots → channelbags)."""
|
| 195 |
+
if hasattr(action, 'fcurves') and action.fcurves is not None:
|
| 196 |
+
try:
|
| 197 |
+
return list(action.fcurves)
|
| 198 |
+
except Exception:
|
| 199 |
+
pass
|
| 200 |
+
out = []
|
| 201 |
+
for layer in getattr(action, 'layers', []):
|
| 202 |
+
for strip in layer.strips:
|
| 203 |
+
for cb in getattr(strip, 'channelbags', []):
|
| 204 |
+
out.extend(cb.fcurves)
|
| 205 |
+
return out
|
| 206 |
+
|
| 207 |
+
|
| 208 |
def clear_scene():
|
| 209 |
bpy.ops.object.select_all(action='SELECT')
|
| 210 |
bpy.ops.object.delete(use_global=False)
|
|
|
|
| 537 |
pivot.keyframe_insert('rotation_euler', frame=1)
|
| 538 |
pivot.rotation_euler.rotate_axis('Y', 0.42 * DURATION)
|
| 539 |
pivot.keyframe_insert('rotation_euler', frame=int(DURATION * FPS) + 1)
|
| 540 |
+
for fc in action_fcurves(pivot.animation_data.action):
|
| 541 |
for kp in fc.keyframe_points:
|
| 542 |
kp.interpolation = 'LINEAR'
|
| 543 |
return pivot
|
|
|
|
| 673 |
nt = world.node_tree
|
| 674 |
bg = nt.nodes.get('Background')
|
| 675 |
sky = nt.nodes.new('ShaderNodeTexSky')
|
| 676 |
+
try:
|
| 677 |
+
sky.sky_type = 'NISHITA' # Blender 4.x
|
| 678 |
+
except TypeError:
|
| 679 |
+
sky.sky_type = 'MULTIPLE_SCATTERING' # Blender 5.x name for the same physical sky
|
| 680 |
sky.sun_rotation = math.pi / 2 + 0.2 + math.pi / 2 # sets toward west-north-west
|
| 681 |
sky.air_density = 1.2
|
| 682 |
+
if hasattr(sky, 'dust_density'):
|
| 683 |
+
sky.dust_density = 2.5
|
| 684 |
+
else:
|
| 685 |
+
sky.aerosol_density = 2.5 # Blender 5.x
|
| 686 |
nt.links.new(sky.outputs['Color'], bg.inputs['Color'])
|
| 687 |
# twilight layer: deep blue dome with a warm afterglow band, faded in after sunset
|
| 688 |
tw = nt.nodes.new('ShaderNodeBackground')
|
|
|
|
| 723 |
sun_data.color = (1.0, lerp(0.38, 0.76, smoothstep(0, 9, e)), lerp(0.14, 0.52, smoothstep(0, 9, e)))
|
| 724 |
sun_data.keyframe_insert('energy', frame=f)
|
| 725 |
sun_data.keyframe_insert('color', frame=f)
|
| 726 |
+
bg.inputs['Strength'].default_value = lerp(0.0, 0.6, smoothstep(-5, 2, e))
|
| 727 |
bg.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 728 |
moon_data.energy = 0.35 * smoothstep(-1.5, -8.5, e)
|
| 729 |
moon_data.keyframe_insert('energy', frame=f)
|
| 730 |
+
tw.inputs['Strength'].default_value = 0.22 * smoothstep(1.0, -4.0, e)
|
| 731 |
tw.inputs['Strength'].keyframe_insert('default_value', frame=f)
|
| 732 |
# camera eye adaptation, like the web version
|
| 733 |
+
scene.view_settings.exposure = lerp(-0.3, 1.4, smoothstep(1, -9, e))
|
| 734 |
scene.view_settings.keyframe_insert('exposure', frame=f)
|
| 735 |
# thin evening mist: a bounded volume over the valley (a world volume would swallow the sky)
|
| 736 |
bpy.ops.mesh.primitive_cube_add(size=1, location=(0, 0, 30))
|
|
|
|
| 742 |
nt2 = mm.node_tree
|
| 743 |
nt2.nodes.remove(nt2.nodes.get('Principled BSDF'))
|
| 744 |
vol = nt2.nodes.new('ShaderNodeVolumePrincipled')
|
| 745 |
+
vol.inputs['Density'].default_value = 0.0005
|
| 746 |
vol.inputs['Color'].default_value = (0.85, 0.8, 0.9, 1)
|
| 747 |
nt2.links.new(vol.outputs['Volume'], nt2.nodes.get('Material Output').inputs['Volume'])
|
| 748 |
mist.data.materials.append(mm)
|
| 749 |
mist.visible_shadow = False
|
| 750 |
vol.inputs['Density'].keyframe_insert('default_value', frame=1)
|
| 751 |
+
vol.inputs['Density'].default_value = 0.0011
|
| 752 |
vol.inputs['Density'].keyframe_insert('default_value', frame=int(80 * FPS))
|
| 753 |
|
| 754 |
|
|
|
|
| 824 |
scene.cycles.samples = 128
|
| 825 |
scene.cycles.use_denoising = True
|
| 826 |
scene.cycles.max_bounces = 6
|
| 827 |
+
avail = [i.identifier for i in scene.view_settings.bl_rna.properties['view_transform'].enum_items]
|
| 828 |
+
for vt in ('AgX', 'Filmic', 'Standard'):
|
| 829 |
+
if vt in avail:
|
| 830 |
+
scene.view_settings.view_transform = vt
|
| 831 |
+
break
|
| 832 |
+
looks = [i.identifier for i in scene.view_settings.bl_rna.properties['look'].enum_items]
|
| 833 |
+
for lk in ('AgX - Medium High Contrast', 'Medium High Contrast', 'AgX - Punchy', 'Punchy', 'None'):
|
| 834 |
+
if lk in looks:
|
| 835 |
+
scene.view_settings.look = lk
|
| 836 |
+
break
|
| 837 |
+
try:
|
| 838 |
+
scene.render.image_settings.file_format = 'FFMPEG'
|
| 839 |
+
scene.render.ffmpeg.format = 'MPEG4'
|
| 840 |
+
scene.render.ffmpeg.codec = 'H264'
|
| 841 |
+
scene.render.ffmpeg.constant_rate_factor = 'HIGH'
|
| 842 |
+
except TypeError:
|
| 843 |
+
scene.render.image_settings.file_format = 'PNG' # builds without FFmpeg (e.g. the bpy pip module)
|
| 844 |
scene.render.filepath = '//暮归江南_blender_'
|
| 845 |
|
| 846 |
|
src/jiangnan/blender/render_film.py
ADDED
|
@@ -0,0 +1,338 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# -*- coding: utf-8 -*-
|
| 2 |
+
"""
|
| 3 |
+
《暮归江南》Blender 离线出片脚本 —— 生成场景 → 逐帧渲染 → 逐帧黑帧检查与自动修复 → 淡入淡出 → 合成音轨 → 编码 MP4 → 报告
|
| 4 |
+
|
| 5 |
+
用法(命令行,无界面):
|
| 6 |
+
blender -b -P render_film.py -- --out ./out [--engine CYCLES|EEVEE] [--samples 64] [--res 1920x1080] [--fps 24]
|
| 7 |
+
[--start 0] [--end 86] [--audio 暮归江南_音轨.wav] [--preview | --final]
|
| 8 |
+
[--qa-step 2] (只做全片抽帧黑帧检查:每 2 秒渲一帧,不出 MP4)
|
| 9 |
+
也可以在 Blender 的 Scripting 面板直接 Run Script(用默认参数,输出到 .blend 同目录的 out/)。
|
| 10 |
+
|
| 11 |
+
为什么黑屏在这里不会出现:
|
| 12 |
+
· 画面由 Cycles / EEVEE 离线渲染成 PNG 落盘,MP4 由 Blender 内置 FFmpeg(libx264, yuv420p)编码,
|
| 13 |
+
不经过浏览器的 WebGL 画布和显卡硬件编码器(网页版黑帧的来源)。
|
| 14 |
+
· 每一帧渲染完都会读回像素做亮度检查;黑帧自动改用 CPU、关闭降噪、提高曝光重渲;
|
| 15 |
+
仍然黑则用前一帧替代并写进报告——输出里不会有一帧「意外的黑」。
|
| 16 |
+
· Nishita 天空在日落后被钳住、世界亮度有下限、胶片不透明、输出 RGB。
|
| 17 |
+
"""
|
| 18 |
+
import bpy
|
| 19 |
+
import os
|
| 20 |
+
import sys
|
| 21 |
+
import math
|
| 22 |
+
import json
|
| 23 |
+
import time
|
| 24 |
+
import importlib.util
|
| 25 |
+
|
| 26 |
+
HERE = os.path.dirname(os.path.abspath(__file__)) if '__file__' in globals() else os.getcwd()
|
| 27 |
+
|
| 28 |
+
|
| 29 |
+
# ------------------------------------------------------------------ arguments
|
| 30 |
+
def parse_args():
|
| 31 |
+
argv = sys.argv[sys.argv.index('--') + 1:] if '--' in sys.argv else []
|
| 32 |
+
o = {'out': os.path.join(HERE, 'out'), 'engine': 'CYCLES', 'samples': 64, 'res': '1920x1080', 'fps': 24, 'start': 0.0, 'end': 86.0,
|
| 33 |
+
'audio': None, 'qa_step': None, 'preview': False, 'final': False, 'device': 'GPU', 'resume': True}
|
| 34 |
+
i = 0
|
| 35 |
+
while i < len(argv):
|
| 36 |
+
a = argv[i]
|
| 37 |
+
nxt = argv[i + 1] if i + 1 < len(argv) else None
|
| 38 |
+
if a == '--out': o['out'] = nxt; i += 1
|
| 39 |
+
elif a == '--engine': o['engine'] = nxt.upper(); i += 1
|
| 40 |
+
elif a == '--samples': o['samples'] = int(nxt); i += 1
|
| 41 |
+
elif a == '--res': o['res'] = nxt; i += 1
|
| 42 |
+
elif a == '--fps': o['fps'] = int(nxt); i += 1
|
| 43 |
+
elif a == '--start': o['start'] = float(nxt); i += 1
|
| 44 |
+
elif a == '--end': o['end'] = float(nxt); i += 1
|
| 45 |
+
elif a == '--audio': o['audio'] = nxt; i += 1
|
| 46 |
+
elif a == '--qa-step': o['qa_step'] = float(nxt); i += 1
|
| 47 |
+
elif a == '--device': o['device'] = nxt.upper(); i += 1
|
| 48 |
+
elif a == '--preview': o['preview'] = True
|
| 49 |
+
elif a == '--final': o['final'] = True
|
| 50 |
+
elif a == '--no-resume': o['resume'] = False
|
| 51 |
+
i += 1
|
| 52 |
+
if o['preview']:
|
| 53 |
+
o['engine'] = 'EEVEE'; o['res'] = '960x540'; o['samples'] = 16
|
| 54 |
+
if o['final']:
|
| 55 |
+
o['engine'] = 'CYCLES'; o['samples'] = 256
|
| 56 |
+
o['w'], o['h'] = [int(x) for x in o['res'].lower().split('x')]
|
| 57 |
+
return o
|
| 58 |
+
|
| 59 |
+
|
| 60 |
+
# ------------------------------------------------------------------ scene
|
| 61 |
+
def load_scene_script():
|
| 62 |
+
"""Run jiangnan_village.py from the same folder (builds the whole village into the current scene)."""
|
| 63 |
+
path = os.path.join(HERE, 'jiangnan_village.py')
|
| 64 |
+
spec = importlib.util.spec_from_file_location('jiangnan_village', path)
|
| 65 |
+
mod = importlib.util.module_from_spec(spec)
|
| 66 |
+
spec.loader.exec_module(mod)
|
| 67 |
+
mod.main()
|
| 68 |
+
return mod
|
| 69 |
+
|
| 70 |
+
|
| 71 |
+
def harden_against_black(scene):
|
| 72 |
+
"""Settings that make a black frame impossible by construction (see README section I.1)."""
|
| 73 |
+
r = scene.render
|
| 74 |
+
r.film_transparent = False
|
| 75 |
+
r.image_settings.file_format = 'PNG'
|
| 76 |
+
r.image_settings.color_mode = 'RGB'
|
| 77 |
+
r.image_settings.color_depth = '8'
|
| 78 |
+
r.image_settings.compression = 50
|
| 79 |
+
r.use_file_extension = True
|
| 80 |
+
r.dither_intensity = 1.0
|
| 81 |
+
# world brightness floor: a tiny constant emission under the sky so the dome is never exactly 0
|
| 82 |
+
world = scene.world
|
| 83 |
+
if world and world.use_nodes:
|
| 84 |
+
nt = world.node_tree
|
| 85 |
+
out = nt.nodes.get('World Output')
|
| 86 |
+
floor = nt.nodes.new('ShaderNodeBackground')
|
| 87 |
+
floor.name = '亮度下限'
|
| 88 |
+
floor.inputs['Color'].default_value = (0.004, 0.006, 0.012, 1)
|
| 89 |
+
floor.inputs['Strength'].default_value = 1.0
|
| 90 |
+
add = nt.nodes.new('ShaderNodeAddShader')
|
| 91 |
+
prev = out.inputs['Surface'].links[0].from_socket if out.inputs['Surface'].links else None
|
| 92 |
+
if prev is not None:
|
| 93 |
+
nt.links.new(prev, add.inputs[0])
|
| 94 |
+
nt.links.new(floor.outputs['Background'], add.inputs[1])
|
| 95 |
+
nt.links.new(add.outputs['Shader'], out.inputs['Surface'])
|
| 96 |
+
# cameras never start clipping inside a wall / canopy that is right at the lens
|
| 97 |
+
for ob in scene.objects:
|
| 98 |
+
if ob.type == 'CAMERA':
|
| 99 |
+
ob.data.clip_start = 0.3
|
| 100 |
+
ob.data.clip_end = 12000
|
| 101 |
+
|
| 102 |
+
|
| 103 |
+
def configure_engine(scene, o, device='GPU', denoise=True):
|
| 104 |
+
r = scene.render
|
| 105 |
+
want = 'CYCLES' if o['engine'] == 'CYCLES' else None
|
| 106 |
+
if want is None:
|
| 107 |
+
for eng in ('BLENDER_EEVEE_NEXT', 'BLENDER_EEVEE'):
|
| 108 |
+
try:
|
| 109 |
+
r.engine = eng
|
| 110 |
+
want = eng
|
| 111 |
+
break
|
| 112 |
+
except TypeError:
|
| 113 |
+
continue
|
| 114 |
+
else:
|
| 115 |
+
r.engine = 'CYCLES'
|
| 116 |
+
if r.engine == 'CYCLES':
|
| 117 |
+
c = scene.cycles
|
| 118 |
+
c.samples = o['samples']
|
| 119 |
+
c.use_denoising = denoise
|
| 120 |
+
c.max_bounces = 6
|
| 121 |
+
c.use_adaptive_sampling = True
|
| 122 |
+
c.device = 'GPU' if device == 'GPU' else 'CPU'
|
| 123 |
+
if device == 'GPU':
|
| 124 |
+
try:
|
| 125 |
+
prefs = bpy.context.preferences.addons['cycles'].preferences
|
| 126 |
+
enabled = False
|
| 127 |
+
for backend in ('OPTIX', 'CUDA', 'HIP', 'METAL', 'ONEAPI'):
|
| 128 |
+
try:
|
| 129 |
+
prefs.compute_device_type = backend
|
| 130 |
+
prefs.get_devices()
|
| 131 |
+
for d in prefs.devices:
|
| 132 |
+
if d.type != 'CPU':
|
| 133 |
+
d.use = True
|
| 134 |
+
enabled = True
|
| 135 |
+
if enabled:
|
| 136 |
+
break
|
| 137 |
+
except Exception:
|
| 138 |
+
continue
|
| 139 |
+
if not enabled:
|
| 140 |
+
c.device = 'CPU'
|
| 141 |
+
except Exception:
|
| 142 |
+
c.device = 'CPU'
|
| 143 |
+
else:
|
| 144 |
+
try:
|
| 145 |
+
scene.eevee.taa_render_samples = max(16, o['samples'])
|
| 146 |
+
except Exception:
|
| 147 |
+
pass
|
| 148 |
+
r.resolution_x, r.resolution_y = o['w'], o['h']
|
| 149 |
+
r.resolution_percentage = 100
|
| 150 |
+
r.fps = o['fps']
|
| 151 |
+
return r.engine, (scene.cycles.device if r.engine == 'CYCLES' else 'GPU')
|
| 152 |
+
|
| 153 |
+
|
| 154 |
+
# ------------------------------------------------------------------ frame QA
|
| 155 |
+
def frame_luma(path):
|
| 156 |
+
"""Mean / max luminance (0–255) of a rendered PNG, sampled on a coarse grid (fast, no PIL needed)."""
|
| 157 |
+
img = bpy.data.images.load(path, check_existing=False)
|
| 158 |
+
try:
|
| 159 |
+
w, h = img.size
|
| 160 |
+
px = img.pixels[:] # linear float RGBA
|
| 161 |
+
step = max(1, min(w, h) // 24)
|
| 162 |
+
n, s, mx = 0, 0.0, 0.0
|
| 163 |
+
for y in range(0, h, step):
|
| 164 |
+
for x in range(0, w, step):
|
| 165 |
+
i = (y * w + x) * 4
|
| 166 |
+
l = 0.2126 * px[i] + 0.7152 * px[i + 1] + 0.0722 * px[i + 2]
|
| 167 |
+
# PNG pixels come back linear; convert to a display-ish value for thresholds
|
| 168 |
+
l = (l ** (1 / 2.2)) * 255
|
| 169 |
+
s += l; n += 1
|
| 170 |
+
if l > mx: mx = l
|
| 171 |
+
return s / max(n, 1), mx
|
| 172 |
+
finally:
|
| 173 |
+
bpy.data.images.remove(img)
|
| 174 |
+
|
| 175 |
+
|
| 176 |
+
def fade_amount(t, end):
|
| 177 |
+
"""Designed fades (same as the web film): 0.9 s in, 1.2 s out. Returns 1 when the frame should be black."""
|
| 178 |
+
fi = 1 - min(1, max(0, t / 0.9))
|
| 179 |
+
fo = min(1, max(0, (t - (end - 1.2)) / 1.2))
|
| 180 |
+
return max(fi, fo)
|
| 181 |
+
|
| 182 |
+
|
| 183 |
+
def render_one(scene, frame, path):
|
| 184 |
+
scene.frame_set(frame)
|
| 185 |
+
scene.render.filepath = path
|
| 186 |
+
bpy.ops.render.render(write_still=True)
|
| 187 |
+
|
| 188 |
+
|
| 189 |
+
def render_frames(scene, o, log):
|
| 190 |
+
frames_dir = os.path.join(o['out'], 'frames')
|
| 191 |
+
os.makedirs(frames_dir, exist_ok=True)
|
| 192 |
+
fps = o['fps']
|
| 193 |
+
f0, f1 = int(o['start'] * fps) + 1, int(o['end'] * fps)
|
| 194 |
+
step = max(1, int(round((o['qa_step'] or 0) * fps))) if o['qa_step'] else 1
|
| 195 |
+
engine, device = configure_engine(scene, o, o['device'])
|
| 196 |
+
log(f'引擎 {engine} · 设备 {device} · {o["w"]}×{o["h"]} · {o["samples"]} 采样 · 帧 {f0}–{f1}(步长 {step})')
|
| 197 |
+
report = {'frames': 0, 'skipped': 0, 'black_fixed': [], 'substituted': [], 'dark': [], 'per_frame': []}
|
| 198 |
+
last_good = None
|
| 199 |
+
t_start = time.time()
|
| 200 |
+
for frame in range(f0, f1 + 1, step):
|
| 201 |
+
t = (frame - 1) / fps
|
| 202 |
+
path = os.path.join(frames_dir, f'{frame:05d}.png')
|
| 203 |
+
expect_black = fade_amount(t, o['end']) > 0.97
|
| 204 |
+
if o['resume'] and os.path.exists(path) and os.path.getsize(path) > 0:
|
| 205 |
+
mean, mx = frame_luma(path)
|
| 206 |
+
if expect_black or mx >= 6:
|
| 207 |
+
report['skipped'] += 1
|
| 208 |
+
report['per_frame'].append([frame, round(mean, 1), round(mx, 1)])
|
| 209 |
+
last_good = path
|
| 210 |
+
continue
|
| 211 |
+
render_one(scene, frame, path)
|
| 212 |
+
mean, mx = frame_luma(path)
|
| 213 |
+
if not expect_black and mx < 6:
|
| 214 |
+
# ---- black frame: escalate (CPU, no denoise, +1 EV) and re-render, up to 3 levels
|
| 215 |
+
fixed = False
|
| 216 |
+
for level, (dev, dn, ev) in enumerate([('CPU', True, 0.0), ('CPU', False, 1.0), ('CPU', False, 2.0)]):
|
| 217 |
+
log(f' 第 {frame} 帧({t:.2f}s)渲染为全黑 → 第 {level + 1} 级修复:{dev}、降噪 {"开" if dn else "关"}、曝光 +{ev}')
|
| 218 |
+
configure_engine(scene, o, dev, dn)
|
| 219 |
+
base_ev = scene.view_settings.exposure
|
| 220 |
+
scene.view_settings.exposure = base_ev + ev
|
| 221 |
+
render_one(scene, frame, path)
|
| 222 |
+
scene.view_settings.exposure = base_ev
|
| 223 |
+
mean, mx = frame_luma(path)
|
| 224 |
+
if mx >= 6:
|
| 225 |
+
fixed = True
|
| 226 |
+
break
|
| 227 |
+
configure_engine(scene, o, o['device'])
|
| 228 |
+
if fixed:
|
| 229 |
+
report['black_fixed'].append(frame)
|
| 230 |
+
elif last_good:
|
| 231 |
+
import shutil
|
| 232 |
+
shutil.copyfile(last_good, path)
|
| 233 |
+
report['substituted'].append(frame)
|
| 234 |
+
log(f' 第 {frame} 帧仍为黑,已用前一帧替代')
|
| 235 |
+
else:
|
| 236 |
+
log(f' 第 {frame} 帧仍为黑,且没有可替代的前一帧')
|
| 237 |
+
if not expect_black and mean < 10:
|
| 238 |
+
report['dark'].append(frame)
|
| 239 |
+
if mx >= 6:
|
| 240 |
+
last_good = path
|
| 241 |
+
report['frames'] += 1
|
| 242 |
+
report['per_frame'].append([frame, round(mean, 1), round(mx, 1)])
|
| 243 |
+
done = (frame - f0) // step + 1
|
| 244 |
+
total = (f1 - f0) // step + 1
|
| 245 |
+
el = time.time() - t_start
|
| 246 |
+
log(f'帧 {frame}/{f1} 亮度 均值 {mean:.0f} 最大 {mx:.0f} · {done}/{total} 剩余约 {el / done * (total - done) / 60:.1f} 分钟')
|
| 247 |
+
return report, frames_dir, (f0, f1)
|
| 248 |
+
|
| 249 |
+
|
| 250 |
+
# ------------------------------------------------------------------ mux (Blender's own FFmpeg via the sequencer)
|
| 251 |
+
def encode_mp4(o, frames_dir, f0, f1, log):
|
| 252 |
+
bpy.ops.scene.new(type='NEW')
|
| 253 |
+
vse = bpy.context.scene
|
| 254 |
+
vse.name = '封装'
|
| 255 |
+
vse.render.fps = o['fps']
|
| 256 |
+
vse.render.resolution_x, vse.render.resolution_y = o['w'], o['h']
|
| 257 |
+
vse.render.resolution_percentage = 100
|
| 258 |
+
vse.frame_start, vse.frame_end = 1, f1 - f0 + 1
|
| 259 |
+
vse.sequence_editor_create()
|
| 260 |
+
seqs = getattr(vse.sequence_editor, 'strips', None) or vse.sequence_editor.sequences # Blender 4.x: sequences, 5.x: strips
|
| 261 |
+
files = [{'name': f'{f:05d}.png'} for f in range(f0, f1 + 1)]
|
| 262 |
+
strip = seqs.new_image(name='frames', filepath=os.path.join(frames_dir, files[0]['name']), channel=1, frame_start=1)
|
| 263 |
+
for f in files[1:]:
|
| 264 |
+
strip.elements.append(f['name'])
|
| 265 |
+
# designed fades, done here (the rendered frames themselves are never black)
|
| 266 |
+
fi, fo = int(0.9 * o['fps']), int(1.2 * o['fps'])
|
| 267 |
+
strip.blend_type = 'ALPHA_OVER'
|
| 268 |
+
strip.blend_alpha = 0.0
|
| 269 |
+
strip.keyframe_insert('blend_alpha', frame=1)
|
| 270 |
+
strip.blend_alpha = 1.0
|
| 271 |
+
strip.keyframe_insert('blend_alpha', frame=1 + fi)
|
| 272 |
+
strip.keyframe_insert('blend_alpha', frame=vse.frame_end - fo)
|
| 273 |
+
strip.blend_alpha = 0.0
|
| 274 |
+
strip.keyframe_insert('blend_alpha', frame=vse.frame_end)
|
| 275 |
+
if o['audio'] and os.path.exists(o['audio']):
|
| 276 |
+
snd = seqs.new_sound(name='audio', filepath=o['audio'], channel=2, frame_start=1 - int(o['start'] * o['fps']))
|
| 277 |
+
snd.frame_final_start = 1
|
| 278 |
+
snd.frame_final_end = vse.frame_end
|
| 279 |
+
log(f'音轨:{o["audio"]}')
|
| 280 |
+
r = vse.render
|
| 281 |
+
try:
|
| 282 |
+
r.image_settings.file_format = 'FFMPEG'
|
| 283 |
+
except TypeError:
|
| 284 |
+
log('这个 Blender 构建没有 FFmpeg(例如 pip 的 bpy 模块):已保留 PNG 序列 frames/,请用完整版 Blender 或 ffmpeg 封装:'
|
| 285 |
+
f'ffmpeg -framerate {o["fps"]} -start_number {f0} -i frames/%05d.png' + (f' -i "{o["audio"]}" -c:a aac -b:a 256k' if o['audio'] else '') + ' -c:v libx264 -pix_fmt yuv420p -crf 17 -movflags +faststart 暮归江南.mp4')
|
| 286 |
+
return None
|
| 287 |
+
r.ffmpeg.format = 'MPEG4'
|
| 288 |
+
r.ffmpeg.codec = 'H264'
|
| 289 |
+
r.ffmpeg.constant_rate_factor = 'HIGH'
|
| 290 |
+
r.ffmpeg.ffmpeg_preset = 'GOOD'
|
| 291 |
+
r.ffmpeg.gopsize = o['fps'] * 2
|
| 292 |
+
r.ffmpeg.use_max_b_frames = False
|
| 293 |
+
r.ffmpeg.audio_codec = 'AAC' if o['audio'] else 'NONE'
|
| 294 |
+
if o['audio']:
|
| 295 |
+
r.ffmpeg.audio_bitrate = 256
|
| 296 |
+
r.film_transparent = False
|
| 297 |
+
vse.view_settings.view_transform = 'Standard'
|
| 298 |
+
name = f'暮归江南_blender_{o["w"]}x{o["h"]}_{o["fps"]}fps.mp4'
|
| 299 |
+
r.filepath = os.path.join(o['out'], name)
|
| 300 |
+
bpy.ops.render.render(animation=True, scene=vse.name)
|
| 301 |
+
return r.filepath
|
| 302 |
+
|
| 303 |
+
|
| 304 |
+
# ------------------------------------------------------------------ main
|
| 305 |
+
def main():
|
| 306 |
+
o = parse_args()
|
| 307 |
+
os.makedirs(o['out'], exist_ok=True)
|
| 308 |
+
logf = open(os.path.join(o['out'], 'render.log'), 'a', encoding='utf-8')
|
| 309 |
+
|
| 310 |
+
def log(msg):
|
| 311 |
+
line = time.strftime('%H:%M:%S ') + msg
|
| 312 |
+
print('[暮归江南] ' + msg, flush=True)
|
| 313 |
+
logf.write(line + '\n'); logf.flush()
|
| 314 |
+
|
| 315 |
+
log('生成场景…')
|
| 316 |
+
load_scene_script()
|
| 317 |
+
scene = bpy.context.scene
|
| 318 |
+
harden_against_black(scene)
|
| 319 |
+
report, frames_dir, (f0, f1) = render_frames(scene, o, log)
|
| 320 |
+
bad = [pf for pf in report['per_frame'] if pf[2] < 6 and fade_amount((pf[0] - 1) / o['fps'], o['end']) <= 0.97]
|
| 321 |
+
log(f'渲染完成:{report["frames"]} 帧(续渲跳过 {report["skipped"]}),自动修复黑帧 {len(report["black_fixed"])},前帧替代 {len(report["substituted"])},'
|
| 322 |
+
f'偏暗帧 {len(report["dark"])},最终非设计黑帧 {len(bad)}')
|
| 323 |
+
mp4 = None
|
| 324 |
+
if not o['qa_step']:
|
| 325 |
+
log('封装 MP4(Blender 内置 FFmpeg,H.264 High / yuv420p)…')
|
| 326 |
+
mp4 = encode_mp4(o, frames_dir, f0, f1, log)
|
| 327 |
+
ok = bool(mp4) and os.path.exists(mp4) and os.path.getsize(mp4) > 1000
|
| 328 |
+
log(f'输出:{mp4}({os.path.getsize(mp4) / 1048576:.1f} MB)' if ok else '封装失败:没有生成 MP4')
|
| 329 |
+
report['mp4'] = mp4
|
| 330 |
+
report['black_frames_final'] = [b[0] for b in bad]
|
| 331 |
+
with open(os.path.join(o['out'], 'report.json'), 'w', encoding='utf-8') as fp:
|
| 332 |
+
json.dump(report, fp, ensure_ascii=False, indent=1)
|
| 333 |
+
log('报告:' + os.path.join(o['out'], 'report.json'))
|
| 334 |
+
logf.close()
|
| 335 |
+
|
| 336 |
+
|
| 337 |
+
if __name__ == '__main__':
|
| 338 |
+
main()
|
src/jiangnan/export/wav.ts
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
// AudioBuffer → 16-bit PCM WAV (for muxing the browser-synthesised soundtrack into the Blender render)
|
| 2 |
+
export function audioBufferToWav(buf: AudioBuffer): Blob {
|
| 3 |
+
const ch = Math.min(2, buf.numberOfChannels), n = buf.length, sr = buf.sampleRate
|
| 4 |
+
const data = new ArrayBuffer(44 + n * ch * 2)
|
| 5 |
+
const v = new DataView(data)
|
| 6 |
+
const str = (o: number, s: string) => { for (let i = 0; i < s.length; i++) v.setUint8(o + i, s.charCodeAt(i)) }
|
| 7 |
+
str(0, 'RIFF'); v.setUint32(4, 36 + n * ch * 2, true); str(8, 'WAVE'); str(12, 'fmt ')
|
| 8 |
+
v.setUint32(16, 16, true); v.setUint16(20, 1, true); v.setUint16(22, ch, true); v.setUint32(24, sr, true)
|
| 9 |
+
v.setUint32(28, sr * ch * 2, true); v.setUint16(32, ch * 2, true); v.setUint16(34, 16, true)
|
| 10 |
+
str(36, 'data'); v.setUint32(40, n * ch * 2, true)
|
| 11 |
+
const chans = Array.from({ length: ch }, (_, i) => buf.getChannelData(i))
|
| 12 |
+
let o = 44
|
| 13 |
+
for (let i = 0; i < n; i++) for (let c = 0; c < ch; c++) {
|
| 14 |
+
const s = Math.max(-1, Math.min(1, chans[c][i]))
|
| 15 |
+
v.setInt16(o, s < 0 ? s * 32768 : s * 32767, true)
|
| 16 |
+
o += 2
|
| 17 |
+
}
|
| 18 |
+
return new Blob([data], { type: 'audio/wav' })
|
| 19 |
+
}
|