本文记录如何在 X11 应用里面,使用 XShapeCombineRegion 方法配置一个 X11 窗口支持和 Win32 窗口一样的命中测试穿透功能,即对应 Win32 的 WS_EX_TRANSPARENT 的鼠标、触摸等的点击等动作的穿透功能,可以实现在窗口中挖空一块范围直接穿透到后面的窗口

在 X11 窗口中,想要实现让 X11Window 窗口不可命中,即所有的鼠标、触摸等的事件点击穿透到后面的窗口上,可以采用 libXext.so 提供的 XShapeCombineRegion 方法,也可以使用有争议的 libXfixes.so 提供的 XFixesSetWindowShapeRegion 方法

通过以上两个方法即可让 X11 窗口不响应鼠标或触摸的点击输入,让其输入到窗口后面的窗口。适合用来制作一个仅用来展示渲染的窗口,让这个窗口不参与到交互里面

使用比较有争议的 libXfixes.so 提供的 XFixesSetWindowShapeRegion 方法的示例代码如下

// 以下的 childWindowHandle 是一个 X11 窗口

var region = XFixesCreateRegion(display, 0, 0);
XFixesSetWindowShapeRegion(display, childWindowHandle, ShapeInput, 0, 0, region);

    [DllImport("libXfixes.so.3")]
    public static extern IntPtr XFixesCreateRegion(IntPtr display, IntPtr rectangles, int nrectangles);

    [DllImport("libXfixes.so.3")]
    public static extern void XFixesSetWindowShapeRegion(IntPtr display, IntPtr window, int shape_type, int x_offset,
        int y_offset, IntPtr region);

采用 libXext.so 提供的 XShapeCombineRegion 方法的示例代码如下

var region = XCreateRegion();
XShapeCombineRegion(display, childWindowHandle, ShapeInput, 0, 0, region, ShapeSet);

        [DllImport(libX11)]
        public static extern IntPtr XCreateRegion();

        [DllImport("libXext.so.6")]
        public static extern void XShapeCombineRegion(IntPtr display, IntPtr dest, int destKind, int xOff, int yOff, IntPtr region, int op);

我尝试创建两个窗口,其中一个窗口调用了 XShapeCombineRegion 方法,运行程序,将设置了的 XShapeCombineRegion 的窗口激活作为前台窗口,点击此窗口的内容,可以看到点击穿透到后面的窗口。如此即可使用 C# dotnet 在 X11 应用里实现 Click Through 窗口点击穿透功能

以上两个方法都能实现功能,且通过阅读 X Server的代码,可以发现以上两个方法核心实现基本相同。为了可能的坑点在于 libXfixes.so 可能在某些系统上被砍掉。只是这个 libXfixes.so 也足够旧了,基本上系统都会带的

所有代码放在 githubgitee 上,可以使用如下命令行拉取代码

先创建一个空文件夹,接着使用命令行 cd 命令进入此空文件夹,在命令行里面输入以下代码,即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 67cd9188399e7f45bfe83e1af9daf10236b3171c

以上使用的是 gitee 的源,如果 gitee 不能访问,请替换为 github 的源。请在命令行继续输入以下代码,将 gitee 源换成 github 源进行拉取代码

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 67cd9188399e7f45bfe83e1af9daf10236b3171c

获取代码之后,进入 DikalehebeekaJaqunicobo 文件夹,即可获取到源代码

以上代码经过我在 UOS 系统上测试通过,在 UOS 上的 KWin_X11 能够符合预期工作

如运行代码提示找不到 libXext.so 文件,错误内容如下

System.DllNotFoundException: Unable to load shared library 'libXext.so' or one of its dependencies. In order to help diagnose loading problems, consider using a tool like strace. If you're using glibc, consider setting the LD_DEBUG environment variable:
/home/uos/Downloads/lin/libXext.so: 无法打开共享对象文件: 没有那个文件或目录
/home/uos/Downloads/lin/liblibXext.so: 无法打开共享对象文件: 没有那个文件或目录
/home/uos/Downloads/lin/libXext.so.so: 无法打开共享对象文件: 没有那个文件或目录
/home/uos/Downloads/lin/liblibXext.so.so: 无法打开共享对象文件: 没有那个文件或目录

   at CPF.Linux.XLib.XShapeCombineRegion(IntPtr display, IntPtr dest, Int32 destKind, Int32 xOff, Int32 yOff, IntPtr region, Int32 op)
   at UnoInk.X11Ink.X11InkWindow..ctor(X11Info x11Info, IntPtr mainWindowHandle)
   at UnoInk.X11Ink.X11InkProvider.Start(Window unoWindow)

可以尝试配置使用 libXext.so.6 版本,代码如下

        [DllImport("libXext.so.6")]
        public static extern void XShapeCombineRegion(IntPtr display, IntPtr dest, int destKind, int xOff, int yOff, IntPtr region, int op);

更新之后的代码放在 githubgitee 上,欢迎拉取代码阅读和构建

以上方法用于设置全应用穿透,在此基础上,支持运行过程中,动态决定穿透范围。比如在某个逻辑里面,设置 (0,0,1000,1000)的范围内支持命中,其他范围依然穿透,可以使用如下代码进行更新

                        var xRectangle = new XRectangle()
                        {
                            x = 0,
                            y = 0, 
                            width = 1000,
                            height = 1000,
                        };
                        XRectangle* p = &xRectangle;
                        XUnionRectWithRegion(p, region, region);
                        XShapeCombineRegion(display, childWindowHandle, ShapeInput, 0, 0, region, ShapeSet);

        [DllImport(libX11)]
        public static extern int XUnionRectWithRegion(XRectangle* rectangle, IntPtr srcRegion, IntPtr destRegion);

更新之后的代码放在 githubgitee 上,可以使用如下命令行拉取代码

先创建一个空文件夹,接着使用命令行 cd 命令进入此空文件夹,在命令行里面输入以下代码,即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 0df132636a27746b1895b7f9a8fa347b1fe9540b

以上使用的是 gitee 的源,如果 gitee 不能访问,请替换为 github 的源。请在命令行继续输入以下代码,将 gitee 源换成 github 源进行拉取代码

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 0df132636a27746b1895b7f9a8fa347b1fe9540b

获取代码之后,进入 X11/DikalehebeekaJaqunicobo 文件夹,即可获取到源代码

参考文档:

如何在屏幕上显示一局部透明、鼠标点击可穿过的窗口 - V2EX

2021-08-21窗口管理器杂谈 - 简书

更多 X11 开发请参阅 博客导航

关于在 Windows 系统下的 WPF 窗口点击穿透,请参阅 WPF 制作支持点击穿透的高性能的透明背景异形窗口


本文会经常更新,请阅读原文: https://blog.lindexi.com/post/dotnet-X11-%E8%AE%BE%E7%BD%AE%E7%AA%97%E5%8F%A3%E9%BC%A0%E6%A0%87%E8%A7%A6%E6%91%B8%E5%91%BD%E4%B8%AD%E7%A9%BF%E9%80%8F.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

如果你想持续阅读我的最新博客,请点击 RSS 订阅,推荐使用RSS Stalker订阅博客,或者收藏我的博客导航

知识共享许可协议 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名林德熙(包含链接: https://blog.lindexi.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系

微软最具价值专家


无盈利,不卖课,做纯粹的技术博客

以下是广告时间

推荐关注 Edi.Wang 的公众号

欢迎进入 Eleven 老师组建的 .NET 社区

以上广告全是友情推广,无盈利