把文学呼吸写进客户端帧率:双 Ren'Py 实机演出工程拆解
好的剧情策划不应止步于 Word 台词表。本卷实事求是展示同一世界观下两套已跑通的 Ren'Py 可执行工程——聚焦幽闭独白心理剧的《少女的反叛 v05(少女の反逆)》与聚焦边境群像政治剧的《阿提拉斯:佩尔序幕 v0.3.3》,并提供零安装浏览器 WebGL2 + WebAudio 实机交互体验切片。
| 工程构建代号 | 叙事体裁与视角 | 文本与节拍规模 | 核心客户端演出模块(真实已实现代码) | 工程验证状态 |
|---|---|---|---|---|
| 《少女的反叛》 v05 典籍光学与声景版 |
第一人称高塔独白心理剧(圣女蒂娅) | 全篇 28 场(S01–S28),311 页源文本拆分为 624 个剧情节点(312 个演出 Beat) |
mahoyo_fx_v5.rpy(GL2 空气尘埃着色器 + RGBA 透明半身立绘)、soundscape_v05.rpy(S13/S14 纯器乐 + Lowpass(340) 认知失联低通)、text_rhythm_v04.rpy 与 music_v04.rpy |
多套件自动化回归通过 |
| 《阿提拉斯:佩尔序幕》 v0.3.3 |
多角色群像边境政治与酒馆潜行剧 | 完整序幕章节 + 等轴测酒馆舞台调度 | CGCamera(renpy.Displayable) 超采样三次平滑推镜、marble_ui.rpy 卡拉拉白大理石古典定制界面、cue_audio 五声道环境总线 |
客户端可运行验收 |
微观演出实例:S04“黄铜镜前练习微笑”为什么要拆成两个独立 Beat?
在源文本第 4 场中,蒂娅在侍女注视下对着模糊铜镜摆出温和圣洁的微笑,而在侍女转身收拾梳具的刹那收起嘴角。若将整段话塞进同一个对话框,画面将丧失最关键的“面具脱落感”。工程上将其精确切分为连续双 Beat(这也是全篇 311 页源文本生成 312 个实机 Beat 的原因)——点击下方按钮切换对比两拍实机画面:
单击检视 2000×1125 实机原图 ⊕
双工程实机运行画面:从高塔晨光独白到佩尔边境群像
左侧为《少女的反叛》开篇晨光实机画面;中间与右侧为同世界观前传《阿提拉斯:佩尔序幕 v0.3.3》的河道夜逃 CG 推镜与酒馆群像对峙界面,展示古典大理石定制 UI 与多图层舞台透视。
圣女篇 S01 实机 ⊕
佩尔序幕 CG 推镜 ⊕
1888×1062 母版在 1600×900 视口内做平滑横摇。
2168×1219
酒馆舞台调度 ⊕
V6 角色几何校准流水线、去框悬浮立绘与 Krea2 × Swiss 平面重构
经逆向拆解 34 套 Krea2 工作流后,全面重构全剧 5 枚 RGBA 半身立绘:以平静母版死锁颅骨比例与平齐眼水平线(Y=195px),剔除生硬纯黑铁丝描边与下颌黑块、以彩色可变线稿 + 高塔环境光学重打光(1.5px 呼吸边 + 丝滑底端微尘消融)替代直尺硬切;标题徽签与对话框同步弃用厚黑高斯模糊投影与四边闭盒,实装 0.75px 星盘矢量线纹与破框悬浮对话系统。
V6 KREA2 × SWISS 角色流水线海报 · 1:1 审阅 ⊕
0.75px 星盘坐标及全五态眼水平线校准底片带。
1920×1080 · V6 PIPELINE ARCHIVE
V6 无模糊题签『少女の反逆』⊕
ShipporiMincho 高反差暖白衬线与古铜金 0.75px 星盘标尺,靠左栏空气暗角达成零遮挡读字对比。
TYPOGRAPHY V6 · TITLE
V6 破框悬浮立绘合框 ⊕
S01-CG01、S04 铜镜)仍自动避让防双脸。
BREAK-OUT CAMEO · V6
纯器乐减法织体与 340Hz 主观失联声学实验室
遵照 S13 (RITE) 与 S14 (THORN) 全程“零合唱、零人声采样、纯器乐与拟音承载压迫感”导演律令:高潮刺痛瞬间不堆叠宏大交响,而是抽空一切中低频只留一根 E7 小提琴高音泛音;在“但我无心倾听”处对信众狂潮实时注入 340 Hz 低通滤波器,将玩家拽入少女抽离麻木的主观耳蜗听感。点击下方真实工程音轨试听并实时拖拽滤波截止频率(在 HTTP/HTTPS 托管与本地演示环境下驱动真实 WebAudio BiquadFilterNode 频谱演算):
核心客户端演出代码解析:镜头插值、语境字速与相位锁定音轨
以下摘自项目仓库真实运行的 cinematic_presentation.rpy、text_rhythm_v04.rpy 与 music_v04.rpy 核心机制,不依赖任何重型外部黑盒插件,纯原生 Python / Ren'Py Displayable 即可稳定复现。
class CGCamera(renpy.Displayable):
"""在 1600x900 视口内对 1888x1062 超采样母版执行无锯齿平滑推摇"""
def render(self, width, height, st, at):
p = min(1.0, max(0.0, st / self.duration)) if self.duration > 0 else 1.0
# Cubic Smoothstep 缓入缓出,消除线性平移的机械生硬感
q = p * p * (3.0 - 2.0 * p)
cx = self.x0 + (self.x1 - self.x0) * q
cy = self.y0 + (self.y1 - self.y0) * q
zoom = self.z0 + (self.z1 - self.z0) * q
child = Transform(
self.child, zoom=zoom, xanchor=0.5, yanchor=0.5,
xpos=int(round(width * 0.5 - cx * zoom)),
ypos=int(round(height * 0.5 - cy * zoom))
)
if p < 1.0:
renpy.redraw(self, 0)
return renpy.render(child, width, height, st, at)
# 1. 四类戏剧语境基准字速与句读呼吸权重(不破坏 say screen id="what")
RHYTHM_CONTEXT_PROFILES = {
"daily": {"cps_mul": 1.00, "comma": 0.14, "period": 0.28, "ellipsis": 0.42},
"grief": {"cps_mul": 0.76, "comma": 0.22, "period": 0.40, "ellipsis": 0.60},
"suspense": {"cps_mul": 0.84, "comma": 0.20, "period": 0.36, "ellipsis": 0.55},
"urgent": {"cps_mul": 1.28, "comma": 0.08, "period": 0.16, "ellipsis": 0.24},
}
# 2. 7 分轨相位锁定起播:切换情绪层时保持小节拍点严丝合缝
def start_stem_bank(bank_prefix, stems):
for ch_name, track_path in stems.items():
renpy.music.play(
track_path,
channel=ch_name,
loop=True,
synchro_start=True,
fadein=1.2
)
renpy.register_shader("attilas.mahoyo_air", variables="""
uniform float u_time;
uniform float u_mode;
varying vec2 v_tex_coord;
""", fragment_300="""
// Mode 0: 月光微尘呼吸 / Mode 1: 东墙玫瑰窗焦散折射 / Mode 2: 3500K 黄昏斜射丁达尔束
float beam = smoothstep(0.75, 0.10, length(v_tex_coord.xy - vec2(0.32, 0.34)));
float breathe = sin(u_time * 0.48) * 0.018 * beam;
gl_FragColor.rgb = clamp(gl_FragColor.rgb * (1.0 + breathe), 0.0, 1.0);
""")
elif beat == "S14-002-02":
# 痛觉减法:抽空全部低频弦乐与管风琴,仅留独奏 E7 小提琴泛音与近距刺入拟音
_ss_set_thorn_stem_gains({"celesta": 0.90}, fade=0.08)
_ss_play_foley("audio/v05/foley_thorn_pierce.wav", vol=0.90)
elif beat == "S14-009-01":
# “但我无心倾听”:实时对广场人群声浪施加 340Hz 低通滤波制造麻木抽离感
_ss_set_crowd(True, vol=0.40, fade=0.25, lowpass_hz=340)
_ss_play_foley("audio/v05/foley_thorn_retract_breath.wav", vol=0.88)