| |
man : xrandr(1)
XRANDR(1) XRANDR(1)
NAME
xrandr - primitive command line interface to RandR exten-
sion
SYNOPSIS
xrandr [-help] [-display display] [-q] [-v] [--verbose]
[--screen snum]
RandR version 1.2 options
[--prop] [--fb <width>x<height>] [--fbmm <width>x<height>]
[--dpi <dpi>]
Per-output options
[--output <output>] [--auto] [--mode <mode>] [--preferred]
[--pos <x>x<y>] [--rate <rate>] [--reflect reflection]
[--rotate orientation] [--left-of <output>] [--right-of
<output>] [--above <output>] [--below <output>] [--same-as
<output>] [--set <property> <value>] [--off] [--crtc
<crtc>] [--newmode <name> mode] [--rmmode <name>]
[--addmode <output> <name>] [--delmode <output> <name>]
RandR version 1.0 and version 1.1 options
[-o orientation] [-s size] [-x] [-y]
DESCRIPTION
Xrandr is used to set the size, orientation and/or reflec-
tion of the outputs for a screen. It can also set the
screen size.
If invoked without any option, it will dump the state of
the outputs, showing the existing modes for each of them,
with a '+' after the preferred mode and a '*' after the
current mode.
There are a few global options. Other options modify the
last output that is specified in earlier parameters in the
command line. Multiple outputs may be modified at the same
time by passing mutiple --output options followed immedi-
ately by their corresponding modifying options.
--help Print out a summary of the usage and exit.
-v Print out the RandR version reported by the X
server and exit.
--verbose
causes xrandr to be more verbose. When used with -q
(or without other options), xrandr will display
more information about the server state. When used
along with options that reconfigure the system,
progress will be reported while executing the con-
figuration changes.
-q When this option is present, or when no configura-
tion changes are requested, xrandr will display the
current state of the system.
X Version 11 xrandr 1.2.3 1
XRANDR(1) XRANDR(1)
-screen snum
This option selects which screen to manipulate.
Note this refers to the X screen abstraction, not
the monitor (or output).
RandR version 1.2 options
These options are only available for X server supporting
RandR version 1.2 or newer.
--prop This option causes xrandr to display the contents
of properties for each output. --verbose also
enables --prop.
--fb <width>x<height>
Reconfigures the screen to the specified size. All
configured monitors must fit within this size. When
this option is not provided, xrandr computes the
smallest screen size that will hold the set of con-
figured outputs; this option provides a way to
override that behaviour.
--fbmm <width>x<height>
Sets the reported values for the physical size of
the screen. Normally, xrandr resets the reported
physical size values to keep the DPI constant.
This overrides that computation.
--dpi <dpi>
This also sets the reported physical size values of
the screen, it uses the specified DPI value to com-
pute an appropriate physical size using whatever
pixel size will be set.
Per-output options
--output <output>
Selects an output to reconfigure. Use either the
name of the output or the XID.
--auto For connected but disabled outputs, this will
enable them using their preferred mode (or, some-
thing close to 96dpi if they have no preferred
mode). For disconnected but enabled outputs, this
will disable them.
--mode <mode>
This selects a mode. Use either the name or the XID
for <mode>
--preferred
This selects the same mode as --auto, but it
doesn't automatically enable or disable the output.
X Version 11 xrandr 1.2.3 2
XRANDR(1) XRANDR(1)
--pos <x>x<y>
Position the output within the screen using pixel
coordinates.
--rate <rate>
This marks a preference for refresh rates close to
the specified value, when multiple modes have the
same name, this will select the one with the near-
est refresh rate.
--reflect reflection
Reflection can be one of 'normal' 'x', 'y' or 'xy'.
This causes the output contents to be reflected
across the specified axes.
--rotate rotation
Rotation can be one of 'normal', 'left', 'right' or
'inverted'. This causes the output contents to be
rotated in the specified direction.
--left-of, --right-of, --above, --below, --same-as
<another out- put>
Use one of these options to position the output
relative to the position of another output. This
allows convenient tiling of outputs within the
screen. The position is always computed relative
to the new position of the other output, so it is
not valid to say --output a --left-of b --output b
--left-of a.
--set <property> <value>
Sets an output property. Integer properties may be
specified as a valid (see --prop) decimal or hex-
adecimal (with a leading 0x) value. Atom properties
may be set to any of the valid atoms (see --prop).
String properties may be set to any value.
--off Disables the output.
--crtc <crtc>
Uses the specified crtc (either as an index in the
list of CRTCs or XID). In normal usage, this
option is not required as xrandr tries to make sen-
sible choices about which crtc to use with each
output. When that fails for some reason, this
option can override the normal selection.
--newmode <name> mode
New modelines can be added to the server and then
associated with outputs. This option does the for-
mer. The mode is specified using the ModeLine syn-
tax for xorg.conf: hdisp hsyncstart hsyncend htotal
vdisp vsyncstart vsyncend vtotal flags. flags can
be zero or more of +HSync, -HSync, +VSync, -VSync,
X Version 11 xrandr 1.2.3 3
XRANDR(1) XRANDR(1)
Interlace, DoubleScan, CSync, +CSync, -CSync.
--rmmode <name>
This removes a mode from the server if it is other-
wise unused.
--addmode <output> <name>
Add a mode to the set of valid modes for an output.
--delmode <output> <name>
Remove a mode from the set of valid modes for an
output.
RandR version 1.1 options
These options are available for X servers supporting RandR
version 1.1 or older. They are still valid for newer X
servers, but they don't interact sensibly with version 1.2
options on the same command line.
-s <size index> or -s <width>x<height>
This sets the screen size, either matching by size
or using the index into the list of available
sizes.
-o rotation
This specifies the orientation of the screen, and
can be one of normal, inverted, left or right.
-x Reflect across the X axis.
-y Reflect across the Y axis.
SEE ALSO
Xrandr(3)
AUTHORS
Keith Packard, Open Source Technology Center, Intel Corpo-
ration. and Jim Gettys, Cambridge Research Laboratory, HP
Labs, HP.
X Version 11 xrandr 1.2.3 4
|
