wlr_gamma_control_unstable_v1

• # zwlr_gamma_control_manager_v1

  This interface is a manager that allows creating per-output gamma controls.

  Requests

  • #

    get_gamma_control

    get a gamma control for an output
    struct zwlr_gamma_control_v1* zwlr_gamma_control_manager_v1_get_gamma_control(

    struct zwlr_gamma_control_manager_v1* zwlr_gamma_control_manager_v1,

    struct wl_output* output

    )
    Create a gamma control that can be used to adjust gamma tables for the provided output.
  • #

    destroy

    destroy the manager
    void zwlr_gamma_control_manager_v1_destroy(

    struct zwlr_gamma_control_manager_v1* zwlr_gamma_control_manager_v1

    )
    All objects created by the manager will still remain valid, until their appropriate destroy request has been called.

• # zwlr_gamma_control_v1

  This interface allows a client to adjust gamma tables for a particular output. The client will receive the gamma size, and will then be able to set gamma tables. At any time the compositor can send a failed event indicating that this object is no longer valid. There can only be at most one gamma control object per output, which has exclusive access to this particular output. When the gamma control object is destroyed, the gamma table is restored to its original value.

  Requests

  • #

    set_gamma

    set the gamma table
    void zwlr_gamma_control_v1_set_gamma(

    struct zwlr_gamma_control_v1* zwlr_gamma_control_v1,

    int32_t fd /* gamma table file descriptor */

    )
    Set the gamma table. The file descriptor can be memory-mapped to provide the raw gamma table, which contains successive gamma ramps for the red, green and blue channels. Each gamma ramp is an array of 16-byte unsigned integers which has the same length as the gamma size. The file descriptor data must have the same length as three times the gamma size.
  • #

    destroy

    destroy this control
    void zwlr_gamma_control_v1_destroy(

    struct zwlr_gamma_control_v1* zwlr_gamma_control_v1

    )
    Destroys the gamma control object. If the object is still valid, this restores the original gamma tables.

  Events

  • #

    gamma_size

    size of gamma ramps
    uint32_t size /* number of elements in a ramp */
    Advertise the size of each gamma ramp. This event is sent immediately when the gamma control object is created.
  • #

    failed

    object no longer valid
    This event indicates that the gamma control is no longer valid. This can happen for a number of reasons, including: - The output doesn't support gamma tables - Setting the gamma tables failed - Another client already has exclusive gamma control for this output - The compositor has transferred gamma control to another client Upon receiving this event, the client should destroy this object.

  Enums

  • #

    error
    ZWLR_GAMMA_CONTROL_V1_ERROR_INVALID_GAMMA /* invalid gamma tables */

Copyright Info