Table of Contents
This NVIDIA driver release contains support for the X Resize and
Rotate (RandR) Extension versions 1.1, 1.2, and 1.3. The version of
the RandR extension advertised to X clients is controlled by the X
server: the RandR extension and protocol are provided by the X
server, which routes protocol requests to the NVIDIA X driver. Run
xrandr --version to
check the version of RandR provided by the X server.
Specific supported features include:
Modes can be set per-screen, and the X screen can be resized through the RRSetScreenConfig request (e.g., with xrandr(1)'s '--size' and '--rate' command line options).
The X screen can be resized with the RandR 1.2 RRSetScreenSize request (e.g., with xrandr(1)'s '--fb' command line option).
The state of the display hardware can be queried with the RandR 1.2 and 1.3 RRGetScreenResources, RRGetScreenResourcesCurrent, RRGetOutputInfo, and RRGetCrtcInfo requests (e.g., with xrandr(1)'s '--query' command line option).
Modes can be set with RandR CRTC granularity with the RandR 1.2
RRSetCrtcConfig request. E.g., xrandr --output DVI-I-2 --mode
1920x1200.
Rotation can be set with RandR CRTC granularity with the RandR
1.2 RRSetCrtcConfig request. E.g., xrandr --output DVI-I-2 --mode 1920x1200
--rotation left.
Per-CRTC transformations can be manipulated with the RandR 1.3
RRSetCrtcTransform and RRGetCrtcTransform requests. E.g.,
xrandr --output DVI-I-3 --mode
1920x1200 --transform
43.864288330078125,21.333328247070312,-16384,0,43.864288330078125,0,0,0.0321197509765625,19.190628051757812.
The configurability exposed through RandR is also available through the MetaMode syntax, independent of X server version. See MetaModes for more details. As an example, these two commands are equivalent:
xrandr --output DVI-I-2 --mode 1280x1024 --pos 0x0 --rotate left \
--output DVI-I-3 --mode 1920x1200 --pos 0x0
nvidia-settings --assign CurrentMetaMode="DVI-I-2: 1280x1024 +0+0 \
{ Rotation=left }, DVI-I-3: 1920x1200 +0+0"
On X servers that support RandR 1.2 or later, when an RandR 1.1
rotation request is received (e.g., xrandr --orientation left), the X
server translates the RandR 1.1 screen rotation request into an
RandR 1.2 CRTC rotation request by picking one RandR CRTC to
rotate, and turning all other RandR CRTCs off.
On X servers that do not support RandR 1.2 or later, the NVIDIA X driver does not advertise RandR rotation support. On such X servers, it is recommended to configure rotation through MetaModes, instead.
RandR per-CRTC gamma manipulation through the RandR 1.2 RRGetCrtcGammaSize, RRGetCrtcGamma, and RRSetCrtcGamma requests is not yet implemented.
RandR per-CRTC panning configuration through the RandR 1.3 RRGetPanning and RRSetPanning requests is not yet implemented.
RandR 1.3 per-Output properties are not yet implemented. The
RandR 1.2 EDID property is
available.
Rotation and Transformations (configured either through RandR or MetaModes) are not yet supported with SLI, Workstation overlays, or stereo.
The RandR 1.2 X configuration options provided by the XFree86 DDX implementation and documented in xorg.conf(5) are not yet supported.
Transformations (configured either through RandR or MetaModes) are not yet correctly clipped.