From 5fd0351aa98bf9b634883caf04a20af575572d29 Mon Sep 17 00:00:00 2001 From: rewine Date: Wed, 16 Sep 2026 15:39:27 +0800 Subject: [PATCH] feat: drop alpha from accent color in appearance protocols MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1. Remove the `a` argument from set_accent_color in treeland-appearance-manager-unstable-v1.xml 2. Remove the `a` argument from accent_color event in treeland-appearance-unstable-v1.xml 3. Add 0.7.0 breaking-change entries to dde/ and public/ READMEs 4. Bump project version to 0.7.0 in CMakeLists.txt Log: Accent color is now opaque RGB (r, g, b) on the wire; the alpha channel is no longer carried by either the privileged set request or the read-only observer event. Influence: 1. Bind treeland_appearance_manager_v1 and call set_accent_color with three uint args (r, g, b); verify the compositor applies the color and no longer reads a trailing alpha value 2. Bind treeland_appearance_v1 and confirm the accent_color event delivers exactly three uint args (r, g, b) on initial bind and on subsequent changes 3. Verify clients sending the old four-arg (r, g, b, a) signature are rejected or handled per compositor policy after the wire change feat: 活动色协议去掉 alpha 分量 1. 移除 treeland-appearance-manager-unstable-v1.xml 中 set_accent_color 的 `a` 参数 2. 移除 treeland-appearance-unstable-v1.xml 中 accent_color 事件的 `a` 参数 3. 在 dde/ 与 public/ 的 README 中补充 0.7.0 破坏性变更条目 4. CMakeLists.txt 项目版本号升至 0.7.0 Log: 活动色现上线缆为不透明 RGB（r, g, b）；特权设置请求与只读观察事件均不再携带 alpha 通道。 Influence: 1. 绑定 treeland_appearance_manager_v1 并以三个 uint 参数（r, g, b）调用 set_accent_color，验证合成器应用该颜色且不再读取末尾 alpha 值 2. 绑定 treeland_appearance_v1，确认 accent_color 事件在初始绑定及后续变化时均只发送三个 uint 参数（r, g, b） 3. 验证发送旧四参数（r, g, b, a）签名的客户端在线缆变更后被拒绝或按合成器策略处理 --- CMakeLists.txt | 2 +- dde/README.md | 6 ++++++ dde/README.zh_CN.md | 6 ++++++ dde/treeland-appearance-manager-unstable-v1.xml | 1 - public/README.md | 4 ++++ public/README.zh_CN.md | 4 ++++ public/treeland-appearance-unstable-v1.xml | 1 - 7 files changed, 21 insertions(+), 3 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index 10251dd..ed62b63 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,6 +1,6 @@ cmake_minimum_required(VERSION 3.25.0) -project(TreelandProtocols VERSION 0.6.0 LANGUAGES NONE) +project(TreelandProtocols VERSION 0.7.0 LANGUAGES NONE) # https://gitlab.kitware.com/cmake/cmake/-/work_items/23461 # Suppress GNUInstallDirs warning for LANGUAGES NONE projects diff --git a/dde/README.md b/dde/README.md index 42602de..0baaa6a 100644 --- a/dde/README.md +++ b/dde/README.md @@ -20,6 +20,12 @@ For DDE desktop components. Installed via `TREELAND_PROTOCOL_DDE_XML_FILES`. Breaking changes are grouped by version. Under each version heading, one subsection per affected protocol explains what changed, what replaces it, and how existing consumers should adapt. +### 0.7.0 + +#### `treeland-appearance-manager-unstable-v1.xml` + +The `set_accent_color` request dropped its `a` (alpha) argument. The accent color is now an opaque RGB triple `r, g, b` (each `uint` in `[0, 255]`); the alpha channel is no longer carried on the wire. Consumers must stop sending the trailing `a` argument and must not interpret accent color opacity from this request; opacity is outside the scope of the accent color setting. + ### 0.6.0 #### `treeland-output-manager-v1.xml` diff --git a/dde/README.zh_CN.md b/dde/README.zh_CN.md index 132b8e4..ece28e3 100644 --- a/dde/README.zh_CN.md +++ b/dde/README.zh_CN.md @@ -20,6 +20,12 @@ 破坏性变更按版本分组。每个版本标题下，每个受影响协议有一个子节说明变更内容、替代方案以及现有消费者如何适配。 +### 0.7.0 + +#### `treeland-appearance-manager-unstable-v1.xml` + +`set_accent_color` 请求移除了 `a`（alpha）参数。活动色现为不透明 RGB 三元组 `r, g, b`（每个为 `[0, 255]` 范围内的 `uint`）；alpha 通道不再上线缆传输。消费者须停止发送末尾的 `a` 参数，且不得从该请求推断活动色不透明度；不透明度不在活动色设置范围内。 + ### 0.6.0 #### `treeland-output-manager-v1.xml` diff --git a/dde/treeland-appearance-manager-unstable-v1.xml b/dde/treeland-appearance-manager-unstable-v1.xml index 9d3f378..f7f2f89 100644 --- a/dde/treeland-appearance-manager-unstable-v1.xml +++ b/dde/treeland-appearance-manager-unstable-v1.xml @@ -157,7 +157,6 @@ - diff --git a/public/README.md b/public/README.md index cf1f0fc..1b5c164 100644 --- a/public/README.md +++ b/public/README.md @@ -14,6 +14,10 @@ Breaking changes are grouped by version. Under each version heading, one subsect ### 0.7.0 +#### `treeland-appearance-unstable-v1.xml` + +The `accent_color` event dropped its `a` (alpha) argument. The accent color is now reported as an opaque RGB triple `r, g, b` (each `uint` in `[0, 255]`); the alpha channel is no longer carried on the wire. Consumers must stop reading the trailing `a` argument and must not derive accent color opacity from this event; opacity is outside the scope of the accent color setting. + #### `treeland-dde-shell-v1.xml` The manager request `set_xwindow_position_relative` is now documented as deprecated and non-functional: it has no effect and no callback is ever created. The file itself stays in place for now; the whole `treeland-dde-shell` protocol is slated for removal in a future release. diff --git a/public/README.zh_CN.md b/public/README.zh_CN.md index 82e9284..3268241 100644 --- a/public/README.zh_CN.md +++ b/public/README.zh_CN.md @@ -15,6 +15,10 @@ ### 0.7.0 +#### `treeland-appearance-unstable-v1.xml` + +`accent_color` 事件移除了 `a`（alpha）参数。活动色现以不透明 RGB 三元组 `r, g, b` 上报（每个为 `[0, 255]` 范围内的 `uint`）；alpha 通道不再上线缆传输。消费者须停止读取末尾的 `a` 参数，且不得从该事件推断活动色不透明度；不透明度不在活动色设置范围内。 + #### `treeland-dde-shell-v1.xml` 管理器的 `set_xwindow_position_relative` 请求现标注为已废弃且不可用：请求无任何效果，也不会创建任何回调。文件暂保留原位；整个 `treeland-dde-shell` 协议计划在未来版本彻底移除。 diff --git a/public/treeland-appearance-unstable-v1.xml b/public/treeland-appearance-unstable-v1.xml index a3692ee..78d2afd 100644 --- a/public/treeland-appearance-unstable-v1.xml +++ b/public/treeland-appearance-unstable-v1.xml @@ -139,7 +139,6 @@ -