Provided by:
manpages-fr-extra_20101103_all 
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 fr'equence] [--reflect sym'etrie] [--rotate orientation]
[--left-of sortie] [--right-of sortie] [--above sortie] [--below
sortie] [--same-as sortie] [--set propri'et'e valeur] [--off] [--crtc
crtc] [--gamma rouge:vert:bleu] [--brightness luminosit'e]
Options des versions 1.0 et 1.1 de RandR
[-o orientation] [-s taille] [-r fr'equence] [-x] [-y]
DESCRIPTION
Xrandr sert a determiner la taille, l'orientation et/ou la reflexion
pour la sortie d'un ecran. Il peut aussi definir la taille de l'ecran.
L'appel sans option provoque l'affichage de l'etat des sorties, la
liste de toutes les modes pour chacune d'elles, avec un '+' apres le
mode prefere et un '*' apres le mode actuel.
Il y a quelques options globales. Les autres modifient la derniere
sortie indiquee par les parametres precedents de la ligne de commande.
Les sorties multiples peuvent etre modifiees simultanement en placant
plusieurs --output immediatement suivies des options de la sortie
correspondante
-help Affiche un resume sur l'utilisation puis quitter.
-v, --version
Affiche la version de RandR renvoyee par le serveur X puis
quitter.
--verbose
Rend xrandr plus verbeux. En combinaison avec -q (ou sans autre
option), xrandr montrera plus de renseignements sur l'etat du
serveur. Veuillez remarquer que les renseignements a propos du
gamma et de la luminosite ne sont que des approximations du
profil de couleur complet stocke dans le serveur. Avec des
options qui modifient le systeme, les modifications seront
affichees lorsque les changements de configuration sont
effectues.
-q, --query
Quand cette option est presente ou quand aucun changement de
configuration n'est demande, xrandr montrera l'etat actuel du
systeme.
--dryrun
Effectue toutes les actions specifiees sans qu'aucune
modification ne soit apportee.
--nograb
Applique les modifications sans verrouiller l'acces a l'ecran.
Ceci evite de bloquer les autres applications pendant la mise a
jour, mais peut empecher certaines applications qui detectent
les changements de taille d'ecran de recevoir les anciennes
valeurs.
-d, -display nom
Cette option permet de selectionner l'affichage X a utiliser.
Noter que ceci se rapporte a l'abstraction de l'affichage, mais
pas au comportement du moniteur (la sortie).
--screen num_'ecran
Cette option choisit quelle configuration d'ecran modifier.
Noter que ceci se rapporte a 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, meme
si une version superieure est disponible.
--q12 Oblige l'utilisation de la version 1.2 du protocole RandR, meme
si elle n'est pas indiquee comme etant prise en charge ou si une
version superieure est disponible.
Options de la version 1.3 de RandR
Les options de RandR 1.3 sont utilisees en plus des options possibles
pour RandR 1.2.
--current
Renvoie la configuration actuelle de l'ecran, sans modification
materielle.
--noprimary
Ne definit 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 definit les parametres de panorama. Des que cette
option est activee, la position CRTC de l'ecran bouge avec les
mouvements de la souris. Les quatre premiers parametres
definissent l'aire de panorama. Les quatre suivants, la zone de
suivi (qui est la meme par defaut). Les quatre derniers, les
bords, a 0 par defaut. Une hauteur ou une largeur fixee a 0
desactive le panorama sur l'axe associe. Generalement, vous
devez fixer la taille de l'ecran avec --fb en meme temps.
--transform a,b,c,d,e,f,g,h,i
Indique une matrice de transformation a appliquer a la sortie.
Un filtre bilineaire est automatiquement selectionne. La forme
mathematique est :
a b c
d e f
g h i
La transformation repose sur des coordonnees homogenes. La
matrice multipliee par le vecteur de coordonnees d'un pixel de
la sortie fournit le vecteur de coordonnees transforme d'un
pixel du tampon graphique. Plus precisement, le vecteur (x, y)
du pixel de sortie est etendu en trois dimensions (x, y, w),
avec 1 pour coordonnee w, et multiplie la matrice. Les
coordonnees finales de peripherique du pixel sont alors
calculees avec la division homogene par la coordonnee w
transformee. Autrement dit, les coordonnees de peripherique (x',
y') du pixel transforme sont :
x' = (ax + by + c) / w' et
y' = (dx + ey + f) / w',
avec w' = (gx + hy + i).
Typiquement, a et e correspondent a l'echelle selon les axes X
et Y, c et f correspondent a une translation suivant ces memes
axes, et g, h et i sont respectivement 0, 0 et 1. La matrice
peut egalement etre utilisee pour exprimer des transformations
plus compliquees, comme la correction de trapeze
(<< keystone >>), ou la rotation. Pour une rotation d'un angle
T, la formule suivante peut etre utilisee :
cos T -sin T 0
sin T cos T 0
0 0 1
Comme parametre special, au lieu de passer une matrice, on peut
passer la chaine none, dans ce cas les valeurs par defaut sont
utilisees (une matrice unitaire sans filtre).
--scale xxy
Modifie les dimensions de l'image de sortie. Les valeurs
superieures a 1 entraineront une compression de l'ecran
(dimension de l'ecran superieures aux dimensions du mode de
sortie) et les valeurs inferieures a 1 entraineront un zoom de
la sortie. Cette option est en fait une version raccourci de
l'option --transform.
--primary
Definit la sortie comme primaire. Cette sortie sera classee
premiere pour les requetes de geometrie 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 recentes.
--prop, --properties
Cette option fait afficher par xrandr les proprietes de chaque
sortie. --verbose active egalement --prop.
--fb largeurxhauteur
Reconfigure l'ecran a la taille specifiee. Tous les moniteurs
configures doivent loger dans ce rectangle. Quand cette option
n'est pas fournie, xrandr calcule la plus petite taille d'ecran
qui contiendra l'ensemble des sorties configurees ; cette option
permet de configurer ce comportement.
--fbmm largeurxhauteur
Configure la taille physique de l'ecran. Normalement, xrandr
remet a zero ces valeurs pour garder la constante de DPI. Ceci
annule ce comportement par defaut.
--dpi dpi
Configure aussi la taille physique de l'ecran. Il utilise la
valeur DPI pour calculer la taille physique de l'ecran quelle
que soit la taille des pixels configuree.
--newmode nom mode
De nouveaux modelines peuvent etre ajoutes au serveur puis
associes avec des sorties. Cette option ajoute un modeline au
serveur. Le mode est defini en utilisant la syntaxe des ModeLine
de xorg.conf : hdisp hsyncstart
hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. On peut
omettre flags ou des parametres parmi +HSync, -HSync, +VSync,
-VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Plusieurs
outils permettent de calculer les parametres usuels des
modelines : hauteur, largeur et la frequence de
rafraichissement. Par exemple, vous pouvez utiliser cvt.
--rmmode nom
Supprime un mode du serveur s'il n'est pas utilise.
--addmode sortie nom
Ajoute un mode a l'ensemble des modes valables d'une sortie.
--delmode sortie nom
Enleve un mode a l'ensemble des modes valables d'une sortie.
Options par sortie
--output sortie
Selectionne la sortie a reconfigurer. Utiliser le nom de la
sortie ou le XID.
--auto Pour les sorties connectees mais desactivees, ceci les activera
en utilisant leur mode prefere (ou, quelque chose autour de 96
dpi si elles n'ont aucun mode prefere). Pour les sorties
debranchees mais activees, ceci les desactivera.
--mode mode
Ceci selectionne un mode. Utilisez le nom ou le XID du mode.
--preferred
Selectionne le meme mode que --auto, mais n'active ou ne
desactive pas automatiquement la sortie.
--pos xxy
Positionne la sortie dans l'ecran en utilisant des coordonnees
de pixels. Dans le cas ou une symetrie ou une rotation est
appliquee, la translation est appliquee apres cet effet.
--rate fr'equence
Ceci marque une preference pour des frequences de
rafraichissement autour de la valeur indiquee. Quand plusieurs
modes ont le meme nom, ceci choisira le mode le plus proche de
la frequence de rafraichissement.
--reflect sym'etrie
La symetrie peut etre << normal >>, << x >>, << y >> ou
<< xy >>. Ceci effectue une symetrie par rapport aux axes
indiques.
--rotate rotation
Rotation peut etre << normal >>, << left >>, << right >> ou
<< inverted >>. Ceci genere respectivement une rotation de la
sortie << sans rotation >>, << a gauche >> (dans le sens inverse
des aiguilles d'une montre), << a droite >> (dans le sens des
aiguilles d'une montre) ou << a l'envers >>.
--left-of, --right-of, --above, --below, --same-as autre_sortie
Chaque option place la sortie relativement a une autre sortie.
Ceci permet un placement commode des sorties dans l'ecran. La
position est toujours calculee relativement a 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 propri'et'e valeur
Definit une propriete d'une sortie. Les valeurs entieres peuvent
etre specifiees comme une valeur decimale ou hexadecimale (avec
un 0x) valable (voir --prop). Les proprietes atomiques peuvent
prendre pour valeur toute valeur atomique valable (voir --prop).
Les proprietes prenant une chaines acceptent n'importe quelle
valeur.
--off Desactive la sortie.
--crtc crtc
Utilise le CRTC indique (comme indexe dans la liste de CRTC ou
de XID). Normalement, cette option n'est pas exigee lorsque
xrandr essaye de faire le choix delicat du CRTC a employer avec
chaque sortie. Quand ce choix echoue pour quelque raison, cette
option peut remplacer le choix normal.
--gamma rouge:vert:bleu
Definit les valeurs, indiquees en virgule flottante, comme
correction gamma pour le CRTC actuellement branche a cette
sortie. Remarquez que pour des sorties clonees (c'est-a-dire qui
partage le meme CRTC) les valeurs doivent etre identiques et que
le changement d'une sortie vers un autre CRTC ne modifie pas la
correction gamma du CRTC.
--brightness luminosit'e
Multiplie les valeurs de gamma du CRTC attache en ce moment a la
sortie par la valeur a virgule flottante indiquee. Utile pour
les sorties trop lumineuses ou trop sombres. Toutefois, ce n'est
qu'une modification logicielle, si votre materiel gere la
modification reelle de luminosite, l'utilisation de xbacklight
est sans doute preferable.
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 recentes, mais elles n'interagissent pas tres
bien avec des options de la version 1.2 sur la meme ligne de commande.
-s, --size index de taille ou --size largeurxhauteur
Configure la taille de l'ecran en utilisant la taille indiquee
ou l'index dans la liste de tailles disponibles.
-r, --rate, --refresh fr'equence
Definit la frequence de rafraichissement a la valeur la plus
proche de celle specifiee.
-o, --orientation rotation
Specifie l'orientation de l'ecran, qui peut etre 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 appelee LVDS au mode prefere de l'ecran, et place a
sa droite la sortie appelee VGA au mode prefere de son ecran 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 ecran LVDS en 1280x800 pour montrer une petite version
d'un bureau de 3200x2000 et avoir un grand ecran VGA affichant les
environs de la souris a 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
Affiche la sortie VGA sous forme trapezoidale pour corriger l'image
quand le projecteur est legerement au dessus de l'ecran :
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.
TRADUCTION
Cette page de manuel a ete traduite par Gerard Delafond en 20085 puis
mise a jour par BernardSIAUD de 2007 a 2010.
La version presente dans Debian est dorenavant 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.