修复 blender 中文输入 BUG (linux/wayland/GNOME/ibus)

莱莱  金牌会员 | 2024-9-19 21:00:06 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题

主题 675|帖子 675|积分 2025

blender 是一个很好的 开源 3D 建模/动画/渲染 软件, 功能很强大, 跨平台 (GNU/Linux, Windows 等系统都支持).
然而, 窝突然发现, blender 居然不支持中文输入 (linux) ! 这怎么能忍 ? 再一查, 不得了, 这居然是个 3 年前不停未解决的陈年老 BUG. 不行, 这绝对忍不了, 这个 BUG 必须干掉 !
恰好, 窝对于 Linux 桌面 (GNOME), 输入法框架 (ibus), wayland 窗口协议, 等等都有一点点履历, 那么就来尝试修复 BUG 吧 ~
这里是 穷人小水滴, 专注于 穷人友好型 低成本技术. (本文为 61 号作品. )

相关文章:


  • 《ibus 源代码阅读 (1)》 https://blog.csdn.net/secext2022/article/details/136099328
  • 《自制: 7 天手搓一个拼音输入法》 https://blog.csdn.net/secext2022/article/details/136520721
  • 《GNOME 如何关闭表现输出 ? (wayland / mutter / KMS / DRI) (源代码阅读)》 https://blog.csdn.net/secext2022/article/details/141160008
  • 《rust GTK4 窗口创建与 wayland Subsurface (vulkan 渲染窗口初始化 (Linux) 上篇)》 https://blog.csdn.net/secext2022/article/details/142300776
参考资料:


  • https://www.blender.org/
  • https://projects.blender.org/blender/blender/issues/87578
  • https://projects.blender.org/blender/blender/commit/a38a49b073f582a0f6ddcca392f2760afdc4d5ed
  • https://github.com/ibus/ibus
  • https://wayland.freedesktop.org/
  • https://wayland.app/protocols/text-input-unstable-v3
  • https://developer.blender.org/docs/handbook/building_blender/linux/
  • https://developer.blender.org/docs/handbook/contributing/
  • https://projects.blender.org/blender/blender/pulls/127824
目次



  • 1 发现问题

    • 1.1 blender 无法输入中文 (linux)
    • 1.2 网上搜索相关问题
    • 1.3 wayland 输入协议 (zwp_text_input_v3)
    • 1.4 奇怪的 BUG: 切换输入法
    • 1.5 对比测试 gedit 和 blender

  • 2 修复陈年老 BUG

    • 2.1 编译 blender
    • 2.2 修改 C++ 代码

  • 3 提交 PR (合并请求)
  • 4 总结与预测
1 发现问题

俗话说, 发现问题比解决问题更重要. 只有发现了产生问题的缘故起因, 才气想办法去解决问题.
1.1 blender 无法输入中文 (linux)

众所周知, 作为一个根正苗红的穷人, 窝平时利用 ArchLinux 操作系统, GNOME (wayland) 图形桌面软件环境, 以及本身写的基于 ibus 输入法框架的开源拼音输入法 (胖喵拼音).

然而, 最近在利用 blender 时突然发现, 这个小可爱居然不支持输入中文 ! 啊 ? 这怎么回事 ? 窝利用的但是 ibus 啊, Linux 桌面最普及的输入法框架. 怎么会出问题 !
并且, ibus 不停是很稳的, 利用多年基本上很少出现大问题. ibus 对 GTK (2, 3, 4), QT, x11, wayland 等各种类型的软件应用都提供了输入支持. GTK 和 QT 是方便编写窗口图形界面的工具包, Linux 桌面的大部门应用都利用 GTK 或 QT.
然而, 巧了, blender 既不用 GTK, 也不用 QT ! 因为 blender 的界面是本身用 OpenGL 绘制的, 所以 blender 是个特殊的例外. 然后就杯摧啦 ~
1.2 网上搜索相关问题

遇事不决, 搜索引擎. 然后:

这 … . 这居然是一个 3 年前就报出来, 不停没解决的陈年老 BUG !
没办法, 只能本身动手了. 顺藤摸瓜, 阅读相关资料, 然后发现了一个神奇的提交: a38a49b073f582a0f6ddcca392f2760afdc4d5ed, 标题和阐明引用如下:
   GHOST/Wayland: IME support using the text-input protocol
  Tested with IBUS on GNOME 45.
Added a capabilities flag to GHOST since support for IME works on
Wayland but not on X11, so runtime detection is needed.
  一看提交时间: 2023 年 10 月 (一年前), 一看版本: v4.0.0.
然后冷静看了下本身利用的 blender 版本:
  1. > blender --version
  2. Blender 4.2.1 LTS
  3.         build date: 2024-09-01
  4.         build time: 08:21:56
  5.         build commit date: 2024-08-19
  6.         build commit time: 11:21
  7.         build hash: 396f546c9d82
  8.         build branch: makepkg (modified)
  9.         build platform: Linux
  10.         build type: Release
复制代码
然后看看本身利用的 GNOME 版本:
  1. > gnome-shell --version
  2. GNOME Shell 46.5
复制代码
什么情况 ? 没道理啊 ! 按理说, 这边利用的软件已经包含了相应的功能, 但是为啥不能正常工作, 输入不了中文 ?
明显上面 (提交阐明) 已经写了, 在 GNOME wayland IBUS 测试过了呀. 为什么到窝这里就不行了 ? 岂非是因为脸黑 ??
1.3 wayland 输入协议 (zwp_text_input_v3)

要想干掉 BUG, 就必须先深入其老窝, 从其内部消灭它. blender 在 Linux 桌面 (GNOME) 利用 wayland 输入协议, 那么就要先搞清楚, wayland 输入协议是什么.
wayland 是 Linux 桌面新的窗口协议, 用来替代老旧的 x11. 在 wayland 中, 主要有两种软件: wayland 合成器 (compositor), 也就是系统的窗口管理器. 以及平常应用 (wayland client), 需要表现窗口. wayland 由很多具体的协议 (protocol, 可以明白为 服务) 构成, 合成器作为一个大管家, 通过这些协议给平常应用提供服务. 合成器控制着应用的输入/输出, 比如鼠标/键盘的输入, 通过合成器分发给具体的应用, 应用绘制的窗口画面, 通过合成器表现到屏幕上.
wayland 输入协议是 wayland 对输入法 (IME) 的实现方式. 输入服务 (输入法) 由合成器提供, 应用可以请求合成器来利用输入服务. 在 GNOME 桌面中, wayland 合成器是 gnome-shell (mutter), 当然 mutter 只是一个代理, mutter 转手就把输入请求发送给 ibus 输入法框架, 由 ibus 处置惩罚现实的输入法.
目前 wayland 最新的输入协议版本是: zwp_text_input_v3. 在 ArchLinux 操作系统, 假如安装了软件包:
  1. sudo pacman -S wayland-protocols
复制代码
那么可以从这个文件看到 wayland 输入协议接口的具体定义和阐明:
  1. /usr/share/wayland-protocols/unstable/text-input/text-input-unstable-v3.xml
复制代码
也可以看这个链接: https://wayland.app/protocols/text-input-unstable-v3
协议中定义了一些 请求 (request, 从应用发送给合成器) 和 事件 (event, 从合成器发送给应用).
此中重要的请求有:


  • enable(): 启用输入, 在文本输入框激活 (获得焦点) 后发送.
  • disable(): 禁用输入, 在文本框失去焦点后发送.
  • commit(): 同步, 使设置见效.
重要的事件有:


  • enter(surface: object<wl_surface>): 表示窗口获得焦点, 可以开始输入.
  • leave(surface: object<wl_surface>): 表示窗口失去焦点.
  • commit_string(text: string): 这个是从输入法传过来的, 具体输入的文本.
  • done(serial: uint): 同步, 使输入见效.
当应用开始输入 (需要输入) 时, 一样寻常发送 enable 以及 commit 请求, 竣事输入时, 则发送 disable 以及 commit 请求.
当输入法需要向应用发送输入的内容 (比如输入法转换之后的汉字) 时, 合成器发送 commit_string 以及 done 事件.
1.4 奇怪的 BUG: 切换输入法

百思不得姐, 这是为什么呢 ? 一切看起来都很正常啊, 但是怎么就是不能工作呢 ?
直到一个偶尔的操作, 窝发现了这个 BUG 更离谱之处: 输入中文不是完全不行, 而是有时间行, 有时间不行 !
颠末继续尝试, 发现了这个 BUG 的关键之处: 切换输入法 !
假如, 在文本框获得焦点 (点击文本框) 之前, ibus 是中文输入法, 那么可以正常输入中文. 但是, 假如在文本框获得焦点之后, 再把 ibus 从英文切换到中文, 这时间就不行了, 只能输入英文, 不能输入中文了 !
也就是说, 这个 BUG 现实上是切换输入法有 BUG, blender 不支持在输入过程中切换输入法.
这种情况吧 … . 也不是完全不能用, 但是用起来就很难受. 因为别的正常的软件, 全都是支持在输入过程中切换输入法的. 对, 窝也是第一次遇见这种类型的奇怪 BUG.
1.5 对比测试 gedit 和 blender

那么, 问题到底是什么 ? 我们来找个正常的软件, 对比一下吧.
恰好 gedit 在 GNOME wayland 也是利用 wayland 输入协议, 并且工作正常. gedit 是一个简朴的文本编辑器, 所以也方便测试分析.
上面已经找到了, 问题出现在切换输入法, 那么就举行相同的操作 (反复切换输入法), 然后观察应用的具体行为吧.
测试下令:
  1. env WAYLAND_DEBUG=1 gedit
复制代码
然后获得 gedit 的调试日志 (输出):
  1. [3529354.672] {Default Queue} wl_registry#2.global(26, "zwp_text_input_manager_v3", 1)
  2. [3529969.414] {Default Queue} wl_registry#30.global(26, "zwp_text_input_manager_v3", 1)
  3. [3529969.434] {Default Queue}  -> wl_registry#30.bind(26, "zwp_text_input_manager_v3", 1, new id [unknown]#42)
  4. [3529969.447] {Default Queue}  -> zwp_text_input_manager_v3#42.get_text_input(new id zwp_text_input_v3#43, wl_seat#21)
  5. [3529993.843] {Default Queue}  -> wl_surface#31.set_input_region(wl_region#47)
  6. [3530009.162] {Default Queue} zwp_text_input_v3#43.enter(wl_surface#31)
  7. [3530009.376] {Default Queue}  -> zwp_text_input_v3#43.enable()
  8. [3530009.412] {Default Queue}  -> zwp_text_input_v3#43.set_surrounding_text("", 0, 0)
  9. [3530009.427] {Default Queue}  -> zwp_text_input_v3#43.set_text_change_cause(1)
  10. [3530009.442] {Default Queue}  -> zwp_text_input_v3#43.set_surrounding_text("", 0, 0)
  11. [3530009.455] {Default Queue}  -> zwp_text_input_v3#43.set_text_change_cause(1)
  12. [3530009.470] {Default Queue}  -> zwp_text_input_v3#43.set_content_type(1, 0)
  13. [3530009.482] {Default Queue}  -> zwp_text_input_v3#43.set_cursor_rectangle(89, 100, 0, 63)
  14. [3530009.493] {Default Queue}  -> zwp_text_input_v3#43.commit()
  15. [3530017.529] {Default Queue} zwp_text_input_v3#43.done(1)
  16. [3531340.639] {Default Queue} zwp_text_input_v3#43.leave(wl_surface#31)
  17. [3531340.657] {Default Queue}  -> zwp_text_input_v3#43.disable()
  18. [3531340.672] {Default Queue}  -> zwp_text_input_v3#43.commit()
  19. [3532434.555] {Default Queue} zwp_text_input_v3#43.enter(wl_surface#31)
  20. [3532434.744] {Default Queue}  -> zwp_text_input_v3#43.enable()
  21. [3532434.812] {Default Queue}  -> zwp_text_input_v3#43.set_surrounding_text("", 0, 0)
  22. [3532434.836] {Default Queue}  -> zwp_text_input_v3#43.set_text_change_cause(1)
  23. [3532434.853] {Default Queue}  -> zwp_text_input_v3#43.set_content_type(1, 0)
  24. [3532434.866] {Default Queue}  -> zwp_text_input_v3#43.set_cursor_rectangle(89, 100, 0, 63)
  25. [3532434.880] {Default Queue}  -> zwp_text_input_v3#43.commit()
  26. [3532439.292] {Default Queue} zwp_text_input_v3#43.done(3)
  27. [3532844.852] {Default Queue} zwp_text_input_v3#43.leave(wl_surface#31)
  28. [3532844.878] {Default Queue}  -> zwp_text_input_v3#43.disable()
  29. [3532844.901] {Default Queue}  -> zwp_text_input_v3#43.commit()
  30. [3533797.049] {Default Queue} zwp_text_input_v3#43.enter(wl_surface#31)
  31. [3533797.186] {Default Queue}  -> zwp_text_input_v3#43.enable()
  32. [3533797.232] {Default Queue}  -> zwp_text_input_v3#43.set_surrounding_text("", 0, 0)
  33. [3533797.250] {Default Queue}  -> zwp_text_input_v3#43.set_text_change_cause(1)
  34. [3533797.269] {Default Queue}  -> zwp_text_input_v3#43.set_content_type(1, 0)
  35. [3533797.286] {Default Queue}  -> zwp_text_input_v3#43.set_cursor_rectangle(89, 100, 0, 63)
  36. [3533797.300] {Default Queue}  -> zwp_text_input_v3#43.commit()
  37. [3533802.135] {Default Queue} zwp_text_input_v3#43.done(5)
  38. [3534172.006] {Default Queue} zwp_text_input_v3#43.leave(wl_surface#31)
  39. [3534172.056] {Default Queue}  -> zwp_text_input_v3#43.disable()
  40. [3534172.124] {Default Queue}  -> zwp_text_input_v3#43.commit()
复制代码

测试下令:
  1. env WAYLAND_DEBUG=1 blender --log-level -1 --log "ghost.*"
复制代码
blender 调试日志:
  1. [3547531.276] {Default Queue} wl_registry#2.global(26, "zwp_text_input_manager_v3", 1)
  2. [3547531.283] {Default Queue}  -> wl_registry#2.bind(26, "zwp_text_input_manager_v3", 1, new id [unknown]#18)
  3. INFO (ghost.wl.handle.registry): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:7044 global_handle_add: add (interface=zwp_text_input_manager_v3, version=1, name=26)
  4. [3547531.895] {Default Queue}  -> zwp_text_input_manager_v3#18.get_text_input(new id zwp_text_input_v3#28, wl_seat#15)
  5. [3547562.769] {Default Queue} wl_registry#30.global(26, "zwp_text_input_manager_v3", 1)
  6. [3547563.043] {Default Queue} wl_registry#32.global(26, "zwp_text_input_manager_v3", 1)
  7. [3547570.089] {Default Queue} wl_registry#2.global(26, "zwp_text_input_manager_v3", 1)
  8. [3547748.370] {mesa egl display queue} wl_registry#42.global(26, "zwp_text_input_manager_v3", 1)
  9. [3547901.864] {Default Queue} zwp_text_input_v3#28.enter(wl_surface#34)
  10. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5556 text_input_handle_enter: enter
  11. [3550150.409] {Default Queue}  -> zwp_text_input_v3#28.enable()
  12. [3550150.439] {Default Queue}  -> zwp_text_input_v3#28.commit()
  13. [3550150.464] {Default Queue}  -> zwp_text_input_v3#28.enable()
  14. [3550150.489] {Default Queue}  -> zwp_text_input_v3#28.commit()
  15. [3550150.519] {Default Queue}  -> zwp_text_input_v3#28.set_content_type(0, 0)
  16. [3550150.569] {Default Queue}  -> zwp_text_input_v3#28.set_cursor_rectangle(2243, 130, 1, 1)
  17. [3550150.620] {Default Queue}  -> zwp_text_input_v3#28.commit()
  18. [3550150.892] {Default Queue}  -> zwp_text_input_v3#28.set_cursor_rectangle(2210, 139, 1, 1)
  19. [3550151.170] {Default Queue}  -> zwp_text_input_v3#28.commit()
  20. [3550159.516] {Default Queue} zwp_text_input_v3#28.done(4)
  21. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5655 text_input_handle_done: done
  22. [3551462.551] {Default Queue} zwp_text_input_v3#28.leave(wl_surface#34)
  23. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5569 text_input_handle_leave: leave
  24. [3552311.934] {Default Queue} zwp_text_input_v3#28.enter(wl_surface#34)
  25. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5556 text_input_handle_enter: enter
  26. [3552662.643] {Default Queue} zwp_text_input_v3#28.leave(wl_surface#34)
  27. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5569 text_input_handle_leave: leave
  28. [3553500.323] {Default Queue} zwp_text_input_v3#28.enter(wl_surface#34)
  29. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5556 text_input_handle_enter: enter
  30. [3553815.091] {Default Queue} zwp_text_input_v3#28.leave(wl_surface#34)
  31. INFO (ghost.wl.handle.text_input): /usr/src/debug/blender/blender/intern/ghost/intern/GHOST_SystemWayland.cc:5569 text_input_handle_leave: leave
复制代码

上面的调试日志主要记载了应用软件和 wayland 合成器互相发送的消息. 可以很明显的看出来 gedit 和 blender 的行为差异:
gedit 在每次收到 leave 之后, 都会发送 disable. 在每次收到 enter 之后, 都会发送 enable.
而 blender 这边, 只会在第一次时这么做, 背面就没动静了.
这, 就是 blender 切换输入法 BUG 的关键 !
2 修复陈年老 BUG

既然发现了问题的关键所在, 接下来就可以尝试修复这个 BUG 了.
2.1 编译 blender

第一步, 当然是下载 blender 的源代码, 并在当地编译.
官方引导文档: https://developer.blender.org/docs/handbook/building_blender/linux/
对于 C++ 项目 (make/cmake) 来说, blender 的源代码下载和编译过程, 都是相对比较容易和顺遂的. 代码下载速度很快 (占用硬盘空间 9.3GB), 编译用时也不长, 这边用 9 年前的老旧小破弱鸡 CPU (i5-6200U) 只用了不到一个小时就编译好了. (回想起了当年编译 Android AOSP 用时一整天, 硬盘占用 200GB 的可怕时光 … . )
不过需要注意一下内存占用, 这边 16GB (DDR3-1600) 内存, 差点内存不敷编译失败. 最后关闭全部别的应用, 只跑一个编译, 才委曲成功.
当地编译的 blender:
  1. > ./build_linux/bin/blender --version
  2. Blender 4.3.0 Alpha
  3.         build date: 2024-09-19
  4.         build time: 01:23:36
  5.         build commit date: 2024-09-18
  6.         build commit time: 21:36
  7.         build hash: 3ca97f8c5c75
  8.         build branch: main (modified)
  9.         build platform: Linux
  10.         build type: Release
复制代码

2.2 修改 C++ 代码

很不幸, blender 的代码是用 C++ 写的, 而 C++ 优劣常困难的超等怪兽 ! (窝熟悉的编程语言只有 js (TypeScript), rust, python) 所以 … . 那只好硬着头皮强行上手了 ! 只要思想不滑坡, 办法总比困难多嘛.
需要修改的文件, 上面的神奇提交已经指出了: blender/intern/ghost/intern/GHOST_SystemWayland.cc
修改的思绪, 上面已经分析过了, 就是改成和 gedit 一样的行为.
颠末一番积极, 对 blender 源代码的修改如下:
  1. diff --git a/intern/ghost/intern/GHOST_SystemWayland.cc b/intern/ghost/intern/GHOST_SystemWayland.cc
  2. index f9a04ca2882..633444b4197 100644
  3. --- a/intern/ghost/intern/GHOST_SystemWayland.cc
  4. +++ b/intern/ghost/intern/GHOST_SystemWayland.cc
  5. @@ -5725,6 +5725,12 @@ static void text_input_handle_enter(void *data,
  6.    CLOG_INFO(LOG, 2, "enter");
  7.    GWL_Seat *seat = static_cast<GWL_Seat *>(data);
  8.    seat->ime.surface_window = surface;
  9. +  /* If text input is enabled, should call `enable` after receive `enter` event.
  10. +   * This support switch input method during input, otherwise input method will not work. */
  11. +  if (seat->ime.is_enabled) {
  12. +    zwp_text_input_v3_enable(seat->wp.text_input);
  13. +    zwp_text_input_v3_commit(seat->wp.text_input);
  14. +  }
  15. }
  16. static void text_input_handle_leave(void *data,
  17. @@ -5740,6 +5746,9 @@ static void text_input_handle_leave(void *data,
  18.    if (seat->ime.surface_window == surface) {
  19.      seat->ime.surface_window = nullptr;
  20.    }
  21. +  /* Always call `disable` after receive `leave` event. */
  22. +  zwp_text_input_v3_disable(seat->wp.text_input);
  23. +  zwp_text_input_v3_commit(seat->wp.text_input);
  24. }
  25. static void text_input_handle_preedit_string(void *data,
  26. @@ -8911,10 +8920,8 @@ void GHOST_SystemWayland::ime_begin(const GHOST_WindowWayland *win,
  27.      seat->ime.has_preedit = false;
  28.      seat->ime.is_enabled = true;
  29. -    /* NOTE(@flibit): For some reason this has to be done twice,
  30. -     * it appears to be a bug in mutter? Maybe? */
  31. -    zwp_text_input_v3_enable(seat->wp.text_input);
  32. -    zwp_text_input_v3_commit(seat->wp.text_input);
  33. +    /* No more enable twice, should call enable after `enter` event.
  34. +     * see `text_input_handle_enter` function. */
  35.      zwp_text_input_v3_enable(seat->wp.text_input);
  36.      zwp_text_input_v3_commit(seat->wp.text_input);
复制代码
很简朴吧, 也就没改几行代码. 主要就是添加发送 disable 和 enable 给 wayland 合成器.
然后重新编译, 测试 … . 再次编译是增量编译, 所以很快, 几分钟就编译好了.
结果 … . 大成功 ! 现在 blender 的中文输入工作良好, 切换输入法正常. 奇怪的离谱 3 岁陈年老 BUG 就这么被修复啦 ~
3 提交 PR (合并请求)

BUG 修复了, 那么接下来的操作就是提交 PR, 请求上游 (upstream, blender) 合并代码.
官方引导文档: https://developer.blender.org/docs/handbook/contributing/

如图, 这个 PR 正在被处置惩罚, 暂时还没有被合并.
现在, 窝已经成为了 ·blender 开发者. 等到 PR 被合并之后, 窝就能成为 ·blender 开发者啦 ~ 撒花 ~~
4 总结与预测

大概是在 Linux 桌面 (1) 利用 blender (2) 的中国人 (3) 太少了吧 (3 个小概率一连相乘), 这个 BUG 挂了 3 年也没人管.
于是, 寒不择衣的窝只能本身动手了, 用 2 天时间, 修改了约莫 10 行 blender 源代码, 从而修复了在 linux 上切换输入法的 BUG, 现在输入中文已经正常了.
以后, 窝就可以自满的对别人说, 窝也是 blender 开发者啦 ~

本文利用 CC-BY-SA 4.0 许可发布.

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

莱莱

金牌会员
这个人很懒什么都没写!

标签云

快速回复 返回顶部 返回列表