Sun ハードウェア Solaris リファレンスマニュアル

afbconfig(1M)

名前

afbconfig- AFB グラフィックスアクセラレータの設定

形式

/usr/sbin/afbconfig

-dev

device-filename

-res

video-mode

-file

-deflinear

-defoverlay

-linearorder

-overlayorder

-expvis

-sov

-maxwids

n

-extovl

-g

gamma-correction-value

-gfile

gamma-correction-file

-propt

-prconf

-defaults

-propt

-prconf

-help

-res

使用条件

SUNWafbcf

機能説明

afbconfig は、AFB グラフィックスアクセラレータおよび AFB 対応の X11 ウィンドウシステムのデフォルトの一部を設定します。

形式の項に記された afbconfig の第 1 の形式では、指定したオプションを OWconfig ファイルに保存します。これらのオプションは、次にウィンドウシステムをそのデバイスで実行するときに AFB デバイスを初期化するために使用されます。 OWconfig ファイル内のオプションの更新は、異なるウィンドウセッションや再起動したシステムでも有効となります。

-prconf、-propt、-help、 -res ? オプションだけを起動する第 2、第 3 の形式では、 OWconfig ファイルは更新されません。また、第 3 の形式では、その他のオプションはすべて無視されます。

オプションは、一度に 1 つの AFB デバイスに対してのみ指定することができます。複数の AFB デバイスに対してオプションを指定するには、 afbconfigを複数回起動する必要があります。

afbconfigで指定できるのは、AFB 固有のオプションだけです。デフォルトの表示色数、デフォルトのビジュアルクラスなどを指定する通常のウィンドウシステムのオプションは、openwin コマンド行のデバイス修飾子で指定してください (OpenWindows のマニュアルページの Xsun(1) を参照)。

ユーザーは、更新する OWconfig ファイルを指定することもできます。デフォルトでは、/etc/openwin ディレクトリツリーにあるマシン固有のファイルが更新されます。別のファイルを指定するには、 -file オプションを使用します。たとえば、/usr/openwin ディレクトリツリーにあるシステム共通の OWconfig ファイルを代わりに更新することができます。

これらの標準 OWconfig ファイルのどちらもスーパーユーザーのみが書き込みを行えます。したがって、スーパーユーザーが所有する afbconfig プログラムは、setuid による root の権限で実行されます。

オプション

-dev device-filename: AFB 特殊ファイルを指定します。デフォルトは /dev/fbs/afb0 です。
-file machine |system: 更新する OWconfig ファイルを指定します。 machine が指定された場合は、/etc/openwin ディレクトリツリーにあるマシン固有の OWconfig ファイルが使用されます。 system が指定された場合は、/usr/openwin ディレクトリツリーにある共通の OWconfig ファイルが使用されます。ファイルがない場合は、新たに生成されます。
-res video-mode [ now |try [ noconfirm |nocheck ] ]: 指定した AFB デバイスに接続されているモニターを制御する際に使われる表示モードを指定します。
組み込まれている表示モードの形式は次のとおりです。
widthxheightxrate: where width はピクセル単位のスクリーン幅、 height はピクセル単位のスクリーンの高さ、 rate は画面を垂直方向に再描画する周期です。 960x680x112s や 960x680x108s の s 接尾辞は、これらが立体表示モードであることを意味します。 640x480x60i や 768x575x50i の i 接尾辞は、インタレース表示タイミングを有効にします。この接尾辞がない場合は、ノンインタレースタイミングが使用されます。便宜上、-res にリフレッシュレートを指定する際、値の直前に x の代わりに @ を使用できます。たとえば、1280x1024@76 のように指定できます。 AFB が対応している一部の表示モードには、モニターが対応していない場合があります。また、AFB がサポートする表示モードにも、モニターがサポートしていないものがあります。AFB デバイスとモニターの両方がサポートしている表示モードのリストは、 -res ? オプション付きの afbconfig (コマンド形式の項に記された 3 番目の形式) を実行することによって得ることができます。AFB がサポートしている表示モードのリストを以下に示します。

1024x768x60
1024x768x70
1024x768x75
1024x768x77
1024x800x84
1152x900x66
1152x900x76
1280x800x76
1280x1024x60
1280x1024x67
1280x1024x76
960x680x112s	(立体表示)
960x680x108s	(立体表示)
640x480x60
640x480x60i	(インタレース)
768x575x50i	(インタレース)

記号名: 便宜上、上記の表示モードのいくつかには記号名が定義されています。 width x height x rate の形式の代わりに、記号名を -res の引数として指定することができます。記号名 none は、ウィンドウシステムを実行すると、画面の解像度は現在デバイスにプログラムされている表示モードになることを意味します。

記号名	対応する表示モード
svga	1024x768x60
1152	1152x900x76
1280	1280x1024x76
stereo	960x680x112s
ntsc	640x480x60i
pal	768x575x50i
none	(上記参照)

The -res オプションには、表示モードの直後に次の追加引数を指定することができます。追加引数は、単独でも複数でも指定できます。

now

OWconfig ファイルの表示モードを更新するとともに、AFB デバイスが指定した表示モードにただちにプログラムされます (この機能は、ウィンドウシステムを開始する前に表示モードを変更する際に便利です)。

注 :: 対象となるデバイスが稼働している間 (たとえば、ウィンドウシステムの稼働中) に、この追加オプションを afbconfig に指定することはお勧めしません。予期しない結果になることもあります。now オプションを指定して afbconfig コマンドを実行する場合は、最初にウィンドウシステムを終了してください。 now オプションがウィンドウシステムのセッション中に使用された場合、表示モードはただちに変更されますが、画面の幅や高さはそのセッションが終了して次のセッションに入るまで変更されません。さらに、立体表示モードではシステムが変更を認識しないことがあります。したがって、ウィンドウシステムの稼働中には絶対に now オプションを指定しないでください。

noconfirm

Using the -res オプションを指定した際に、システムが使用可能であっても、表示出力のない状態になる場合があります。このような状況は、特定のコードが読み込まれた際のモニターセンスコードにあいまいさがあった場合などに発生します。このような事態を避けるために afbconfig のデフォルトの動作では、この問題についての警告メッセージと、処理を継続するかどうかを確認するメッセージを表示します。 noconfirm オプションを指定すると、 afbconfig コマンドはこの確認をせずに、要求のあった表示モードにプログラムします。このオプションは、 afbconfig がシェルスクリプトから実行されている場合に便利です。

nocheck

このオプションを指定すると、(前述の) モニターセンスコードに基づく通常のエラーチェックが行われません。ユーザーによって指定された表示モードは、現在接続されているモニターに適切かどうかにかかわらず受け付けられます。このオプションは、AFB デバイスに異なるモニターを接続する場合に便利です。このオプションの指定は、noconfirm の指定も兼ねます。

try

このオプションを指定すると、指定した表示モードが試験的にプログラムされます。ユーザーは、指定した表示モードを使用する場合は、メッセージが表示されてから 10 秒以内に「y」を入力します。表示されたモードを使用しない場合は、10 秒以内に任意の文字を入力します。「y」または Return キー以外の文字の入力は、すべて「使用しない」と判断され、以前の表示モードに戻され、OWconfig ファイル中の表示モードは書き換えられません (その他の指定されたオプションは有効となります)。 Return キーの入力があった場合は、新しい表示モードを保持するかどうかを yes または no で確認するメッセージが表示されます。このオプションの指定は、now サブオプションの指定も兼ねます (now サブオプションの注意を参照)。

AFB には、2 種類の画像表示形式があります。リニア画像と非リニア画像です。: リニア画像はガンマ補正され、非リニア画像は補正されません。リニア画像版も非リニア画像版も、ともに持つ画像表示形式が 2 つあります。24 ビットトゥルーカラーと 8 ビットスタティックグレーです。 true のときは、デフォルトの画像表示形式として、デフォルトで選択されたオプション (特に、Xsun(1) の defdepth および defclass オプション。詳細は OpenWindows のマニュアルページを参照) を満たすリニア画像がセットされます。 false のとき、または他のデフォルトで選択されたオプションを満たすリニア画像がないときは、これらの他のオプションを満たす、非リニア画像がデフォルトとして選択されます。 AFB にはリニアオーバーレイ画像表示形式がないため、 -defoverlay オプションが存在するときには、このオプションを使用することはできません。
-defoverlay true | false: AFB が、残りの AFB 画像から切り離されたピクセルを持つ 8 ビット疑似カラー画像を提供します。これを、オーバーレイ画像といいます。この画像表示形式で作成されたウィンドウは、他の画像表示形式で作成されたウィンドウに影響を与えません。逆に、他の画像表示形式で作成されたウィンドウは、オーバーレイウィンドウに影響を与えます。この画像を使用して作成されたウィンドウで使用することができる色の数は extovl オプションの設定に依存します。 extovl オプションが有効になっている場合は、 256 種類の不透明カラーの値による拡張オーバーレイを使用することができます ( -extovl を参照)。 extovl が無効になっている場合は、拡張オーバーレイを使用することはできず、この画像には、不透明カラーの (256-maxwids) の値が使用されます (詳細は、 -maxwids オプションを参照してください)。このオプションの値が true である場合には、オーバーレイ画像がデフォルト画像になります。オプションの値が false の場合には、他のデフォルトで選択された defdepth および defclassオプションを満たすオーバーレイでない画像表示形式が、デフォルトの画像表示形式として選択されます。詳細は、OpenWindows のマニュアルページの Xsun(1) を参照してください。 -defoverlay true が使用されるときは、常に openwin コマンド行で選択されたデフォルトの深さとクラスは 8 ビット疑似カラーである必要があります。それ以外の場合は、警告メッセージが出力され、 -defoverlay オプションは false として扱われます。 -deflinear オプションが存在するときには、 AFB にはリニアオーバーレイ画像表示形式がないため、このオプションは使用することができません。
-linearorder first | last: first のときには、AFB スクリーン用の X11 スクリーン画像表示形式リスト上で、リニア画像が非リニア画像より前に表示されます。 last のときには、非リニア画像は、リニア画像より前に表示されます。
-overlayorder first |last: first のときには、AFB スクリーン用の X11 スクリーン画像表示形式リスト上で、8 ビット疑似カラーオーバーレイ画像が、非オーバーレイ画像より前に表示されます。 last のときには、非オーバーレイ画像は、オーバーレイ画像より前に表示されます。
-expvis enable |disable: enable にすると、OpenGL Visual Expansion が起動されます。選択された画像表示形式グループ (8 ビット Pseu- doColor、24 ビット TrueColor など) が画像表示形式リストに見つかります。
-sov enable |disable: enable にすると、ルートウィンドウの SERVER_OVERLAY_VISUALS 属性が有効になります。 SOV 画像が転送され、それらの透過タイプ、値、階層は、この属性によって参照することができます。 disable にすると、SERVER_OVERLAY_VISUALS 属性は定義されません。 SOV 画像は転送されません。
-maxwids n: このオプションは extovl が無効になっている場合のみ使用することができます。ウィンドウ ID (WID) として使用するために予約される最大数の AFB チャネルピクセル値を指定します。オーバーレイカラーマップのピクセル値の残りは、通常の X11 の未使用のカラーピクセルのために使用されます。確保された WID は、 (XGL などの) 3 次元グラフィックスウィンドウ、MBX ウィンドウと、デフォルト以外の画像表示形式をもつウィンドウにより発生順に割り当てられます。 X チャネルコードの 0 から (255-n) は、未使用のカラーピクセルです。 (255-n+1) から 255 の X チャネルコードは、 WID として使用するために予約されます。適切な値は、1、2、4、8、16、32 です。
-extovl enable |disable: enable にすると、拡張オーバーレイを使用することができます。このオーバーレイ画像には 256 種類の不透明カラーがあります。 SOV 画像には 255 種類の不透明カラーと 1 種類の透明カラーがあります。また、このオプションは、ハードウェアによる透明カラーを有効にするため、 SOV 画像を使用するウィンドウで、より高い性能が得られます。
-g gamma-correction value: このオプションによって、ガンマ補正の値を変えることができます。すべてのリニア画像ではガンマ補正を使用することができます。デフォルトでは、ガンマ補正の値は 2.22 です。 0 より小さい値は無効 (不正) です。このオプションは、ウィンドウシステムが稼動しているときに使用することができます。ガンマ補正の値を変更すると、リニア画像を使用して表示されているすべてのウィンドウが影響を受けます。
-gfile gamma-correction file: このオプションは、指定されたファイルからガンマ補正表を読み込みます。このファイルは、各行が R、G、B チャネルの値を持つように書式化されている必要があります。それらの値は、16 進数で指定し、値と値の間は 1 つ以上のスペースで区切ります。また、このファイルは、そのような 3 つの値の組が 256 種類定義されます。このファイルの例を以下に示します。

0x00 0x00 0x00
0x01 0x01 0x01
0x02 0x02 0x02
...
...
0xff 0xff 0xff

このオプションを使用することによって、

ウィンドウシステムが稼動しているときにガンマ補正表を読み込むことができます。新しいガンマ補正は、このリニア画像によって表示されているすべてのウィンドウに影響を与えます。ユーザーが指定した表によってガンマ補正を行う際は、ガンマ補正の値は定義されません。デフォルトでは、ウィンドウシステムはガンマ補正値として 2.22 を使用し、このガンマ補正値に対応してウィンドウシステムが作成したガンマ補正表を読み込みます。

-defaults

すべてのオプションの値をそれぞれのデフォルト値に戻します。

-propt

オプションで指定された OWconfig ファイルに書かれた AFB オプションの値のうち、 -dev オプションで指定されたデバイスに対するものすべてを表示します。 afbconfig の呼び出しが終了した後に、 OWconfig ファイルに書き込まれるオプションの値を表示します。次に表示例を示します。

--- OpenWindows Configuration for /dev/fbs/afb0 ---
OWconfig: machine
Video Mode: 1280x1024x76
Default Visual: Non-Linear Normal Visual
Visual Ordering: Linear Visuals are last
                 Overlay Visuals are last
OpenGL Visual Expansion: enabled
Server Overlay Visuals: enabled
Extended Overlay: enabled
Underlay WIDs: 64 (not configurable)
Overlay WIDs: 4 (not configurable)
Gamma Correction Value: 2.220000
Gamma Correction Table: Available

-prconf

AFB ハードウェア構成を表示します。次に表示例を示します。

--- Hardware Configuration for /dev/fbs/afb0 ---
Type: double-buffered AFB with Z-buffer
Board: rev 0 (Horizontal)
Number of Floats: 6
PROM Information: @(#)afb.fth x.xx xx/xx/xx 
AFB ID: 0x101df06d
DAC: Brooktree 9070, version 1 (Pac2)
3DRAM: Mitsubishi 130a, version x
EDID Data: Available - EDID version 1 revision x
Monitor Sense ID: 4  (Sun 37x29cm RGB color monitor)
Monitor possible resolutions: 1024x768x77, 1024x800x84, 1152x900x66,
        1152x900x76, 1280x1024x67, 1280x1024x76, 960x680x112s, 960x680x108s
Current resolution setting: 1280x1024x76

-help

コマンド行のオプションと機能の概要を一覧で表示します。

デフォルト

コマンド行で指定されていないオプションについては、対応する OWconfig ファイル中のオプションは更新されず、ファイル内の値がそのまま使用されます。

ウィンドウシステムを実行する際に、 afbconfig による AFB オプションの指定がまったくなかった場合は、デフォルト値が使用されます。オプションのデフォルトは次のとおりです。

オプション	デフォルト値
-dev	/dev/fbs/afb0
-file	machine
-res	none
-deflinear	false
-defoverlay	false
-linearorder	last
-overlayorder	last
-expvis	enabled
-sov	enabled
-maxwids	32
-extovl	enabled
-g	2.22

-res オプションのデフォルト値 none とは、ウィンドウシステムが実行された場合に、画面解像度がそのデバイスに現在プログラムされている表示モードになることを意味しています。

注 :: これによって、PROM によってデバイスの解像度を指定しているユーザーとの共用性が保てます。 (GX などの) 一部のデバイスでは、PROM が表示モードを指定する唯一の手段です。これは、デフォルトの AFB 表示モードは、最終的に PROM によって決まることを意味しています。

使用例

例 1 モニターの種類を、垂直周波数 76 Hz で解像度 1280 * 1024 に変更する例を以下に示します。

: example% /usr/sbin/afbconfig -res 1280x1024x76

ファイル

/dev/fbs/afb0: デバイス特殊ファイル