xrandr - RandR 拡張に対する基本的なコマンドラインインターフェース
SYNOPSIS
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]
DESCRIPTION
Xrandr は、画面の出力のサイズ、向き、またはリフレクションを設定するために使用されます。 また、画面のサイズを設定することもできます。
オプションなしで呼び出された場合、出力の状態をダンプし、それぞれに既存のモードを表示します。
"+" は優先モード、"*" は現在のモードを示します。
いくつかのグローバルオプションがあります。他のオプションは、コマンドライン内の以前のパラメータで指定された最後の出力に適用されます。複数の --output オプションと、それに続く対応する変更オプションを渡すことで、複数の出力を同時に変更できます。
--help
使用法の概要を表示して終了します。
-v, --version
X サーバーによって報告された RandR バージョンを表示して終了します。
--verbose
これにより、xrandr がより詳細になります。`-q` (または他のオプションなし) と組み合わせて使用すると、xrandr はサーバーの状態に関するより多くの情報を表示します。ただし、gamma と brightness の情報は、サーバーに保存されている完全なカラープロファイルの近似値にすぎないことに注意してください。システムを再構成するオプションと共に使用すると、構成の変更を実行しながら、進行状況が報告されます。
-q, --query
このオプションが存在する場合、または構成の変更が要求されない場合、xrandr は現在のシステムの状態を表示します。
--dryrun
指定されたすべての操作を実行しますが、変更は行いません。
--nograb
画面キャプチャを行わずに変更を適用します。これにより、更新中に他のアプリケーションがブロックされるのを防ぎますが、画面サイズ変更を検出する一部のアプリケーションには古い値が渡される可能性があります。
-d, --display 名前
このオプションは、使用する X ディスプレイを選択します。これは、モニター（または出力）ではなく、X スクリーン抽象化を指します。
--screen 番号
このオプションは、操作するスクリーンを選択します。これは、モニター（または出力）ではなく、X スクリーン抽象化を指します。
--q1 利用可能な場合でも、RandR バージョン 1.1 プロトコルの使用を強制します。
--q12 ディスプレイがサポートしていると報告しない場合、またはより高いバージョンが利用可能な場合でも、RandR バージョン 1.2 プロトコルの使用を強制します。
RandR バージョン 1.5 のオプション
RandR 1.5 のオプションは、RandR 1.4 のオプションのスーパーセットとして使用されます。
--listmonitors
定義されたすべてのモニターに関する情報を報告します。
--listactivemonitors
現在アクティブなモニターに関する情報を報告します。
--setmonitor 名前 ジオメトリ 出力
指定されたジオメトリで新しいモニターを定義し、指定された出力に関連付けます。出力リストはキーワード none またはコンマで区切られた出力のリストです。ジオメトリは、キーワード auto であり、この場合、モニターは関連付けられた出力のジオメトリを自動的に追跡するか、w/mmwxh/mmh+x+y の形式での手動指定です。ここで、w、h、x、y はピクセル単位、mmw、mmh はモニターの物理的寸法です。
--delmonitor 名前
指定されたユーザー定義のモニターを削除します。
RandR バージョン 1.4 のオプション
RandR 1.4 のオプションは、RandR 1.3 のオプションのスーパーセットとして使用されます。
--listproviders
利用可能なプロバイダーに関する情報を報告します。
--setprovideroutputsource プロバイダー ソース
ソースをプロバイダーのディスプレイ出力画像のソースとして設定します。これは、ソースとプロバイダーがそれぞれソース出力とシンク出力の機能を持っている場合にのみ可能です。ソースが 0x0 の場合、プロバイダーは現在の出力ソースから切断されます。
--setprovideroffloadsink プロバイダー シンク
プロバイダーをシンクのレンダリングオフロードデバイスとして設定します。これは、プロバイダーとシンクがそれぞれソースオフロードとシンクオフロードの機能を持っている場合にのみ可能です。シンクが 0x0 の場合、プロバイダーは現在のレンダリングオフロードシンクから切断されます。
RandR バージョン 1.3 のオプション
RandR 1.3 のオプションは、RandR 1.2 のオプションのスーパーセットとして使用されます。
--current
ハードウェアの変更をポーリングせずに、現在のスクリーン構成を返します。
--noprimary
プライマリ出力の定義を行いません。
出力ごとのオプション
--panning 幅x高さ[+x+y[/追跡_幅x追跡_高さ+追跡_x+追跡_y[/境界_左/境界_上/境界_右/境界_下]]]
このオプションは、パンニングパラメータを設定します。パンニングが有効になるとすぐに、CRTC の位置はポインタの移動ごとに変更される可能性があります。最初の 4 つのパラメータは、総パンニング領域を指定し、次の 4 つのパラメータは、ポインタ追跡領域を指定します（デフォルトは同じ領域です）。最後の 4 つのパラメータは境界を指定し、デフォルトは 0 です。幅または高さを 0 に設定すると、対応する軸でのパンニングが無効になります。通常、--fb を使用して同時に画面サイズを設定する必要があります。
--transform a,b,c,d,e,f,g,h,i
出力に適用する変換行列を指定します。双線形フィルタが自動的に選択されますが、--filter パラメータも指定すると、別のフィルタを選択できます。数式は次のようになります。 a b c d e f g h i 変換は同次座標に基づいています。行列に、出力ピクセルの座標ベクトルを乗算することで、グラフィックバッファ内のピクセルの変換された座標ベクトルが得られます。具体的には、出力ピクセルのベクトル (x y) を 3 つの値 (x y w) に拡張し、w 座標に 1 を設定して行列に乗算します。最終的なデバイス座標 (x' y') は、いわゆる同次除算によって、変換された w 座標で計算されます。つまり、変換されたピクセルのデバイス座標は次のようになります。 x' = (ax + by + c) / w' および y' = (dx + ey + f) / w' 、 ここで w' = (gx + hy + i) です。 通常、a と e は X 軸と Y 軸のスケールに対応し、c と f はそれらの軸の平行移動に対応し、g、h、i はそれぞれ 0、0、1 です。この行列を使用して、キーストーン補正や回転などのより複雑な変換を表現することもできます。角度 T での回転の場合、次の式を使用できます。 cos T -sin T 0 sin T cos T 0 0 0 1 特別な引数として、行列の代わりに文字列「none」を渡すこともでき、この場合、デフォルト値 (単位行列、フィルタなし) が使用されます。
--filter filtermode
画面がスケールまたは変換されるときに適用するスケーリングフィルタのメソッドを選択します。'bilinear' または 'nearest' のいずれかになります。
--scale x[xy]
出力画像のサイズを変更します。y の値が省略された場合、x の値が両方の次元で使用されます。1 より大きい値は、画面の寸法が出力モードの寸法よりも大きく、圧縮された画面になります。1 より小さい値は、出力のズームインになります。このオプションは、実際には --transform オプションのショートカットバージョンです。
--scale-from wxh
この出力に表示されるフレームバッファの領域のピクセル単位のサイズを指定します。このオプションは、実際には --transform オプションのショートカットバージョンです。
--primary
出力をプライマリとして設定します。Xinerama および RANDR ジオメトリ要求で最初にソートされます。
RandR バージョン 1.2 オプション
これらのオプションは、RandR バージョン 1.2 以降をサポートする X サーバーでのみ使用できます。
--prop、--properties
このオプションにより、xrandr は各出力のプロパティの内容を表示します。--verbose も --prop を有効にします。
--fb widthxheight
画面を特定のサイズに再構成します。構成されたすべてのモニターは、このサイズに収まる必要があります。このオプションが指定されていない場合、xrandr は、構成されたすべての出力に収まる最小の画面サイズを計算します。このオプションを使用すると、その動作をオーバーライドできます。
--fbmm 幅x高さ
Xスクリーンの物理的なサイズ全体（構成されたすべてのモニターの結合）として報告される値を設定します。異なるDPIの複数のモニターで構成されている場合、この値は物理的な意味を持ちませんが、RandRバージョン1.2をサポートしていない一部のレガシークライアントで使用され、参照フォントスケーリングを計算する場合があります。通常、xrandrは、DPIを一定に保つために、報告された物理的なサイズ値をリセットします。このオプションは、その計算をオーバーライドします。デフォルトのDPI値は96です。
--dpi dpi
--dpi from-output
これも、Xスクリーンの物理的なサイズ全体（構成されたすべてのモニターの結合）として報告される値を設定します。異なるDPIの複数のモニターで構成されている場合、この値は物理的な意味を持ちませんが、RandRバージョン1.2をサポートしていない一部のレガシークライアントで使用され、参照フォントスケーリングを計算する場合があります。このオプションは、指定されたDPI値、または指定された出力のDPIを使用して、適切な物理サイズを計算します。これは、設定するピクセルサイズを使用します。一般的な値は、デフォルト（96 DPI）、シングルモニター構成の唯一のモニターのDPI、またはマルチモニター構成のプライマリモニターのDPIです。
--newmode 名前 モード
新しいモデルインをサーバーに追加し、次にそれらを出力に関連付けることができます。このオプションは、前者の処理を行います。モードは、xorg.confのModeLine構文を使用して指定されます：clock hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal フラグ。フラグは、+HSync、-HSync、+VSync、-VSync、Interlace、DoubleScan、CSync、+CSync、-CSyncのうち、0個またはそれ以上の組み合わせにすることができます。高さ、幅、およびリフレッシュレートから通常の使用されるモデルインを計算するために使用できるツールがいくつかあります。たとえば、cvtを使用できます。
--rmmode 名前
このオプションは、サーバーからモードを削除します。ただし、そのモードがそうでない場合、未使用である必要があります。
--addmode 出力 名前
出力の有効なモードのセットにモードを追加します。
--delmode 出力 名前
出力の有効なモードのセットからモードを削除します。
出力ごとのオプション
--output 出力
再構成する出力を選択します。出力の名前またはXIDを使用します。
--auto 接続されているが無効になっている出力の場合、これはそれらを有効にして、最初の優先モード（または、優先モードがない場合は96dpiに近いモード）を使用します。切断されているが有効になっている出力の場合、これはそれらを無効にします。
--mode モード
モードを選択します。名前またはXIDを使用してモードを指定します。
--preferred
これは、--autoと同じモードを選択しますが、自動的に出力を有効または無効にすることはありません。
--pos x,y
出力が適用されている場合、翻訳は効果が適用された後に適用されます。画面内の出力の位置をピクセル座標を使用して設定します。
--rate 速度
複数のモードが同じ名前を持つ場合、これは指定された値に近いリフレッシュレートを優先することを示します。これは、最も近いリフレッシュレートを持つモードを選択します。
--reflect reflection
Reflection は、'normal'、'x'、'y'、または 'xy' のいずれかになります。これにより、出力コンテンツが指定された軸に対して反転されます。
--rotate rotation
Rotation は、'normal'、'left'、'right'、または 'inverted' のいずれかになります。これにより、出力コンテンツが指定された方向に回転されます。'right' は、画像を時計回りに回転させ、'left' は、反時計回りに回転させます。
--left-of、--right-of、--above、--below、--same-as another-output
これらのオプションのいずれかを使用して、別の出力の位置に対して出力を配置します。これにより、画面内の出力を便利に配置できます。位置は常に、他の出力の新しい位置に対して計算されるため、--output a --left-of b --output b --left-of a のように指定することはできません。
--set property value
出力プロパティを設定します。整数プロパティは、有効な (「--prop」を参照) 10 進数または 16 進数 (先頭に 0x を付ける) の値をカンマで区切ったリストとして指定できます。アトムプロパティは、有効なアトム (「--prop」を参照) のいずれかに設定できます。文字列プロパティは、任意の値を設定できます。
--off 出力を無効にします。
--crtc crtc
指定された crtc (CRTC のリスト内のインデックスまたは XID として) を使用します。通常の使用では、このオプションは必要ありません。xrandr は、各出力に対して適切な CRTC を選択しようとします。それが何らかの理由で失敗した場合、このオプションを使用して、通常の選択をオーバーライドできます。
--gamma red[:green:blue]
この出力にアタッチされている CRTC で、指定された浮動小数点値をガンマ補正として設定します。緑と青が指定されていない場合、赤の値はすべて3つのコンポーネントに使用されます。ただし、クローンされた出力 (同じ CRTC を共有する出力) で異なる値を取得することはできず、出力を別の CRTC に切り替えても、CRTC ガンマ補正は変更されません。
--brightness brightness
この出力にアタッチされている CRTC で、ガンマ値に指定された浮動小数点値を掛けます。明るすぎる、または暗すぎる出力に役立ちます。ただし、これはソフトウェアのみの変更であり、ハードウェアが実際に明るさを変更する機能を備えている場合は、xbacklight を使用する方が良いでしょう。
RandR バージョン 1.1 のオプション
これらのオプションは、RandR バージョン 1.1 またはそれ以前をサポートする X サーバーで使用できます。新しい X サーバーでも有効ですが、同じコマンドラインでバージョン 1.2 のオプションと組み合わせて使用すると、適切に機能しません。
-s、--size size-index または --size widthxheight
これにより、画面サイズが、サイズに一致するか、利用可能なサイズのリスト内のインデックスを使用して設定されます。
-r、--rate、--refresh rate
これにより、指定された値に最も近いリフレッシュレートが設定されます。
-o、--orientation rotation
これにより、画面の向きが指定され、'normal'、'inverted'、'left'、または 'right' のいずれかになります。
-x X 軸に対して反転します。
-y Y 軸に対して反転します。
例
LVDS という名前の出力を、その優先モードに設定し、右側に、物理的に時計回りに回転された画面の優先モードを持つ VGA という名前の出力を配置します。 xrandr --output LVDS --auto --rotate normal --pos 0x0 --output VGA --auto --rotate left --right-of LVDS
VGAという出力に1024x768モードを強制的に使用させます。 xrandr --newmode "1024x768" 63.50 1024 1072 1176 1328 768 771 775 798 -hsync +vsync xrandr --addmode VGA 1024x768 xrandr --output VGA --mode 1024x768
1600x768のデスクトップで、VGAという出力に1024x768モードを表示しながら、パンニングを有効にします。 xrandr --fb 1600x768 --output VGA --mode 1024x768 --panning 1600x0
小さな1280x800のLVDSスクリーンに、大きな3200x2000のデスクトップの縮小版を表示し、大きなVGAスクリーンにマウスの周囲を通常サイズで表示します。 xrandr --fb 3200x2000 --output LVDS --scale 2.5x2.5 --output VGA --pos 0x0 --panning 32002000+0+0/3200x2000+0+0/64/64/64/64
プロジェクターが画面よりもわずかに上にある場合に、VGA出力を台形にしてキーストーン補正を行います。 xrandr --fb 1024x768 --output VGA --transform 1.24,0.16,-124,0,1.24,0,0,0.000316,1
関連項目
Xrandr(3), cvt(1), xkeystone(1), xbacklight(1)
著者
キース・パカード、インテル・コーポレーション・オープンソース・テクノロジー・センター。およびジム・ゲティス、ヒューレット・パッカード・ラボ、ヒューレット・パッカード。