443 lines
17 KiB
HTML
443 lines
17 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XRANDR</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XRANDR</H1>
|
|
Section: User Commands (1)<BR>Updated: xrandr 1.5.0<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xrandr - primitive command line interface to RandR extension
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xrandr</B>
|
|
|
|
[--help] [--display <I>display</I>]
|
|
[-q] [-v]
|
|
[--verbose]
|
|
[--dryrun]
|
|
[--screen <I>snum</I>]
|
|
[--q1]
|
|
[--q12]
|
|
[--current]
|
|
[--noprimary]
|
|
[--panning <I>width</I>x<I>height</I>[+<I>x</I>+<I>y</I>[/<I>track_width</I>x<I>track_height</I>+<I>track_x</I>+<I>track_y</I>[/<I>border_left</I>/<I>border_top</I>/<I>border_right</I>/<I>border_bottom</I>]]]]
|
|
[--scale <I>x</I>x<I>y</I>]
|
|
[--scale-from <I>w</I>x<I>h</I>]
|
|
[--transform <I>a</I>,<I>b</I>,<I>c</I>,<I>d</I>,<I>e</I>,<I>f</I>,<I>g</I>,<I>h</I>,<I>i</I>]
|
|
[--primary]
|
|
[--prop]
|
|
[--fb <I>width</I>x<I>height</I>]
|
|
[--fbmm <I>width</I>x<I>height</I>]
|
|
[--dpi <I>dpi</I>]
|
|
[--newmode <I>name</I> <I>mode</I>]
|
|
[--rmmode <I>name</I>]
|
|
[--addmode <I>output</I> <I>name</I>]
|
|
[--delmode <I>output</I> <I>name</I>]
|
|
[--output <I>output</I>]
|
|
[--auto]
|
|
[--mode <I>mode</I>]
|
|
[--preferred]
|
|
[--pos <I>x</I>x<I>y</I>]
|
|
[--rate <I>rate</I>]
|
|
[--reflect <I>reflection</I>]
|
|
[--rotate <I>orientation</I>]
|
|
[--left-of <I>output</I>]
|
|
[--right-of <I>output</I>]
|
|
[--above <I>output</I>]
|
|
[--below <I>output</I>]
|
|
[--same-as <I>output</I>]
|
|
[--set <I>property</I> <I>value</I>]
|
|
[--off]
|
|
[--crtc <I>crtc</I>]
|
|
[--gamma <I>red</I>:<I>green</I>:<I>blue</I>]
|
|
[--brightness <I>brightness</I>]
|
|
[-o <I>orientation</I>]
|
|
[-s <I>size</I>]
|
|
[-r <I>rate</I>]
|
|
[-x] [-y]
|
|
[--listproviders]
|
|
[--setprovideroutputsource <I>provider</I> <I>source</I>]
|
|
[--setprovideroffloadsink <I>provider</I> <I>sink</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<I>Xrandr</I>
|
|
|
|
is used to set the size, orientation and/or reflection of the outputs for a
|
|
screen. It can also set the screen size.
|
|
<P>
|
|
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
|
|
modes and a '*' after the current mode.
|
|
<P>
|
|
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 multiple --output options followed
|
|
immediately by their corresponding modifying options.
|
|
<DL COMPACT>
|
|
<DT id="1">--help<DD>
|
|
Print out a summary of the usage and exit.
|
|
<DT id="2">-v, --version<DD>
|
|
Print out the RandR version reported by the X server and exit.
|
|
<DT id="3">--verbose<DD>
|
|
Causes xrandr to be more verbose. When used with -q (or without other
|
|
options), xrandr will display more information about the server state. Please
|
|
note that the gamma and brightness informations are only approximations of the
|
|
complete color profile stored in the server. When
|
|
used along with options that reconfigure the system, progress will be
|
|
reported while executing the configuration changes.
|
|
<DT id="4">-q, --query<DD>
|
|
When this option is present, or when no configuration changes are requested,
|
|
xrandr will display the current state of the system.
|
|
<DT id="5">--dryrun<DD>
|
|
Performs all the actions specified except that no changes are made.
|
|
<DT id="6">--nograb<DD>
|
|
Apply the modifications without grabbing the screen. It avoids to block other
|
|
applications during the update but it might also cause some applications that
|
|
detect screen resize to receive old values.
|
|
<DT id="7">-d, --display <I>name</I><DD>
|
|
This option selects the X display to use. Note this refers to the X
|
|
screen abstraction, not the monitor (or output).
|
|
<DT id="8">--screen <I>snum</I><DD>
|
|
This option selects which screen to manipulate. Note this refers to the X
|
|
screen abstraction, not the monitor (or output).
|
|
<DT id="9">--q1<DD>
|
|
Forces the usage of the RandR version 1.1 protocol, even if a higher version
|
|
is available.
|
|
<DT id="10">--q12<DD>
|
|
Forces the usage of the RandR version 1.2 protocol, even if the display does
|
|
not report it as supported or a higher version is available.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>RandR version 1.4 options</H2>
|
|
|
|
<P>
|
|
|
|
Options for RandR 1.4 are used as a superset of the options for RandR 1.3.
|
|
<DL COMPACT>
|
|
<DT id="11">--listproviders<DD>
|
|
Report information about the providers available.
|
|
<DT id="12">--setprovideroutputsource <I>provider</I> <I>source</I><DD>
|
|
Set <I>source</I> as the source of display output images for <I>provider</I>.
|
|
This is only possible if <I>source</I> and <I>provider</I> have the <B>Source
|
|
Output</B> and <B>Sink Output</B> capabilities, respectively.
|
|
If <I>source</I> is <B>0x0</B>, then <I>provider</I> is disconnected from its
|
|
current output source.
|
|
<DT id="13">--setprovideroffloadsink <I>provider</I> <I>sink</I><DD>
|
|
Set <I>provider</I> as a render offload device for <I>sink</I>.
|
|
This is only possible if <I>provider</I> and <I>sink</I> have the <B>Source
|
|
Offload</B> and <B>Sink Offload</B> capabilities, respectively.
|
|
If <I>sink</I> is <B>0x0</B>, then <I>provider</I> is disconnected from its current
|
|
render offload sink.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>RandR version 1.3 options</H2>
|
|
|
|
<P>
|
|
|
|
Options for RandR 1.3 are used as a superset of the options for RandR 1.2.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="14">--current<DD>
|
|
Return the current screen configuration, without polling for hardware changes.
|
|
<DT id="15">--noprimary<DD>
|
|
Don't define a primary output.
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Per-output options</B>
|
|
|
|
<DL COMPACT>
|
|
<DT id="16">--panning <I>width</I>x<I>height</I>[+<I>x</I>+<I>y</I>[/<I>track_width</I>x<I>track_height</I>+<I>track_x</I>+<I>track_y</I>[/<I>border_left</I>/<I>border_top</I>/<I>border_right</I>/<I>border_bottom</I>]]]<DD>
|
|
This option sets the panning parameters. As soon as panning is
|
|
enabled, the CRTC position can change with every pointer move.
|
|
The first four parameters specify the total panning area, the next four the
|
|
pointer tracking area (which defaults to the same area). The last four
|
|
parameters specify the border and default to 0. A width or height set to zero
|
|
disables panning on the according axis. You typically have to set the screen
|
|
size with <I>--fb</I> simultaneously.
|
|
<DT id="17">--transform <I>a</I>,<I>b</I>,<I>c</I>,<I>d</I>,<I>e</I>,<I>f</I>,<I>g</I>,<I>h</I>,<I>i</I><DD>
|
|
Specifies a transformation matrix to apply on the output. Automatically a bilinear filter is selected.
|
|
The mathematical form corresponds to:
|
|
<DL COMPACT><DT id="18"><DD>
|
|
<DL COMPACT><DT id="19"><DD>
|
|
a b c
|
|
<BR>
|
|
|
|
d e f
|
|
<BR>
|
|
|
|
g h i
|
|
</DL>
|
|
|
|
The transformation is based on homogeneous coordinates. The matrix multiplied
|
|
by the coordinate vector of a pixel of the output gives the transformed
|
|
coordinate vector of a pixel in the graphic buffer. More precisely, the vector
|
|
(x y)
|
|
|
|
of the output pixel is extended to 3 values
|
|
(x y w),
|
|
|
|
with 1 as the w coordinate and multiplied against the matrix. The final device
|
|
coordinates of the pixel are then calculated with the so-called homogenic
|
|
division by the transformed w coordinate. In other words, the device
|
|
coordinates
|
|
(x' y')
|
|
|
|
of the transformed pixel are:
|
|
<DL COMPACT><DT id="20"><DD>
|
|
x' = (ax + by + c) / w' and
|
|
<BR>
|
|
|
|
y' = (dx + ey + f) / w' ,
|
|
<BR>
|
|
|
|
with w' = (gx + hy + i) .
|
|
</DL>
|
|
|
|
Typically, <I>a</I> and
|
|
<I>e</I> corresponds to the scaling on the X and Y axes, <I>c</I> and <I>f</I>
|
|
corresponds to the translation on those axes, and <I>g</I>, <I>h</I>, and <I>i</I>
|
|
are respectively 0, 0 and 1. The matrix can also be used to express more
|
|
complex transformations such as keystone correction, or rotation. For a
|
|
rotation of an angle T, this formula can be used:
|
|
<DL COMPACT><DT id="21"><DD>
|
|
cos T -sin T 0
|
|
<BR>
|
|
|
|
sin T cos T 0
|
|
<BR>
|
|
|
|
<BR> 0 0 1
|
|
</DL>
|
|
|
|
As a special argument, instead of
|
|
passing a matrix, one can pass the string <I>none</I>, in which case the default
|
|
values are used (a unit matrix without filter).
|
|
</DL>
|
|
|
|
<DT id="22">--scale <I>x</I>x<I>y</I><DD>
|
|
Changes the dimensions of the output picture. Values superior to 1 will lead to
|
|
a compressed screen (screen dimension bigger than the dimension of the output
|
|
mode), and values below 1 leads to a zoom in on the output. This option is
|
|
actually a shortcut version of the <I>--transform</I> option.
|
|
<DT id="23">--scale-from <I>w</I>x<I>h</I><DD>
|
|
Specifies the size in pixels of the area of the framebuffer to be displayed on
|
|
this output.
|
|
This option is actually a shortcut version of the <I>--transform</I> option.
|
|
<DT id="24">--primary<DD>
|
|
Set the output as primary.
|
|
It will be sorted first in Xinerama and RANDR geometry requests.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>RandR version 1.2 options</H2>
|
|
|
|
These options are only available for X server supporting RandR version 1.2
|
|
or newer.
|
|
<DL COMPACT>
|
|
<DT id="25">--prop, --properties<DD>
|
|
This option causes xrandr to display the contents of properties for each
|
|
output. --verbose also enables --prop.
|
|
<DT id="26">--fb <I>width</I>x<I>height</I><DD>
|
|
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 configured outputs; this
|
|
option provides a way to override that behaviour.
|
|
<DT id="27">--fbmm <I>width</I>x<I>height</I><DD>
|
|
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.
|
|
<DT id="28">--dpi <I>dpi</I><DD>
|
|
This also sets the reported physical size values of the screen, it uses the
|
|
specified DPI value to compute an appropriate physical size using whatever
|
|
pixel size will be set.
|
|
<DT id="29">--newmode <I>name</I> <I>mode</I><DD>
|
|
New modelines can be added to the server and then associated with outputs.
|
|
This option does the former. The <I>mode</I> is specified using the ModeLine
|
|
syntax for xorg.conf: clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart
|
|
vsyncend vtotal <I>flags</I>. <I>flags</I> can be zero or more of +HSync,
|
|
-HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Several
|
|
tools permit to compute the usual modeline from a height, width, and refresh
|
|
rate, for instance you can use <B>cvt</B>.
|
|
<DT id="30">--rmmode <I>name</I><DD>
|
|
This removes a mode from the server if it is otherwise unused.
|
|
<DT id="31">--addmode <I>output</I> <I>name</I><DD>
|
|
Add a mode to the set of valid modes for an output.
|
|
<DT id="32">--delmode <I>output</I> <I>name</I><DD>
|
|
Remove a mode from the set of valid modes for an output.
|
|
</DL>
|
|
<P>
|
|
|
|
<B>Per-output options</B>
|
|
|
|
<DL COMPACT>
|
|
<DT id="33">--output <I>output</I><DD>
|
|
Selects an output to reconfigure. Use either the name of the output or the
|
|
XID.
|
|
<DT id="34">--auto<DD>
|
|
For connected but disabled outputs, this will enable them using their
|
|
first preferred mode (or, something close to 96dpi if they have no preferred
|
|
mode). For disconnected but enabled outputs, this will disable them.
|
|
<DT id="35">--mode <I>mode</I><DD>
|
|
This selects a mode. Use either the name or the XID for <I>mode</I>
|
|
<DT id="36">--preferred<DD>
|
|
This selects the same mode as --auto, but it doesn't automatically enable or
|
|
disable the output.
|
|
<DT id="37">--pos <I>x</I>x<I>y</I><DD>
|
|
Position the output within the screen using pixel coordinates. In case reflection
|
|
or rotation is applied, the translation is applied after the effects.
|
|
<DT id="38">--rate <I>rate</I><DD>
|
|
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 nearest
|
|
refresh rate.
|
|
<DT id="39">--reflect <I>reflection</I><DD>
|
|
Reflection can be one of 'normal' 'x', 'y' or 'xy'. This causes the output
|
|
contents to be reflected across the specified axes.
|
|
<DT id="40">--rotate <I>rotation</I><DD>
|
|
Rotation can be one of 'normal', 'left', 'right' or 'inverted'. This causes
|
|
the output contents to be rotated in the specified direction. 'right' specifies
|
|
a clockwise rotation of the picture and 'left' specifies a counter-clockwise
|
|
rotation.
|
|
<DT id="41">--left-of, --right-of, --above, --below, --same-as <I>another-output</I><DD>
|
|
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.
|
|
<DT id="42">--set <I>property</I> <I>value</I><DD>
|
|
Sets an output property. Integer properties may be specified as a valid
|
|
(see --prop) comma-separated list of decimal or hexadecimal (with a leading 0x) values.
|
|
Atom properties may be set to any of the valid atoms (see --prop).
|
|
String properties may be set to any value.
|
|
<DT id="43">--off<DD>
|
|
Disables the output.
|
|
<DT id="44">--crtc <I>crtc</I><DD>
|
|
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
|
|
sensible choices about which crtc to use with each output. When that fails
|
|
for some reason, this option can override the normal selection.
|
|
<DT id="45">--gamma <I>red</I>:<I>green</I>:<I>blue</I><DD>
|
|
Set the specified floating point values as gamma correction on the crtc
|
|
currently attached to this output. Note that you cannot get two different values
|
|
for cloned outputs (i.e.: which share the same crtc) and that switching an output to another crtc doesn't change
|
|
the crtc gamma corrections at all.
|
|
<DT id="46">--brightness <I>brightness</I><DD>
|
|
Multiply the gamma values on the crtc currently attached to the output to
|
|
specified floating value. Useful for overly bright or overly dim outputs.
|
|
However, this is a software only modification, if your hardware has support to
|
|
actually change the brightness, you will probably prefer to use <B>xbacklight</B>.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<H2>RandR version 1.1 options</H2>
|
|
|
|
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.
|
|
<DL COMPACT>
|
|
<DT id="47">-s, --size <I>size-index</I> or --size <I>width</I>x<I>height</I><DD>
|
|
This sets the screen size, either matching by size or using the index into
|
|
the list of available sizes.
|
|
<DT id="48">-r, --rate, --refresh <I>rate</I><DD>
|
|
This sets the refresh rate closest to the specified value.
|
|
<DT id="49">-o, --orientation <I>rotation</I><DD>
|
|
This specifies the orientation of the screen,
|
|
and can be one of normal, inverted, left or right.
|
|
<DT id="50">-x<DD>
|
|
Reflect across the X axis.
|
|
<DT id="51">-y<DD>
|
|
Reflect across the Y axis.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
Sets an output called LVDS to its preferred mode, and on its right put an
|
|
output called VGA to preferred mode of a screen which has been physically rotated clockwise:
|
|
<DL COMPACT><DT id="52"><DD>
|
|
xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Forces to use a 1024x768 mode on an output called VGA:
|
|
<DL COMPACT><DT id="53"><DD>
|
|
xrandr --newmode "1024x768" 63.50 1024 1072 1176 1328 768 771 775 798 -hsync +vsync
|
|
<BR>
|
|
|
|
xrandr --addmode VGA 1024x768
|
|
<BR>
|
|
|
|
xrandr --output VGA --mode 1024x768
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Enables panning on a 1600x768 desktop while displaying 1024x768 mode on an output called VGA:
|
|
<DL COMPACT><DT id="54"><DD>
|
|
xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Have one small 1280x800 LVDS screen showing a small version of a huge 3200x2000 desktop, and have a
|
|
big VGA screen display the surrounding of the mouse at normal size.
|
|
<DL COMPACT><DT id="55"><DD>
|
|
xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA --pos 0x0 --panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Displays the VGA output in trapezoid shape so that it is keystone corrected
|
|
when the projector is slightly above the screen:
|
|
<DL COMPACT><DT id="56"><DD>
|
|
xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
|
|
</DL>
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?3+Xrandr">Xrandr</A>(3), <A HREF="/cgi-bin/man/man2html?1+cvt">cvt</A>(1), <A HREF="/cgi-bin/man/man2html?1+xkeystone">xkeystone</A>(1), <A HREF="/cgi-bin/man/man2html?1+xbacklight">xbacklight</A>(1)
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Keith Packard,
|
|
Open Source Technology Center, Intel Corporation.
|
|
and
|
|
Jim Gettys,
|
|
Cambridge Research Laboratory, HP Labs, HP.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="57"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="58"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="59"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="60"><A HREF="#lbAE">RandR version 1.4 options</A><DD>
|
|
<DT id="61"><A HREF="#lbAF">RandR version 1.3 options</A><DD>
|
|
<DT id="62"><A HREF="#lbAG">RandR version 1.2 options</A><DD>
|
|
<DT id="63"><A HREF="#lbAH">RandR version 1.1 options</A><DD>
|
|
<DT id="64"><A HREF="#lbAI">EXAMPLES</A><DD>
|
|
<DT id="65"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="66"><A HREF="#lbAK">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:31 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|