Available in

(1) (1)/fr

Contents

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équence] [−−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 fréquence] [−x] [−y]

DESCRIPTION

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
largeur
xhauteur[+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 fréquence

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 symétrie

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 propriété 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 fréquence

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 Bernard SIAUD 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.

COMMENTS

blog comments powered by Disqus