xrandr - interface en ligne de commande rudimentaire pour l'extension RandR
SYNTAXE
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 est utilisé pour définir la taille, l'orientation et/ou la réflexion des sorties d'un écran. Il peut également définir la taille de l'écran.
Si invoqué sans aucune option, il affichera l'état des sorties, en montrant les modes existants pour chacune d'entre elles, avec un '+' après les modes préférés et un '*' après le mode actuel.
Il existe quelques options globales. Les autres options modifient la dernière sortie qui est spécifiée dans les paramètres précédents de la ligne de commande. Plusieurs sorties peuvent être modifiées en même temps en passant plusieurs options --output suivies immédiatement de leurs options de modification correspondantes.
--help Affiche un résumé de l'utilisation et quitte.
-v, --version
Affiche la version RandR signalée par le serveur X et quitte.
--verbose
Force xrandr à être plus verbeux. Lorsqu'il est utilisé avec -q (ou sans autres options), xrandr affichera davantage d'informations sur l'état du serveur. Veuillez noter que les informations sur le gamma et la luminosité ne sont que des approximations du profil de couleur complet stocké dans le serveur. Lorsqu'il est utilisé avec des options qui reconfigurent le système, la progression sera signalée pendant l'exécution des modifications de configuration.
-q, --query
Lorsque cette option est présente, ou lorsqu'aucune modification de configuration n'est demandée, xrandr affichera l'état actuel du système.
--dryrun
Exécute toutes les actions spécifiées, sauf qu'aucune modification n'est apportée.
--nograb
Applique les modifications sans capturer l'écran. Cela évite de bloquer d'autres applications pendant la mise à jour, mais peut également entraîner le fait que certaines applications qui détectent le redimensionnement de l'écran reçoivent d'anciennes valeurs.
-d, --display nom
Cette option sélectionne l'écran X à utiliser. Notez que cela fait référence à l'abstraction d'écran X, et non au moniteur (ou à la sortie).
--screen snum
Cette option sélectionne l'écran à manipuler. Notez que cela fait référence à l'abstraction d'écran X, et non au moniteur (ou à la sortie).
--q1
Force l'utilisation du protocole RandR version 1.1, même si une version plus récente est disponible.
--q12
Force l'utilisation du protocole RandR version 1.2, même si l'écran ne le signale pas comme étant pris en charge ou si une version plus récente est disponible.
Options RandR version 1.5
Les options pour RandR 1.5 sont utilisées comme un sur-ensemble des options pour RandR 1.4.
--listmonitors
Affiche des informations sur tous les moniteurs définis.
--listactivemonitors
Affiche des informations sur les moniteurs actifs.
--setmonitor nom géométrie sorties
Définit un nouveau moniteur avec la géométrie donnée et l'associe aux sorties données. La liste des sorties est soit le mot-clé none, soit une liste séparée par des virgules de sorties. La géométrie est soit le mot-clé auto, auquel cas le moniteur suivra automatiquement la géométrie des sorties associées, soit une spécification manuelle sous la forme w/mmwxh/mmh+x+y où w, h, x, y sont en pixels et mmw, mmh sont les dimensions physiques du moniteur.
--delmonitor nom
Supprime le moniteur défini par l'utilisateur donné.
Options RandR version 1.4
Les options pour RandR 1.4 sont utilisées comme un sur-ensemble des options pour RandR 1.3.
--listproviders
Affiche des informations sur les fournisseurs disponibles.
--setprovideroutputsource fournisseur source
Définit source comme la source d'images de sortie d'affichage pour le fournisseur. Ceci n'est possible que si source et fournisseur ont les capacités Source Output et Sink Output, respectivement. Si source est 0x0, alors le fournisseur est déconnecté de sa source de sortie actuelle.
--setprovideroffloadsink fournisseur puits
Définit le fournisseur comme un périphérique de déchargement de rendu pour le puits. Ceci n'est possible que si le fournisseur et le puits ont les capacités Source Offload et Sink Offload, respectivement. Si le puits est 0x0, alors le fournisseur est déconnecté de son puits de déchargement de rendu actuel.
Options RandR version 1.3
Les options pour RandR 1.3 sont utilisées comme un sur-ensemble des options pour RandR 1.2.
--current
Retourne la configuration d'écran actuelle, sans interroger le matériel pour détecter les modifications.
--noprimary
Ne définit pas de sortie principale.
Options par sortie
--panning largeurxhauteur[+x+y[/suivi_largeurxtraque_hauteur+traque_x+traque_y[/bord_gauche/bord_haut/bord_droit/bord_bas]]]
Cette option définit les paramètres de panoramique. Dès que le panoramique est activé, la position du CRTC peut changer à chaque mouvement de la souris. Les quatre premiers paramètres spécifient la zone de panoramique totale, les quatre suivants la zone de suivi du pointeur (qui par défaut est la même zone). Les quatre derniers paramètres spécifient la bordure et ont une valeur par défaut de 0. Une largeur ou une hauteur définie sur zéro désactive le panoramique sur l'axe correspondant. Vous devez généralement définir la taille de l'écran avec --fb simultanément.
--transform a,b,c,d,e,f,g,h,i
Spécifie une matrice de transformation à appliquer sur la sortie. Un filtre bilinéaire est sélectionné automatiquement, à moins que le paramètre --filter ne soit également spécifié. La forme mathématique correspond à :
a b c
d e f
g h i
La transformation est basée sur les coordonnées homogènes. La matrice multipliée par le vecteur de coordonnées d’un pixel de la sortie donne le vecteur de coordonnées transformé d’un pixel dans le tampon graphique. Plus précisément, le vecteur (x y) du pixel de sortie est étendu à 3 valeurs (x y w), avec 1 comme coordonnée w, et multiplié par la matrice. Les coordonnées d’appareil finales du pixel sont ensuite calculées à l’aide de la division homogène par la coordonnée w transformée. En d’autres termes, les coordonnées d’appareil (x’ y’) du pixel transformé sont :
x’ = (ax + by + c) / w’ et
y’ = (dx + ey + f) / w’ ,
avec w’ = (gx + hy + i).
En général, a et e correspondent à la mise à l’échelle sur les axes X et Y, c et f correspondent à la translation sur ces axes, et g, h et i sont respectivement 0, 0 et 1. La matrice peut également être utilisée pour exprimer des transformations plus complexes, telles que la correction de distorsion trapézoïdale ou la rotation. Pour une rotation d’un angle T, cette formule peut être utilisée :
cos T -sin T 0
sin T cos T 0
0 0 1
En tant qu’argument spécial, au lieu de passer une matrice, on peut passer la chaîne « none », auquel cas les valeurs par défaut sont utilisées (une matrice unité sans filtre).
--filter filtermode
Choisit la méthode de filtrage de mise à l’échelle à appliquer lorsque l’écran est mis à l’échelle ou transformé. Peut être « bilinear » ou « nearest ».
--scale x[xy]
Modifie les dimensions de l’image de sortie. Si la valeur y est omise, la valeur x sera utilisée pour les deux dimensions. Les valeurs supérieures à 1 entraînent un écran compressé (la dimension de l’écran est supérieure à la dimension du mode de sortie), et les valeurs inférieures à 1 entraînent un zoom sur la sortie. Cette option est en fait une version raccourcie de l’option --transform.
--scale-from wxh
Spécifie la taille en pixels de la zone du framebuffer à afficher sur cette sortie. Cette option est en fait une version raccourcie de l’option --transform.
--primary
Définit la sortie comme sortie principale. Elle sera triée en premier dans les requêtes de géométrie Xinerama et RANDR.
Options de la version 1.2 de RandR
Ces options ne sont disponibles que pour les serveurs X prenant en charge RandR version 1.2 ou ultérieure.
--prop, --properties
Cette option amène xrandr à afficher le contenu des propriétés pour chaque sortie. --verbose active également --prop.
--fb widthxheight
Reconfigure l’écran à la taille spécifiée. Tous les moniteurs configurés doivent tenir dans cette taille. Lorsque cette option n’est pas fournie, xrandr calcule la plus petite taille d’écran qui contiendra l’ensemble des sorties configurées ; cette option permet de remplacer ce comportement.
--fbmm largeurxhauteur
Définit la valeur signalée comme taille physique de l’écran X dans son ensemble (union de tous les moniteurs configurés). Dans les configurations avec plusieurs moniteurs ayant des DPI différents, la valeur n’a pas de signification physique, mais elle peut être utilisée par certains clients hérités qui ne prennent pas en charge la version 1.2 de RandR pour calculer une mise à l’échelle de police de référence. Normalement, xrandr réinitialise les valeurs de taille physique signalées pour maintenir le DPI constant. Cette option annule ce calcul.
La valeur DPI par défaut est de 96.
--dpi dpi
--dpi from-output
Cela définit également la valeur signalée comme taille physique de l’écran X dans son ensemble (union de tous les moniteurs configurés). Dans les configurations avec plusieurs moniteurs ayant des DPI différents, la valeur n’a pas de signification physique, mais elle peut être utilisée par certains clients hérités qui ne prennent pas en charge la version 1.2 de RandR pour calculer une mise à l’échelle de police de référence. Cette option utilise soit la valeur DPI spécifiée, soit le DPI de la sortie donnée, pour calculer une taille physique appropriée en utilisant la taille de pixel qui sera définie. Les valeurs typiques sont la valeur par défaut (96 DPI), le DPI du seul moniteur dans les configurations à moniteur unique, ou le DPI du moniteur principal dans les configurations multi-moniteurs.
--newmode nom mode
De nouveaux modèles peuvent être ajoutés au serveur, puis associés aux sorties. Cette option effectue la première opération. Le mode est spécifié à l’aide de la syntaxe ModeLine pour xorg.conf : clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. flags peut être zéro ou plus parmi +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Plusieurs outils permettent de calculer le modèle habituel à partir d’une hauteur, d’une largeur et d’un taux de rafraîchissement. Vous pouvez, par exemple, utiliser cvt.
--rmmode nom
Cela supprime un mode du serveur s’il n’est pas utilisé par ailleurs.
--addmode sortie nom
Ajoute un mode à l’ensemble des modes valides pour une sortie.
--delmode sortie nom
Supprime un mode de l’ensemble des modes valides pour une sortie.
Options par sortie
--output sortie
Sélectionne une sortie à reconfigurer. Utilisez soit le nom de la sortie, soit l’ID X.
--auto Pour les sorties connectées mais désactivées, cela les activera en utilisant leur premier mode préféré (ou quelque chose de proche de 96 dpi s’elles n’ont pas de mode préféré). Pour les sorties déconnectées mais activées, cela les désactivera.
--mode mode
Cela sélectionne un mode. Utilisez soit le nom, soit l’ID X pour le mode.
--preferred
Cela sélectionne le même mode que --auto, mais cela n’active ou ne désactive pas automatiquement la sortie.
--pos xxy
Positionne la sortie dans l’écran en utilisant des coordonnées en pixels. Dans le cas où une réflexion ou une rotation est appliquée, la translation est appliquée après les effets.
--rate taux
Cela indique une préférence pour les taux de rafraîchissement proches de la valeur spécifiée. Lorsque plusieurs modes ont le même nom, cela sélectionnera celui dont le taux de rafraîchissement est le plus proche.
--reflect reflection
La réflexion peut être l’une des valeurs suivantes : « normal », « x », « y » ou « xy ». Cela permet de refléter le contenu de la sortie le long des axes spécifiés.
--rotate rotation
La rotation peut être l’une des valeurs suivantes : « normal », « gauche », « droite » ou « inversé ». Cela permet de faire pivoter le contenu de la sortie dans la direction spécifiée. « droite » spécifie une rotation dans le sens des aiguilles d’une montre, et « gauche » spécifie une rotation dans le sens inverse des aiguilles d’une montre.
--left-of, --right-of, --above, --below, --same-as autre-sortie
Utilisez l’une de ces options pour positionner la sortie par rapport à la position d’une autre sortie. Cela permet de disposer facilement les sorties à l’écran. La position est toujours calculée par rapport à la nouvelle position de l’autre sortie. Il n’est donc pas valide de dire : « --output a --left-of b --output b --left-of a ».
--set propriété valeur
Définit une propriété de sortie. Les propriétés entières peuvent être spécifiées sous la forme d’une liste valide (voir --prop) de valeurs décimales ou hexadécimales (précédées de 0x) séparées par des virgules. Les propriétés atomiques peuvent être définies sur n’importe laquelle des valeurs atomiques valides (voir --prop). Les propriétés de chaîne peuvent être définies sur n’importe quelle valeur.
--off Désactive la sortie.
--crtc crtc
Utilise le crtc spécifié (soit sous la forme d’un index dans la liste des CRTC, soit sous la forme d’un XID). Dans une utilisation normale, cette option n’est pas nécessaire, car xrandr tente de faire des choix raisonnables sur le crtc à utiliser pour chaque sortie. Lorsque cela échoue pour une raison quelconque, cette option peut remplacer la sélection normale.
--gamma rouge[:vert:bleu]
Définit les valeurs à virgule flottante spécifiées comme correction gamma sur le crtc actuellement attaché à cette sortie. Si les valeurs vert et bleu ne sont pas spécifiées, la valeur rouge sera utilisée pour les trois composants. Notez que vous ne pouvez pas obtenir deux valeurs différentes pour les sorties clonées (c’est-à-dire celles qui partagent le même crtc) et que la modification d’une sortie pour qu’elle utilise un autre crtc ne modifie pas les corrections gamma du crtc.
--brightness luminosité
Multiplie les valeurs gamma du crtc actuellement attaché à la sortie par la valeur à virgule flottante spécifiée. Utile pour les sorties trop lumineuses ou trop sombres. Cependant, il s’agit d’une modification logicielle uniquement. Si votre matériel prend en charge la modification réelle de la luminosité, vous préférerez probablement utiliser xbacklight.
Options de la version 1.1 de RandR
Ces options sont disponibles pour les serveurs X qui prennent en charge la version 1.1 de RandR ou une version antérieure. Elles sont toujours valides pour les serveurs X plus récents, mais elles n’interagissent pas de manière cohérente avec les options de la version 1.2 sur la même ligne de commande.
-s, --size index-taille ou --size largeurxhauteur
Cela définit la taille de l’écran, soit en la faisant correspondre à une taille existante, soit en utilisant l’index dans la liste des tailles disponibles.
-r, --rate, --refresh taux
Cela définit le taux de rafraîchissement le plus proche de la valeur spécifiée.
-o, --orientation rotation
Cela spécifie l’orientation de l’écran, et peut être l’une des valeurs suivantes : normal, inversé, gauche ou droite.
-x Reflète le long de l’axe X.
-y Reflète le long de l’axe Y.
EXEMPLES
Définit une sortie appelée LVDS sur son mode préféré, et place une sortie appelée VGA sur le côté droit, en mode préféré, sur un écran qui a été physiquement pivoté dans le sens des aiguilles d’une montre : xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
Force l’utilisation d’un mode 1024x768 sur une sortie appelée 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
Active le panoramique sur un bureau 1600x768 tout en affichant un mode 1024x768 sur une sortie appelée VGA : xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
Avoir un petit écran LVDS 1280x800 affichant une petite version d’un bureau 3200x2000, et avoir un grand écran VGA affichant la zone autour de la souris en taille normale. xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA --pos 0x0 --panning 32002000+0+0/3200x2000+0+0/64/64/64/64
Affiche la sortie VGA sous forme de trapèze afin qu’elle soit corrigée en forme de trapèze lorsque le projecteur est légèrement au-dessus de l’écran : xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
VOIR AUSSI
Xrandr(3), cvt(1), xkeystone(1), xbacklight(1)
AUTEURS
Keith Packard, Open Source Technology Center, Intel Corporation et Jim Gettys, Cambridge Research Laboratory, HP Labs, HP.