The string value is in the format
of white space separated string construct. The values keywords are
case sensitive. The following are the rules:
- MON1/MON2: mandatory constant values for monitor1
and monitor2, if specific resolutions or placement are to be set for
each individual monitors.
- To specify resolutions: use
1920x1080 format,
resolution numbers with delimiter
x (lowercase) after MON1/MON2
value keyword. Resolutions are optional. If not specified, DDC (optimal)
resolutions is used.
For Example : DisplaySettings=MON1
1920x1080 MON2 1920x1200
- To specify resolutions with refresh rate: use
1920x1080@60 format, refresh rate is optional. If not specified, the optimal
refresh rate is used automatically.
For Example: DisplaySettings=MON1 1920x1080@60 MON2 1920x1200@60
MON1 primary 1920x1080 MON2 1920x1200:
Used for the specified configuration of primary
monitor that is retained previously. Primary monitor is where the
taskbar and app icons are present. It specifies monitor as the primary
monitor, use the value keyword
primary, which is optional.
For Example: Set MON1 as primary : DisplaySettings=MON1
primary 1920x1080 MON2 1920x1200
Set MON2 as
primary : DisplaySettings=MON1 1920x1080 MON2 primary 1920x1200
MON1 primary on-left 1920x1080, MON2 on-right
1920x1200
To specify monitors in horizontal
placement and on the left or right, use the legacy value keywords
on-left and
on-right after MON1/MON2 to arrange monitors
left/right placement. You can use these options in pair.
MON1 primary on-above 1920x1080, MON2 on-below 1920x1200
To specify monitors in vertical placement and
on the top or bottom, use the legacy value keywords
on-above and
on-below after each
MON1 and
MON2 to arrange
monitors top/bottom placement. You can use these options in pair.
MON1 primary rotate-left 1920x1080 MON2 1920x1200
rotate-left, rotate-normal, and rotate-right
are supported as legacy parameters. These parameters rotate the framebuffer
for monitors that do not actually support rotation. Specifying these
parameters requires monitors to be
physically rotated. For
monitors that support rotation, these parameters are not necessary.
<default>
This key value
is to reset both monitors to default settings. (Optimal resolutions
in horizontal placement and MON1 on the left as primary display).
DDC
Resets all the monitors
to default layout and default resolutions – The default layout is
all in
HORIZONTAL placement, Primary is
MON1 and resolutions
are optimal.
Horizontal
For Example: DisplaySettings=Horizontal (which is equal to
DisplaySettings= <default>)
OR DisplaySettings=Horizontal
MON1 primary 1920x1080 MON2 1920x1200
This single
Horizontal (with capital H) key value without any parameter is
used to reset both the monitors to DDC mode as it is in default settings.
There can be parameters as in MON1 and MON2 format as described above.
The result is to set the monitors in horizontal placements with specified
individual parameters.
Vertical
For Example: DisplaySettings=Vertical (which is equal
to DisplaySettings= <default>)
OR DisplaySettings=Vertical
MON1 primary 1920x1080 MON2 1920x1200
This single
Vertical (with capital V) key value is used to set both monitors
to DDC resolutions, but in vertical placement with default MON1 on
the top.
MON2 … MON1…
With individual monitor with their specific parameters in place,
but swaps the MON2 at the beginning of the string, followed by MON1
will be placed MON2 on the left and MON1 on the right. This is equivalent
of MON1 on-right MON2 on-left. For Example: MON2 MON1 = MON1 on-right
MON2 on-left
Mirror <rotate{normal, left,
right, inverted}, {resolution}>
It sets the
monitors in mirror mode with given resolution and rotation.
|