.\" .\" Copyright 2001 Keith Packard .\" .\" Permission to use, copy, modify, distribute, and sell this software and its .\" documentation for any purpose is hereby granted without fee, provided that .\" the above copyright notice appear in all copies and that both that .\" copyright notice and this permission notice appear in supporting .\" documentation, and that the name of Keith Packard not be used in .\" advertising or publicity pertaining to distribution of the software without .\" specific, written prior permission. Keith Packard makes no .\" representations about the suitability of this software for any purpose. It .\" is provided "as is" without express or implied warranty. .\" .\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, .\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO .\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR .\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, .\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH XRANDR 1 "xrandr 1.4.2" "X Version 11" .SH NOM xrandr \- Interface primitive en ligne de commande pour l'extension RandR .SH SYNOPSIS \fBxrandr\fP [\fB\-\-help\fP] [\fB\-\-display\fP \fInom\fP] [\fB\-q\fP] [\fB\-v\fP] [\fB\-\-verbose\fP] [\fB\-\-dryrun\fP] [\fB\-\-screen\fP \fInum_écran\fP] [\fB\-\-q1\fP] [\fB\-\-q12\fP] [\fB\-\-current\fP] [\fB\-\-noprimary\fP] [\fB\-\-panning\fP \fIlargeur\fP\fBx\fP\fIhauteur\fP[\fB+\fP\fIx\fP\fB+\fP\fIy\fP[\fB/\fP\fIlargeur_piste\fP\fBx\fP\fIhauteur_piste\fP\fB+\fP\fIpiste_x\fP\fB+\fP\fIpiste_y\fP[\fB/\fP\fIbord_gauche\fP\fB/\fP\fIbord_haut\fP\fB/\fP\fIbord_droit\fP\fB/\fP\fIbord_bas\fP]]]] [\fB\-\-scale\fP \fIx\fP\fBx\fP\fIy\fP] [\fB\-\-scale\-from\fP \fIl\fP\fBx\fP\fIh\fP] [\fB\-\-transform\fP \fIa\fP\fB,\fP\fIb\fP\fB,\fP\fIc\fP\fB,\fP\fId\fP\fB,\fP\fIe\fP\fB,\fP\fIf\fP\fB,\fP\fIg\fP\fB,\fP\fIh\fP\fB,\fP\fIi\fP] [\fB\-\-primary\fP] [\fB\-\-prop\fP] [\fB\-\-fb\fP \fIlargeur\fP\fBx\fP\fIhauteur\fP] [\fB\-\-fbmm\fP \fIlargeur\fP\fBx\fP\fIhauteur\fP] [\fB\-\-dpi\fP \fIdpi\fP] [\fB\-\-newmode\fP \fInom\fP \fImode\fP] [\fB\-\-rmmode\fP \fInom\fP] [\fB\-\-addmode\fP \fIsortie\fP \fInom\fP] [\fB\-\-delmode\fP \fIsortie\fP \fInom\fP] [\fB\-\-output\fP \fIsortie\fP] [\fB\-\-auto\fP] [\fB\-\-mode\fP \fImode\fP] [\fB\-\-preferred\fP] [\fB\-\-pos\fP \fIx\fP\fBx\fP\fIy\fP] [\fB\-\-rate\fP \fIfréquence\fP] [\fB\-\-reflect\fP \fIréflexion\fP] [\fB\-\-rotate\fP \fIrotation\fP] [\fB\-\-left\-of\fP \fIautre_sortie\fP] [\fB\-\-right\-of\fP \fIautre_sortie\fP] [\fB\-\-above\fP \fIautre_sortie\fP] [\fB\-\-below\fP \fIautre_sortie\fP] [\fB\-\-same\-as\fP \fIautre_sortie\fP] [\fB\-\-set\fP \fIpropriété\fP \fIvaleur\fP] [\fB\-\-off\fP] [\fB\-\-crtc\fP \fIcrtc\fP] [\fB\-\-gamma\fP \fIrouge\fP\fB:\fP\fIvert\fP\fB:\fP\fIbleu\fP] [\fB\-\-brightness\fP \fIluminosité\fP] [\fB\-o\fP \fIrotation\fP] [\fB\-s\fP, \fB\-\-size\fP \fIindice de taille\fP] [\fB\-r\fP \fIfréquence\fP] [\fB\-x\fP] [\fB\-y\fP] [\fB\-\-listproviders\fP] [\fB\-\-setprovideroutputsource\fP \fIfournisseur\fP \fIsource\fP] [\fB\-\-setprovideroffloadsink\fP \fIfournisseur\fP \fIcollecteur\fP] .SH DESCRIPTION \fIXrandr\fP sert à déterminer la taille, l'orientation ou la réflexion des sorties pour un écran. Il permet aussi de définir la taille de l'écran. L'appel sans option provoque l'affichage de l'état des sorties, la liste de tous les modes pour chacune d'elles, avec un «\ +\ » après les modes préférés et un «\ *\ » après le mode actuel. Quelques options sont 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 \fB\-\-output\fP immédiatement suivies des options de la sortie correspondante .IP \fB\-\-help\fP Afficher un résumé sur l'utilisation puis quitter. .IP "\fB\-v\fP, \fB\-\-version\fP" Afficher la version de RandR renvoyée par le serveur X puis quitter. .IP \fB\-\-verbose\fP Rendre xrandr plus prolixe. En combinaison avec \fB\-q\fP (ou sans autre option), xrandr montrera plus de renseignements sur l'état du serveur. Veuillez remarquer que les renseignements à propos du gamma et de la luminosité ne sont que des approximations du profil de couleur complet stocké dans le serveur. Avec des options qui modifient le système, les modifications seront affichées lorsque les changements de configuration sont effectués. .IP "\fB\-q\fP, \fB\-\-query\fP" Quand cette option est présente ou quand aucun changement de configuration n'est demandé, xrandr montrera l'état actuel du système. .IP \fB\-\-dryrun\fP Effectuer toutes les actions indiquées, mais sans qu'aucune modification ne soit apportée. .IP \fB\-\-nograb\fP Appliquer les modifications sans verrouiller l'accès à l'écran. Cela é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. .IP "\fB\-d\fP, \fB\-\-display\fP \fInom\fP" Choisir l'affichage X à utiliser. Remarquez que cela se rapporte à l'abstraction de l’écran mais pas au comportement du moniteur (la sortie). .IP "\fB\-\-screen\fP \fInum_écran\fP" Choisir l'écran à modifier. Remarquez que cela se rapporte à l'abstraction de l'écran, mais pas au comportement du moniteur (la sortie). .IP \fB\-\-q1\fP Imposer l'utilisation de la version\ 1.1 du protocole RandR, même si une version supérieure est disponible. .IP \fB\-\-q12\fP Imposer 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. .PP .SH "Options de la version\ 1.4 de RandR" .PP Les options de RandR\ 1.4 sont utilisées en plus des options possibles pour RandR\ 1.3. .IP \fB\-\-listproviders\fP Renvoyer des renseignements sur les fournisseurs disponibles. .IP "\fB\-\-setprovideroutputsource\fP \fIfournisseur\fP \fIsource\fP" Définir la \fIsource\fP comme source d’affichage des images en sortie pour le \fIfournisseur\fP. Ce n’est possible qui si la \fIsource\fP et le \fIfournisseur\fP ont respectivement les capacités \fBSource Output\fP et \fBSink Output\fP. Si \fIsource\fP est \fB0x0\fP, alors \fIfournisseur\fP est déconnecté de sa source de sortie actuelle. .IP "\fB\-\-setprovideroffloadsink\fP \fIfournisseur\fP \fIcollecteur\fP" Définir le \fIfournisseur\fP comme périphérique de déchargement du rendu pour le \fIcollecteur\fP. Ce n’est possible qui si le \fIfournisseur\fP et le \fIcollecteur\fP ont respectivement les capacités \fBSource Offload\fP et \fBSink Offload\fP. Si \fIcollecteur\fP est \fB0x0\fP, alors \fIfournisseur\fP est déconnecté de son collecteur de déchargement du rendu actuel. .PP .SH "Options de la version\ 1.3 de RandR" .PP Les options de RandR\ 1.3 sont utilisées en plus des options possibles pour RandR\ 1.2. .PP .IP \fB\-\-current\fP Renvoyer la configuration actuelle de l'écran, sans modification matérielle. .IP \fB\-\-noprimary\fP Ne pas définir de sortie principale. .PP \fBOptions par sortie\fP .IP "\fB\-\-panning\fP \fIlargeur\fP\fBx\fP\fIhauteur\fP[\fB+\fP\fIx\fP\fB+\fP\fIy\fP[\fB/\fP\fIlargeur_piste\fP\fBx\fP\fIhauteur_piste\fP\fB+\fP\fIpiste_x\fP\fB+\fP\fIpiste_y\fP[\fB/\fP\fIbord_gauche\fP\fB/\fP\fIbord_haut\fP\fB/\fP\fIbord_droit\fP\fB/\fP\fIbord_bas\fP]]]" Définir les paramètres du panoramique. Dès que cette option est activée, la position du CRTC dans l'écran bouge avec les mouvements de la souris. Les quatre premiers paramètres définissent l'aire du panoramique\ ; 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 définie à 0 désactive le panoramique sur l'axe associé. Généralement, vous devez définir la taille de l'écran avec \fB\-\-fb\fP en même temps. .IP "\fB\-\-transform\fP \fIa\fP\fB,\fP\fIb\fP\fB,\fP\fIc\fP\fB,\fP\fId\fP\fB,\fP\fIe\fP\fB,\fP\fIf\fP\fB,\fP\fIg\fP\fB,\fP\fIh\fP\fB,\fP\fIi\fP" Indiquer une matrice de transformation à appliquer à la sortie. Un filtre bilinéaire est automatiquement sélectionné. La forme mathématique est\ : .RS .RS a b c .br d e f .br g h i .RE La transformation repose sur des coordonnées homogènes. La matrice multipliée par le vecteur de coordonnées d'un pixel de la sortie fournit le vecteur de coordonnées transformé d'un pixel du tampon graphique. Plus précisément, le vecteur (x, y) du pixel de sortie est étendu en trois dimensions (x, y, w), avec 1 pour coordonnée w, et multiplie la matrice. Les coordonnées finales de périphérique du pixel sont alors calculées avec la division homogène par la coordonnée w transformée. Autrement dit, les coordonnées de périphérique (x', y') du pixel transformé sont\ : .RS x' = (ax + by + c) / w' et .br y' = (dx + ey + f) / w', .br avec w' = (gx + hy + i). .RE Typiquement, \fIa\fP et \fIe\fP correspondent à l'échelle selon les axes X et Y, \fIc\fP et \fIf\fP correspondent à une translation suivant ces mêmes axes, et \fIg\fP, \fIh\fP et \fIi\fP sont respectivement 0, 0 et 1. La matrice peut également être utilisée pour exprimer des transformations plus compliquées, comme la correction de trapèze («\ keystone\ »), ou la rotation. Pour une rotation d'un angle T, la formule suivante peut être utilisée\ : .RS cos T \-sin T 0 .br sin T cos T 0 .br 0 0 1 .RE Comme paramètre spécial, au lieu de passer une matrice, la chaîne \fInone\fP peut être passée, dans ce cas les valeurs par défaut sont utilisées (une matrice unitaire sans filtre). .RE .IP "\fB\-\-scale\fP \fIx\fP\fBx\fP\fIy\fP" Modifier les dimensions de l'image de sortie. Les valeurs supérieures à 1 entraîneront une compression de l'écran (dimensions 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 raccourcie de l'option \fB\-\-transform\fP. .IP "\fB\-\-scale\-from\fP \fIl\fP\fBx\fP\fIh\fP" Indiquer la taille en pixel de la surface du tampon vidéo à afficher sur cette sortie. Cette option est en fait une version raccourcie de l’option \fB\-\-transform\fP. .IP \fB\-\-primary\fP Définir la sortie comme primaire. Cette sortie sera classée première pour les requêtes de géométrie de Xinerama et RandR. .PP .SH "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. .IP "\fB\-\-prop\fP, \fB\-\-properties\fP" Afficher les propriétés de chaque sortie. \fB\-\-verbose\fP active également \fB\-\-prop\fP. .IP "\fB\-\-fb\fP \fIlargeur\fP\fBx\fP\fIhauteur\fP" Reconfigurer l'écran à la taille indiquée. Tous les moniteurs configurés doivent entrer 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 modifier ce comportement. .IP "\fB\-\-fbmm\fP \fIlargeur\fP\fBx\fP\fIhauteur\fP" Configurer la taille physique de l'écran aux valeurs indiquées. Normalement, xrandr réinitialise cette taille pour garder constante la valeur DPI. Cela annule ce comportement par défaut. .IP "\fB\-\-dpi\fP \fIdpi\fP" Configurer aussi la taille physique de l'écran. La valeur DPI est utilisée pour calculer la taille physique de l'écran quelle que soit la taille des pixels configurée. .IP "\fB\-\-newmode\fP \fInom\fP \fImode\fP" De nouveaux modelines (modes vidéo) peuvent être ajoutés au serveur puis associés à des sorties. Cette option ajoute un modeline au serveur. Le \fImode\fP est défini en utilisant la syntaxe des ModeLine de xorg.conf\ : clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal \fIflags\fP. On peut omettre \fIflags\fP 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 fréquence de rafraîchissement. Par exemple, vous pouvez utiliser \fBcvt\fP. .IP "\fB\-\-rmmode\fP \fInom\fP" Supprimer un mode du serveur s'il n'est pas utilisé. .IP "\fB\-\-addmode\fP \fIsortie\fP \fInom\fP" Ajouter un mode à l'ensemble des modes valables d'une sortie. .IP "\fB\-\-delmode\fP \fIsortie\fP \fInom\fP" Enlever un mode de l'ensemble des modes valables d'une sortie. .PP \fBOptions par sortie\fP .IP "\fB\-\-output\fP \fIsortie\fP" Sélectionner la sortie à reconfigurer. Utilisez le nom de la sortie ou le XID. .IP \fB\-\-auto\fP Pour les sorties connectées mais désactivées, cela les activera en utilisant leur premier mode préféré (ou une valeur proche de 96\ dpi si elles n'ont aucun mode préféré). Pour les sorties débranchées mais activées, cela les désactivera. .IP "\fB\-\-mode\fP \fImode\fP" Sélectionner un mode. Utilisez le nom ou le XID du \fImode\fP. .IP \fB\-\-preferred\fP Sélectionner le même mode que \fB\-\-auto\fP, mais sans activer ou désactiver automatiquement la sortie. .IP "\fB\-\-pos\fP \fIx\fP\fBx\fP\fIy\fP" Positionner la sortie dans l'écran en utilisant des coordonnées de pixels. Dans le cas où une réflexion ou une rotation est appliquée, la modification est appliquée après cet effet. .IP "\fB\-\-rate\fP \fIfréquence\fP" Marquer 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, le mode le plus proche de la fréquence de rafraîchissement est choisi. .IP "\fB\-\-reflect\fP \fIréflexion\fP" La réflexion peut être «\ normal\ », «\ x\ », «\ y\ » ou «\ xy\ ». Cela produit une sortie symétrique par rapport aux axes indiqués. .IP "\fB\-\-rotate\fP \fIrotation\fP" La rotation peut être «\ normal\ », «\ left\ », «\ right\ » ou «\ inverted\ ». Cela génère respectivement une sortie «\ sans rotation\ », une rotation «\ à gauche\ » (dans le sens inverse des aiguilles d'une montre), une «\ à droite\ » (dans le sens des aiguilles d'une montre) ou «\ à l'envers\ ». .IP "\fB\-\-left\-of\fP, \fB\-\-right\-of\fP, \fB\-\-above\fP, \fB\-\-below\fP, \fB\-\-same\-as\fP \fIautre_sortie\fP" Chaque option place la sortie relativement à une autre sortie. Cela permet un pavage (tiling) 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 \fB\-\-output\fP a \fB\-\-left\-of\fP b \fB\-\-output\fP b \fB\-\-left\-of\fP a. .IP "\fB\-\-set\fP \fIpropriété\fP \fIvaleur\fP" Définir une propriété de sortie. Les valeurs entières peuvent être indiquées dans une liste, séparées par des virgules, de valeurs décimales ou hexadécimales (débutant avec 0x) valables (consultez \fB\-\-prop\fP). Les propriétés atomiques peuvent prendre pour valeur toute valeur atomique valable (consultez \fB\-\-prop\fP). Les propriétés prenant une chaîne acceptent n'importe quelle valeur. .IP \fB\-\-off\fP Désactiver la sortie. .IP "\fB\-\-crtc\fP \fIcrtc\fP" Utiliser le CRTC indiqué (par son indice dans la liste de CRTC ou son XID). Normalement, cette option n'est pas exigée lorsque xrandr essaye de faire le choix délicat du CRTC à employer pour chaque sortie. Quand ce choix échoue pour quelque raison, cette option peut remplacer le choix normal. .IP "\fB\-\-gamma\fP \fIrouge\fP\fB:\fP\fIvert\fP\fB:\fP\fIbleu\fP" Définir les valeurs, indiquées en virgule flottante, comme correction gamma pour le CRTC actuellement branché à cette sortie. Remarquez que pour des sorties clonées (c'est\-à\-dire qui partagent le même CRTC) les valeurs doivent être identiques et que le changement d'une sortie vers un autre CRTC ne modifie pas la correction gamma du CRTC. .IP "\fB\-\-brightness\fP \fIluminosité\fP" Multiplier les valeurs de gamma du CRTC attaché en ce moment à la sortie par la valeur à virgule flottante indiquée. Utile pour les sorties trop lumineuses ou trop sombres. Toutefois, ce n'est qu'une modification logicielle, si votre matériel gère la modification réelle de luminosité, l'utilisation de \fBxbacklight\fP est sans doute préférable. .PP .SH "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écents, mais elles n'interagissent pas très bien avec des options de la version\ 1.2 sur la même ligne de commande. .IP "\fB\-s\fP, \fB\-\-size\fP \fIindice de taille\fP ou \fB\-\-size\fP \fIlargeur\fPx\fIhauteur\fP" Configurer la taille de l'écran en utilisant la taille indiquée ou l'indice dans la liste de tailles disponibles. .IP "\fB\-r\fP, \fB\-\-rate\fP, \fB\-\-refresh\fP \fIfréquence\fP" Définir la fréquence de rafraîchissement à la valeur la plus proche de celle indiquée. .IP "\fB\-o\fP, \fB\-\-orientation\fP \fIrotation\fP" Indiquer l'orientation de l'écran, qui peut être choisie parmi «\ normal\ », «\ inverted\ », «\ left\ » ou «\ right\ ». .IP \fB\-x\fP Réfléchir l'image symétriquement par rapport à l'axe X. .IP \fB\-y\fP Réfléchir l'image symétriquement par rapport à l'axe Y. .SH EXEMPLES Configurer la sortie appelée LVDS à son mode préféré, et placer à sa droite la sortie appelée VGA au mode préféré d’un écran physiquement tourné dans le sens des aiguilles d'une montre\ : .RS xrandr \-\-output LVDS \-\-auto \-\-rotate normal \-\-pos 0x0 \-\-output VGA \-\-auto \-\-rotate left \-\-right\-of LVDS .RE .PP Forcer l'utilisation d'un mode 1024x768 sur la sortie VGA\ : .RS xrandr \-\-newmode "1024x768" 63.50 1024 1072 1176 1328 768 771 775 798 \-hsync +vsync .br xrandr \-\-addmode VGA 1024x768 .br xrandr \-\-output VGA \-\-mode 1024x768 .RE .PP Activer le mode panoramique sur un bureau 1600×768 avec l'affichage en 1024×768 sur la sortie VGA\ : .RS xrandr \-\-fb 1600x768 \-\-output VGA \-\-mode 1024x768 \-\-panning 1600x0 .RE .PP Activer un petit écran LVDS en 1280×800 pour montrer une petite version d'un bureau de 3200×2000 et avoir un grand écran VGA affichant les environs de la souris à la taille normale\ : .RS xrandr \-\-fb 3200x2000 \-\-output LVDS \-\-scale 2.5x2.5 \-\-output VGA \-\-pos 0x0 \-\-panning 3200x2000+0+0/3200x2000+0+0/64/64/64/64 .RE .PP Afficher la sortie VGA sous forme trapézoïdale pour corriger l'image quand le projecteur est légèrement au\-dessus de l'écran\ : .RS xrandr \-\-fb 1024x768 \-\-output VGA \-\-transform 1.24,0.16,\-124,0,1.24,0,0,0.000316,1 .RE .SH "VOIR AUSSI" \fBcvt\fP(1), \fBxbacklight\fP(1), \fBxkeystone\fP(1), \fBXrandr\fP(3) .SH AUTEURS Keith Packard, Open Source Technology Center, Intel Corporation. et Jim Gettys, Cambridge Research Laboratory, HP Labs, HP. .SH TRADUCTION Cette page de manuel a été traduite par Gérard Delafond en 2005 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 . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages\-fr\-extra.