NOM
xrandr - Interface primitive en ligne de commande pour l’extension
RandR
SYNOPSIS
xrandr [-help] [-display display] [-q] [-v] [--verbose] [--dryrun]
[--screen snum] [--q1] [--q12]
Options de la version 1.3 de RandR
[--current] [--noprimary]
Options par sortie
[--panning
largeurxhauteur[+x+y[/largeur_pistexhauteur_piste+piste_x+piste_y[/bord_gauche/bord_haut/bord_droit/bord_bas]]]]
[--scale xxy] [--transform a,b,c,d,e,f,g,h,i] [--primary]
Options de la version 1.2 de RandR
[--prop] [--fb largeurxhauteur] [--fbmm largeurxhauteur] [--dpi dpi]
[--newmode nom mode] [--rmmode nom] [--addmode sortie nom] [--delmode
sortie nom]
Options par sortie
[--output sortie] [--auto] [--mode mode] [--preferred] [--pos xxy]
[--rate frquence] [--reflect reflection] [--rotate orientation]
[--left-of sortie] [--right-of sortie] [--above sortie] [--below
sortie] [--same-as output] [--set property value] [--off] [--crtc crtc]
[--gamma rouge:vert:bleu]
Options des versions 1.0 et 1.1 de RandR
[-o orientation] [-s taille] [-r frquence] [-x] [-y]
Xrandr sert à déterminer la taille, l’orientation et/ou la réflexion
pour la sortie d’un écran. Il peut aussi définir la taille de l’écran.
L’appel sans option provoque l’affichage de l’état des sorties, la
liste de toutes les modes pour chacune d’elles, avec un ’+’ après le
mode préféré et un ’*’ après le mode actuel.
Il y a quelques options globales. Les autres modifient la dernière
sortie indiquée par les paramètres précédents de la ligne de commande.
Les sorties multiples peuvent être modifiées simultanément en plaçant
plusieurs --output immédiatement suivies des options de la sortie
correspondante
-help Afficher un résumé sur l’utilisation puis quitter.
-v, --version
Afficher la version de RandR supportée par le serveur X puis
quitter.
--verbose
Rend xrandr plus verbeux. En combinaison avec -q (ou sans autres
options), xrandr montrera plus d’informations sur l’état de
serveur. Avec des options qui modifient le système, les
modifications seront affichées lorsque les changements de
configuration sont effectués.
-q, --query
Quand cette option est présente ou quand aucun changement de
configuration n’est demandé, xrandr montrera l’état actuel du
système.
--dryrun
Effectue toutes les actions spécifiées sans qu’aucune
modification ne soit apportée.
--nograb
Applique les modifications sans verrouiller l’accès à l’écran.
Ceci évite de bloquer les autres applications pendant la mise à
jour, mais peut empêcher certaines applications qui détectent
les changements de taille d’écran de recevoir les anciennes
valeurs.
-d, -display nom
Cette option permet de sélectionner l’affichage X à utiliser.
Noter que ceci se rapporte à l’abstraction de l’affichage, mais
pas au comportement du moniteur (la sortie).
--screen num_cran
Cette option choisit quelle configuration d’écran modifier.
Noter que ceci se rapporte à l’abstraction de l’affichage, mais
pas au comportement du moniteur (la sortie).
--q1 Oblige l’utilisation de la version 1.1 du protocole RandR, même
si une version supérieure est disponible.
--q12 Oblige l’utilisation de la version 1.2 du protocole RandR, même
si elle n’est pas indiquée comme étant prise en charge ou si une
version supérieure est disponible.
Options de la version 1.3 de RandR
Les options de RandR 1.3 sont utilisées en plus des options possibles
pour RandR 1.2.
--current
Renvoie la configuration actuelle de l’écran, sans modification
matérielle.
--noprimary
Ne définit pas de sortie principale.
Options par sortie
--panning
largeurxhauteur[+x+y[/largeur_pistexhauteur_piste+piste_x+piste_y[/bord_gauche/bord_haut/bord_droit/bord_bas]]]
Cette option défini les paramètres de panorama. Dès que cette
option est activée, la position CRTC de l’écran bouge avec les
mouvements de la souris. Les quatre premiers paramètres
définissent l’aire de panorama. Les quatre suivants, la zone de
suivi (qui est la même par défaut). Les quatre derniers, les
bords, à 0 par défaut. Une hauteur ou une largeur fixée à 0
désactive le panorama sur l’axe associé. Généralement, vous
devez fixer la taille de l’écran avec --fb en même temps.
--transform a,b,c,d,e,f,g,h,i
Spécifie une matrice de transformation à appliquer à la sortie.
Un filtre bilinéaire est automatiquement sélectionné. La formule
mathématique correspond à :
a b c
d e f
g h i
La matrice de transformation multipliée par un vecteur de
coordonnées d’un pixel de la sortie (étendues à trois valeurs)
fournit le vecteur de coordonnées approprié d’un pixel du buffer
graphique. Typiquement, a et e correspondent à l’échelle selon
les axes X et Y, c et f correspondent à une translation suivant
ces mêmes axes, et g, h et i sont respectivement 0, 0 et 1. Ceci
permet également d’exprimer une rotation d’un angle T de la
façon suivante :
cos T -sin T 0
sin T cos T 0
0 0 1
Comme paramètre spécial, au lieu de passer une matrice, on peut
passer la chaîne none, dans ce cas les valeurs par défaut sont
utilisées (une matrice unitaire sans filtre).
--scale xxy
Modifie les dimensions de l’image de sortie. Les valeurs
supérieures à 1 entraîneront une compression de l’écran
(dimension de l’écran supérieures aux dimensions du mode de
sortie) et les valeurs inférieures à 1 entraîneront un zoom de
la sortie. Cette option est en fait une version raccourci de
l’option --transform.
--primary
Définit la sortie comme primaire. Cette sortie sera classée
première pour les requêtes de géométrie de Xinerama et RandR.
Options de la version 1.2 de RandR
Ces options ne sont disponibles que pour les serveurs X fournis avec
les versions de RandR 1.2 ou plus récentes.
--prop, --properties
Cette option fait afficher par xrandr les propriétés de chaque
sortie. --verbose active également --prop.
--fb largeurxhauteur
Reconfigure l’écran à la taille spécifiée. Tous les moniteurs
configurés doivent loger dans ce rectangle. Quand 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 configurer ce comportement.
--fbmm largeurxhauteur
Configure la taille physique de l’écran. Normalement, xrandr
remet à zéro ces valeurs pour garder la constante de DPI. Ceci
annule ce comportement par défaut.
--dpi dpi
Configure aussi la taille physique de l’écran. Il utilise la
valeur DPI pour calculer la taille physique de l’écran quelle
que soit la taille des pixels configurée.
--newmode nom mode
De nouveaux modelines peuvent être ajoutés au serveur puis
associés avec des sorties. Cette option ajoute un modeline au
serveur. Le mode est défini en utilisant la syntaxe des ModeLine
de xorg.conf : hdisp hsyncstart
hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. On peut
omettre flags ou des paramètres parmi +HSync, -HSync, +VSync,
-VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Plusieurs
outils permettent de calculer les paramètres usuels des
modelines : hauteur, largeur et la fréquence de
rafraîchissement. Par exemple, vous pouvez utiliser cvt.
--rmmode nom
Supprime un mode du serveur s’il n’est pas utilisé.
--addmode sortie nom
Ajoute un mode à l’ensemble des modes valables d’une sortie.
--delmode sortie nom
Enlève un mode à l’ensemble des modes valables d’une sortie.
Options par sortie
--output sortie
Sélectionne la sortie à reconfigurer. Utiliser le nom de la
sortie ou le XID.
--auto Pour les sorties connectées mais désactivées, ceci les activera
en utilisant leur mode préféré (ou, quelque chose autour de 96
dpi si elles n’ont aucun mode préféré). Pour les sorties
débranchées mais activées, ceci les désactivera.
--mode mode
Ceci sélectionne un mode. Utilisez le nom ou le XID du mode.
--preferred
Sélectionne le même mode que --auto, mais n’active ou ne
désactive pas automatiquement la sortie.
--pos xxy
Positionne la sortie dans l’écran en utilisant des coordonnées
de pixels. Dans le cas où une symétrie ou une rotation est
appliquée, la translation est appliquée après cet effet.
--rate frquence
Ceci marque une préférence pour des fréquences de
rafraîchissement autour de la valeur indiquée. Quand plusieurs
modes ont le même nom, ceci choisira le mode le plus proche de
la fréquence de rafraîchissement.
--reflect symtrie
La symétrie peut être ’normal’, ’x’, ’y’ ou ’xy’. Ceci effectue
une symétrie par rapport aux axes indiqués.
--rotate rotation
Rotation peut être « normal », « left », « right » ou
« inverted ». Ceci génère respectivement une rotation de la
sortie « sans rotation », « à gauche » (dans le sens inverse des
aiguilles d’une montre), « à droite » (dans le sens des
aiguilles d’une montre) ou « à l’envers ».
--left-of, --right-of, --above, --below, --same-as autre_sortie
Utilisez une de ces options pour placer la sortie relativement à
une autre sortie. Ceci permet un placement commode des sorties
dans l’écran. La position est toujours calculée relativement à
la nouvelle position de l’autre sortie. Ainsi, il n’est pas
admissible d’indiquer --output a --left-of b --output b
--left-of a.
--set proprit valeur
Définit une propriété d’une sortie. Les valeurs entières peuvent
être spécifiées comme une valeur décimale ou hexadécimale (avec
un 0x) valable (voir --prop). Les propriétés atomiques peuvent
prendre pour valeur toute valeur atomique valable (voir --prop).
Les propriétés prenant une chaînes acceptent n’importe quelle
valeur.
--off Désactiver la sortie.
--crtc crtc
Utiliser le crtc indiqué (comme indexé dans la liste de CRTCs ou
de XID). Normalement, cette option n’est pas exigée lorsque
xrandr essaye de faire le choix délicat du crtc à employer avec
chaque sortie. Quand ce choix échoue pour quelque raison, cette
option peut remplacer le choix normal.
--gamma rouge:vert:bleu
Définit les valeurs, spécifiées en virgule flottante, comme
correction gamma pour le CRTC actuellement branché à cette
sortie. Remarquez que pour des sorties clonées les valeurs
doivent être identiques et que le changement d’une sortie vers
un autre CRTC ne modifie pas la correction gamma du CRTC.
Options de la version 1.1 de RandR
Ces options sont disponibles pour les serveurs X qui ont la version 1.1
de RandR ou une version plus ancienne. Elles sont toujours valables
pour les serveurs X plus récentes, mais elles n’interagissent pas très
bien avec des options de la version 1.2 sur la même ligne de commande.
-s, --size index de taille ou --size largeurxhauteur
Configure la taille de l’écran en utilisant la taille indiquée
ou l’index dans la liste de tailles disponibles.
-r, --rate, --refresh frquence
Définit la fréquence de rafraîchissement à la valeur la plus
proche de celle spécifiée.
-o, --orientation rotation
Spécifie l’orientation de l’écran, qui peut être choisie parmi
« normal », « inverted », « left » ou « right ».
-x Inversion de l’image sur l’axe des X.
-y Inversion de l’image sur l’axe des Y.
EXEMPLES
Configure la sortie appelée LVDS au mode préféré de l’écran, et place à
sa droite la sortie appelée VGA au mode préféré de son écran avec une
rotation 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 la sortie 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 mode panoramique sur un bureau 1600x768 avec l’affichage en
1024x768 sur la sortie VGA:
xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning
1600x0
Active un petit écran LVDS en 1280x800 pour montrer une petite version
d’un bureau de 3200x2000 et avoir un grand écran VGA affichant les
environs de la souris à la taille normale.
xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA
--pos 0x0 --panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64
VOIR AUSSI
Xrandr(3), cvt(1)
AUTEURS
Keith Packard, Open Source Technology Center, Intel Corporation. et Jim
Gettys, Cambridge Research Laboratory, HP Labs, HP.
TRADUCTION
Cette page de manuel a été traduite par Gérard Delafond en 20085 puis
mise à jour par BernardSIAUD de 2007 à 2010.
La version présente dans Debian est dorénavant maintenue par les
membres de la liste <debian-l10n-french AT lists DOT debian DOT org>.
Veuillez signaler toute erreur de traduction par un rapport de bogue
sur le paquet manpages-fr-extra.