cinematic subtitles

A subtitle API that can generate subtitles for videos
Back to Files

cinematic_subtitles-0.2.7.jar

File namecinematic_subtitles-0.2.7.jar
Uploaded
Nov 16, 2026
Downloads
0
Size
295.2 KB
Mod Loaders
Forge
File ID
9647357
Type
B
Beta
Supported game versions
  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:cinematic-subtitles-1786568:9647357")

Learn more about Curse Maven

What's new

0.2.7 Update

English

Fixed

  • Glow is no longer "ghosted text". The old glow drew the whole line eight times at a single radius in eight directions, all at the same low opacity — visually eight discrete copies of the glyphs with hard edges. It is now an outline gradient glow: several concentric outline rings with increasing radius and decreasing per-ring opacity (bright inside, fading outward), with sample counts growing with circumference so the band stays continuous. The result is a soft light falloff from the glyph edge outward, close to a Gaussian bloom, instead of equally-bright duplicated glyphs.
  • Fixed "text sometimes flashes once before appearing". Entry presets such as neon_flicker can still land on a dark frame at the very end of their window, but the old code applied the animation only while time < start + entry_duration (an open interval) and stopped applying it afterwards — so RenderParams.alpha jumped straight from a dark-frame value back to the default 1.0. Whether the last frame lands on a bright or dark step depends on frame rate, hence "sometimes". The entry window now converges smoothly back to neutral (smoothstep) at its tail, so the seam at window close is continuous.
  • Fixed "a sudden flash after fading out, then it disappears". Same root cause, but more visible on short lines (line shorter than the entry duration): the entry and exit windows overlap, and the entry window used to snap closed during the fade-out, pulling alpha from a dark frame back to 1.0. With tail convergence the fade-out stays monotonic and no longer rebounds.
  • Fixed exit animation drifting out of sync with the visibility end. compose received a visibleEnd argument but never used it; the exit was normalized against entry.getEnd() + fixed duration, while the subtitle actually disappears at visibleEnd (which can be truncated by the next line's start). This caused "fading that never finishes before the line vanishes / a rebound at the boundary". The exit window now ends at visibleEnd, so the fade always reaches zero exactly when the line is removed and stays at zero (no rebound) afterwards.

Added

  • Gradient glow layer planner GlowLayers (pure Java): larger glow_radius gives more rings (2–6), and the total sample count is budget-capped (96) so a single line is never copied hundreds of times. intensity > 1 now genuinely brightens the rings instead of being clamped away early. Breathing pulse / animated glow multipliers still stack on top.
  • Hidden old_glow toggle (legacy ghosting kept). To switch back to the old "single-radius, 8-direction, equally-bright ghosting" for comparison or regression testing, add "old_glow": true (or "glow_mode": "old", aliases legacy / classic) to the font or glow_effect section. Off by default (i.e. the new gradient glow is the default). Enabling it in either font or glow_effect is enough. This is a hidden option and is not written into the shipped style templates.
  • Animation window continuity envelope AnimationEnvelope (pure Java, deterministic): centralizes entry progress, tail convergence weight, and the visibleEnd-anchored exit window / terminal hold, guaranteeing a frame-by-frame continuous alpha sequence with no isolated spikes across pause / resume / time jumps.
  • New example style glow_gradient_demo.json (gradient glow + breathing pulse, with a comment documenting the hidden old_glow toggle), shipped automatically with the mod.

中文

修复

  • glow 不再是「字体重影」:旧版发光是把整段文字在单一半径的 8 个方向各画一遍、全部用同一个低透明度,肉眼看到的是 8 个离散字形副本,边缘生硬。现改为描边渐变发光——多层同心描边环,半径从内到外递增、每层透明度递减(内亮外淡),每环的采样点随周长增多以保证光带连续。叠加结果是从文字边缘向外平滑淡出的柔光,近似高斯辉光,不再是等亮度的字形复制。
  • 修复「字体有时候闪一下然后再出现」:neon_flicker 等入场动画在窗口末端 alpha 仍可能落在暗帧,而旧逻辑在 time < start + 入场时长 这个开区间之外就不再应用动画,导致 RenderParams.alpha 从暗帧值直接跳回默认 1.0。最后一帧落在亮帧还是暗帧取决于帧率,因此表现为「有时候」闪一下。现在入场窗口末端会按 smoothstep 平滑收敛回中性,窗口关闭前后无缝衔接。
  • 修复「渐隐后突然闪一下然后消失」:同上根因在短句(句长小于入场时长)时更明显——入场与出场窗口重叠,入场窗口在渐隐进行中突然关闭,把 alpha 从暗帧拉回 1.0。收敛修复后渐隐过程单调、不再回弹。
  • 修复出场动画与可见终点不对齐:compose 此前接收 visibleEnd 参数却完全没用,出场以 entry.getEnd() + 固定时长 归一化,而字幕实际在 visibleEnd(会被下一句开始时间截断)消失,导致「渐隐没走完就突然消失 / 边界回弹」。现在出场窗口以 visibleEnd 为终点,渐隐总在字幕移除那一刻恰好归零,越过终点后保持终态 0、不回弹。

新增

  • 渐变发光层规划器 GlowLayers(纯 Java):glow_radius 越大层数越多(2~6 层),采样点总数受预算约束(上限 96),避免一行文字被复制上百次拖垮帧率;intensity > 1 能真正提亮光环而不被提前截平。呼吸脉冲 / 动画发光倍率照常叠加。
  • 隐藏开关 old_glow(保留旧版重影):如需切回旧版「单半径 8 方向等亮重影」做对比 / 回归测试,在 font 或 glow_effect 段加 "old_glow": true,或写 "glow_mode": "old"(别名 legacy / classic)。默认关闭(即默认用新的渐变发光)。glow_effect 与 font 任一方开启即生效。这是隐藏配置,不写进正式样式模板。
  • 动画窗口连续性包络 AnimationEnvelope(纯 Java、确定性):统一管理入场进度、末端收敛权重、以 visibleEnd 为基准的出场窗口与终点保持,保证 alpha 序列逐帧连续、无孤立尖峰,暂停 / 恢复 / 跳时间都不跳变。
  • 新增示例样式 glow_gradient_demo.json(渐变发光 + 呼吸脉冲,并在注释里说明隐藏 old_glow 写法),随模组自动释放。

This mod has no additional files