更新日志

版本 0.9.3 (2026年5月3日)

  • 各向异性定向模糊 (blur.wgsl): 改进了模糊算法,通过计算局部亮度梯度向量,并将模糊核沿边缘切线方向 (edge_dir) 对齐。
  • 引入 Macro-Tangent AA: 引入了亚像素抗锯齿算法(通过在切线方向 ±1.0px 和 ±2.2px 距离上混合采样点)。这能有效消除界面和视频画面中高对比度对角边缘的“锯齿”。
  • 多尺度锐化着色器 (sharpness.wgsl): 该着色器已转换为基于拉普拉斯金字塔分解的方法。分别在三个频段(精细、中等、粗糙)提升锐度,以避免放大噪声。引入了各向异性结构张量计算,以稳定沿边缘的细节。实现了韦伯增益控制机制(Dehalo),以抑制高对比度跃变边界处的白边。
  • 原始帧辅助缓冲区 (Original Frame Buffer): 图形引擎中新增了额外的 original_tex 纹理 (@group(2) @binding(0) var t_original)。在每帧开始时,将干净的已解码帧存储在该缓冲区。后续的着色器链(例如锐化)可以访问此未失真的原始源进行边缘分析,从而避免由于前置后处理着色器引入的累积误差。
  • 着色器安全编译: pipeline.rs 中的编译调用现在被包裹在 device.push_error_scope 错误校验域中。当自定义着色器中存在语法错误时,应用程序不会崩溃,而是在控制台中输出详细的编译错误日志,并安全地回滚到上一个正常的着色器管线版本。

版本 0.9.2 (2026年4月30日)

  • 数据库编辑器: editor.rs 界面新增了“+”(创建空电影记录)和“-”(从 SQLite 数据库中删除所选电影,同时删除所有相关的分季设置和剧集书签)按钮。
  • 视频解码器优化: 在 copy_plane 方法中引入了 YUV 分量复制的边界检查。对于奇数帧分辨率,缺失的行和像素会自动用零填充,从而防止缓冲区越界。将已解码帧发送到队列的操作更改为非阻塞调用 send_timeout(..., Duration::from_millis(50))。当缓冲区溢出时,解码线程不再挂起,从而减少了超高码率视频中出现微小卡顿(micro-stuttering)的概率。
  • 音频时钟稳定: 在 SDL2 音频回调中,累加器 played_samples 的计数现在被严格锁定到系统请求缓冲区的大小 (out.len()),这有助于避免在播放静音场景或发生音频欠载(underrun)时出现音画不同步。

版本 0.9.1 (2026年4月29日)

  • UI 及主题自定义: 实现了通过外部 themes.json 文件的动态主题切换。程序可在运行时即时读取背景、活动元素、按钮、滑块和文本的颜色配置。设置界面内置的主题编辑器允许用户使用实时 RGB 滑块手动调整活动主题的颜色。启动时扫描 fonts/ 文件夹,将唯一字体按 PostScript 名称分组,允许用户为五个功能角色(标题、普通文本、细体文本、特殊文本及字幕)重新分配字体。
  • 国际化 (i18n): 通过 lang/ 文件夹下的外部 .loc 文件(新增了 ru-RU.loc 和 en-US.loc)引入了多语言本地化支持,动态翻译所有界面元素。
  • 着色器热重载 (Hot-Reload): 添加了 ReloadShaders 事件(快捷键“R”),允许从磁盘即时重新读取后处理效果文件,而无需重启视频文件。

版本 0.9.0 (2026年4月28日)

  • 全新设置界面 (settings.rs): 重新构建了应用程序配置界面,采用选项卡方式分离:外观(切换主题、程序化背景类型)、音频(音频输出设备选择)和解码设置。
  • 硬件集成支持: SDL2 回调现在可以向操作系统查询可用的播放设备,从而允许从下拉列表中选择音频输出设备。实现了通过 enumerate_adapters 遍历并手动选择物理显卡以进行硬件渲染加速。新增了用于 FFmpeg 解码负载分配的 CPU 使用核心数选择。
  • 播放器细节改进: 在播放器的音频及着色器面板内为长列表引入了独立的垂直滚动条,以防止列表内容超出屏幕边界。引入了视频启动错误处理器:如果磁盘上缺少文件或解码器崩溃,播放器将安全地切换到显示错误日志的界面,而不会使整个程序崩溃。

版本 0.8.2 (2026年4月26日)

  • 媒体引擎与 GPU 管线: 实现了通过 C-API 从视频流中提取色彩元数据 extract_color_info 的系统。解码器可读取亮度范围(Full vs Limited Range)、色彩空间(BT.709、BT.470BG、BT.601/SMPTE170M、BT.2020)、基色和传输特性类型(SDR、HDR/PQ、HLG)。这些参数通过 uniform 缓冲区(传入 custom 数组的第 14 个插槽)传输至 GPU。视频着色器 pipeline.rs 中添加了 decode_yuv 函数,以便在硬件端利用对应的矩阵即时完成 YUV -> RGB 的格式转换。
  • 后处理着色器: 彻底重写了胶片噪点算法 (grain.wgsl)。后处理效果现在被划分为两个基于 FBM 的独立噪声层:与原始图像轮廓绑定的锚定噪声 (noise_anchored) 以及模拟无序微粒运动的自由噪声 (noise_free)。添加了对噪声伽马值及随机色彩偏移 (HSV) 的调节。

版本 0.8.1 (2026年4月25日)

  • 数据库与元数据分离: 设计并添加了针对剧集类视频的 season_settings 和 episode_bookmarks 数据库表支持。图像、着色器、音频和后处理参数现在已实现相互隔离,并可针对每一季分别进行独立保存,书签则对应具体剧集。扩展了 parse_db_settings 逻辑,以便根据所选的季度和剧集动态加载配置。
  • 目录界面 (catalogue.rs): 引入了 calc_fade_alpha(y: f32) 函数,以在滚动边界处(在 130px 和 970px 范围内)为电影卡片应用柔和的淡出透明度效果。实现了 ScrollList(d) 事件,当通过键盘切换焦点时,可自动平滑滚动并确保右侧列表中的活动元素处于可视区域内。实现了动态故障(Glitch)效果:在快速滚动时,子流派水平菜单的文本将渲染出带有程序化抖动和闪烁的双重偏移阴影(Red/Cyan)。针对溢出边界的超长电影名称和分类添加了 Marquee(沿 X 轴往复滚动的跑马灯)效果。
  • 控制交互: 在 ToggleFilterMode 处理器中内置了过滤规则,当激活按导演或系列电影进行筛选时,系统会自动切换到列表视图展示模式。

版本 0.8.0 (2026年4月24日)

  • 弃用命令行子进程以切换为 C-API (ffmpeg-next): 彻底移除了通过命令行调用 FFmpeg 子进程的代码逻辑。该项目已通过安全 Rust 封装库 ffmpeg-next(链接到 FFmpeg 8.1)转换为直接对解码库进行系统级调用。视频分量、音频样片的解码、缩放和重采样操作均在应用程序本地地址空间内完成,彻底消除了 IPC 开销和内存泄漏隐患。
  • 异步无锁队列机制: 视频帧向图形渲染线程的传输已转移到具备超时控制机制的 crossbeam_channel::bounded 线程安全通道中,消除了微小卡顿。向 SDL2 线程传输音频的操作已转为非阻塞式的环形缓冲区 ringbuf::HeapRb(生产/消费隔离模式),确保即使在 100% CPU 负载下音频也不会出现爆音。
  • 音频处理器低级优化 (SSE 汇编): dsp.rs 中内置的压缩器循环(Soundgoodizer)已利用内联汇编 (asm!) 进行了手动优化。计算模值、限幅比较和硬剪切的操作现在通过 SSE 向量寄存器(利用指令 andps, ucomiss, minss, maxss)来执行,使音频回调函数产生的 CPU 负载降低了 3 倍以上。
  • 孤立封面资源清理服务 (Orphan Covers Cleaner): 在 editor.rs 中添加了 clean_orphan_covers 函数。在保存更改时,数据库会交叉对比所有活动的封面、帧快照和图标路径。所有磁盘上不再使用的 JXL 和 WebP 文件均会被自动删除。
  • 硬件定时器同步: 在音频回调 audio.rs 中,播放样片计数器 played_samples 严格按系统缓冲区大小 (out.len()) 进行自增,而与环形缓冲区中的实际数据量无关。这有效防止了在静音场景或音频数据饥饿时出现音视频同步漂移。

版本 0.7.0 (2026年4月20日)

  • 切换至原生 YUV 渲染: FFmpeg 被配置为输出高位深平面格式 -pix_fmt yuv420p16le(16位 YUV 4:2:0)。在 texture.rs 中分配了三个 R16Unorm 格式的独立纹理通道 VideoY、VideoU 和 VideoV。与传统的 RGBA 相比,这使传送到 GPU 的每帧数据量减少了约 50%。YUV -> RGB 的颜色转换已被转移到硬件端着色器 fs_video 中利用 BT.709 矩阵来完成。
  • 多通道效果管线 (Ping-Pong 缓冲机制): 创建了两个 HDR 格式 Rgba16Float 的 4K 分辨率中间纹理 pass_a_tex 和 pass_b_tex。渲染引擎在这两片纹理之间动态交替切换源目标和渲染目标,以实现后处理着色器链的顺序叠加。
  • 五通道锐化着色器 (sharpness.wgsl): 通道 0 和 1 执行基于 Lanczos4 方法的双向图像放大。通道 2 计算结构张量和高频噪声水平。通道 3 通过亚像素纹理坐标微调来实现边缘细化(Edge Thinning)。通道 4 引入了各向异性流扩散,以抑制图像振铃并保留细腻自然的微观表面纹理。
  • 交互式“放大镜”工具 (Zoom & Pan): 添加了视频图像放大工具(最高支持 5 倍),并支持在左键按下时拖动并平移画面。其坐标参数通过 zoom_factor 和 zoom_offset 变量传递给 UI 着色器。
  • 播放进度保存与自动续播: 实现了每隔 5 秒将播放进度自动保存到 movies.json 文件中。再次打开电影时,将展示“是否继续播放?”的交互式提示窗,以便快速跳转到上次保存的时间点。
  • 双边滤波模糊: blur.wgsl 中的模糊算法增加了基于亮度的双边滤波。像素仅在与其中心像素的亮度差值符合指数分布时才会被模糊,从而较好地保留了物体的高对比度边界。

版本 0.6.0 (2026年4月18日)

  • 电影胶片着色器 (cinema.wgsl): 开发了模拟模拟胶片质感的后处理算法:包括四面体颜色插值(用于模拟画面色调向 Teal & Orange 倾向的色移)、减色混合密度(模拟胶片感光乳剂对物理光线的吸收阻隔)、色彩空间压缩(采用 Cube Shrink 算法来消除画面高饱和霓虹色调处的溢出截断)以及采用 Reinhard 曲线的高光滚降(Highlight Roll-Off)和高光处柔和的去饱和处理。
  • 硬件 3D LUT 解码: 增加了对三维颜色查找表(.cube 文件)的支持。引擎解析来自 shaders/LUT 目录的文件,将其转化为单张 3D 纹理 t_lut (Rgba32Float),并在 GPU 端通过四面体插值进行色彩重采样 (lut.wgsl)。
  • 减色 CMY 着色器 (subtractive.wgsl): 实现了 CMY 空间下的指数级染料通道加深,并具备原片亮度保护 cmy_luma_prot 功能,以防止画面出现不必要的过暗。

版本 0.5.2 (2026年4月15日)

  • 文本对齐修复: 修复了 catalogue.rs 中电影详情文本偏移的 Bug。垂直对齐参数 v_align 被强制设置为 0,从而防止长文本在卡片动态缩放时漂移到裁剪遮罩上方。
  • 多模块编译稳定化: 在根目录 Cargo.toml 中临时禁用了 release 级别的优化配置 (profile.release),以加快增量编译速度,并方便在测试环境中对 FFmpeg 与 SDL2 的多线程交互进行调试。

版本 0.5.1 (2026年4月14日)

  • 界面音频管理器 (UiAudioManager): 在图形渲染引擎中深度集成了基于 SDL2 Audio 的音频子系统。实现了利用 FFmpeg 底层调用对 SFX/ 目录下的 .opus 文件进行解码,以将原始的 pcm_f32le 立体声(48000 Hz)流载入应用程序常驻内存中。
  • 音效混音器 (UiMixer): 研发了专用的音频混音器,支持循环播放环境背景垫乐,并可同时触发极低延迟的短促操作音效 (SFX)。
  • 无缝循环平滑过渡 (Crossfade): 实现了背景音乐的无缝循环算法:当播放接近音频尾部时,混音器将利用正弦淡入淡出曲线将淡出端 (fade_out) 与新起点 (fade_in) 进行重叠平滑混合,从而消除了爆音和卡顿空白。
  • 交互音效事件集成: 在 state.rs 中添加了 AppEvent::PlayUiSound 事件。将音效播放与用户操作绑定:如点击按钮、切换流派和列表滚动。
  • 音效触发频率限制: 引入了 last_played_movie_sfx_idx 过滤变量,以防止在快速动力学滚动电影列表时触发过密音效导致音频系统过载。

版本 0.5.0 (2026年4月13日)

  • 渲染通道架构分离: 重新整理了 pipeline.rs 中的着色器调用逻辑。函数 sample_pipeline 现在仅负责第一阶段的视频帧图像预处理(色彩空间转换及 HDR 到 SDR 的映射)。空间效果(胶片噪点、图像锐化等)被移至统一的、顺序排列的后处理链中,从而消除了各种后处理效果间的相互干扰。
  • 字体图集溢出修复: 在渲染器 Renderer::render 方法的末尾添加了强制调用 self.text_atlas.trim() 的逻辑,彻底解决了长列表快速滚动时因字符堆积导致的 AtlasFull 崩溃。从文本处理 prepare 函数中移除了 .unwrap() 调用,以防在偶发性丢帧时程序异常退出。
  • 程序化计算动态背景: 在 ui.wgsl 像素着色器中,针对混合模式 5u (Color Dodge) 的静态噪声部分已被 fs_background 产生的程序化纹理所替代。这消除了当界面发生移动时,背景模糊由于未跟随重构而产生的冻结感。
  • Mode 12 颜色叠加层: 在 ui.wgsl 中添加了 12u 模式,允许在 SCREEN_BUFFER 之上叠加 Color Dodge 亮部效果,可在背景界面元素之上渲染出发光。
  • 数据库结构自动升级: 在 Db 初始化逻辑中添加了安全的 ALTER TABLE 数据库操作块,在升级旧版本数据库文件时,会自动补充 bookmarks 和 audio_track 字段。

版本 0.4.2 (2026年4月8日)

  • 多波段音频均衡器 (engine/dsp.rs): 基于双极子滤波器(Biquad)级联设计了 8 波段参量均衡器。开发了 Soundgoodizer 动态压缩器算法,支持基于三分频交叉滤波器和独立 TrueCompressor 的四种压缩签名模式(A, B, C, D)。
  • 音频超低延迟: DSP 处理逻辑被直接移入 SDL2 音频回调中(代替以往在 FFmpeg 读取阶段进行处理),从而消除了实时调节音频参数时产生的多秒延迟。
  • 多线程 JPEG XL 解码: 图像解码切换为 jxl-oxide 库,支持通过全局 Rayon 线程池对电影封面进行并行异步解码。
  • 视频图像优化: sharpness.wgsl 中的反遮罩锐化算法加入了局部对比度权重计算,以抑制对比度变换交界处的黑白边缘光晕(Dehalo)。编写了基于 Uncharted 2 映射曲线和 BT.2020 -> BT.709 色彩矩阵的色彩映射器,以便在标准 SDR 显示器上精确呈现 HDR 视频 (PQ)。
  • 功能特性补充: 增加了导出无损 .png 截图至用户桌面的功能。引入了视频书签系统(支持记录存入数据库并在时间轴上渲染刻度)。实现了在视频暂停时,胶片噪点噪点纹理保持静态冻结的功能。
  • 可执行文件体积优化: 在 Cargo.toml 中精细化配置了 release 编译参数(包括 LTO, codegen-units, panic abort 以及 strip 丢弃调试信息),使打包出的单体二进制文件体积成倍缩小。

版本 0.4.1 (2026年4月5日)

  • 多集剧集/美剧模式支持: 引入了能够自动解析季、集目录结构的检测算法。播放器可根据磁盘文件名称(如包含 {第1季} {第2集} 等字符标签)进行智能分组,并在播放器界面中生成季、集下拉选择菜单。
  • 磁盘着色器动态解析: 各种后处理效果着色器被移入 shaders/effects/ 目录下的独立文件中。在 Rust 端编写了专门的文件头解析器(支持提取 // NAME:, // FUNC: 和 // PARAM: 等配置元数据)。程序在启动时自动读取这些文件并在 GUI 中动态绘制出参数调节拉杆。
  • 通用多态参数传参缓冲区: Uniform 缓冲区重构为通用数组 custom: array<vec4<f32>, 16>。此项改动使得在引入全新效果着色器时,无需对 Rust 源码进行任何修改即可完成参数封包投递。
  • 交互与列表滚动优化: 引入了基于线性插值(LERP)的平滑阻尼动力学列表滚动。实现了目录左侧边栏的响应式折叠(在进入“所有电影”模式时,侧边栏会自动折叠至极简状态以留出视觉空间)。

版本 0.4.0 (2026年4月3日)

  • 视频播放引擎集成 (engine/media.rs): 实现了两个 FFmpeg 独立子进程的管道数据读取:一个子进程将视频解码为原始 RGBA 分量,另一个将音频解码为 pcm_f32le 样片流。集成了 sdl2 音频输出模块。帧率同步严格对齐音频输出端时钟(current_audio_time)。
  • 播放器控制台 (screens/player.rs): 编写了专用的视频播放界面,配备了带缓冲指示的时间轴进度条(支持直接点击跳转定位)、控制键组以及快捷配置面板。
  • 动态着色器合成: 实现了运行中即时合成 WGSL 的机制。PipelineManager 可在程序运行时根据用户激活的滤镜选项,读取 original.wgsl 模板并拼接效果着色器调用链,最终动态编译为新着色器管线。
  • 首批着色器后处理效果: 编写了针对视频分量的首批 WGSL 后处理算法:包括胶片噪点 (grain.wgsl)、均值及高斯模糊 (blur.wgsl)、色差 (chroma.wgsl) 以及反遮罩边缘锐化 (sharpness.wgsl)。

版本 0.3.0 (2026年3月25日)

  • 整合 Glyphon: 移除了旧版的 wgpu_text 和 ab_glyph 库,转换为最新的 glyphon 字体渲染管线(版本 0.9.0)。这大幅改善了文字排版的精细度与多语言字符显示,改进了显存字符图集(Atlas)的管理,减少了内存碎片。
  • 多通道离屏渲染 (Offscreen Pass): 在 GpuState 中引入了 offscreen_texture,用作界面背景层的预绘制缓冲区。采用了两阶段绘制结构:在每一帧中,首先将核心图层绘制到离屏缓冲区,之后将其拷贝回主显示卡流并进行重整,在其上叠加高分辨率界面文字与控件。
  • “分散折射毛玻璃”效果: 基于离屏缓冲区,实现了高性能毛玻璃模糊滤镜(对应 ui.wgsl 中的 6u 渲染模式)。模糊采样逻辑基于 IGN(交错梯度噪声)与色散色差,提供了柔和且不损失帧率的半透明界面折射效果。
  • 目录展示界面交互动效 (catalogue.rs):
    • 次级流派滑块:实现了带阻尼的水平惯性滚动,在快速移动时文字边缘伴有色差及动态像素故障效果。
    • 3D 空间立体卡片滚动:设计了垂直立体电影卡片传送带,卡片按物理景深映射至 5 个不等的空间虚拟景深槽位。系统会动态计算每个槽位卡片的缩放比、透明度以及边缘淡化。
  • 数据库结构适配: 为了简化项目早期的联调,core_db 的数据存储方案暂时从依赖繁琐的外键 ID 检索转换为直接存储文本字符串的形式。

版本 0.2.0 (2026年3月23日)

  • 原生文本流体排版: 移除了对外部 egui 库的依赖。在 gui/text_layout.rs 中,使用 ab_glyph 手动实现了针对复杂字符字形宽度的计算、字符行进折行以及文字包围盒 (Bounding Box) 的运算。
  • 全功能文本框输入:
    • 开发了 hit_test 定位算法,支持在点击文字框时精确测定光标位置(字符下标)。
    • 编写了文字的鼠标拖拽框选逻辑 (get_selection_rects)。
    • 集成了 arboard 系统剪贴板接口,支持利用 Ctrl+A/C/V 快捷键进行复制、剪切及粘贴操作。
  • 解决 Rust 所有权编译冲突: 解决了处理输入文本框借用状态时常见的 Rust 编译器 E0499 错误。通过将所有针对文本输入的写操作收拢至 AppState 内的统一 apply_text_logic 方法中来完成安全的状态流转。
  • 界面微交互事件拓展: 新增了系统事件 UpdateCursor(在悬停不同控件时改变系统鼠标状态)和 ToggleMultiSelect(支持下拉框中的按住多选模式)。

版本 0.1.0 (2026年3月21日)

  • 工作区规划: 项目被细分为两个核心 Cargo 子项目:负责底层本地 SQLite 数据库事务的 core_db (调用内置封装的 rusqlite) 以及负责核心界面和渲染的 app_main。
  • 图形技术选型: 放弃了早期技术验证阶段基于 eframe/egui 的快速原型方案,全面使用 Rust 低级图形接口 wgpu(底层绑定 winit 视窗框架)来重构图形引擎。
  • 批处理批渲染器 (GuiComposer): 创建了专门的几何顶点装配器,支持将界面各个模块的顶点和索引信息进行打包组装,在单次 Draw Call 中完成绘制,最大程度减少 GPU 的开销。
  • 基础字符排布: 引入了 wgpu_text 库,在 WGPU 环境中实现了基于 TrueType 字体文件的文字基本输出。
  • 基础着色器实现: 编写了底层的 WGSL 控制着色器 (shader.wgsl),支持多态的几何绘制:
    • 基础几何单色填充。
    • 外部图片(纹理)输出与可变色矢量图标(利用 resvg、usvg 联合 tiny-skia 先行将 SVG 栅格化为位图)。
    • 基础软件模糊与亮部颜色减淡 (Color Dodge) 算法。
  • 数据库结构设计与目录递归扫描: 规范了 cinema.db 数据库的主外键表结构。加入了针对电影条目以及电影类型、分辨率、容器格式的分类维度数据表。集成了基于 walkdir 异步递归扫描指定目录中 .mp4 和 .mkv 视频文件的入库逻辑。
  • 图片辅助转换: 在 image_utils.rs 中编写了调用 FFmpeg 命令行的工具函数,支持自动将各种不规则的电影海报转换为统一的 JPEG XL (.jxl) 高压缩图像。