canonical/mir

The MirAL API should support more options for display configuration

Open

#4,184 opened on Sep 3, 2025

View on GitHub
 (0 comments) (0 reactions) (0 assignees)C++ (137 forks)auto 404
Good first issue

Repository metrics

Stars
 (775 stars)
PR merge metrics
 (PR metrics pending)

Description

Discussed in https://github.com/canonical/mir/discussions/2913

Originally posted by AlanGriffiths July 16, 2019 While the mirclient API (mir_toolkit/mir_display_configuration.h) provides for configuring the display we have no corresponding Wayland extension. (E.g. for setting the gamma ramp).

Within the MirAL API there is inadequate support for many options: miral::DisplayConfiguration only offers the option to select some basic screen layout choices from a configuration file.

To configure the display within the server currently requires use of the mirserver and mirplatform APIs (mir/graphics/display_configuration.h & mir::Server::wrap_display_configuration_policy()).

We should expose more of these features.

Contributor guide

Research direction
Research the existing MirAL display configuration API and compare with the mirclient API to identify missing features. Understand the Wayland extension mechanism used in Mir. Design a proposal for adding gamma ramp and other display configuration options to the MirAL API.
Tech stack
cpp
Domain
desktop
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
4
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
C++WaylandMir internals
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30