Manpages

NOM

xrandr - interface primitive de l’extension RandR en ligne de commande

SYNOPSIS

xrandr [--help] [--display affichage] [-q] [-v] [--verbose] [--dryrun] [--screen num_écran] [--q1] [--q12] [--current] [--noprimary] [--panning largeurxhauteur[+x+y[/track_widthxtrack_height+track_x+track_y[/bordure_gauche/bordure_bas/bordure_droite/bordure_bas]]]] [--scale xxy] [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb largeurxhauteur] [--fbmm largeurxhauteur] [--dpi dpi] [--newmode nom mode] [--rmmode nom] [--addmode sortie nom] [--delmode sortie nom] [--output sortie] [--auto] [--mode mode] [--preferred] [--pos xxy] [--rate fréq] [--reflect réflexion] [--rotate orientation] [--left-of sortie] [--right-of sortie] [--above sortie] [--below sortie] [--same-as sortie] [--set propriété valeur] [--off] [--crtc crtc] [--gamma rouge:vert:bleu] [--brightness luminosité] [-o orientation] [-s taille] [-r fréq] [-x] [-y] [--listproviders] [--setprovideroutputsource fournisseur source] [--setprovideroffloadsink fournisseur sink]

DESCRIPTION

Xrandr est utilisé pour spécifier la taille, l’orientation ou la réflexion des sorties d’un écran. Il peut également spécifier la taille de l’écran.

Si appelé sans aucune option, il affichera le statut des sorties, montrant les modes existant pour chacune d’entre elles, avec un « + » après les modes préférés et une « * » après le mode en cours.

Il y a peu d’options globales. Les autres options modifient la dernière sortie spécifiée dans les paramètres précédents passés dans la ligne de commande. De nombreuses sorties peuvent être modifiées au même moment à l’aide de plusieurs options --output suivies immédiatement par leurs options de modification correspondantes.

--help

Afficher un sommaire des différentes utilisations possibles et sortir.

-v, --version

Afficher la version de RandR rapportée par le serveur X et sortir.

--verbose

xrandr devient plus verbeux. Quand utilisé avec -q (ou sans autre option), xrandr affichera plus d’informations sur l’état du serveur. Veuillez noter que les informations sur le gamma et la luminosité sont seulement des approximations du profil couleur du serveur. Quand utilisé avec des options qui reconfigurent le système, l’évolution sera rapportée pendant les changements de configuration.

-q, --query

Quand cette option est présente, ou quand aucun changement de configuration n’a été demandé, xrandr affichera l’état actuel du système.

--dryrun

Effectuer toutes les actions spécifiées sans apporter aucune modification.

--nograb

Appliquer les modifications sans neutraliser l’écran. Cela évite de bloquer les autres applications lors de la mise à jour, mais cela pourrait conduire certaines applications qui détectent le redimensionnement de l’écran à recevoir les anciennes valeurs.

-d, --display nom

Cette option sélectionne l’écran X à utiliser. Veuillez noter que cela concerne la forme abstraite de l’écran X, non le moniteur (ou la sortie).

--screen num-écran

Cette option sélectionne l’écran à manipuler. Veuillez noter que cela concerne la forme abstraite de l’écran X, non le moniteur (ou la sortie).

--q1

Forcer l’utilisation de la version 1.1 du protocole RandR, même si une version plus récente est disponible.

--q12

Forcer l’utilisation de la version 1.2 du protocole RandR, même si l’écran ne semble pas être compatible ou qu’une version plus récente soit disponible.

Options de RandR version 1.4

Les options de RandR 1.4 sont utilisées comme une supercollection des options de RandR 1.3.
--listproviders

Rapporter des informations sur les fournisseurs disponibles.

--setprovideroutputsource fournisseur source

Définir source en tant que source des images de la sortie d’affichage pour fournisseur. Cela n’est possible que si source et fournisseur ont, respectivement, les possibilités Source Output et Sink Output. Si source vaut 0x0, fournisseur est déconnecté de sa source d’affichage actuelle.

--setprovideroffloadsink fournisseur sink

Définir fournisseur en tant que périphérique de destination pour le rendu de sink. Cela n’est possible que si fournisseur et sink ont respectivement les possibilités Source Offload et Sink Offload. Si sink vaut 0x0, fournisseur est déconnecté de sa source de destination de rendu.

Options de RandR version 1.3

Les options de RandR 1.3 sont utilisées comme une supercollection des options de RandR 1.2.
--current

Retourner la configuration de l’écran en cours, sans recherche de changements matériels.

--noprimary

Ne pas définir de sortie primaire.

Options par sortie
--panning
largeur
xhauteur[+x+y[/track_widthxtrack_height+track_x+track_y[/bordure_gauche/bordure_haute/bordure_droite/bordure_bas]]]

Cette option définit les paramètres de glissement. Dès que le glissement est activé, la position du CRTC peut changer à chaque mouvement du pointeur. Les quatre premiers paramètres indiquent la zone du glissement, les quatre suivants celle de poursuite du pointeur (qui est par défaut la même). Les quatre derniers paramètres indiquent la bordure et sont à 0 par défaut. Une largeur ou une hauteur à 0 désactivent le glissement sur l’axe en question. Vous devez généralement définir simultanément la taille de l’écran avec --fb.

--transform a,b,c,d,e,f,g,h,i

Spécifier 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 transformation s’appuie sur des coordonnées homogènes. La matrice multipliée par les composantes vectorielles d’un pixel d’affichage donne les composantes vectorielles transformées d’un pixel dans le tampon graphique. Plus précisément, le vecteur (x y) du pixel d’affichage est étendu à trois valeurs (x y w), avec 1 comme coordonnée w multiplié par la matrice. Les coordonnées du pixel final du périphérique sont alors calculées avec ce qu’on appelle la division homogène par la coordonnée w transformée. Autrement dit, les coordonnées (x’ y’) du pixel transformé sont :

x’ = (ax + by + c) / w’ et
y’ = (dx + ey + f) / w’ ,
avec w’ = (gx + hy + i) .

Typiquement, 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. Cette matrice peut être également utilisée pour formuler des transformations plus complexes telles que la correction de trapèze, 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, on peut passer, à la place d’une matrice, la chaîne de caractères none : dans ce cas les valeurs par défaut sont utilisées (une matrice unitaire sans filtre).

--scale xxy

Modifier les dimensions de l’image de sortie. Les valeurs supérieures à 1 donnent un écran compressé (une taille d’écran supérieure à celle du mode de sortie), et des valeurs inférieures à 1 donnent un zoom sur la sortie. Cette option est, en fait, une version raccourcie de --transform.

--scale-from wxh

Spécifier 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

Spécifier la sortie comme primaire. Elle sera affichée en premier lors des requêtes géométriques Xinerama et RANDR.

Options de RandR version 1.2

Ces options sont disponibles pour un serveur X gérant RandR version 1.2 ou ultérieure.
--prop, --properties

Cette option conduit xrandr à afficher le contenu des propriétés de chaque sortie. --verbose active implicitement --prop.

--fb largeurxhauteur

Reconfigure l’écran avec la taille spécifiée. Tous les moniteurs configurés doivent tenir dans cette taille. Quand cette option n’est pas fournie, xrandr calcule la plus petite taille de l’écran qui contiendra toute la collection de sorties configurées. Cette option fournit un moyen de surcharger ce comportement.

--fbmm largeurxhauteur

Définir les valeurs indiquées pour la taille physique de l’écran. En principe, xrandr réinitialise les valeurs de la taille physique indiquée pour conserver la valeur de DPI constante. Cela outrepasse le calcul.

--dpi dpi

Cela définit également les valeurs indiquées de la taille physique de l’écran. Elle utilise la valeur DPI spécifiée pour calculer la taille physique appropriée en utilisant n’importe quelle taille de pixel définie.

--newmode nom mode

De nouvelles définitions d’écran (modeline) peuvent être ajoutées au serveur puis associées aux sorties. Cette option fait la première chose. Le mode est indiqué en utilisant la syntaxe Modeline pour xorg.conf : les drapeaux clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal. Les drapeaux peuvent valoir 0 ou plus de +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Divers outils permettent de calculer les définitions habituelles à partir de la hauteur, de la largeur et de la fréquence de rafraîchissement, vous pouvez par exemple utiliser cvt.

--rmmode nom

Cela supprime un mode du serveur s’il n’est utilisé autrement.

--addmode sortie nom

Ajouter un mode à l’ensemble des modes valables pour une sortie.

--delmode sortie nom

Supprimer un mode de l’ensemble des modes valables pour une sortie.

Options par sortie
--output sortie

Sélectionner une sortie à reconfigurer. Utilisez soit le nom de la sortie soit son XID.

--auto

Pour les sorties connectées mais désactivées, cela les activera en utilisant leur premier mode préféré (ou, si aucun mode n’est préféré, quelque chose de proche de 96 dpi). Pour les sorties déconnectées mais activées, cela les désactivera.

--mode mode

Cela sélectionne un mode. Utilisez soit le nom ou le XID pour mode

--preferred

Cela sélectionne le même mode que --auto, à l’exception qu’il n’active ou ne désactive pas automatiquement la sortie.

--pos xxy

Positionner la sortie sur l’écran en utilisant des coordonnées en pixels. Si une réflexion ou une rotation est appliquée, la translation s’opère après ses effets.

--rate fréq

Cela marque une préférence pour les fréquences de rafraichissement proches de la valeur spécifiée, quand de nombreux modes ont le même nom. Cela sélectionnera la fréquence de rafraichissement qui est la plus proche.

--reflect réflexion

Réflexion peut être « normal », « x », « y » ou « xy ». Cela réfléchit le contenu de la sortie selon les axes donnés.

--rotate rotation

La rotation peut être soit « normal » (normale), soit « left » (gauche), soit « right » (droite) ou encore « inverted » (inversée). Cela conduit le contenu des sorties à être pivoté vers certaine direction. « right » (droite) spécifie une rotation dans le sens des aiguilles d’une montre et inversement pour « left » (gauche).

--left-of, --right-of, --above, --below, --same-as autre-sortie

Utiliser une de ces options pour positionner la sortie par rapport à la position d’une autre sortie. Cela permet d’arranger commodément les sorties à l’intérieur de un écran. La position est toujours calculée par rapport à la nouvelle position de l’autre sortie, donc on ne peut pas dire --output a --left-of b --output b --left-of a.

--set caractéristique valeur

Définir les caractéristiques d’une sortie. Des caractéristiques numériques peuvent être indiquées (voir --prop) dans une liste séparée par des virgules de valeurs décimales ou hexadécimales (précédées de 0x). Les propriétés atomiques peuvent être positionnées sur n’importe quel valeur atomique (voir --prop). Les caractéristiques de chaîne peuvent être positionnées à n’importe quelle valeur.

--off

Désactiver la sortie.

--crtc crtc

Utiliser le crtc spécifié (soit comme index d’une liste de CRTC ou d’XID). Normalement, cette option n’est pas nécessaire car xrandr essaie de faire des choix sensés quant au crtc à utiliser avec chaque sortie. Quand cela échoue pour une raison ou pour une autre, cette option peut outrepasser la sélection normale.

--gamma rouge:vert:bleu

Positionner les valeurs décimales spécifiées en tant que correction gamma sur le CRTC actuellement connecté à cette sortie. Remarquez que vous ne pouvez pas avoir deux valeurs différentes pour deux sorties clones (à savoir qui partagent le même CRTC) et que le passage d’une sortie d’un CRTC à l’autre ne modifie en aucun cas les corrections gamma du CRTC.

--brightness luminosité

Multiplier les valeurs gamma du CRTC connecté à la sortie par la valeur décimale spécifiée. Utile pour des sorties à la luminosité trop importante ou trop faible. Toutefois, il ne s’agit que d’une modification logicielle, si votre matériel gère, en fait, la modification de la luminosité, vous préfèrerez probablement utiliser xbacklight.

Options de RandR version 1.1

Ces options sont disponibles pour les serveurs X prenant en charge RandR version 1.1 ou inférieure. Elles fonctionnent encore sur les nouveaux serveurs X, mais elles n’interagissent pas sensiblement avec les options de la version 1.2 sur la même ligne de commande.
-s, --size size-index ou --size largeurxhauteur

Cela détermine la taille de l’écran, soit en l’adaptant à la taille soit en utilisant l’index de la liste des tailles disponibles.

-r, --rate, --refresh fréq

Cela spécifie la fréquence de rafraichissement le plus proche de la valeur donnée.

-o, --orientation rotation

Cela spécifie l’orientation de l’écran, et peut être soit normal (normale), soit inverted (inversée), soit left (gauche) ou right (droite).

-x

Réflexion sur l’axe X.

-y

Réflexion sur l’axe Y.

EXEMPLES

Positionner une sortie appelée LVDS sur son mode préféré, puis positionner à sa droite une sortie appelée VGA sur le mode préféré de l’écran physiquement orienté dans le sens des aiguilles d’une montre :

xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS

Forcer l’utilisation du mode 1024x768 sur une sortie se nommant 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

Activer le glissement sur un bureau de 1600x768 dans un affichage en 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 grand bureau de 3200x2000 et avoir un grand écran VGA pour afficher l’environnement de la souris dans une 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

Afficher la sortie VGA sous forme de trapèze pour une correction logicielle (keystone) si le vidéoprojecteur 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.

TRADUCTION

La traduction française de cette page de manuel a été créée par José JORGE, Cyril Guilloud <guilloud [AT] lautre.net>, Simon Depiets, Gérard Delafond <gerard [AT] delafond.org>, Bernard Siaud, Nicolas François <nicolas.francois [AT] centraliens.net>, David Prévot <david [AT] tilapin.org>, Jean-Philippe MENGUAL <jpmengual [AT] debian.org> et Mattéo Rossillol‑‑Laruelle <beatussum [AT] protonmail.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n’y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french [AT] lists.org>.