康普顿 - 云端在线

程序：

您的姓名

compton - X11 的合成器

概要

康普顿 [配置]

警告

此手册页可能不如 compton (compton -h) 中的用法文本更新。

商品描述

compton 是一个基于 Dana Jansens 版本的 xcompmgr（它本身是
由基思·帕卡德 (Keith Packard) 撰写）。 它包括对原始 xcompmgr 的一些改进，例如
窗口框架不透明度和非活动窗口透明度。

配置

-h, - 帮帮我
获取嵌入在程序代码中的用法文本，可能比这个更新
手册页。

-d 显示屏玻璃制造
要管理的显示。

-r 半径
阴影的模糊半径，以像素为单位。 （默认为 12）

-o 不透明
阴影的不透明度。 （0.0 - 1.0，默认为 0.75）

-l OFFSET
阴影的左偏移量，以像素为单位。 （默认为 -15）

-t OFFSET
阴影的顶部偏移量，以像素为单位。 （默认为 -15）

-I 不透明度_步骤
淡入时步骤之间的不透明度变化。（0.01 - 1.0，默认为 0.028）

-O 不透明度_步骤
淡出时步骤之间的不透明度变化。 （0.01 - 1.0，默认为 0.03）

-D 毫秒
淡入淡出步骤中的步骤之间的时间，以毫秒为单位。 （> 0，默认为 10）

-m 不透明
下拉菜单和弹出菜单的默认不透明度。 （0.0 - 1.0，默认为 1.0）

-c
在 Windows 上启用客户端阴影。 注意桌面窗口（带有
_NET_WM_WINDOW_TYPE_DESKTOP) 永远不会有阴影。

-C
避免在停靠栏/面板窗口上绘制阴影。

-z
将窗口后面的阴影遮罩部分归零。 请注意这可能无法正常工作
在具有完全透明区域的 ARGB 窗口上。

-f
在打开/关闭和不透明度改变时淡入/淡出窗口，除非
--无褪色打开关闭 用来。

-F
等于 -f. 已弃用。

-i 不透明
非活动窗口的不透明度。 （0.1 - 1.0，默认禁用）

-e 不透明
窗口标题栏和边框的不透明度。 （0.1 - 1.0，默认禁用）

-G
不要在拖放窗口上绘制阴影。

-b
守护进程。 初始化后分叉到后台。

-S
启用同步 X 操作（用于调试）。

--配置 PATH
在路径中查找配置文件。 看 配置 FILES 以下部分为
默认情况下，compton 在其中查找配置文件。

--shadow-红色 VALUE
阴影的红色值（0.0 - 1.0，默认为 0）。

--阴影-绿色 VALUE
阴影的绿色值（0.0 - 1.0，默认为 0）。

--阴影蓝 VALUE
阴影的蓝色值（0.0 - 1.0，默认为 0）。

--非活动不透明度覆盖
让非活动不透明度设置为 -i 覆盖窗口' _NET_WM_OPACITY 值。

--主动不透明度 不透明
活动窗口的默认不透明度。 (0.0 - 1.0)

--非活动暗淡 VALUE
使非活动窗口变暗。 （0.0 - 1.0，默认为 0.0）

--mark-wmwin-集中
尝试检测 WM 窗口（一个没有子窗口的非覆盖重定向窗口）
WM_STATE) 并将它们标记为活动状态。

--mark-overdir-focused
使用 WM_STATE 标记没有子窗口的覆盖重定向窗口。

--无褪色打开关闭
不要在窗户打开/关闭时褪色。

--shadow-ignore-形状
不要在异形窗户上画阴影。 注意这里的形状窗口是指窗口设置
它的形状通过 X Shape 扩展。 那些使用 ARGB 背景的超出我们的范围
控制。

--检测圆角
尝试检测带有圆角的窗口，不要将它们视为异形窗口。 这
准确率不是很高，可惜。

--检测客户端不透明度
检测 _NET_WM_OPACITY 在客户端窗口上，对于不通过的窗口管理器很有用
_NET_WM_OPACITY 客户端窗口到框架窗口。

- 刷新率 刷新率
指定屏幕的刷新率。 如果未指定或为 0，康普顿将尝试检测
这与 X RandR 扩展。

--垂直同步 垂直同步方法
设置垂直同步方法。 目前可用的垂直同步方法：

· 没有: 没有垂直同步

· DRM: 垂直同步 DRM_IOCTL_WAIT_VBLANK. 可能仅适用于某些驱动程序。

· OpenGL的: 尝试垂直同步 SGI_视频_同步 OpenGL 扩展。 只对一些工作
驱动程序。

· opengl-oml: 尝试垂直同步 OML_sync_control OpenGL 扩展。 只对一些工作
驱动程序。

· opengl-swc: 尝试垂直同步 SGI_swap_control OpenGL 扩展。 只对一些工作
司机。 仅适用于 GLX 后端。 已知对许多驱动程序最有效。
实际上不控制绘制时间，只影响缓冲区交换，所以它
没有效果 --sw-优化 不同于其他方法。 实验性的。

· opengl MSWC: 尝试垂直同步 MESA_交换_控制 OpenGL 扩展。 基本上
一样 opengl-swc 以上，除了我们使用的扩展名。

（请注意，某些 VSync 方法可能在编译时未启用。）

--vsync-激进
尝试在 VBlank 之前发送绘画请求并在 VBlank 期间执行 XFlush()。 报告
工作非常糟糕。 这个开关可以随时解除。

--alpha 步 VALUE
X Render backend：预生成 alpha 图片的步骤。 （0.01 - 1.0，默认为
0.03）

--dbe
启用 DBE 绘画模式，旨在与 VSync 一起使用以（希望）消除撕裂。
不过据说没有效果。

-- 覆盖层上漆
在 X Composite 覆盖窗口而不是在根窗口上绘画。

--sw-优化
限制康普顿最多每 1 次重绘一次 / 刷新率 第二个提升
表现。 这不应该与 --垂直同步 drm/opengl/opengl-oml 因为它们
基本上是 --sw-优化的工作已经，除非你想指定一个较低的刷新
率高于实际值。

--使用 ewmh-active-win
使用 EWMH _NET_ACTIVE_WINDOW 确定当前聚焦的窗口，而不是
听 专注于/焦点输出 事件。 可能有更高的准确性，前提是 WM
支持它。

--尊重道具阴影
尊重 _康普顿_阴影. 这是一个原型级功能，您不能依赖它。

--unredir-如果可能
如果检测到全屏不透明窗口，则取消重定向所有窗口，以最大化
全屏窗口的性能。 已知会导致闪烁
重定向/取消重定向窗口。 -- 覆盖层上漆 可以减少闪烁
明显。

--unredir-如果可能延迟 毫秒
取消重定向窗口之前的延迟，以毫秒为单位。 默认为 0。

--unredir-如果可能-排除 条件
不应该被视为全屏进行取消重定向的窗口的条件
屏幕上。

--影子排除 条件
指定不应有阴影的窗口条件列表。

--淡入淡出 条件
指定不应褪色的窗户条件列表。

--焦点排除 条件
指定应始终被视为聚焦的窗口条件列表。

--inactive-dim-固定
使用固定的非活动暗度值，而不是根据窗口不透明度进行调整。

--检测瞬态
使用 WM_TRANSIENT_FOR 对窗口进行分组，并考虑集中在同一组中的窗口
在相同的时间。

--检测客户领导
使用 WM_CLIENT_LEADER 对窗口进行分组，并考虑集中在同一组中的窗口
在相同的时间。 WM_TRANSIENT_FOR 有更高的优先级，如果 --检测瞬态 is
也启用。

--模糊背景
模糊半透明/ARGB 窗口的背景。 性能不佳，与
依赖于驱动程序的行为。 开关的名称可能会未经事先更改
通知。

--模糊背景帧
当窗口框架不透明时，模糊窗口的背景。 暗示
--模糊背景. 性能不佳，具有依赖于驱动程序的行为。 名字可能
改变。

--模糊背景固定
使用固定的模糊强度而不是根据窗口不透明度进行调整。

--模糊核距 MATRIX
指定模糊卷积核，格式如下：

WIDTH,HEIGHT,ELE1,ELE2,ELE3,ELE4,ELE5...

中间的元素一定不能被包含，它将永远是 1.0 或变化
基于不透明度，取决于你是否有 --blur-background-fixed。 然而
模糊因子的自动调整可能不适用于自定义模糊内核。

一个 7x7 高斯模糊内核 (sigma = 0.84089642) 看起来像：

--blur - 克恩“7,7,0.000003,0.000102,0.000849,0.001723,0.000849,0.000102,0.000003,0.000102,0.003494,0.029143,0.059106,0.029143,0.003494,0.000102,0.000849,0.029143,0.243117,0.493069,0.243117,0.029143,0.000849,0.001723,0.059106,0.493069,0.493069,0.059106,0.001723,0.000849,0.029143,0.243117,0.493069,0.243117,0.029143,0.000849,0.000102,0.003494,0.029143,0.059106,0.029143,0.003494,0.000102,0.000003,0.000102,0.000849,0.001723,0.000849,0.000102,0.000003， XNUMX， XNUMX'

也可能是预定义的内核之一：3x3box（默认）、5x5box、7x7box、
3x3 高斯、5x5 高斯、7x7 高斯、9x9 高斯、11x11 高斯。 全高斯
内核是用 sigma = 0.84089642 生成的。 您可以使用随行
compton-convgen.py 生成模糊内核。

--模糊背景排除 条件
排除背景模糊的条件。

--调整大小损坏 INTEGER
按特定数量的像素调整损坏区域的大小。 正值放大
而负数则缩小它。 如果值为正，那些额外的像素
不会实际绘制到屏幕上，仅用于模糊计算等。 （到期的
到技术限制，与 --dbe or --glx-交换方法，这些像素仍将是
错误地绘制到屏幕上。）主要用于修复线路损坏问题
模糊，在这种情况下，您应该在此处使用模糊半径值（例如，使用 3x3 内核，
你应该使用 --调整大小损坏 1、用一个5x5的你用 --调整大小损坏 2，等等
在）。 可能会或可能不会与 --glx-no-stencil 一起使用。 收缩功能不正常。

--反转颜色包含 条件
指定应使用反转颜色绘制的窗口条件列表。
资源占用，并且没有经过很好的测试。

--不透明度规则 不透明：'健康）状况'
指定不透明度规则列表，格式为 PERCENT:PATTERN，如 50:name *=
“火狐”。 建议使用 compton-trans。 请注意，我们不区分 100% 和
未设置，我们不保证与其他程序可能发生冲突
该集 _NET_WM_WINDOW_OPACITY 在框架或客户端窗口上。

--阴影排除-reg 几何
指定一个 X 几何体来描述不应绘制阴影的区域
在，例如停靠窗口区域。 使用--shadow-exclude-reg x10+0-0，例如，如果
屏幕底部的 10 个像素不应有阴影。

--xinerama-阴影作物
在特定的 Xinerama 屏幕上完全裁剪窗口的阴影到屏幕上。

--后端 后端
指定要使用的后端：xrender 或 glx。 GLX（OpenGL）后端一般有很多
只要您拥有图形卡/芯片和驱动程序，就可以获得卓越的性能。

--glx-无模板
GLX 后端：避免使用模板缓冲区，如果您没有模板缓冲区，则很有用。
渲染透明内容时可能会导致不正确的不透明度（但永远不会
实际发生过）并且可能不适用于 --模糊背景. 我的测试显示 15%
性能提升。 受到推崇的。

--glx-从前面复制
GLX 后端：从前端缓冲区复制未修改的区域，而不是将它们全部重绘。
我对 nvidia 驱动程序的测试显示，当整个屏幕显示时，性能会下降 10%
已修改，但只有 20/1 时增加 4%。 我对 nouveau 的测试显示很糟糕
慢一点。 对 --glx-swap-method 也很有用。

--glx-use-copysubbuffermesa
GLX 后端：使用 MESA_copy_sub_buffer 做部分屏幕更新。 我对 nouveau 的测试
仅更新 200/1 屏幕时显示 4% 的性能提升。 可能会破坏垂直同步
并且在某些驱动程序上不可用。 覆盖 --glx-从前面复制.

--glx-无重新绑定像素图
GLX 后端：避免在窗口损坏时重新绑定像素图。 可能会改进
快速窗口内容更改的性能，但已知会破坏某些内容
驱动程序（LLVMpipe）。 如果有效，推荐。

--glx-交换方法 未定义/交换/复制/3/4/5/6/buffer-age
GLX 后端：我们假设的 GLX 缓冲区交换方法。 可能未定义 (0)，复制 (1)，
交换 (2)、3-6 或缓冲年龄 (-1)。 undefined 是最慢和最安全的，并且
默认值。 复制速度最快，但在某些驱动程序上可能会失败，2-6 个逐渐
更慢但更安全（6 仍然比 0 快）。 通常，双缓冲意味着 2、三重
buffer 表示 3. buffer-age 表示自动检测使用 GLX_EXT_buffer_age，由
一些司机。 没用的 --glx-use-copysubbuffermesa. 部分中断
--调整大小损坏。 默认为未定义。

--glx-使用-gpushader4
GLX 后端：使用 GL_EXT_gpu_shader4 对模糊 GLSL 代码进行一些优化。 我的测试
在 GTX 670 上没有显示出明显的效果。

--dbus
通过 D-Bus 启用远程控制。 见 总线 API 以下部分了解更多详情。

- 基准 单车
基准模式。 重复涂漆，直到达到指定的周期。

--基准宽度 窗口ID
指定窗口 ID 以在基准模式下重新绘制。 如果省略或为0，则全屏
被重新粉刷。

FORMAT OF 条件

某些选项接受条件字符串以匹配某些窗口。 条件字符串是
由一个或多个条件组成，由逻辑运算符连接。

带有“exists”运算符的条件如下所示：

[ ] :

使用等于运算符，它看起来像：

[ ] : =

对于大于/小于运算符，它看起来像：

[ ] :

否定 （可选）是一个或多个感叹号；

TARGET 是预定义的目标名称或要匹配的窗口属性的名称。
支持的预定义目标是 id, x, y, x2 (x + widthb), y2, width, height, widthb
(width + 2 * border), heightb, override_redirect, argb (窗口是否有ARGB
visual)、focused、wmwin（窗口是否看起来像 WM 窗口，即没有子窗口
带有 WM_STATE 且未被覆盖重定向的窗口），客户端（客户端窗口的 ID），
window_type（字符串中的窗口类型）、leader（窗口leader的ID）、名称、class_g（=
WM_CLASS[1])、class_i (= WM_CLASS[0]) 和角色。

客户端/框架 如果应该在客户端上查找窗口属性，则为单个 @
窗口，如果在框架窗口上什么都没有；

指数 （可选）是要查找的属性的索引号。 例如，[2] 表示
查看属性中的第三个值。 不要为预定义的目标指定它。

FORMAT （可选）指定属性的格式，8、16 或 32。如果不存在，我们使用
格式 X 报告。 不要为预定义或字符串目标指定它。

型 是表示要匹配的属性类型的单个字符：c for
红衣主教, 对于 ATOM, w 对于 窗口, d 为 可绘制, 为 STRING （和任何其他字符串
类型，例如 UTF8_STRING）。 不要为预定义的目标指定它。

OP 合格者 （可选），仅适用于等于运算符，可以是 ? （忽略大小写）。

MATCH 型 （可选），仅适用于等号运算符，可以什么都不是（精确
匹配）、*（在任何地方匹配）、^（从开始匹配）、%（通配符）或 ~（PCRE 常规
表达）。

操作员 是 =（等于）、<、>、<=、=> 或没有（存在）之一。 存在操作员检查
属性是否存在于窗口上（但对于预定义的目标，存在意味着 != 0
然后）。

模式 是由单引号或双引号括起来的整数或字符串。
字符串格式支持 Python-3 样式的转义序列和原始字符串。

支持的逻辑运算符是 && (and) 和 || （或者）。 && 比 || 有更高的优先级，
从左到右的结合性。 使用括号更改优先级。

例子：

# 如果窗口被聚焦
重点
专注 = 1
# 如果窗口没有被覆盖重定向
!override_redirect
override_redirect = false
override_redirect != 真
覆盖_重定向！= 1
# 如果窗口是菜单
window_type *= "菜单"
_NET_WM_WINDOW_TYPE@:a *= "菜单"
# 如果窗口名称包含“Firefox”，忽略大小写
名称 *?= "火狐"
_NET_WM_NAME@:s *?= "火狐"
# 如果窗口名称以“Firefox”结尾
名称 %= "*火狐"
名称 ~= "火狐$"
# 如果窗口有一个值为 0 的属性 _COMPTON_SHADOW，输入 CARDINAL，
# 格式 32，值 0，在其框架窗口上
_COMPTON_SHADOW：32c = 0
# 如果_NET_FRAME_EXTENTS的第三个值小于20，或者没有
# 客户端窗口的 _NET_FRAME_EXTENTS 属性
_NET_FRAME_EXTENTS@[2]:32c < 20 || !_NET_FRAME_EXTENTS@:32c
# 这里的模式将被解析为“dd4”
名称 = "\x64\x64\o64"
# 这里的模式将被解析为“\x64\x64\x64”
名称 = r"\x64\x64\o64"

LEGACY FORMAT OF 条件

这是我们曾经使用的旧条件格式。 可能会删除对这种格式的支持
未来。

条件 = TARGET:TYPE[FLAGS]:PATTERN

TARGET 是“n”（窗口名称）、“i”（窗口类实例）、“g”（窗口通用）之一
类）和“r”（窗口角色）。

型 是“e”（完全匹配）、“a”（任何地方匹配）、“s”（从开始匹配）、“w”之一
（通配符）和“p”（PCRE 正则表达式，如果编译支持）。

旗帜 可能是一系列标志。 目前唯一定义的标志是“i”（忽略大小写）。

模式 是实际的模式字符串。

配置 FILES

如果编译了 libconfig 支持，compton 可以从配置文件中读取。如果
--配置 未使用，compton 将在
$XDG_CONFIG_HOME/compton.conf (〜/.config/compton.conf, 通常), 那么 〜/.compton.conf,
然后是 $XDG_DATA_DIRS 下的 compton.conf（通常是 /etc/xdg/compton.conf）。

compton 使用通用的 libconfig 配置文件格式。 示例配置文件是
在源代码树中作为 compton.sample.conf 可用。 大多数命令行开关都可以
替换为配置文件中的一个选项，如上所示。
特定于窗口类型的设置仅在配置文件中公开，并具有以下内容
格式：

类型：
{
WINDOW_TYPE = { 淡入淡出 = BOOL; 阴影 = 布尔； 不透明度 = 浮动； 焦点=布尔； };
};

窗口类型 是 EWMH 标准中定义的 15 种窗口类型之一：“未知”、“桌面”、
“码头”，“工具栏”，“菜单”，“实用程序”，“飞溅”，“对话框”，“正常”，“下拉菜单”，
“弹出菜单”、“工具提示”、“通知”、“组合”和“免打扰”。 “淡入淡出”和“阴影”控制
特定于窗口类型的阴影和淡入淡出设置。 “opacity”控制默认的不透明度
窗口类型。 “focus”控制是否总是考虑这种类型的窗口
专注。 （默认情况下，除“普通”和“对话框”之外的所有窗口类型都启用了此功能。）

讯号

· compton 在收到 SIGUSR1 后重新初始化自身。

总线 API

通过运行 compton 可以通过 D-Bus 消息控制 compton --dbus 和
向 com.github.chjj.compton 发送消息。 . 是使用的显示器
compton，所有非字母数字字符都转换为下划线。 对于 DISPLAY=:0.0
例如，您应该使用 com.github.chjj.compton._0_0。

D-Bus 方法和信号还不稳定，因此目前没有记录。

示例

· 禁用配置文件解析：

$ compton --config /dev/null

· 使用客户端阴影和淡入淡出运行 compton，禁用停靠窗口上的阴影和
拖放窗口：

$康普顿-cCGf

· 同上，加上使非活动窗口 80% 透明，使框架 80%
透明，在窗口打开/关闭时不褪色，启用软件优化和分叉
背景：

$ 康普顿-bcCGf -i 0.8 -e 0.8 --no-fading-openclose --sw-opti

· 绘制白色阴影：

$ compton -c --shadow-red 1 --shadow-green 1 --shadow-blue 1

· 避免在 wbar 窗口上绘制阴影：

$ compton -c --shadow-exclude 'class_g = "wbar"'

· 使用 GLX 后端启用 OpenGL SGI_swap_control VSync：

$ compton --backend glx --vsync opengl-swc

使用 onworks.net 服务在线使用 compton