xrandr - interface de linha de comando básica para a extensão RandR
SINTAXE
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]
DESCRIÇÃO
Xrandr é usado para definir o tamanho, a orientação e/ou a reflexão das saídas para uma tela. Ele também pode definir o tamanho da tela.
Se invocado sem nenhuma opção, ele exibirá o estado das saídas, mostrando os modos existentes para cada uma delas, com um '+' após os modos preferenciais e um '*' após o modo atual.
Existem algumas opções globais. Outras opções modificam a última saída que é especificada em parâmetros anteriores na linha de comando. Várias saídas podem ser modificadas ao mesmo tempo, passando várias opções --output seguidas imediatamente por suas opções de modificação correspondentes.
--help Imprime um resumo do uso e sai.
-v, --version
Imprime a versão do RandR relatada pelo servidor X e sai.
--verbose
Faz com que o xrandr seja mais detalhado. Quando usado com -q (ou sem outras opções), o xrandr exibirá mais informações sobre o estado do servidor. Observe que as informações de gama e brilho são apenas aproximações do perfil de cores completo armazenado no servidor. Quando usado juntamente com opções que reconfiguram o sistema, o progresso será relatado durante a execução das alterações de configuração.
-q, --query
Quando esta opção está presente, ou quando nenhuma alteração de configuração é solicitada, o xrandr exibirá o estado atual do sistema.
--dryrun
Executa todas as ações especificadas, exceto que nenhuma alteração é feita.
--nograb
Aplica as modificações sem capturar a tela. Evita bloquear outros aplicativos durante a atualização, mas também pode fazer com que alguns aplicativos que detectam o redimensionamento da tela recebam valores antigos.
-d, --display nome
Esta opção seleciona o display X a ser usado. Observe que isso se refere à abstração de tela X, e não ao monitor (ou saída).
--screen snum
Esta opção seleciona qual tela manipular. Observe que isso se refere à abstração de tela X, e não ao monitor (ou saída).
--q1 Força o uso do protocolo RandR versão 1.1, mesmo que uma versão superior esteja disponível.
--q12 Força o uso do protocolo RandR versão 1.2, mesmo que o display não o reporte como suportado ou uma versão superior esteja disponível.
Opções da versão 1.5 do RandR
As opções para RandR 1.5 são usadas como um superconjunto das opções para RandR 1.4.
--listmonitors
Relata informações sobre todos os monitores definidos.
--listactivemonitors
Relata informações sobre os monitores ativos atualmente.
--setmonitor nome geometria saídas
Define um novo monitor com a geometria fornecida e associado às saídas fornecidas. A lista de saídas é ou a palavra-chave none ou uma lista separada por vírgulas de saídas. A geometria é ou a palavra-chave auto, caso em que o monitor rastreará automaticamente a geometria das saídas associadas, ou uma especificação manual no formato w/mmwxh/mmh+x+y, onde w, h, x, y estão em pixels e mmw, mmh são as dimensões físicas do monitor.
--delmonitor nome
Exclui o monitor definido pelo usuário fornecido.
Opções da versão 1.4 do RandR
As opções para RandR 1.4 são usadas como um superconjunto das opções para RandR 1.3.
--listproviders
Relata informações sobre os provedores disponíveis.
--setprovideroutputsource provedor fonte
Define fonte como a fonte de saída de imagens de exibição para provedor. Isso só é possível se fonte e provedor tiverem os recursos Source Output e Sink Output, respectivamente. Se fonte for 0x0, o provedor será desconectado de sua fonte de saída atual.
--setprovideroffloadsink provedor coletor
Define provedor como um dispositivo de descarregamento de renderização para coletor. Isso só é possível se provedor e coletor tiverem os recursos Source Offload e Sink Offload, respectivamente. Se coletor for 0x0, o provedor será desconectado de seu coletor de descarregamento de renderização atual.
Opções da versão 1.3 do RandR
As opções para RandR 1.3 são usadas como um superconjunto das opções para RandR 1.2.
--current
Retorna a configuração de tela atual, sem pesquisar por alterações de hardware.
--noprimary
Não define uma saída primária.
Opções por saída
--panning larguraxaltura[+x+y[/track_widthxtrack_height+track_x+track_y[/border_left/border_top/border_right/border_bottom]]]
Esta opção define os parâmetros de panning. Assim que o panning for habilitado, a posição do CRTC pode mudar a cada movimento do ponteiro. Os quatro primeiros parâmetros especificam a área total de panning, os quatro seguintes a área de rastreamento do ponteiro (que assume como padrão a mesma área). Os quatro parâmetros finais especificam a borda e o padrão é 0. Uma largura ou altura definida como zero desabilita o panning no eixo correspondente. Normalmente, você também precisa definir o tamanho da tela com --fb simultaneamente.
--transform a,b,c,d,e,f,g,h,i
Especifica uma matriz de transformação a ser aplicada na saída. Um filtro bilinear é selecionado automaticamente, a menos que o parâmetro --filter também seja especificado. A forma matemática corresponde a: a b c d e f g h i A transformação é baseada em coordenadas homogêneas. A matriz multiplicada pelo vetor de coordenadas de um pixel da saída fornece o vetor de coordenadas transformado de um pixel no buffer gráfico. Mais precisamente, o vetor (x y) do pixel de saída é estendido para 3 valores (x y w), com 1 como a coordenada w, e multiplicado pela matriz. As coordenadas finais do dispositivo do pixel são então calculadas com a chamada divisão homogênea pela coordenada w transformada. Em outras palavras, as coordenadas do dispositivo (x' y') do pixel transformado são: x' = (ax + by + c) / w' e y' = (dx + ey + f) / w' , com w' = (gx + hy + i) . Tipicamente, a e e correspondem à escala nos eixos X e Y, c e f correspondem à translação nesses eixos e g, h e i são, respectivamente, 0, 0 e 1. A matriz também pode ser usada para expressar transformações mais complexas, como correção de distorção trapezoidal ou rotação. Para uma rotação de um ângulo T, esta fórmula pode ser usada: cos T -sin T 0 sin T cos T 0 0 0 1 Como um argumento especial, em vez de passar uma matriz, pode-se passar a string "none", caso em que os valores padrão são usados (uma matriz unitária sem filtro).
--filter filtermode
Escolhe o método de filtro de escala a ser aplicado quando a tela é redimensionada ou transformada. Pode ser 'bilinear' ou 'nearest'.
--scale x[xy]
Altera as dimensões da imagem de saída. Se o valor y for omitido, o valor x será usado para ambas as dimensões. Valores maiores que 1 levam a uma tela comprimida (a dimensão da tela maior do que a dimensão do modo de saída) e valores menores que 1 levam a um zoom na saída. Esta opção é, na verdade, uma versão abreviada da opção --transform.
--scale-from wxh
Especifica o tamanho em pixels da área do framebuffer a ser exibida nesta saída. Esta opção é, na verdade, uma versão abreviada da opção --transform.
--primary
Define a saída como primária. Ela será classificada primeiro nas solicitações de geometria Xinerama e RANDR.
Opções da versão 1.2 do RandR
Essas opções estão disponíveis apenas para servidores X que suportam a versão 1.2 ou mais recente do RandR.
--prop, --properties
Esta opção faz com que o xrandr exiba o conteúdo das propriedades para cada saída. --verbose também habilita --prop.
--fb widthxheight
Reconfigura a tela para o tamanho especificado. Todos os monitores configurados devem caber dentro deste tamanho. Quando esta opção não é fornecida, o xrandr calcula o menor tamanho de tela que conterá o conjunto de saídas configuradas; esta opção fornece uma maneira de substituir esse comportamento.
--fbmm widthxheight
Define o valor relatado como o tamanho físico da tela X como um todo (união de todos os monitores configurados). Em configurações com vários monitores com DPIs diferentes, o valor não tem significado físico, mas pode ser usado por alguns clientes legados que não suportam a versão 1.2 do RandR para calcular uma escala de fonte de referência. Normalmente, o xrandr redefine os valores de tamanho físico relatados para manter o DPI constante. Isso substitui esse cálculo. O valor padrão do DPI é 96.
--dpi dpi
--dpi from-output
Isso também define o valor relatado como o tamanho físico da tela X como um todo (união de todos os monitores configurados). Em configurações com vários monitores com DPIs diferentes, o valor não tem significado físico, mas pode ser usado por alguns clientes legados que não suportam a versão 1.2 do RandR para calcular uma escala de fonte de referência. Esta opção usa o valor DPI especificado ou o DPI da saída fornecida para calcular um tamanho físico apropriado usando o tamanho de pixel que será definido. Valores típicos são o padrão (96 DPI), o DPI do único monitor em configurações de monitor único ou o DPI do monitor primário em configurações de vários monitores.
--newmode name mode
Novos modelines podem ser adicionados ao servidor e, em seguida, associados a saídas. Esta opção faz o primeiro. O modo é especificado usando a sintaxe ModeLine para xorg.conf: clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal flags. flags pode ser zero ou mais de +HSync, -HSync, +VSync, -VSync, Interlace, DoubleScan, CSync, +CSync, -CSync. Várias ferramentas permitem calcular o modeline usual a partir de uma altura, largura e taxa de atualização, por exemplo, você pode usar cvt.
--rmmode name
Isso remove um modo do servidor se ele não estiver sendo usado.
--addmode output name
Adicione um modo ao conjunto de modos válidos para uma saída.
--delmode output name
Remova um modo do conjunto de modos válidos para uma saída.
Opções por saída
--output output
Seleciona uma saída para reconfigurar. Use o nome da saída ou o XID.
--auto Para saídas conectadas, mas desativadas, isso as habilitará usando seu primeiro modo preferido (ou, algo próximo de 96 DPI, se não tiverem um modo preferido). Para saídas desconectadas, mas habilitadas, isso as desativará.
--mode mode
Isso seleciona um modo. Use o nome ou o XID para o modo.
--preferred
Isso seleciona o mesmo modo que --auto, mas não habilita ou desabilita automaticamente a saída.
--pos xxy
Posicione a saída dentro da tela usando coordenadas de pixel. No caso de reflexão ou rotação serem aplicadas, a tradução é aplicada após os efeitos.
--rate rate
Isso indica uma preferência por taxas de atualização próximas ao valor especificado. Quando vários modos têm o mesmo nome, isso selecionará aquele com a taxa de atualização mais próxima.
--reflect reflection
Reflection pode ser 'normal', 'x', 'y' ou 'xy'. Isso faz com que o conteúdo da saída seja refletido ao longo dos eixos especificados.
--rotate rotation
Rotation pode ser 'normal', 'left', 'right' ou 'inverted'. Isso faz com que o conteúdo da saída seja rotacionado na direção especificada. 'right' especifica uma rotação no sentido horário da imagem e 'left' especifica uma rotação no sentido anti-horário.
--left-of, --right-of, --above, --below, --same-as another-output
Use uma dessas opções para posicionar a saída em relação à posição de outra saída. Isso permite um posicionamento conveniente das saídas na tela. A posição é sempre calculada em relação à nova posição da outra saída, portanto, não é válido usar --output a --left-of b --output b --left-of a.
--set property value
Define uma propriedade de saída. As propriedades inteiras podem ser especificadas como uma lista válida (veja --prop) de valores decimais ou hexadecimais (com um prefixo 0x) separados por vírgula. As propriedades atômicas podem ser definidas para qualquer um dos átomos válidos (veja --prop). As propriedades de string podem ser definidas para qualquer valor.
--off Desativa a saída.
--crtc crtc
Usa o crtc especificado (seja como um índice na lista de CRTCs ou XID). Em uso normal, esta opção não é necessária, pois o xrandr tenta fazer escolhas sensatas sobre qual crtc usar para cada saída. Quando isso falha por algum motivo, esta opção pode substituir a seleção normal.
--gamma red[:green:blue]
Define os valores de ponto flutuante especificados como correção de gama no crtc atualmente anexado a esta saída. Se o verde e o azul não forem especificados, o valor vermelho será usado para todos os três componentes. Observe que você não pode obter dois valores diferentes para saídas clonadas (ou seja, que compartilham o mesmo crtc) e que alternar uma saída para outro crtc não altera as correções de gama do crtc.
--brightness brightness
Multiplica os valores de gama no crtc atualmente anexado à saída pelo valor de ponto flutuante especificado. Útil para saídas excessivamente brilhantes ou excessivamente escuras. No entanto, esta é uma modificação apenas de software; se o seu hardware tiver suporte para alterar realmente o brilho, você provavelmente preferirá usar o xbacklight.
Opções da versão 1.1 do RandR
Essas opções estão disponíveis para servidores X que suportam a versão 1.1 do RandR ou versões anteriores. Elas ainda são válidas para servidores X mais recentes, mas não interagem de forma sensata com as opções da versão 1.2 na mesma linha de comando.
-s, --size size-index ou --size widthxheight
Isso define o tamanho da tela, seja correspondendo pelo tamanho ou usando o índice na lista de tamanhos disponíveis.
-r, --rate, --refresh rate
Isso define a taxa de atualização mais próxima do valor especificado.
-o, --orientation rotation
Isso especifica a orientação da tela e pode ser normal, invertida, esquerda ou direita.
-x Reflete ao longo do eixo X.
-y Reflete ao longo do eixo Y.
EXEMPLOS
Define uma saída chamada LVDS para seu modo preferido e, à direita, coloca uma saída chamada VGA no modo preferido de uma tela que foi fisicamente rotacionada no sentido horário: xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
Força o uso de um modo 1024x768 em uma saída chamada 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 o pan em uma área de trabalho de 1600x768, exibindo o modo 1024x768 em uma saída chamada VGA: xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
Tenha uma pequena tela LVDS de 1280x800 exibindo uma versão pequena de uma enorme área de trabalho de 3200x2000, e tenha uma grande tela VGA exibindo a área ao redor do mouse em tamanho 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
Exibe a saída VGA em forma de trapézio, de modo que seja corrigida para projeção em keystone quando o projetor estiver ligeiramente acima da tela: xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
VEJA TAMBÉM
Xrandr(3), cvt(1), xkeystone(1), xbacklight(1)
AUTORES
Keith Packard, Open Source Technology Center, Intel Corporation. e Jim Gettys, Cambridge Research Laboratory, HP Labs, HP.