書式

Section "Device"
Identifier "devname"
Driver "s3virge"
  ...
  [ Option "optionname" ["optionvalue"]]
EndSection

説明

s3virge は S3 ベースのビデオカード用の XFree86 ドライバである。 このドライバは完全にアクセラレーションが効き、フレームバッファの深さは 8, 15, 16, 24 に対応している。 深さ 8 では全てのビジュアル型に対応しており、その他の深さでは TrueColor ビジュアルに対応している。

対応ハードウェア

s3virge ドライバは以下の S3 チップベースの PCI および AGP ビデオカードに対応している:

ViRGE

86C325

ViRGE VX

86C988

ViRGE DX

86C375

ViRGE GX

86C385

ViRGE GX2

86C357

ViRGE MX

86C260

ViRGE MX+

86C280

Trio 3D

86C365

Trio 3D/2X

86C362, 86C368

詳細設定

詳細設定の一般的な部分については XF86Config(5x) を参照すること。 このセクションではこのドライバ固有の詳細設定のみを扱う。 全てのオプション名について、サーバの解析の際には大文字・小文字の区別と 空白文字は無視される。 例えば "lynxe" と "LynxE" は同じ意味である。

このドライバはチップセットの種類を自動検出するが、以下の チップセット名を設定ファイルの "Device" セクションの ChipSet 項目に指定し(省略可能)、自動検出の結果を上書きしてもよい:

"virge", "86c325", "virge vx", "86c988", "virge dx", "86c375", "virge gx", "86c385", "virge gx2", "86c357", "virge mx", "86c260", "virge mx+", "86c280", "trio 3d", "86c365", "trio 3d/2x", "86c362", "86c368".

カーソル関連のオプションは以下のものに対応している( Option 項目):

Option "HWCursor" ["boolean"]

ハードウェアカーソルを有効または無効にする。 デフォルト値: on

Option "SWCursor" ["boolean"]

"HWCursor" の逆である。 デフォルト値: off

表示関連のオプションは以下のものに対応している( Option 項目):

Option "ShadowFB" ["boolean"]

シャドウフレームバッファを使用する。 このオプションはハードウェアアクセラレーションを無効にする。 デフォルト値: off

Option "Rotate" "cw | ccw"

ディスプレイを時計周りまたは反時計周りに回転させる。 このオプションはハードウェアアクセラレーションとハードウェアカーソルを 無効にし、ShadowFB を使用する。 デフォルト値: 回転させない

ビデオメモリ関連のオプションは以下のものに対応している( Option 項目):

Option "slow_edodram"

標準の ViRGE を 2 サイクル edo モードに切り替える。 ViRGE を使っていてピクセル表示が崩れる場合にはこのオプションを試すこと。 このオプションを使うと性能は大幅に落ちる。 デフォルト値: off

Option "fpm_vram"

ViRGE/VX の VRAM モードを高速ページモードに切り替える。 デフォルト値: off

Option "slow_dram | fast_dram"

Trio 3D, 3D/2X のメモリオプションを変更する。 デフォルト値: BIOS のデフォルト値を使用

Option "early_ras_precharge | late_ras_precharge"

メモリパラメータを調整する。 これらのいずれかはビデオカードのデフォルト値と同じ設定であり、 どちらも設定ファイルに書かなかった場合も同じである。

Option "set_mclk" "integer"

メモリクロックを設定する。 ここで integer は kHz 単位であり、100000 以下の整数である。 デフォルト値: メモリクロック値を探査し、これをサーバの初期値状態で使う

Option "set_refclk" "integer"

ViRGE MX のリフレッシュクロックを設定する。 ここで integer は kHz 単位の整数である。 デフォルト値: メモリクロック値を探査し、これをサーバの初期値状態で使う

アクセラレーションとグラフィックスエンジン関連のオプションは以下のもの に対応している( Option 項目):

Option "NoAccel"

アクセラレーションを無効にする。 ドライバの描画ルーチンとアクセラレーションルーチンに問題があるかどうか 確かめる際には非常に便利である。 このオプションは、サーバが起動するけれど画面のグラフィックス表示が壊れ る場合に、最初に試すべきものである。 このオプションを使うと性能は落ちる。というのも、ビデオドライバが ハードウェアで高速処理できる描画操作をソフトウェアでエミュレーション するからである。 デフォルト値: アクセラレーションが有効

Option "UseFB"

フレームバッファを使ったレンダリングの方法は二通りある。 すなわち fb と cfb である。 fb の方が新しい方法であり、デフォルトの方法でもある。 cfb に戻すにはこのオプションに no, off または負の値を設定すること。 デフォルト値: on

Option "fifo_aggressive | fifo_moderate | fifo_conservative"

ピクセルの FIFO が内部メモリバスを占有し、これを再び満たす際の閾値の設 定を変更する。この閾値小さいほど、カードのアクセラレーション性能は 向上する。最初は最も高速な設定 (fifo_aggressive) にし、ピクセルが壊れるようであれば速度を落としていくとよい。 最適な設定はおそらくドットクロックと色の深さによって決まる。 これらのオプションのいずれかを指定すると、性能向上に繋がるような他の オプションも変更されるかもしれない。したがって fifo_conservative を試すとほとんどの場合少し効果がある(これはチップのデフォルト値を使う)。 描画操作の間にピクセル表示が崩れたり画面に一時的に縞模様が出る場合は、 FIFO 関連のオプションを全て削除することが望ましい。 デフォルト値: 指定なし

PCI バス関連のオプションは以下のもの に対応している( Option 項目):

Option "pci_burst" ["boolean"]

PCI バーストモードを有効にする。このオプションはごく一部の 壊れた PCI チップセットを除いて全ての PCI チップセットで 動作するはずであり、性能を向上させる。 デフォルト値: off

Option "pci_retry" ["boolean"]

ドライバに PCI リトライを信頼させ、ViRGE レジスタをプログラムできるよ うにする。 このオプションを動作させるには オプションが有効でなければならない。 このオプションは性能を向上させるが、特に小さい塗りつぶし/データ転送で は効果が大きい。なぜなら、ドライバはコマンドを送る前に ViRGE が準備で きているかどうか確かめるためにポーリングを行う必要がなくなるからである。 このオプションは最近のほとんどの PCI チップセットで動作するはずである。 デフォルト値: off

ViRGE MX LCD 用のオプションは以下のものに対応している( Option 項目):

Option "lcd_center"

Option "set_lcdclk" "integer"

ViRGE MX LCD ディスプレイのためのクロック値を設定できるようにする。 integer は Hz 単位の整数である。 デフォルト値: 探査で得た値が使われる

その他のオプションは以下のものに対応している( Option 項目):

Option "ShowCache" ["boolean"]

オフスクリーンキャッシュメモリの表示を有効または無効にする。 これは開発用デバッグオプションである。 デフォルト値: off

サポート

このドライバ、あるいは XFree86 一般の開発の支援を考えていたら、 XFree86 のウェブサイト http://www.xfree86.org を参照すること。 FAQ もウェブサイトに掲載されている(http://www.xfree86.org/FAQ/)。 XFree86 の不具合を見つけた場合や、FAQ に載っていない質問がある場合には、 ウェブサイトにあるバグ報告フォームを利用するか、[email protected] 宛 にメールを送ること。ドライバに関する問題を報告する際にはできるだけ詳し い情報を送ること。例えばチップセットの種類、サーバの出力ログ、OS 固有 の情報などである。

作者

Kevin Brosius, Matt Grossman, Harald Koenig, Sebastien Marineau, Mark Vojkovich