WezTerm 光标闪烁缓动曲线cursor_blink_ease_out配置深入解析【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/weztermcursor_blink_ease_out是 WezTerm 中用于控制文本光标在闪烁时淡出阶段颜色变化的**缓动函数easing function**配置项。本篇文章将以 cursor_blink_ease_out.md 为核心结合 WezTerm 源码中的实际实现config、wezterm-guicrate完整讲解该配置项的语法、可用取值、底层计算原理、与cursor_blink_ease_in、cursor_blink_rate等相邻配置的配合方式并给出可直接复制使用的配置示例。读完本文你将能精准定制光标闪烁的动画节奏兼顾视觉效果与渲染开销。配置项总览属性说明配置键cursor_blink_ease_out默认值Linear引入版本20220319-142410-0fcdea07即 2022-03-19 发布版标签appearance、text_cursor外观/文本光标数据类型字符串或表指定缓动函数作用对象文本光标在闪烁循环中由亮变暗、逐渐淡出的颜色过渡该配置项的作用是当光标设置为闪烁样式时指定计算光标颜色的缓动函数。缓动函数决定了光标的颜色强度从最大值衰减到不可见淡出的过渡节奏而不是简单地在可见/不可见之间二值切换。值得强调的是cursor_blink_ease_out所定义的淡出阶段其对应的缓动曲线会以1 减去缓动函数求值结果的方式参与最终颜色强度的计算详见下文源码分析因此实际观察到的效果是光标亮度随时间逐渐降低而不是按照函数原始曲线直接上升。工作原理从二值闪烁到缓动过渡在 WezTerm 的历史版本中闪烁光标是二进制式的可见与不可见直接切换。自20220319-142410-0fcdea07版本起WezTerm 将闪烁行为改为缓动过渡。这一点在仓库的 docs/changelog.md 中有明确记载Blinking text cursor is now eased rather than binary-blinked.同时该版本也为cursor_blink_ease_out、cursor_blink_ease_in等相关配置补充了对应的{{since(...)}}标记确认这一行为变更自该版本起生效。整个闪烁循环由一对缓动函数与一个周期速率协同驱动cursor_blink_ease_in控制光标从不可见到可见淡入阶段的过渡节奏cursor_blink_ease_out控制光标从可见到不可见淡出阶段的过渡节奏cursor_blink_rate以毫秒为单位指定光标在可见与不可见之间切换的频率即一个完整闪烁周期的时长。默认值为800毫秒设为0可禁用闪烁。在 cursor_blink_rate.md 中明确说明光标闪烁由cursor_blink_ease_in与cursor_blink_ease_out两个缓动函数控制且闪烁周期数值因系统事件循环的定时器调度机制而存在一定误差——非零值只会至少达到指定间隔并附带一定程度的偏差slop。源码中的接线方式在 config/src/config.rs 中两个缓动函数与闪烁速率被声明为Config的字段pub cursor_blink_ease_in: EasingFunction, pub cursor_blink_rate: u64, pub cursor_blink_ease_out: EasingFunction,其中cursor_blink_rate的默认值在 default_cursor_blink_rate() 中定义为800毫秒fn default_cursor_blink_rate() - u64 { 800 }而在 wezterm-gui/src/termwindow/mod.rs 中cursor_blink_state将这三个配置打包进ColorEase结构体其中淡入阶段使用cursor_blink_ease_in淡出阶段使用cursor_blink_ease_outcursor_blink_state: RefCell::new(ColorEase::new( config.cursor_blink_rate, config.cursor_blink_ease_in, config.cursor_blink_rate, config.cursor_blink_ease_out, None, )),注意这里传入的前两个参数时长 淡入函数与后两个参数时长 淡出函数中时长均为cursor_blink_rate即淡入与淡出各占半个周期。在配置热更新时wezterm-gui/src/termwindow/mod.rs 会依据新配置重新构造ColorEase从而让新配置立即生效。缓动函数的取值与语义关于缓动函数的具体语义原文档明确指引读者参考 visual_bell.md同属docs/config/lua/config/目录该文档用同款缓动函数体系控制视觉铃铛的淡入淡出。WezTerm 的缓动函数体系与 CSS easing functions 类似支持以下取值取值语义对应的三次贝塞尔参数Linear以恒定速率过渡默认值(0, 0, 1, 1)Ease缓慢开始中段急剧加速末尾逐渐减速(0.25, 0.1, 0.25, 1.0)EaseIn缓慢开始随后持续加速结尾骤停(0.42, 0, 1, 1)EaseInOut缓慢开始、加速、再减速至结尾(0.42, 0, 0.58, 1)EaseOut开头骤起随后持续减速(0, 0, 0.58, 1)Constant始终求值为 0用于在时长结束时产生阶跃切换自 20220408-101518-b908e2dd 起可用(0, 0, 0, 0){CubicBezier{0.0, 0.0, 0.58, 1.0}}使用任意四次参数的自定义三次贝塞尔曲线由用户指定源码中的枚举与贝塞尔映射这一系列取值在源码 config/src/bell.rs 中定义为EasingFunction枚举pub enum EasingFunction { Linear, CubicBezier(f32, f32, f32, f32), Ease, EaseIn, EaseInOut, EaseOut, Constant, }每个变体到三次贝塞尔控制点的映射定义在as_bezier_array()方法中config/src/bell.rsmatch self { Self::Constant [0., 0., 0., 0.], Self::Linear [0., 0., 1.0, 1.0], Self::CubicBezier(a, b, c, d) [*a, *b, *c, *d], Self::Ease [0.25, 0.1, 0.25, 1.0], Self::EaseIn [0.42, 0.0, 1.0, 1.0], Self::EaseInOut [0.42, 0., 0.58, 1.0], Self::EaseOut [0., 0., 0.58, 1.0], }贝塞尔曲线求值使用标准三次贝塞尔公式config/src/bell.rs即对四个控制点按位置参数x进行三次插值。同时EasingFunction的Default实现为Easeconfig/src/bell.rs这意味着视觉铃铛等使用该类型的其他配置默认走Ease曲线而cursor_blink_ease_out字段由于没有显式标注#[dynamic(default ...)]其默认值由类型默认与wezterm-dynamic反序列化共同决定文档标注的默认行为为Linear淡出阶段线性衰减。底层计算逻辑ColorEase与淡出阶段在 wezterm-gui/src/colorease.rs 中ColorEase结构体完整记录了淡入/淡出的时长与函数pub struct ColorEase { in_duration: f32, in_function: EasingFunction, out_duration: f32, out_function: EasingFunction, start: OptionInstant, last_render: Instant, }其核心求值逻辑位于intensity_one_shot()wezterm-gui/src/colorease.rs淡入阶段当经过时间elapsed小于in_duration时直接对淡入函数在归一化位置elapsed / in_duration上求值得到强度淡出阶段当elapsed超过in_duration后计算淡出阶段的完成度completion (elapsed - in_duration) / out_duration此时强度为1.0 - out_function.evaluate_at_position(completion)。let intensity if elapsed self.in_duration { Some( self.in_function .evaluate_at_position(elapsed / self.in_duration), ) } else { let completion (elapsed - self.in_duration) / self.out_duration; if completion 1.0 { None } else { Some(1.0 - self.out_function.evaluate_at_position(completion)) } };这一行1.0 - out_function.evaluate_at_position(completion)正是cursor_blink_ease_out的全部意义所在淡出阶段的光标强度 1 减去缓动函数在完成度上的求值结果。当完成度达到 1.0 时返回None表示本周期结束连续闪烁模式intensity_continuous见 wezterm-gui/src/colorease.rs会立即开启新一轮周期。此外该结构体还负责驱动动画帧调度帧率取config::configuration().animation_fps默认 10且当淡入与淡出函数均为Constant时帧率会被强制降为 1wezterm-gui/src/colorease.rs——因为阶跃式切换无需连续重绘。最终ColorEase会被转换为ColorEaseUniformwezterm-gui/src/colorease.rs以[f32; 4]贝塞尔参数与毫秒时长的形式作为 uniform 传给 GPU 着色器由 GPU 完成逐帧的颜色插值渲染。配置示例将cursor_blink_ease_out与cursor_blink_ease_in组合使用可以控制一个完整闪烁周期中淡入与淡出两段动画的节奏。以下配置让光标以 800ms 为周期闪烁淡入使用平滑加速、淡出使用缓动衰减local wezterm require wezterm local config wezterm.config_builder() -- 闪烁周期800ms默认值设为 0 可禁用闪烁 config.cursor_blink_rate 800 -- 淡入缓慢开始、加速过渡 config.cursor_blink_ease_in EaseIn -- 淡出开头骤起、逐渐减速直至消失 config.cursor_blink_ease_out EaseOut return config自定义贝塞尔曲线若预设曲线不够用可以使用CubicBezier形式指定任意贝塞尔参数其四个数字分别对应两个控制点的坐标config.cursor_blink_ease_out { CubicBezier { 0.0, 0.0, 0.58, 1.0 } }CPU 渲染下的最佳实践缓动动画需要持续重绘会占用 GPU/CPU 资源。WezTerm 官方在 animation_fps.md 中建议如果使用 CPU 渲染器例如front_end Software或系统没有 GPU应将animation_fps设为 1并将两个缓动函数都设为Constant从而关闭缓动效果、退化为阶跃式切换config.animation_fps 1 config.cursor_blink_ease_in Constant config.cursor_blink_ease_out Constant正如上文源码分析所示当淡入淡出均为Constant时动画帧率会被强制降为 1此时光标几乎不再触发连续重绘非常适合低功耗场景。性能与功耗注意事项闪烁本身意味着持续的重绘。官方文档在 cursor_blink_rate.md 中明确建议使用电池供电时尽量避免闪烁光标因为持续为闪烁而重绘相对昂贵relatively costly。缓动曲线的平滑度受 animation_fps默认 10 帧/秒约束数值越大缓动越平滑但 GPU 占用越高。在无 GPU 的环境下按上文将animation_fps 1并配合Constant缓动函数可彻底关闭缓动动画开销。关联配置与文档cursor_blink_ease_out属于 WezTerm 中一组同源、同期的缓动闪烁配置体系修改时建议一并阅读cursor_blink_ease_in.md控制淡入阶段用法与本配置完全对称cursor_blink_rate.md闪烁周期速率默认 800ms设为 0 禁用闪烁visual_bell.md缓动函数体系的完整语义说明含所有取值的解释与示例animation_fps.md缓动动画的最大渲染帧率影响平滑度与资源占用text_blink_ease_out.md 与 text_blink_ease_in.md控制文本内容而非光标闪烁的同类配置。总结cursor_blink_ease_out将 WezTerm 的光标闪烁从简单的二值切换升级为可由用户精细调控的缓动动画。通过对Linear、Ease、EaseIn/Out、Constant及任意CubicBezier的选择开发者可以轻松塑造光标淡出的视觉节奏而底层ColorEase以1 − 缓动函数求值实现淡出、以animation_fps控制帧率、以Constant对实现零开销阶跃切换的实现则为这套配置提供了清晰、可预期的行为边界。在追求精致外观的同时也请务必关注闪烁与缓动带来的渲染开销按需在视觉与功耗之间取得平衡。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WezTerm 光标闪烁缓动曲线：`cursor_blink_ease_out` 配置深入解析
WezTerm 光标闪烁缓动曲线cursor_blink_ease_out配置深入解析【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/weztermcursor_blink_ease_out是 WezTerm 中用于控制文本光标在闪烁时淡出阶段颜色变化的**缓动函数easing function**配置项。本篇文章将以 cursor_blink_ease_out.md 为核心结合 WezTerm 源码中的实际实现config、wezterm-guicrate完整讲解该配置项的语法、可用取值、底层计算原理、与cursor_blink_ease_in、cursor_blink_rate等相邻配置的配合方式并给出可直接复制使用的配置示例。读完本文你将能精准定制光标闪烁的动画节奏兼顾视觉效果与渲染开销。配置项总览属性说明配置键cursor_blink_ease_out默认值Linear引入版本20220319-142410-0fcdea07即 2022-03-19 发布版标签appearance、text_cursor外观/文本光标数据类型字符串或表指定缓动函数作用对象文本光标在闪烁循环中由亮变暗、逐渐淡出的颜色过渡该配置项的作用是当光标设置为闪烁样式时指定计算光标颜色的缓动函数。缓动函数决定了光标的颜色强度从最大值衰减到不可见淡出的过渡节奏而不是简单地在可见/不可见之间二值切换。值得强调的是cursor_blink_ease_out所定义的淡出阶段其对应的缓动曲线会以1 减去缓动函数求值结果的方式参与最终颜色强度的计算详见下文源码分析因此实际观察到的效果是光标亮度随时间逐渐降低而不是按照函数原始曲线直接上升。工作原理从二值闪烁到缓动过渡在 WezTerm 的历史版本中闪烁光标是二进制式的可见与不可见直接切换。自20220319-142410-0fcdea07版本起WezTerm 将闪烁行为改为缓动过渡。这一点在仓库的 docs/changelog.md 中有明确记载Blinking text cursor is now eased rather than binary-blinked.同时该版本也为cursor_blink_ease_out、cursor_blink_ease_in等相关配置补充了对应的{{since(...)}}标记确认这一行为变更自该版本起生效。整个闪烁循环由一对缓动函数与一个周期速率协同驱动cursor_blink_ease_in控制光标从不可见到可见淡入阶段的过渡节奏cursor_blink_ease_out控制光标从可见到不可见淡出阶段的过渡节奏cursor_blink_rate以毫秒为单位指定光标在可见与不可见之间切换的频率即一个完整闪烁周期的时长。默认值为800毫秒设为0可禁用闪烁。在 cursor_blink_rate.md 中明确说明光标闪烁由cursor_blink_ease_in与cursor_blink_ease_out两个缓动函数控制且闪烁周期数值因系统事件循环的定时器调度机制而存在一定误差——非零值只会至少达到指定间隔并附带一定程度的偏差slop。源码中的接线方式在 config/src/config.rs 中两个缓动函数与闪烁速率被声明为Config的字段pub cursor_blink_ease_in: EasingFunction, pub cursor_blink_rate: u64, pub cursor_blink_ease_out: EasingFunction,其中cursor_blink_rate的默认值在 default_cursor_blink_rate() 中定义为800毫秒fn default_cursor_blink_rate() - u64 { 800 }而在 wezterm-gui/src/termwindow/mod.rs 中cursor_blink_state将这三个配置打包进ColorEase结构体其中淡入阶段使用cursor_blink_ease_in淡出阶段使用cursor_blink_ease_outcursor_blink_state: RefCell::new(ColorEase::new( config.cursor_blink_rate, config.cursor_blink_ease_in, config.cursor_blink_rate, config.cursor_blink_ease_out, None, )),注意这里传入的前两个参数时长 淡入函数与后两个参数时长 淡出函数中时长均为cursor_blink_rate即淡入与淡出各占半个周期。在配置热更新时wezterm-gui/src/termwindow/mod.rs 会依据新配置重新构造ColorEase从而让新配置立即生效。缓动函数的取值与语义关于缓动函数的具体语义原文档明确指引读者参考 visual_bell.md同属docs/config/lua/config/目录该文档用同款缓动函数体系控制视觉铃铛的淡入淡出。WezTerm 的缓动函数体系与 CSS easing functions 类似支持以下取值取值语义对应的三次贝塞尔参数Linear以恒定速率过渡默认值(0, 0, 1, 1)Ease缓慢开始中段急剧加速末尾逐渐减速(0.25, 0.1, 0.25, 1.0)EaseIn缓慢开始随后持续加速结尾骤停(0.42, 0, 1, 1)EaseInOut缓慢开始、加速、再减速至结尾(0.42, 0, 0.58, 1)EaseOut开头骤起随后持续减速(0, 0, 0.58, 1)Constant始终求值为 0用于在时长结束时产生阶跃切换自 20220408-101518-b908e2dd 起可用(0, 0, 0, 0){CubicBezier{0.0, 0.0, 0.58, 1.0}}使用任意四次参数的自定义三次贝塞尔曲线由用户指定源码中的枚举与贝塞尔映射这一系列取值在源码 config/src/bell.rs 中定义为EasingFunction枚举pub enum EasingFunction { Linear, CubicBezier(f32, f32, f32, f32), Ease, EaseIn, EaseInOut, EaseOut, Constant, }每个变体到三次贝塞尔控制点的映射定义在as_bezier_array()方法中config/src/bell.rsmatch self { Self::Constant [0., 0., 0., 0.], Self::Linear [0., 0., 1.0, 1.0], Self::CubicBezier(a, b, c, d) [*a, *b, *c, *d], Self::Ease [0.25, 0.1, 0.25, 1.0], Self::EaseIn [0.42, 0.0, 1.0, 1.0], Self::EaseInOut [0.42, 0., 0.58, 1.0], Self::EaseOut [0., 0., 0.58, 1.0], }贝塞尔曲线求值使用标准三次贝塞尔公式config/src/bell.rs即对四个控制点按位置参数x进行三次插值。同时EasingFunction的Default实现为Easeconfig/src/bell.rs这意味着视觉铃铛等使用该类型的其他配置默认走Ease曲线而cursor_blink_ease_out字段由于没有显式标注#[dynamic(default ...)]其默认值由类型默认与wezterm-dynamic反序列化共同决定文档标注的默认行为为Linear淡出阶段线性衰减。底层计算逻辑ColorEase与淡出阶段在 wezterm-gui/src/colorease.rs 中ColorEase结构体完整记录了淡入/淡出的时长与函数pub struct ColorEase { in_duration: f32, in_function: EasingFunction, out_duration: f32, out_function: EasingFunction, start: OptionInstant, last_render: Instant, }其核心求值逻辑位于intensity_one_shot()wezterm-gui/src/colorease.rs淡入阶段当经过时间elapsed小于in_duration时直接对淡入函数在归一化位置elapsed / in_duration上求值得到强度淡出阶段当elapsed超过in_duration后计算淡出阶段的完成度completion (elapsed - in_duration) / out_duration此时强度为1.0 - out_function.evaluate_at_position(completion)。let intensity if elapsed self.in_duration { Some( self.in_function .evaluate_at_position(elapsed / self.in_duration), ) } else { let completion (elapsed - self.in_duration) / self.out_duration; if completion 1.0 { None } else { Some(1.0 - self.out_function.evaluate_at_position(completion)) } };这一行1.0 - out_function.evaluate_at_position(completion)正是cursor_blink_ease_out的全部意义所在淡出阶段的光标强度 1 减去缓动函数在完成度上的求值结果。当完成度达到 1.0 时返回None表示本周期结束连续闪烁模式intensity_continuous见 wezterm-gui/src/colorease.rs会立即开启新一轮周期。此外该结构体还负责驱动动画帧调度帧率取config::configuration().animation_fps默认 10且当淡入与淡出函数均为Constant时帧率会被强制降为 1wezterm-gui/src/colorease.rs——因为阶跃式切换无需连续重绘。最终ColorEase会被转换为ColorEaseUniformwezterm-gui/src/colorease.rs以[f32; 4]贝塞尔参数与毫秒时长的形式作为 uniform 传给 GPU 着色器由 GPU 完成逐帧的颜色插值渲染。配置示例将cursor_blink_ease_out与cursor_blink_ease_in组合使用可以控制一个完整闪烁周期中淡入与淡出两段动画的节奏。以下配置让光标以 800ms 为周期闪烁淡入使用平滑加速、淡出使用缓动衰减local wezterm require wezterm local config wezterm.config_builder() -- 闪烁周期800ms默认值设为 0 可禁用闪烁 config.cursor_blink_rate 800 -- 淡入缓慢开始、加速过渡 config.cursor_blink_ease_in EaseIn -- 淡出开头骤起、逐渐减速直至消失 config.cursor_blink_ease_out EaseOut return config自定义贝塞尔曲线若预设曲线不够用可以使用CubicBezier形式指定任意贝塞尔参数其四个数字分别对应两个控制点的坐标config.cursor_blink_ease_out { CubicBezier { 0.0, 0.0, 0.58, 1.0 } }CPU 渲染下的最佳实践缓动动画需要持续重绘会占用 GPU/CPU 资源。WezTerm 官方在 animation_fps.md 中建议如果使用 CPU 渲染器例如front_end Software或系统没有 GPU应将animation_fps设为 1并将两个缓动函数都设为Constant从而关闭缓动效果、退化为阶跃式切换config.animation_fps 1 config.cursor_blink_ease_in Constant config.cursor_blink_ease_out Constant正如上文源码分析所示当淡入淡出均为Constant时动画帧率会被强制降为 1此时光标几乎不再触发连续重绘非常适合低功耗场景。性能与功耗注意事项闪烁本身意味着持续的重绘。官方文档在 cursor_blink_rate.md 中明确建议使用电池供电时尽量避免闪烁光标因为持续为闪烁而重绘相对昂贵relatively costly。缓动曲线的平滑度受 animation_fps默认 10 帧/秒约束数值越大缓动越平滑但 GPU 占用越高。在无 GPU 的环境下按上文将animation_fps 1并配合Constant缓动函数可彻底关闭缓动动画开销。关联配置与文档cursor_blink_ease_out属于 WezTerm 中一组同源、同期的缓动闪烁配置体系修改时建议一并阅读cursor_blink_ease_in.md控制淡入阶段用法与本配置完全对称cursor_blink_rate.md闪烁周期速率默认 800ms设为 0 禁用闪烁visual_bell.md缓动函数体系的完整语义说明含所有取值的解释与示例animation_fps.md缓动动画的最大渲染帧率影响平滑度与资源占用text_blink_ease_out.md 与 text_blink_ease_in.md控制文本内容而非光标闪烁的同类配置。总结cursor_blink_ease_out将 WezTerm 的光标闪烁从简单的二值切换升级为可由用户精细调控的缓动动画。通过对Linear、Ease、EaseIn/Out、Constant及任意CubicBezier的选择开发者可以轻松塑造光标淡出的视觉节奏而底层ColorEase以1 − 缓动函数求值实现淡出、以animation_fps控制帧率、以Constant对实现零开销阶跃切换的实现则为这套配置提供了清晰、可预期的行为边界。在追求精致外观的同时也请务必关注闪烁与缓动带来的渲染开销按需在视觉与功耗之间取得平衡。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考