This patch allows the rotation of an output to be set from kscreen-doctor.

The syntax is
kscreen-doctor output.HDMI-2.rotation.left

This makes the mode setting through kscreen-doctor a bit more intuitive
and documents it

Bit of a screwup between not merging the Plasma/5.10 branch and this slightly improved version.

David Edmundson authored Jun 05, 2017 and Sebastian Kügler committed Sep 20, 2017

Summary:
Adds set scale option to kscreen doctor.

Test Plan: Ran it, my screen changed awesomely.

Reviewers: #plasma, mart

Reviewed By: #plasma, mart

Subscribers: mart, plasma-devel

Tags: #plasma

Differential Revision: https://phabricator.kde.org/D6026

Instead of our hand-baked version, use QString::toInt() to convert to numbers.

Add the option to set the scale of an output in kscreen doctor.

CHANGELOG: kscreen-doctor: support setting scale of outputs

This allows to use config commands such as "output.HDMI-1.enable"
instead of "output.73.enable", the former being more human-readable,
easier to identify, and more stable (the output id may change across
sessions).

If an output with that name isn't found, we still parse it as an int
output id.

- rename cli option to reflect that this outputs more general runtime
  information now, not just the backend config
- add information about logging to --info output

Also, color and indicate current and preferred mode, this was really
missing from the outputs output.

This change shows when an output is the primary in the outputs list of
kscreen-doctor.

BUG:364091

Show an error and exit instead of hanging.

We need to wait until the supported signal comes in, then set the mode.
In order to make sure that all outputs are done before we quit, we'll
count the number of supported display's "under way signals".

The rest of the code is pretty much boilerplate.

Add a --dpms option which currently switches off the display.

This command shows the backend configuration, available backends,
preferred ones and environmental matters.

This is pretty straight-forward now, including error handling when the
supplied mode id is invalid.

Make sure we return as soon as we notice a problem. This avoids calling
qApp->quit() before the event loop is stopped, and makes returning the
proper error code work.

- exit with error codes as documented in main.cpp
- stricter checking if ints are parsed by comparing them as strings
- return early where possible

This introduces new syntax which allows to set multiple options at once,
as to align with atomic modesetting semantics.

It's pretty simple:

- kscreen-doctor receives a list of "commands"
- each command translates to one setting of an output
- in general, the output commands are separated by '.'

Commands can be (currently limited to, but it gets you the idea):

// Disable an output
kscreen-doctor output.1.disable

// Enable an output, set a specific mode
kscreen-doctor output.1.enable output.1.mode.3

// Position outputs next to each other
kscreen-doctor output.1.position.0,0 output.2.position.1920,0

You can use the --outputs option to find the ids for outputs and modes.

kscreen-doctor is a command-line tool to interact with kscreen. Its
mainly for testing, but can surely prove useful in the future as a
replacement for tools such as xrandr.

It can show the output configuration as json for now, not much else.