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 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`(仓库里也有 `blender/jiangnan_village.py`),Blender 4.x → Scripting → Run Script,约 1–2 分钟生成完整场景,Cycles 渲染。
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.fcurves:
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
- sky.sky_type = 'NISHITA'
 
 
 
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.dust_density = 2.5
 
 
 
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, 1.0, smoothstep(-5, 2, e))
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.6 * smoothstep(1.0, -4.0, e)
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.0, 3.2, smoothstep(1, -9, e))
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.0012
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.0026
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
- scene.view_settings.view_transform = 'AgX' if 'AgX' in [i.identifier for i in scene.view_settings.bl_rna.properties['view_transform'].enum_items] else 'Filmic'
807
- scene.view_settings.look = 'None'
808
- scene.render.image_settings.file_format = 'FFMPEG'
809
- scene.render.ffmpeg.format = 'MPEG4'
810
- scene.render.ffmpeg.codec = 'H264'
811
- scene.render.ffmpeg.constant_rate_factor = 'HIGH'
 
 
 
 
 
 
 
 
 
 
 
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 场景脚本</h2>
403
- <p className="lead">同一座村庄的 Blender 版本:在 Blender 4.x 的「脚本」面板里打开并运行,会自动生成地形、河道、徽派民居、石拱桥、水车、古樟、灯笼、日落到夜晚的灯光关键帧和 10 个镜头的摄像机,可用 Cycles 离线渲染 4K。</p>
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
- <span className="jn-note" style={{ margin: 0 }}>使用:Blender → Scripting → 打开脚本 → Run Script(约 1 分钟)。</span>
 
 
 
 
 
 
 
 
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.fcurves:
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
- sky.sky_type = 'NISHITA'
 
 
 
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.dust_density = 2.5
 
 
 
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, 1.0, smoothstep(-5, 2, e))
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.6 * smoothstep(1.0, -4.0, e)
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.0, 3.2, smoothstep(1, -9, e))
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.0012
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.0026
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
- scene.view_settings.view_transform = 'AgX' if 'AgX' in [i.identifier for i in scene.view_settings.bl_rna.properties['view_transform'].enum_items] else 'Filmic'
807
- scene.view_settings.look = 'None'
808
- scene.render.image_settings.file_format = 'FFMPEG'
809
- scene.render.ffmpeg.format = 'MPEG4'
810
- scene.render.ffmpeg.codec = 'H264'
811
- scene.render.ffmpeg.constant_rate_factor = 'HIGH'
 
 
 
 
 
 
 
 
 
 
 
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
+ }