wlr gamma control
此协议允许特权客户端设置输出的 gamma 表。
警告！此文件中描述的实验性协议可能会进行向后不兼容的更改。向后兼容的更改可能会与相应的接口版本号提升一起添加。向后不兼容的更改通过提升协议和接口名称中的版本号并重置接口版本来完成。一旦协议被宣布为稳定版本，协议和接口名称中的 'z' 前缀和版本号将被移除，接口版本号将被重置。
此接口是一个管理器，允许创建逐输出的 gamma 控制。
get_gamma_control(id: new_id<zwlr_gamma_control_v1>, output: object<wl_output>)
参数 | 类型 | 描述 |
|---|---|---|
| id | new_id<zwlr_gamma_control_v1> | |
| output | object<wl_output> |
创建一个可用于调整提供的输出的 gamma 表的 gamma 控制。
此接口允许客户端调整特定输出的 gamma 表。
客户端将接收 gamma 大小，然后能够设置 gamma 表。合成器可以随时发送 failed 事件，指示此对象不再有效。
每个输出最多只能有一个 gamma 控制对象，该对象对此特定输出具有独占访问权。当 gamma 控制对象被销毁时，gamma 表将恢复为其原始值。
set_gamma(fd: fd)
参数 | 类型 | 描述 |
|---|---|---|
| fd | fd | gamma table file descriptor |
设置 gamma 表。文件描述符可以内存映射以提供原始 gamma 表，其中包含红色、绿色和蓝色通道的连续 gamma 坡道。每个 gamma 坡道是一个 16 字节无符号整数数组，其长度与 gamma 大小相同。
文件描述符数据的长度必须是 gamma 大小的三倍。
gamma_size(size: uint)
参数 | 类型 | 描述 |
|---|---|---|
| size | uint | number of elements in a ramp |
广播每个 gamma 坡道的大小。
此事件在 gamma 控制对象创建时立即发送。
failed()
此事件表示 gamma 控制不再有效。这可能由于多种原因发生，包括：
- 输出不支持 gamma 表
- 设置 gamma 表失败
- 另一个客户端已对此输出具有独占 gamma 控制
- 合成器已将 gamma 控制转移给另一个客户端
收到此事件后，客户端应销毁此对象。
合成器支持
Cage  | COSMIC  | GameScope  | Hyprland  | Jay | KWin  | Labwc  | Louvre  | Mir  | Muffin  | Mutter  | niri  | phoc  | river  | Sway  | Treeland  | Wayfire  | Weston  | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| zwlr_gamma_control_manager_v1 | 1 | x | x | 1 | 1 | x | 1 | 1 | x | x | x | 1 | 1 | 1 | 1 | 1 | 1 | x |
Copyright
Copyright © 2015 Giulio camuffo Copyright © 2018 Simon Ser
Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of the copyright holders not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The copyright holders make no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.
THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.