xrandr - interfaz de línea de comandos primitiva para la extensión RandR
SINOPSIS
xrandr [--help] [--display display] [-q] [-v] [--verbose] [--dryrun] [--screen snum] [--q1]
[--q12] [--current] [--noprimary] [--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]] [--scale
x[xy]] [--scale-from wxh] [--transform a,b,c,d,e,f,g,h,i] [--primary] [--prop] [--fb widthxheight] [--fbmm widthxheight] [--dpi dpi] [--dpi from-output] [--newmode name mode] [--rmmode
name] [--addmode output name] [--delmode output name] [--output output] [--auto] [--mode mode]
[--preferred] [--pos xxy] [--rate rate] [--reflect reflection] [--rotate orientation] [--left-of
output] [--right-of output] [--above output] [--below output] [--same-as output] [--set property
value] [--off] [--crtc crtc] [--gamma red[:green:blue]] [--brightness brightness] [-o orientation] [-s size] [-r rate] [-x] [-y] [--listproviders] [--setprovideroutputsource provider source]
[--setprovideroffloadsink provider sink] [--listmonitors] [--listactivemonitors] [--setmonitor
name geometry outputs] [--delmonitor name]
DESCRIPCIÓN
Xrandr se utiliza para establecer el tamaño, la orientación y/o la reflexión de las salidas de una pantalla. También puede establecer el tamaño de la pantalla.
Si se invoca sin ninguna opción, mostrará el estado de las salidas, mostrando los modos existentes para cada una de ellas, con un "+" después de los modos preferidos y un "*" después del modo actual.
Existen algunas opciones globales. Otras opciones modifican la última salida que se especifica en los parámetros anteriores de la línea de comandos. Se pueden modificar varias salidas al mismo tiempo pasando varias opciones --output seguidas inmediatamente de sus opciones de modificación correspondientes.
--help Imprime un resumen del uso y sale.
-v, --version
Imprime la versión de RandR informada por el servidor X y sale.
--verbose
Hace que xrandr sea más detallado. Cuando se usa con -q (o sin otras opciones), xrandr mostrará más información sobre el estado del servidor. Tenga en cuenta que la información de gamma y brillo es solo una aproximación del perfil de color completo almacenado en el servidor. Cuando se utiliza junto con opciones que reconfiguran el sistema, se mostrará el progreso mientras se ejecutan los cambios de configuración.
-q, --query
Cuando está presente esta opción, o cuando no se solicitan cambios de configuración, xrandr mostrará el estado actual del sistema.
--dryrun
Realiza todas las acciones especificadas, excepto que no se realizan cambios.
--nograb
Aplica las modificaciones sin capturar la pantalla. Evita bloquear otras aplicaciones durante la actualización, pero también puede provocar que algunas aplicaciones que detectan cambios en el tamaño de la pantalla reciban valores antiguos.
-d, --display name
Esta opción selecciona la pantalla X que se va a utilizar. Tenga en cuenta que esto se refiere a la abstracción de pantalla X, no al monitor (o salida).
--screen snum
Esta opción selecciona la pantalla que se va a manipular. Tenga en cuenta que esto se refiere a la abstracción de pantalla X, no al monitor (o salida).
--q1 Fuerza el uso del protocolo RandR versión 1.1, incluso si hay disponible una versión superior.
--q12 Fuerza el uso del protocolo RandR versión 1.2, incluso si la pantalla no lo informa como compatible o si hay disponible una versión superior.
Opciones de la versión 1.5 de RandR
Las opciones de RandR 1.5 se utilizan como un superconjunto de las opciones de RandR 1.4.
--listmonitors
Informa sobre toda la información de los monitores definidos.
--listactivemonitors
Informa sobre toda la información de los monitores activos.
--setmonitor name geometry outputs
Define un nuevo monitor con la geometría dada y asociado a las salidas dadas. La lista de salidas es o bien la palabra clave none, o una lista separada por comas de salidas. La geometría es o bien la palabra clave auto, en cuyo caso el monitor hará un seguimiento automático de la geometría de las salidas asociadas, o una especificación manual en el formato w/mmwxh/mmh+x+y, donde w, h, x, y están en píxeles y mmw, mmh son las dimensiones físicas del monitor.
--delmonitor name
Elimina el monitor definido por el usuario.
Opciones de la versión 1.4 de RandR
Las opciones de RandR 1.4 se utilizan como un superconjunto de las opciones de RandR 1.3.
--listproviders
Informa sobre los proveedores disponibles.
--setprovideroutputsource provider source
Establece source como la fuente de imágenes de salida de pantalla para provider. Esto solo es posible si source y provider tienen las capacidades Source Output y Sink Output, respectivamente. Si source es 0x0, entonces provider se desconecta de su fuente de salida actual.
--setprovideroffloadsink provider sink
Establece provider como un dispositivo de descarga de renderizado para sink. Esto solo es posible si provider y sink tienen las capacidades Source Offload y Sink Offload, respectivamente. Si sink es 0x0, entonces provider se desconecta de su sink de descarga de renderizado actual.
Opciones de la versión 1.3 de RandR
Las opciones de RandR 1.3 se utilizan como un superconjunto de las opciones de RandR 1.2.
--current
Devuelve la configuración de pantalla actual, sin realizar sondeos de los cambios de hardware.
--noprimary
No define una salida principal.
Opciones por salida
--panning widthxheight[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]
Esta opción establece los parámetros de panning. Tan pronto como se habilita el panning, la posición del CRTC puede cambiar con cada movimiento del puntero. Los cuatro primeros parámetros especifican el área total de panning, los siguientes cuatro el área de seguimiento del puntero (que por defecto es la misma área). Los últimos cuatro parámetros especifican el borde y por defecto son 0. Un ancho o una altura establecidos en cero deshabilitan el panning en el eje correspondiente. Normalmente, también debe establecer el tamaño de la pantalla con --fb.
--transform a,b,c,d,e,f,g,h,i
Especifica una matriz de transformación para aplicar a la salida. Se selecciona automáticamente un filtro bilineal a menos que también se especifique el parámetro --filter. La forma matemática corresponde a: a b c d e f g h i La transformación se basa en coordenadas homogéneas. La matriz multiplicada por el vector de coordenadas de un píxel de la salida da el vector de coordenadas transformado de un píxel en el búfer gráfico. Más precisamente, el vector (x, y) del píxel de salida se extiende a 3 valores (x, y, w), con 1 como coordenada w, y se multiplica por la matriz. Las coordenadas finales del dispositivo del píxel se calculan entonces con la llamada división homogénea por la coordenada w transformada. En otras palabras, las coordenadas del dispositivo (x', y') del píxel transformado son: x' = (ax + by + c) / w' y y' = (dx + ey + f) / w' , donde w' = (gx + hy + i) . Normalmente, a y e corresponden a la escala en los ejes X e Y, c y f corresponden a la traslación en esos ejes, y g, h e i son respectivamente 0, 0 y 1. La matriz también se puede utilizar para expresar transformaciones más complejas, como la corrección trapezoidal o la rotación. Para una rotación de un ángulo T, se puede utilizar esta fórmula: cos T -sin T 0 sin T cos T 0 0 0 1 Como argumento especial, en lugar de pasar una matriz, se puede pasar la cadena "none", en cuyo caso se utilizarán los valores predeterminados (una matriz unitaria sin filtro).
--filter filtermode
Elige el método de filtrado de escala que se aplicará cuando la pantalla se escale o transforme. Puede ser 'bilinear' o 'nearest'.
--scale x[xy]
Cambia las dimensiones de la imagen de salida. Si se omite el valor y, el valor x se utilizará para ambas dimensiones. Los valores mayores que 1 dan como resultado una pantalla comprimida (la dimensión de la pantalla es mayor que la dimensión del modo de salida), y los valores menores que 1 dan como resultado un zoom en la salida. Esta opción es en realidad una versión abreviada de la opción --transform.
--scale-from wxh
Especifica el tamaño en píxeles del área del búfer de fotogramas que se mostrará en esta salida. Esta opción es en realidad una versión abreviada de la opción --transform.
--primary
Establece la salida como principal. Se ordenará primero en las solicitudes de geometría de Xinerama y RANDR.
Opciones de la versión 1.2 de RandR
Estas opciones solo están disponibles para los servidores X que admiten la versión 1.2 de RandR o posterior.
--prop, --properties
Esta opción hace que xrandr muestre el contenido de las propiedades de cada salida. --verbose también habilita --prop.
--fb widthxheight
Reconfigura la pantalla al tamaño especificado. Todos los monitores configurados deben caber dentro de este tamaño. Cuando no se proporciona esta opción, xrandr calcula el tamaño de pantalla más pequeño que contendrá el conjunto de salidas configuradas; esta opción proporciona una forma de anular ese comportamiento.
--fbmm ancho x alto
Establece el valor que se informa como tamaño físico de la pantalla X en su conjunto (unión de todos los monitores configurados). En las configuraciones con varios monitores con diferentes DPI, el valor no tiene un significado físico, pero puede ser utilizado por algunos clientes antiguos que no admiten RandR versión 1.2 para calcular una escala de fuente de referencia. Normalmente, xrandr restablece los valores de tamaño físico informados para mantener el DPI constante. Esto anula ese cálculo. El valor DPI predeterminado es 96.
--dpi dpi
--dpi from-output
Esto también establece el valor que se informa como tamaño físico de la pantalla X en su conjunto (unión de todos los monitores configurados). En las configuraciones con varios monitores con diferentes DPI, el valor no tiene un significado físico, pero puede ser utilizado por algunos clientes antiguos que no admiten RandR versión 1.2 para calcular una escala de fuente de referencia. Esta opción utiliza el valor DPI especificado o el DPI de la salida dada para calcular un tamaño físico apropiado utilizando el tamaño de píxel que se establecerá. Los valores típicos son el valor predeterminado (96 DPI), el DPI del único monitor en las configuraciones de un solo monitor o el DPI del monitor principal en las configuraciones de varios monitores.
--newmode nombre modo
Se pueden agregar nuevas líneas de modelo al servidor y luego asociarlas con las salidas. Esta opción realiza lo primero. El modo se especifica utilizando la sintaxis ModeLine para xorg.conf: reloj hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. flags puede ser cero o más de +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Varias herramientas permiten calcular la línea de modelo habitual a partir de una altura, un ancho y una frecuencia de actualización, por ejemplo, puede utilizar cvt.
--rmmode nombre
Esto elimina un modo del servidor si no se utiliza de otra manera.
--addmode salida nombre
Agrega un modo al conjunto de modos válidos para una salida.
--delmode salida nombre
Elimina un modo del conjunto de modos válidos para una salida.
Opciones por salida
--output salida
Selecciona una salida para reconfigurar. Utilice el nombre de la salida o el XID.
--auto Para las salidas conectadas pero deshabilitadas, esto las habilitará utilizando su primer modo preferido (o, algo cercano a 96 DPI si no tienen un modo preferido). Para las salidas desconectadas pero habilitadas, esto las deshabilitará.
--mode modo
Esto selecciona un modo. Utilice el nombre o el XID para el modo
--preferred
Esto selecciona el mismo modo que --auto, pero no habilita ni deshabilita automáticamente la salida.
--pos xxy
Posiciona la salida dentro de la pantalla utilizando coordenadas de píxel. En caso de que se aplique una reflexión o rotación, la traducción se aplica después de los efectos.
--rate frecuencia
Esto marca una preferencia por las frecuencias de actualización cercanas al valor especificado; cuando varios modos tienen el mismo nombre, esto seleccionará el que tenga la frecuencia de actualización más cercana.
--reflect reflection
Reflection puede ser 'normal', 'x', 'y' o 'xy'. Esto hace que el contenido de la salida se refleje a lo largo de los ejes especificados.
--rotate rotation
Rotation puede ser 'normal', 'left', 'right' o 'inverted'. Esto hace que el contenido de la salida se rote en la dirección especificada. 'right' especifica una rotación en el sentido de las agujas del reloj de la imagen y 'left' especifica una rotación en el sentido contrario a las agujas del reloj.
--left-of, --right-of, --above, --below, --same-as another-output
Use una de estas opciones para posicionar la salida en relación con la posición de otra salida. Esto permite un posicionamiento conveniente de las salidas dentro de la pantalla. La posición siempre se calcula en relación con la nueva posición de la otra salida, por lo que no es válido decir --output a --left-of b --output b --left-of a.
--set property value
Establece una propiedad de la salida. Las propiedades enteras pueden especificarse como una lista válida (ver --prop) de valores decimales o hexadecimales (con un prefijo 0x) separados por comas. Las propiedades atómicas se pueden establecer en cualquiera de los átomos válidos (ver --prop). Las propiedades de cadena se pueden establecer en cualquier valor.
--off Desactiva la salida.
--crtc crtc
Utiliza el crtc especificado (ya sea como índice en la lista de CRTC o como XID). En el uso normal, esta opción no es necesaria, ya que xrandr intenta tomar decisiones sensatas sobre qué crtc utilizar con cada salida. Cuando esto falla por alguna razón, esta opción puede anular la selección normal.
--gamma red[:green:blue]
Establece los valores de punto flotante especificados como corrección gamma en el crtc actualmente conectado a esta salida. Si no se especifican verde y azul, el valor rojo se utilizará para los tres componentes. Tenga en cuenta que no puede obtener dos valores diferentes para las salidas clonadas (es decir, que comparten el mismo crtc) y que cambiar una salida a otro crtc no cambia las correcciones gamma del crtc en absoluto.
--brightness brightness
Multiplica los valores gamma en el crtc actualmente conectado a la salida por el valor de punto flotante especificado. Útil para salidas demasiado brillantes o demasiado tenues. Sin embargo, esta es una modificación puramente de software; si su hardware tiene soporte para cambiar realmente el brillo, probablemente preferirá utilizar xbacklight.
Opciones de RandR versión 1.1
Estas opciones están disponibles para los servidores X que admiten RandR versión 1.1 o anterior. Siguen siendo válidas para los servidores X más recientes, pero no interactúan de forma coherente con las opciones de la versión 1.2 en la misma línea de comandos.
-s, --size size-index o --size widthxheight
Esto establece el tamaño de la pantalla, ya sea haciendo coincidir por tamaño o utilizando el índice en la lista de tamaños disponibles.
-r, --rate, --refresh rate
Esto establece la frecuencia de actualización más cercana al valor especificado.
-o, --orientation rotation
Esto especifica la orientación de la pantalla y puede ser normal, invertida, izquierda o derecha.
-x Refleja a lo largo del eje X.
-y Refleja a lo largo del eje Y.
EJEMPLOS
Establece una salida llamada LVDS en su modo preferido y, a su derecha, coloca una salida llamada VGA en el modo preferido de una pantalla que ha sido rotada físicamente en el sentido de las agujas del reloj: xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
Fuerza el uso de un modo de 1024x768 en una salida llamada 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
Habilita el desplazamiento en un escritorio de 1600x768 mientras se muestra un modo de 1024x768 en una salida llamada VGA: xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
Tiene una pequeña pantalla LVDS de 1280x800 que muestra una versión pequeña de un escritorio enorme de 3200x2000, y tiene una pantalla VGA grande que muestra el entorno del ratón a tamaño normal. xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA --pos 0x0 --panning 32002000+0+0/3200x2000+0+0/64/64/64/64
Muestra la salida VGA en forma de trapecio para que se corrija la distorsión en forma de prisma cuando el proyector está ligeramente por encima de la pantalla: xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
VÉASE TAMBIÉN
Xrandr(3), cvt(1), xkeystone(1), xbacklight(1)
AUTORES
Keith Packard, Open Source Technology Center, Intel Corporation, y Jim Gettys, Cambridge Research Laboratory, HP Labs, HP.