| 1 |
.\" |
| 2 |
.\" Copyright 2001 Keith Packard |
| 3 |
.\" |
| 4 |
.\" Permission to use, copy, modify, distribute, and sell this software and its |
| 5 |
.\" documentation for any purpose is hereby granted without fee, provided that |
| 6 |
.\" the above copyright notice appear in all copies and that both that |
| 7 |
.\" copyright notice and this permission notice appear in supporting |
| 8 |
.\" documentation, and that the name of Keith Packard not be used in |
| 9 |
.\" advertising or publicity pertaining to distribution of the software without |
| 10 |
.\" specific, written prior permission. Keith Packard makes no |
| 11 |
.\" representations about the suitability of this software for any purpose. It |
| 12 |
.\" is provided "as is" without express or implied warranty. |
| 13 |
.\" |
| 14 |
.\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, |
| 15 |
.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO |
| 16 |
.\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR |
| 17 |
.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, |
| 18 |
.\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER |
| 19 |
.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR |
| 20 |
.\" PERFORMANCE OF THIS SOFTWARE. |
| 21 |
.\" |
| 22 |
.TH XRANDR 1 2025-04-15 "xrandr 1.5.4" "X Version 11" |
| 23 |
.SH NAME |
| 24 |
xrandr - adjust size, orientation, reflection of a screen |
| 25 |
(using RandR extension) |
| 26 |
.SH SYNOPSIS |
| 27 |
.nf |
| 28 |
\fBxrandr\fP \ |
| 29 |
[\fB\-\-help\fP] \ |
| 30 |
[\fB\-\-display\fP \fIdisplay\fP] \ |
| 31 |
[\fB\-q\fP] [\fB\-v\fP] \ |
| 32 |
[\fB\-\-verbose\fP] \ |
| 33 |
[\fB\-\-dryrun\fP] |
| 34 |
[\fB\-\-screen\fP \fIsnum\fP] \ |
| 35 |
[\fB\-\-q1\fP] \ |
| 36 |
[\fB\-\-q12\fP] \ |
| 37 |
[\fB\-\-current\fP] \ |
| 38 |
[\fB\-\-noprimary\fP] |
| 39 |
[\fB\-\-panning\fP \fIwidth\fPx\fIheight\fP[+\fIx\fP+\fIy\fP\:\ |
| 40 |
[/\fItrack_width\fPx\fItrack_height\fP+\fItrack_x\fP+\fItrack_y\fP\:\ |
| 41 |
[/\fIborder_left\fP/\fIborder_top\fP/\fIborder_right\fP/\fIborder_bottom\fP]]]] |
| 42 |
[\fB\-\-scale\fP \fIx\fP[x\fIy\fP]] \ |
| 43 |
[\fB\-\-scale\-from\fP \fIw\fPx\fIh\fP] \ |
| 44 |
[\fB\-\-transform\fP \fIa\fP,\fIb\fP,\fIc\fP,\fId\fP,\fIe\fP,\fIf\fP,\fIg\fP,\fIh\fP,\fIi\fP] |
| 45 |
[\fB\-\-primary\fP] \ |
| 46 |
[\fB\-\-prop\fP] \ |
| 47 |
[\fB\-\-fb\fP \fIwidth\fPx\fIheight\fP] \ |
| 48 |
[\fB\-\-fbmm\fP \fIwidth\fPx\fIheight\fP] |
| 49 |
[\fB\-\-dpi\fP \fIdpi\fP] \ |
| 50 |
[\fB\-\-dpi\fP \fIfrom-output\fP] |
| 51 |
[\fB\-\-newmode\fP \fIname\fP \fImode\fP] \ |
| 52 |
[\fB\-\-rmmode\fP \fIname\fP] \ |
| 53 |
[\fB\-\-addmode\fP \fIoutput\fP \fIname\fP] |
| 54 |
[\fB\-\-delmode\fP \fIoutput\fP \fIname\fP] \ |
| 55 |
[\fB\-\-output\fP \fIoutput\fP] \ |
| 56 |
[\fB\-\-auto\fP] \ |
| 57 |
[\fB\-\-mode\fP \fImode\fP] |
| 58 |
[\fB\-\-preferred\fP] \ |
| 59 |
[\fB\-\-pos\fP \fIx\fPx\fIy\fP] \ |
| 60 |
[\fB\-\-rate\fP \fIrate\fP] |
| 61 |
[\fB\-\-reflect\fP \fIreflection\fP] \ |
| 62 |
[\fB\-\-rotate\fP \fIorientation\fP] |
| 63 |
[\fB\-\-left\-of\fP \fIoutput\fP] \ |
| 64 |
[\fB\-\-right\-of\fP \fIoutput\fP] |
| 65 |
[\fB\-\-above\fP \fIoutput\fP] \ |
| 66 |
[\fB\-\-below\fP \fIoutput\fP] \ |
| 67 |
[\fB\-\-same-as\fP \fIoutput\fP] |
| 68 |
[\fB\-\-set\fP \fIproperty\fP \fIvalue\fP] \ |
| 69 |
[\fB\-\-off\fP] \ |
| 70 |
[\fB\-\-crtc\fP \fIcrtc\fP] |
| 71 |
[\fB\-\-gamma\fP \fIred\fP[:\fIgreen\fP:\fIblue\fP]] \ |
| 72 |
[\fB\-\-brightness\fP \fIbrightness\fP] |
| 73 |
[\fB\-o\fP \fIorientation\fP] \ |
| 74 |
[\fB\-s\fP \fIsize\fP] \ |
| 75 |
[\fB\-r\fP \fIrate\fP] \ |
| 76 |
[\fB\-x\fP] [\fB\-y\fP] |
| 77 |
[\fB\-\-listproviders\fP] \ |
| 78 |
[\fB\-\-setprovideroutputsource\fP \fIprovider\fP \fIsource\fP] |
| 79 |
[\fB\-\-setprovideroffloadsink\fP \fIprovider\fP \fIsink\fP] |
| 80 |
[\fB\-\-listmonitors\fP] \ |
| 81 |
[\fB\-\-listactivemonitors\fP] |
| 82 |
[\fB\-\-setmonitor\fP \fIname\fP \fIgeometry\fP \fIoutputs\fP] \ |
| 83 |
[\fB\-\-delmonitor\fP \fIname\fP] |
| 84 |
.SH DESCRIPTION |
| 85 |
.B Xrandr |
| 86 |
is used to set the size, orientation, and/or reflection of the outputs for a |
| 87 |
screen. |
| 88 |
It can also set the size of the overall screen. |
| 89 |
.PP |
| 90 |
If invoked without any option, it will dump the state of the outputs, |
| 91 |
showing the existing modes for each of them, with a \&'+' after the preferred |
| 92 |
modes and a \&'*' after the current mode. |
| 93 |
.PP |
| 94 |
There are a few global options. |
| 95 |
Other options modify the last output that is |
| 96 |
specified in earlier parameters in the command line. |
| 97 |
Multiple outputs may be modified at the same time by passing |
| 98 |
multiple \fB\-\-output\fP options followed |
| 99 |
immediately by their corresponding modifying options. |
| 100 |
.IP \fB\-\-help\fP |
| 101 |
Print out a summary of the usage and exit. |
| 102 |
.IP "\fB\-v\fP, \fB\-\-version" |
| 103 |
Print out the RandR version reported by the X server and exit. |
| 104 |
.IP \fB\-\-verbose\fP |
| 105 |
Causes xrandr to be more verbose. When used with \fB\-q\fP (or without other |
| 106 |
options), xrandr will display more information about the server state. |
| 107 |
Please note that the gamma and brightness information are only |
| 108 |
approximations of the complete color profile stored in the server. |
| 109 |
When used along with options that reconfigure the system, |
| 110 |
progress will be reported while executing the configuration changes. |
| 111 |
.IP "\fB\-q\fP, \fB\-\-query" |
| 112 |
When this option is present, or when no configuration changes are requested, |
| 113 |
xrandr will display the current state of the system. |
| 114 |
.IP "\fB\-\-dryrun\fP" |
| 115 |
Performs all the actions specified except that no changes are made. |
| 116 |
.IP "\fB\-\-nograb\fP" |
| 117 |
Apply the modifications without grabbing the screen. |
| 118 |
It avoids blocking other applications during the update |
| 119 |
but it might also cause some applications that |
| 120 |
detect screen resize to receive old values. |
| 121 |
.IP "\fB\-d\fP, \fB\-\-display\fP \fIname\fP" |
| 122 |
This option selects the X display to use. |
| 123 |
Note this refers to the X screen abstraction, not the monitor (or output). |
| 124 |
.IP "\fB\-\-screen\fP \fIsnum\fP" |
| 125 |
This option selects which screen to manipulate. |
| 126 |
Note this refers to the X screen abstraction, not the monitor (or output). |
| 127 |
.IP \fB\-\-q1\fP |
| 128 |
Forces the usage of the RandR version 1.1 protocol, |
| 129 |
even if a higher version is available. |
| 130 |
.IP \fB\-\-q12\fP |
| 131 |
Forces the usage of the RandR version 1.2 protocol, even if the display does |
| 132 |
not report it as supported or a higher version is available. |
| 133 |
.SH "RandR version 1.5 options" |
| 134 |
Options for RandR 1.5 are used as a superset of the options for RandR 1.4. |
| 135 |
.IP \fB\-\-listmonitors\fP |
| 136 |
Report information about all defined monitors. |
| 137 |
.IP \fB\-\-listactivemonitors\fP |
| 138 |
Report information about currently active monitors. |
| 139 |
.IP "\fB\-\-setmonitor\fP \fIname\fP \fIgeometry\fP \fIoutput-list\fP" |
| 140 |
Define a new monitor with the given geometry and associated to the given outputs. |
| 141 |
The \fIoutput-list\fP is either the keyword \fBnone\fP |
| 142 |
or a comma-separated list of outputs. |
| 143 |
The \fIgeometry\fP is either the keyword \fBauto\fP, in which case the monitor |
| 144 |
will automatically track the geometry of the associated outputs, |
| 145 |
or a manual specification in the form |
| 146 |
\fIw\fP/\fImmw\fPx\fIh\fP/\fImmh\fP+\fIx\fP+\fIy\fP |
| 147 |
where |
| 148 |
.IR w ", " h ", " x ", " y |
| 149 |
are in pixels and |
| 150 |
.IR mmw ", " mmh |
| 151 |
are the physical dimensions of the monitor. |
| 152 |
.IP "\fB\-\-delmonitor\fP \fIname\fP" |
| 153 |
Delete the given user-defined monitor. |
| 154 |
.SH "RandR version 1.4 options" |
| 155 |
Options for RandR 1.4 are used as a superset of the options for RandR 1.3. |
| 156 |
.IP \fB\-\-listproviders\fP |
| 157 |
Report information about the providers available. |
| 158 |
.IP "\fB\-\-setprovideroutputsource\fP \fIprovider\fP \fIsource\fP" |
| 159 |
Set \fIsource\fP as the source of display output images for \fIprovider\fP. |
| 160 |
This is only possible if \fIsource\fP and \fIprovider\fP have the \fBSource |
| 161 |
Output\fR and \fBSink Output\fR capabilities, respectively. |
| 162 |
If \fIsource\fP is \fB0x0\fP, then \fIprovider\fP is disconnected from its |
| 163 |
current output source. |
| 164 |
.IP "\fB\-\-setprovideroffloadsink\fP \fIprovider\fP \fIsink\fP" |
| 165 |
Set \fIprovider\fP as a render offload device for \fIsink\fP. |
| 166 |
This is only possible if \fIprovider\fP and \fIsink\fP have the |
| 167 |
\fBSource Offload\fR and \fBSink Offload\fR capabilities, respectively. |
| 168 |
If \fIsink\fP is \fB0x0\fP, then \fIprovider\fP is disconnected from its current |
| 169 |
render offload sink. |
| 170 |
.SH "RandR version 1.3 options" |
| 171 |
Options for RandR 1.3 are used as a superset of the options for RandR 1.2. |
| 172 |
.IP \fB\-\-current\fP |
| 173 |
Return the current screen configuration, without polling for hardware changes. |
| 174 |
.IP \fB\-\-noprimary\fP |
| 175 |
Don't define a primary output. |
| 176 |
.PP |
| 177 |
.B "Per-output options" |
| 178 |
.IP "\fB\-\-panning\fP \fIwidth\fPx\fIheight\fP[+\fIx\fP+\fIy\fP\:\ |
| 179 |
[/\fItrack_width\fPx\fItrack_height\fP+\fItrack_x\fP+\fItrack_y\fP\:\ |
| 180 |
[/\fIborder_left\fP/\fIborder_top\fP/\fIborder_right\fP/\fIborder_bottom\fP]]]" |
| 181 |
This option sets the panning parameters. |
| 182 |
As soon as panning is enabled, |
| 183 |
the CRTC position can change with every pointer move. |
| 184 |
The first four parameters specify the total panning area, |
| 185 |
the next four the pointer tracking area (which defaults to the same area). |
| 186 |
The last four parameters specify the border and default to 0. |
| 187 |
A width or height set to zero disables panning on the according axis. |
| 188 |
You typically have to set the screen size with \fB\-\-fb\fP simultaneously. |
| 189 |
.IP "\fB\-\-transform\fP \fIa\fP,\fIb\fP,\fIc\fP,\fId\fP,\fIe\fP,\fIf\fP,\fIg\fP,\fIh\fP,\fIi\fP" |
| 190 |
Specifies a transformation matrix to apply on the output. |
| 191 |
A bilinear filter is selected automatically |
| 192 |
unless the \fB\-\-filter\fP parameter is also specified. |
| 193 |
The mathematical form corresponds to: |
| 194 |
.RS |
| 195 |
.RS |
| 196 |
a b c |
| 197 |
.br |
| 198 |
d e f |
| 199 |
.br |
| 200 |
g h i |
| 201 |
.RE |
| 202 |
The transformation is based on homogeneous coordinates. |
| 203 |
The matrix multiplied by the coordinate vector of a pixel of the output |
| 204 |
gives the transformed coordinate vector of a pixel in the graphic buffer. |
| 205 |
More precisely, the vector |
| 206 |
.RI ( "x y" ) |
| 207 |
of the output pixel is extended to 3 values |
| 208 |
.RI ( "x y w" ), |
| 209 |
with 1 as the w coordinate and multiplied against the matrix. |
| 210 |
The final device coordinates of the pixel are then calculated with the |
| 211 |
so-called homogenic division by the transformed w coordinate. |
| 212 |
In other words, the device coordinates |
| 213 |
.RI ( "x' y'" ) |
| 214 |
of the transformed pixel are: |
| 215 |
.RS |
| 216 |
x' = (ax + by + c) / w' and |
| 217 |
.br |
| 218 |
y' = (dx + ey + f) / w' , |
| 219 |
.br |
| 220 |
with w' = (gx + hy + i) . |
| 221 |
.RE |
| 222 |
Typically, \fIa\fP and \fIe\fP corresponds to the scaling on the X and Y axes, |
| 223 |
\fIc\fP and \fIf\fP corresponds to the translation on those axes, |
| 224 |
and \fIg\fP, \fIh\fP, and \fIi\fP are respectively 0, 0 and 1. |
| 225 |
The matrix can also be used to express more complex transformations |
| 226 |
such as keystone correction, or rotation. |
| 227 |
For a rotation of an angle T, this formula can be used: |
| 228 |
.RS |
| 229 |
cos T \-sin T 0 |
| 230 |
.br |
| 231 |
sin T cos T 0 |
| 232 |
.br |
| 233 |
0 0 1 |
| 234 |
.RE |
| 235 |
As a special argument, instead of passing a matrix, |
| 236 |
one can pass the string \fBnone\fP, in which case the default |
| 237 |
values are used (a unit matrix without filter). |
| 238 |
.RE |
| 239 |
.IP "\fB\-\-filter\fP \fIfiltermode\fP" |
| 240 |
Chooses the scaling filter method to be applied when the screen is scaled or |
| 241 |
transformed. |
| 242 |
Can be either \&'bilinear' or \&'nearest'. |
| 243 |
.IP "\fB\-\-scale\fP \fIx\fP[x\fIy\fP]" |
| 244 |
Changes the dimensions of the output picture. |
| 245 |
If the \fIy\fP value is omitted, |
| 246 |
the \fIx\fP value will be used for both dimensions. |
| 247 |
Values larger than 1 lead to a compressed screen (screen dimension bigger |
| 248 |
than the dimension of the output mode), and values less than 1 lead to |
| 249 |
a zoom in on the output. |
| 250 |
This option is actually a shortcut version of the \fB\-\-transform\fP option. |
| 251 |
.IP "\fB\-\-scale\-from\fP \fIw\fPx\fIh\fP" |
| 252 |
Specifies the size in pixels of the area of the framebuffer to be displayed on |
| 253 |
this output. |
| 254 |
This option is actually a shortcut version of the \fB\-\-transform\fP option. |
| 255 |
.IP \fB\-\-primary\fP |
| 256 |
Set the output as primary. |
| 257 |
It will be sorted first in Xinerama and RANDR geometry requests. |
| 258 |
.SH "RandR version 1.2 options" |
| 259 |
These options are only available for X server supporting RandR version 1.2 |
| 260 |
or newer. |
| 261 |
.IP "\fB\-\-prop\fP, \fB\-\-properties\fP" |
| 262 |
This option causes xrandr to display the contents of properties for each |
| 263 |
output. |
| 264 |
\fB\-\-verbose\fP also enables \fB\-\-prop\fP. |
| 265 |
.IP "\fB\-\-fb\fP \fIwidth\fPx\fIheight\fP" |
| 266 |
Reconfigures the screen to the specified size. |
| 267 |
All configured monitors must fit within this size. |
| 268 |
When this option is not provided, xrandr computes the |
| 269 |
smallest screen size that will hold the set of configured outputs; |
| 270 |
this option provides a way to override that behaviour. |
| 271 |
.IP "\fB\-\-fbmm\fP \fIwidth\fPx\fIheight\fP" |
| 272 |
Sets the value reported as physical size of the X screen as a whole |
| 273 |
(union of all configured monitors). |
| 274 |
In configurations with multiple monitors with different DPIs, |
| 275 |
the value has no physical meaning, |
| 276 |
but it may be used by some legacy clients which do not support RandR |
| 277 |
version 1.2 to compute a reference font scaling. |
| 278 |
Normally, |
| 279 |
xrandr resets the reported physical size values to keep the DPI constant. |
| 280 |
This overrides that computation. |
| 281 |
Default DPI value is 96. |
| 282 |
.IP "\fB\-\-dpi\fP \fIdpi\fP" |
| 283 |
.IP "\fB\-\-dpi\fP \fIfrom-output\fP" |
| 284 |
This also sets the value reported as physical size of the X screen as a whole |
| 285 |
(union of all configured monitors). |
| 286 |
In configurations with multiple monitors with different DPIs, |
| 287 |
the value has no physical meaning, |
| 288 |
but it may be used by some legacy clients which do not support RandR |
| 289 |
version 1.2 to compute a reference font scaling. |
| 290 |
This option uses either the specified DPI value, |
| 291 |
or the DPI of the given output, |
| 292 |
to compute an appropriate physical size using whatever pixel size will be set. |
| 293 |
Typical values are the default (96 DPI), |
| 294 |
the DPI of the only monitor in single-monitor configurations, |
| 295 |
or the DPI of the primary monitor in multi-monitor configurations. |
| 296 |
.IP "\fB\-\-newmode\fP \fIname\fP \fImode\fP" |
| 297 |
New modelines can be added to the server and then associated with outputs. |
| 298 |
This option does the former. |
| 299 |
The \fImode\fP is specified using the ModeLine syntax for xorg.conf: |
| 300 |
\fIclock hdisp hsyncstart hsyncend htotal vdisp vsyncstart |
| 301 |
vsyncend vtotal flags\fP. |
| 302 |
\fIflags\fP can be zero or more of |
| 303 |
.BR +HSync ", " -HSync ", " +VSync ", " -VSync ", " |
| 304 |
.BR Interlace ", " DoubleScan ", " CSync ", " +CSync ", " -CSync . |
| 305 |
Several tools compute the usual modeline from a height, width, |
| 306 |
and refresh rate, for instance you can use |
| 307 |
.BR cvt (1). |
| 308 |
.IP "\fB\-\-rmmode\fP \fIname\fP" |
| 309 |
This removes a mode from the server if it is otherwise unused. |
| 310 |
.IP "\fB\-\-addmode\fP \fIoutput\fP \fIname\fP" |
| 311 |
Add a mode to the set of valid modes for an output. |
| 312 |
.IP "\fB\-\-delmode\fP \fIoutput\fP \fIname\fP" |
| 313 |
Remove a mode from the set of valid modes for an output. |
| 314 |
.PP |
| 315 |
.B "Per-output options" |
| 316 |
.IP "\fB\-\-output\fP \fIoutput\fP" |
| 317 |
Selects an output to reconfigure. Use either the name of the output or the |
| 318 |
XID. |
| 319 |
.IP \fB\-\-auto\fP |
| 320 |
For connected but disabled outputs, |
| 321 |
this will enable them using their first preferred mode |
| 322 |
(or something close to 96\~dpi if they have no preferred mode). |
| 323 |
For disconnected but enabled outputs, this will disable them. |
| 324 |
.IP "\fB\-\-mode\fP \fImode\fP" |
| 325 |
This selects a mode. |
| 326 |
Use either the name or the XID for \fImode\fP. |
| 327 |
.IP "\fB\-\-preferred\fP" |
| 328 |
This selects the same mode as \fB\-\-auto\fP, |
| 329 |
but it doesn't automatically enable or disable the output. |
| 330 |
.IP "\fB\-\-pos\fP \fIx\fPx\fIy\fP" |
| 331 |
Position the output within the screen using pixel coordinates. |
| 332 |
In case reflection or rotation is applied, |
| 333 |
the translation is applied after the effects. |
| 334 |
.IP "\fB\-\-rate\fP \fIrate\fP" |
| 335 |
This marks a preference for refresh rates close to the specified value. |
| 336 |
When multiple modes have the same name, |
| 337 |
this will select the one with the nearest refresh rate. |
| 338 |
.IP "\fB\-\-reflect\fP \fIreflection\fP" |
| 339 |
Reflection can be one of |
| 340 |
.BR normal ", " x ", " y ", or " xy . |
| 341 |
This causes the output contents to be reflected across the specified axes. |
| 342 |
.IP "\fB\-\-rotate\fP \fIrotation\fP" |
| 343 |
Rotation can be one of |
| 344 |
.BR normal ", " left ", " right ", or " inverted . |
| 345 |
This causes the output contents to be rotated in the specified direction. |
| 346 |
\fBright\fP specifies a clockwise rotation of the picture and |
| 347 |
\fBleft\fP specifies a counter-clockwise rotation. |
| 348 |
.IP "\fB\-\-left\-of\fP, \fB\-\-right\-of\fP, \fB\-\-above\fP, \ |
| 349 |
\fB\-\-below\fP, \fB\-\-same-as\fP \fIanother-output\fP" |
| 350 |
Use one of these options to position the output relative to the position of |
| 351 |
another output. |
| 352 |
This allows convenient tiling of outputs within the screen. |
| 353 |
The position is always computed relative to the new position of the other output, |
| 354 |
so it is not valid to say |
| 355 |
\fB\-\-output a \-\-left\-of b \-\-output b \-\-left\-of a\fP. |
| 356 |
.IP "\fB\-\-set\fP \fIproperty\fP \fIvalue\fP" |
| 357 |
Sets an output property. |
| 358 |
Integer properties may be specified as a valid (see \fB\-\-prop\fP) |
| 359 |
comma-separated list of decimal or hexadecimal (with a leading 0x) values. |
| 360 |
Atom properties may be set to any of the valid atoms (see \fB\-\-prop\fP). |
| 361 |
String properties may be set to any value. |
| 362 |
.IP "\fB\-\-off\fP" |
| 363 |
Disables the output. |
| 364 |
.IP "\fB\-\-crtc\fP \fIcrtc\fP" |
| 365 |
Uses the specified crtc (either as an index in the list of CRTCs or XID). |
| 366 |
In normal usage, this option is not required as xrandr tries to make |
| 367 |
sensible choices about which crtc to use with each output. |
| 368 |
When that fails for some reason, this option can override the normal selection. |
| 369 |
.IP "\fB\-\-gamma\fP \fIred\fP[:\fIgreen\fP:\fIblue\fP]" |
| 370 |
Set the specified floating point values as gamma correction on the crtc |
| 371 |
currently attached to this output. |
| 372 |
If green and blue are not specified, the red value will be used |
| 373 |
for all three components. |
| 374 |
Note that you cannot get two different values for cloned outputs |
| 375 |
(i.e., outputs which share the same crtc) |
| 376 |
and that switching an output to another crtc doesn't change |
| 377 |
the crtc gamma corrections at all. |
| 378 |
.IP "\fB\-\-brightness\fP \fIbrightness\fP" |
| 379 |
Multiply the gamma values on the crtc currently attached to the output to |
| 380 |
specified floating value. |
| 381 |
Useful for overly bright or overly dim outputs. |
| 382 |
However, this is a software only modification, |
| 383 |
if your hardware has support to actually change the brightness, |
| 384 |
you will probably prefer to use |
| 385 |
.BR xbacklight (1). |
| 386 |
.SH "RandR version 1.1 options" |
| 387 |
These options are available for X servers supporting RandR version 1.1 or |
| 388 |
older. |
| 389 |
They are still valid for newer X servers, but they don't interact |
| 390 |
sensibly with version 1.2 options on the same command line. |
| 391 |
.IP "\fB\-s\fP, \fB\-\-size\fP \fIsize-index\fP or \fB\-\-size\fP \fIwidth\fPx\fIheight\fP" |
| 392 |
This sets the screen size, either matching by size or using the index into |
| 393 |
the list of available sizes. |
| 394 |
.IP "\fB\-r\fP, \fB\-\-rate\fP, \fB\-\-refresh\fP \fIrate\fP" |
| 395 |
This sets the refresh rate closest to the specified value. |
| 396 |
.IP "\fB\-o\fP, \fB\-\-orientation\fP \fIrotation\fP" |
| 397 |
This specifies the orientation of the screen, |
| 398 |
and can be one of |
| 399 |
.BR normal ", " inverted ", " left ", or " right . |
| 400 |
.IP \fB\-x\fP |
| 401 |
Reflect across the X axis. |
| 402 |
.IP \fB\-y\fP |
| 403 |
Reflect across the Y axis. |
| 404 |
.SH EXAMPLES |
| 405 |
Sets an output called LVDS to its preferred mode, |
| 406 |
and on its right put an output called VGA to set to the preferred mode |
| 407 |
of a screen which has been physically rotated clockwise: |
| 408 |
.RS |
| 409 |
.nf |
| 410 |
xrandr \-\-output LVDS \-\-auto \-\-rotate normal \-\-pos 0x0 \\ |
| 411 |
\-\-output VGA \-\-auto \-\-rotate left \-\-right\-of LVDS |
| 412 |
.fi |
| 413 |
.RE |
| 414 |
.PP |
| 415 |
Forces to use a 1024x768 mode on an output called VGA: |
| 416 |
.RS |
| 417 |
.nf |
| 418 |
xrandr \-\-newmode "1024x768" \\ |
| 419 |
63.50 1024 1072 1176 1328 768 771 775 798 \-hsync +vsync |
| 420 |
.fi |
| 421 |
.br |
| 422 |
xrandr \-\-addmode VGA 1024x768 |
| 423 |
.br |
| 424 |
xrandr \-\-output VGA \-\-mode 1024x768 |
| 425 |
.RE |
| 426 |
.PP |
| 427 |
Enables panning on a 1600x768 desktop while displaying 1024x768 mode on an |
| 428 |
output called VGA: |
| 429 |
.RS |
| 430 |
.nf |
| 431 |
xrandr \-\-fb 1600x768 \-\-output VGA \-\-mode 1024x768 \\ |
| 432 |
\-\-panning 1600x0 |
| 433 |
.fi |
| 434 |
.RE |
| 435 |
.PP |
| 436 |
Have one small 1280x800 LVDS screen showing a small version of |
| 437 |
a huge 3200x2000 desktop, |
| 438 |
and have a big VGA screen display the surrounding of the mouse at normal size. |
| 439 |
.RS |
| 440 |
.nf |
| 441 |
xrandr \-\-fb 3200x2000 \-\-output LVDS \-\-scale 2.5x2.5 \\ |
| 442 |
\-\-output VGA \-\-pos 0x0 \\ |
| 443 |
\-\-panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64 |
| 444 |
.fi |
| 445 |
.RE |
| 446 |
.PP |
| 447 |
Displays the VGA output in trapezoid shape so that it is keystone corrected |
| 448 |
when the projector is slightly above the screen: |
| 449 |
.RS |
| 450 |
.nf |
| 451 |
xrandr \-\-fb 1024x768 \-\-output VGA \\ |
| 452 |
\-\-transform 1.24,0.16,\-124,0,1.24,0,0,0.000316,1 |
| 453 |
.fi |
| 454 |
.RE |
| 455 |
.SH "XWAYLAND" |
| 456 |
.BR Xwayland (1) |
| 457 |
is an X server that uses a Wayland Compositor as backend. |
| 458 |
\fBXwayland\fP acts as translation layer between the X protocol and the Wayland |
| 459 |
protocol but does not have direct access to the hardware. |
| 460 |
With \fBXwayland\fP rootless (the default with most Wayland compositors), |
| 461 |
RandR is emulated and only available read-only to report the current status |
| 462 |
and configuration of the outputs as exposed to X11 clients. |
| 463 |
As a result, it is not possible to change the configuration of the outputs |
| 464 |
using \fBxrandr\fP on a Wayland environment with \fBXwayland\fP running rootless. |
| 465 |
.SH "SEE ALSO" |
| 466 |
.BR Xrandr (3), |
| 467 |
.BR cvt (1), |
| 468 |
.BR xkeystone (1), |
| 469 |
.BR xbacklight (1) |
| 470 |
.SH AUTHORS |
| 471 |
Keith Packard, |
| 472 |
Open Source Technology Center, Intel Corporation. |
| 473 |
and |
| 474 |
Jim Gettys, |
| 475 |
Cambridge Research Laboratory, HP Labs, HP. |