xrandr - primitive command line interface to RandR extension
SYNOPSIS
xrandr [--help] [--display display] [-q] [-v] [--verbose] [--dryrun] [--screen snum] [--q1]
[--q12] [--current] [--noprimary] [--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]] [--scale
x[xy]] [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb widthxheight] [--fbmm widthxheight] [--dpi dpi] [--dpi from-output] [--newmode name mode] [--rmmode
name] [--addmode output name] [--delmode output name] [--output output] [--auto] [--mode mode]
[--preferred] [--pos xxy] [--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] [--gamma red[:green:blue]] [--brightness brightness] [-o orientation] [-s size] [-r rate] [-x] [-y] [--listproviders] [--setprovideroutputsource provider source]
[--setprovideroffloadsink provider sink] [--listmonitors] [--listactivemonitors] [--setmonitor
name geometry outputs] [--delmonitor name]
DESCRIPTION
Xrandr wird verwendet, um die Größe, Ausrichtung und/oder Spiegelung der Ausgaben für einen Bildschirm festzulegen. Es kann auch die Bildschirmgröße festlegen.
Wenn es ohne Optionen aufgerufen wird, gibt es den Status der Ausgaben aus und zeigt die vorhandenen Modi für jede von ihnen an, wobei ein '+' nach den bevorzugten Modi und ein '*' nach dem aktuellen Modus steht.
Es gibt ein paar globale Optionen. Andere Optionen ändern die zuletzt in den vorherigen Parametern der Befehlszeile angegebene Ausgabe. Mehrere Ausgaben können gleichzeitig geändert werden, indem mehrere --output-Optionen, gefolgt von ihren entsprechenden Modifikationsoptionen, übergeben werden.
--help Gibt eine Zusammenfassung der Verwendung aus und beendet das Programm.
-v, --version
Gibt die vom X-Server gemeldete RandR-Version aus und beendet das Programm.
--verbose
Verursacht, dass xrandr ausführlicher ist. Wenn es zusammen mit -q (oder ohne andere Optionen) verwendet wird, zeigt xrandr mehr Informationen über den Serverstatus an. Bitte beachten Sie, dass die Gamma- und Helligkeitsinformationen nur Annäherungen des vollständigen Farbprofils sind, das im Server gespeichert ist. Wenn es zusammen mit Optionen verwendet wird, die das System neu konfigurieren, werden Fortschrittsmeldungen angezeigt, während die Konfigurationsänderungen ausgeführt werden.
-q, --query
Wenn diese Option vorhanden ist oder wenn keine Konfigurationsänderungen angefordert werden, zeigt xrandr den aktuellen Zustand des Systems an.
--dryrun
Führt alle angegebenen Aktionen aus, außer dass keine Änderungen vorgenommen werden.
--nograb
Wendet die Änderungen an, ohne den Bildschirm abzufassen. Dadurch wird vermieden, dass andere Anwendungen während des Updates blockiert werden, kann aber auch dazu führen, dass einige Anwendungen, die Bildschirmänderungen erkennen, alte Werte erhalten.
-d, --display name
Diese Option wählt die zu verwendende X-Anzeige aus. Beachten Sie, dass sich dies auf die X-Bildschirmabstraktion und nicht auf den Monitor (oder die Ausgabe) bezieht.
--screen snum
Diese Option wählt den zu bearbeitenden Bildschirm aus. Beachten Sie, dass sich dies auf die X-Bildschirmabstraktion und nicht auf den Monitor (oder die Ausgabe) bezieht.
--q1
Erzwingt die Verwendung des RandR-Protokolls der Version 1.1, auch wenn eine höhere Version verfügbar ist.
--q12
Erzwingt die Verwendung des RandR-Protokolls der Version 1.2, auch wenn das Display dies nicht als unterstützt meldet oder eine höhere Version verfügbar ist.
RandR-Version 1.5-Optionen
Optionen für RandR 1.5 werden als Obermenge der Optionen für RandR 1.4 verwendet.
--listmonitors
Gibt Informationen über alle definierten Monitore aus.
--listactivemonitors
Gibt Informationen über die derzeit aktiven Monitore aus.
--setmonitor name geometry outputs
Definiert einen neuen Monitor mit der angegebenen Geometrie und ordnet ihn den angegebenen Ausgaben zu. Die Ausgabeliste ist entweder das Schlüsselwort „none“ oder eine durch Kommas getrennte Liste von Ausgaben. Die Geometrie ist entweder das Schlüsselwort „auto“, in diesem Fall verfolgt der Monitor automatisch die Geometrie der zugehörigen Ausgaben, oder eine manuelle Angabe in der Form w/mmwxh/mmh+x+y, wobei w, h, x, y in Pixeln und mmw, mmh die physischen Abmessungen des Monitors sind.
--delmonitor name
Löscht den angegebenen benutzerdefinierten Monitor.
RandR-Version 1.4-Optionen
Optionen für RandR 1.4 werden als Obermenge der Optionen für RandR 1.3 verwendet.
--listproviders
Gibt Informationen über die verfügbaren Anbieter aus.
--setprovideroutputsource provider source
Setzt source als Quelle für die Anzeigebilder für provider. Dies ist nur möglich, wenn source und provider über die Funktionen Source Output bzw. Sink Output verfügen. Wenn source 0x0 ist, wird provider von seiner aktuellen Ausgabequelle getrennt.
--setprovideroffloadsink provider sink
Setzt provider als Rendering-Offload-Gerät für sink. Dies ist nur möglich, wenn provider und sink über die Funktionen Source Offload bzw. Sink Offload verfügen. Wenn sink 0x0 ist, wird provider von seinem aktuellen Rendering-Offload-Sink getrennt.
RandR-Version 1.3-Optionen
Optionen für RandR 1.3 werden als Obermenge der Optionen für RandR 1.2 verwendet.
--current
Gibt die aktuelle Bildschirmanordnung zurück, ohne Hardwareänderungen abzufragen.
--noprimary
Definiert keine primäre Ausgabe.
Pro-Ausgabe-Optionen
--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]
Diese Option setzt die Panning-Parameter. Sobald das Panning aktiviert ist, kann sich die CRTC-Position mit jeder Zeigerbewegung ändern. Die ersten vier Parameter geben die gesamte Panning-Fläche an, die nächsten vier die Zeigerverfolgungsfläche (die standardmäßig mit der gleichen Fläche übereinstimmt). Die letzten vier Parameter geben den Rand an und sind standardmäßig 0. Eine auf Null gesetzte Breite oder Höhe deaktiviert das Panning auf der entsprechenden Achse. In der Regel müssen Sie die Bildschirmgröße gleichzeitig mit --fb festlegen.
--transform a,b,c,d,e,f,g,h,i
Gibt eine Transformationsmatrix an, die auf die Ausgabe angewendet werden soll. Ein bilineares Filter wird automatisch ausgewählt, es sei denn, der Parameter --filter wird ebenfalls angegeben. Die mathematische Form entspricht:
a b c
d e f
g h i
Die Transformation basiert auf homogenen Koordinaten. Die Matrix multipliziert mit dem Koordinatenvektor eines Pixels der Ausgabe ergibt den transformierten Koordinatenvektor eines Pixels im Grafikpuffer. Genauer gesagt wird der Vektor (x y) des Ausgabepixels zu einem 3-wertigen Vektor (x y w) erweitert, wobei die w-Koordinate 1 ist, und mit der Matrix multipliziert. Die endgültigen Gerätekoordinaten des Pixels werden dann mit der so genannten homogenen Division durch die transformierte w-Koordinate berechnet. Mit anderen Worten, die Gerätekoordinaten (x' y') des transformierten Pixels sind:
x' = (ax + by + c) / w' und
y' = (dx + ey + f) / w',
wobei w' = (gx + hy + i).
Typischerweise entsprechen a und e der Skalierung auf der X- und Y-Achse, und c und f entsprechen der Translation auf diesen Achsen, und g, h und i sind jeweils 0, 0 bzw. 1. Die Matrix kann auch verwendet werden, um komplexere Transformationen wie Keystone-Korrektur oder Rotation auszudrücken. Für eine Rotation um einen Winkel T kann diese Formel verwendet werden:
cos T -sin T 0
sin T cos T 0
0 0 1
Als spezielles Argument kann man anstelle einer Matrix die Zeichenkette „none“ übergeben, in diesem Fall werden die Standardwerte verwendet (eine Einheitsmatrix ohne Filter).
--filter filtermode
Wählt die Skalierungsmethode, die angewendet werden soll, wenn der Bildschirm skaliert oder transformiert wird. Kann entweder „bilinear“ oder „nearest“ sein.
--scale x[xy]
Ändert die Abmessungen des Ausgabebildes. Wenn der y-Wert weggelassen wird, wird der x-Wert für beide Dimensionen verwendet. Werte größer als 1 führen zu einem komprimierten Bildschirm (Bildschirmabmessung größer als die Abmessung des Ausgabemodus), und Werte kleiner als 1 führen zu einem Zoom auf die Ausgabe. Diese Option ist eigentlich eine Kurzform der Option --transform.
--scale-from wxh
Gibt die Größe in Pixeln des Bereichs des Framebuffers an, der auf dieser Ausgabe angezeigt werden soll. Diese Option ist eigentlich eine Kurzform der Option --transform.
--primary
Setzt die Ausgabe als primäre Ausgabe. Sie wird zuerst in den Xinerama- und RANDR-Geometrieanforderungen sortiert.
RandR-Version 1.2-Optionen
Diese Optionen sind nur für X-Server verfügbar, die RandR-Version 1.2 oder höher unterstützen.
--prop, --properties
Diese Option bewirkt, dass xrandr den Inhalt der Eigenschaften für jede Ausgabe anzeigt. --verbose aktiviert ebenfalls --prop.
--fb widthxheight
Konfiguriert den Bildschirm mit der angegebenen Größe neu. Alle konfigurierten Monitore müssen in diese Größe passen. Wenn diese Option nicht angegeben wird, berechnet xrandr die kleinste Bildschirmgröße, die die Menge der konfigurierten Ausgaben aufnehmen kann. Diese Option bietet eine Möglichkeit, dieses Verhalten zu überschreiben.
--fbmm widthxheight
Legt den Wert fest, der als physische Größe des X-Bildschirms als Ganzes (Vereinigung aller konfigurierten Monitore) gemeldet wird. In Konfigurationen mit mehreren Monitoren mit unterschiedlichen DPI-Werten hat dieser Wert keine physische Bedeutung, kann aber von einigen älteren Clients verwendet werden, die keine RandR-Version 1.2 unterstützen, um eine Referenz für die Schriftgrößenanpassung zu berechnen. Normalerweise setzt xrandr die gemeldeten Werte für die physische Größe zurück, um die DPI konstant zu halten. Diese Option überschreibt diese Berechnung. Der Standard-DPI-Wert ist 96.
--dpi dpi
--dpi from-output
Dies legt ebenfalls den Wert fest, der als physische Größe des X-Bildschirms als Ganzes (Vereinigung aller konfigurierten Monitore) gemeldet wird. In Konfigurationen mit mehreren Monitoren mit unterschiedlichen DPI-Werten hat der Wert keine physische Bedeutung, kann aber von einigen älteren Clients verwendet werden, die keine RandR-Version 1.2 unterstützen, um eine Referenz für die Schriftgrößenanpassung zu berechnen. Diese Option verwendet entweder den angegebenen DPI-Wert oder den DPI-Wert des angegebenen Ausgabegeräts, um eine geeignete physische Größe unter Verwendung der festgelegten Pixelgröße zu berechnen. Typische Werte sind der Standardwert (96 DPI), der DPI des einzigen Monitors in Einzelmonitor-Konfigurationen oder der DPI des primären Monitors in Mehrfachmonitor-Konfigurationen.
--newmode name mode
Neue Modellinien können dem Server hinzugefügt und dann Ausgabegeräten zugeordnet werden. Diese Option führt das erstere aus. Die Modellinie wird mit der ModeLine-Syntax für xorg.conf angegeben: clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. Flags können null oder mehr der folgenden sein: +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Mehrere Tools ermöglichen es, die übliche Modellinie aus einer Höhe, Breite und Bildwiederholfrequenz zu berechnen. Sie können beispielsweise cvt verwenden.
--rmmode name
Dies entfernt eine Mode aus dem Server, wenn sie anderweitig nicht verwendet wird.
--addmode output name
Fügt eine Mode zur Menge der gültigen Modes für ein Ausgabegerät hinzu.
--delmode output name
Entfernt eine Mode aus der Menge der gültigen Modes für ein Ausgabegerät.
Pro Ausgabegerät Optionen
--output output
Wählt ein Ausgabegerät zur Rekonfiguration aus. Verwenden Sie entweder den Namen des Ausgabegeräts oder die XID.
--auto Für verbundene, aber deaktivierte Ausgabegeräte werden diese mit ihrer ersten bevorzugten Mode aktiviert (oder mit etwas, das 96 DPI nahe kommt, falls sie keine bevorzugte Mode haben). Für getrennte, aber aktivierte Ausgabegeräte werden diese deaktiviert.
--mode mode
Diese Option wählt eine Mode aus. Verwenden Sie entweder den Namen oder die XID für die Mode.
--preferred
Diese Option wählt die gleiche Mode wie --auto aus, aktiviert oder deaktiviert das Ausgabegerät jedoch nicht automatisch.
--pos xxy
Positioniert das Ausgabegerät innerhalb des Bildschirms unter Verwendung von Pixelkoordinaten. Falls eine Spiegelung oder Rotation angewendet wird, wird die Transformation nach den Effekten angewendet.
--rate rate
Dies kennzeichnet eine Präferenz für Bildwiederholfrequenzen, die nahe am angegebenen Wert liegen. Wenn mehrere Modes denselben Namen haben, wird diejenige mit der nächstgelegenen Bildwiederholfrequenz ausgewählt.
--reflect reflection
^ eflection kann einer der folgenden Werte sein: normal, x, y oder xy. Dies führt dazu, dass der Inhalt der Ausgabe entlang der angegebenen Achsen gespiegelt wird.
--rotate rotation
^ otation kann einer der folgenden Werte sein: normal, left, right oder inverted. Dies führt dazu, dass der Inhalt der Ausgabe in die angegebene Richtung gedreht wird. right gibt eine im Uhrzeigersinn erfolgende Drehung des Bildes an und left eine gegen den Uhrzeigersinn erfolgende Drehung.
--left-of, --right-of, --above, --below, --same-as another-output
Verwenden Sie eine dieser Optionen, um die Position der Ausgabe relativ zur Position einer anderen Ausgabe festzulegen. Dies ermöglicht eine praktische Anordnung von Ausgaben innerhalb des Bildschirms. Die Position wird immer relativ zur neuen Position der anderen Ausgabe berechnet, daher ist es nicht zulässig, --output a --left-of b --output b --left-of a anzugeben.
--set property value
Setzt eine Eigenschaft der Ausgabe. Integer-Eigenschaften können als eine gültige (siehe --prop) kommaseparierte Liste aus Dezimal- oder Hexadezimalwerten (mit einem führenden 0x) angegeben werden. Atom-Eigenschaften können auf einen beliebigen gültigen Atomwert (siehe --prop) gesetzt werden. String-Eigenschaften können auf einen beliebigen Wert gesetzt werden.
--off Deaktiviert die Ausgabe.
--crtc crtc
Verwendet das angegebene CRTC (entweder als Index in der Liste der CRTCs oder als XID). In der normalen Verwendung ist diese Option nicht erforderlich, da xrandr versucht, sinnvolle Entscheidungen darüber zu treffen, welches CRTC für jede Ausgabe verwendet werden soll. Wenn dies aus irgendeinem Grund fehlschlägt, kann diese Option die normale Auswahl außer Kraft setzen.
--gamma red[:green:blue]
Setzt die angegebenen Gleitkommawerte als Gammakorrektur für das derzeit an diese Ausgabe angeschlossene CRTC. Wenn Grün und Blau nicht angegeben sind, wird der Rotwert für alle drei Komponenten verwendet. Beachten Sie, dass Sie für geklonte Ausgaben (d. h. die dasselbe CRTC verwenden) keine zwei unterschiedlichen Werte erhalten können und dass das Umschalten einer Ausgabe auf ein anderes CRTC die CRTC-Gammakorrekturen nicht ändert.
--brightness brightness
Multipliziert die Gammawerte auf dem derzeit an die Ausgabe angeschlossenen CRTC mit dem angegebenen Gleitkommawert. Nützlich für Ausgaben, die zu hell oder zu dunkel sind. Dies ist jedoch eine rein softwarebasierte Änderung; wenn Ihre Hardware die Möglichkeit bietet, die Helligkeit tatsächlich zu ändern, sollten Sie wahrscheinlich xbacklight verwenden.
RandR-Version 1.1-Optionen
Diese Optionen sind für X-Server verfügbar, die RandR-Version 1.1 oder älter unterstützen. Sie sind auch für neuere X-Server gültig, interagieren aber nicht sinnvoll mit den Optionen der Version 1.2 in derselben Befehlszeile.
-s, --size size-index oder --size widthxheight
Dies setzt die Bildschirmgröße, entweder durch Übereinstimmung mit der Größe oder durch Verwendung des Indexes in der Liste der verfügbaren Größen.
-r, --rate, --refresh rate
Dies setzt die Bildwiederholfrequenz auf den nächstgelegenen Wert.
-o, --orientation rotation
Dies gibt die Ausrichtung des Bildschirms an und kann einer der folgenden Werte sein: normal, inverted, left oder right.
-x Spiegelt die Ausgabe entlang der X-Achse.
-y Spiegelt die Ausgabe entlang der Y-Achse.
BEISPIELE
Legt eine Ausgabe namens LVDS auf ihren bevorzugten Modus fest und platziert rechts davon eine Ausgabe namens VGA im bevorzugten Modus auf einem Bildschirm, der physisch im Uhrzeigersinn gedreht wurde:
xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
Erzwingt die Verwendung eines 1024x768-Modus auf einem Ausgang namens VGA: xrandr --newmode "1024x768" 63.50 1024 1072 1176 1328 768 771 775 798 -hsync +vsync xrandr --addmode VGA 1024x768 xrandr --output VGA --mode 1024x768
Aktiviert das Panning auf einem 1600x768-Desktop, während der 1024x768-Modus auf einem Ausgang namens VGA angezeigt wird: xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
Ein kleiner 1280x800 LVDS-Bildschirm zeigt eine kleine Version eines riesigen 3200x2000-Desktops an, und ein großer VGA-Bildschirm zeigt den Bereich um die Maus in normaler Größe an: xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA --pos 0x0 --panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64
Zeigt den VGA-Ausgang in Trapezform an, sodass er keystone-korrigiert ist, wenn der Projektor etwas über dem Bildschirm angebracht ist: xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
SIEHE AUCH
Xrandr(3), cvt(1), xkeystone(1), xbacklight(1)
AUTOREN
Keith Packard, Open Source Technology Center, Intel Corporation, und Jim Gettys, Cambridge Research Laboratory, HP Labs, HP.