DN_SCRSPEC :
data: DEV_SPEC devspec;
typedef struct {
H attr; /* デバイス属性 */
H planes; /* プレーン数 */
H pixbits; /* ピクセルビット数 */
H hpixels; /* 横のピクセル数 */
H vpixels; /* 縦のピクセル数 */
H hres; /* 横の解像度 */
H vres; /* 縦の解像度 */
H color[4]; /* カラー情報 */
H resv[6]; /* 予約 */
} DEV_SPEC;
現在設定されている表示モードにおけるデバイス仕様を取り出す
( DEV_SPEC に関しては DP の仕様
gget_spc() を参照のこと)。
DN_SCRLIST :
data: TC list[];
サポートしている表示モード一覧を以下の形式で取り出す。
<区切り><表示モード><区切り><表示モード>.....<0><区切り> は、表示モード番号(1 〜 N < 256) で上位バイト = 0 ということで、表示モードを区切る。
<表示モード>は、解像度や色数などを表わす文字列で、 例えば "1024 × 768 256C" のような簡単な説明文とする。
表示モードは解像度や色数などにグループ化された整然とした順番 に並んでおり、基本的にそのままの順番で表示される。
サポートする表示モードの追加により、順番は変る可能性があるが、 表示モード番号は変らない。
DN_SCRNO :
data: W scrno;現在の表示モード番号を設定、または取り出す。
表示モード番号は
DN_SCRLIST で取り出される表示モードに
付けられている番号である。- ※
- PC/AT 版では、表示モードの設定はサポートしていない。
DN_SCRCOLOR :
data: COLOR map[*]現在の表示モードにおけるカラーマップを設定、または取り出す。
DEV_SPEC.attr.P = 0 のときは、カラーマップは適用されない。カラーマップはピクセル値をインデックスとした、絶対 RGB カラー 値の配列となる (
COLOR に関しては
BTRON3 仕様書「第2編 OS 仕様 2.2.3 カラー表現」を参照のこと)。
エントリの最大数は、DEV_SPEC のプレーン数×ピクセルビット数
で決まるが、実際にはそれより少ない場合もある。
DN_SCRBMP :
data: BMP devbmp;現在の表示モードにおける、デバイス固有イメージ領域 ( ビットマップ ) に関する情報を取り出す。
devbmp.baseaddr[*] がイメージ領域のメモリを指し、この領域に
DP が直接アクセスすることができる(ただし、一般の
アプリケーションから直接アクセスしてはいけない)。
デバイス固有イメージ領域は、DEV_SPEC.attr.M = 1 のときのみ存在する。
DN_SCRBRIGHT :
data: W brightness;現在の表示モードにおける、スクリーンの明るさを設定、 または取り出す。
スクリーンの明るさは (暗) 0 〜 (明) 31 の範囲の値とする。
- ※
- PC/AT 版では、この属性データはサポートしていない。
DN_SCRUPDFN :
data FP updfn(W x, W y, W dx, W dy)
x: X 座標値, y: Y 座標値, dx: X 幅, dy: Y 幅
デバイス固有イメージ領域の内容を更新した場合に、
どの領域を更新したかを通知する関数ポインタを取り出す。DP はこの関数ポインタを取り出し、
NULL
でないときは、デバイス固有イメージ領域の内容を更新した時点で、
この関数を直接呼び出す。
したがって、この関数は、DP から直接呼び出せなくてはいけない。指定された領域が、
devbmp.bounds をはみ出す場合は、
はみ出した部分は無視される。- この機能は、ディスプレイのハードウェアや表示モードに依存して、 スクリーンの更新に対して特別な処理が必要な場合に適用される。
DN_SCRVFREQ :
data: W vfreq;現在の表示モードにおけるモニタの垂直周波数(リフレッシュレート)を設定、 または取り出す。
- 取り出し :
vfreq <= 0は不明を意味する。
取り出した値が正確に現在適用されている値であるかどうかは保証されない。- 設定 :
vfreq <= 0は無視される。
設定する値によっては、画面の表示は保証されないので、注意が必要である。また、正確に設定した値になるかどうかも保証されない。
通常は 60 (Hz) 〜 90 (Hz) 前後の値となる。
- この機能は、ディスプレイのハードウェアや表示モードによってはサポートされない。
DN_SCRADJUST :
data: ScrAdjust adj;
typedef struct {
UH left; /* 左ブランクドット数(8 の倍数) */
UH hsync; /* 水平シンクドット数(8 の倍数) */
UH right; /* 右ブランクドット数(8 の倍数) */
UH top; /* 上ブランクドット数 */
UH vsync; /* 垂直シンクドット数 */
UH bottom; /* 下ブランクドット数 */
} ScrAdjust;
現在設定されている表示モードにおける、モニタのタイミング
調整パラメータを設定、または取り出す。
left + right + hsync を大きくすると表示領域の幅は小 left + right + hsync を小さくすると表示領域の幅は大 top + bottom + vsync を大きくすると表示領域の高さは小 top + bottom + vsync を小さくすると表示領域の高さは大 left, right の値の調整で表示領域は左右に移動 top, bottom の値の調整で表示領域は上下に移動
left, hsync, rightは 8 ドット単位。
- この機能は、ディスプレイのハードウェアや表示モードによってはサポートされない。
- ※
- PC/AT 版では、この属性データはサポートしていない。
DN_SCRDEVINFO :
data: ScrDevInfo info;
typedef struct {
UB name1[32]; /* 名称-1 (ASCII) */
UB name2[32]; /* 名称-2 (ASCII) */
UB name3[32]; /* 名称-3 (ASCII) */
VP framebuf_addr; /* フレームバッファアドレス */
W framebuf_size; /* フレームバッファサイズ */
W mainmem_size; /* 主メモリサイズ */
UB reserved[28]; /* 予約 */
} ScrDevInfo;
ディスプレイのハードウェアに関する情報を取り出す。name1, name2, name3 はハードウェアに関する情報を
ASCII コードで示したもので、32 文字に満たない部分は 0 パッドされる。framebuf_addr は ( リニア ) フレームバッファの物理アドレスを示し、
( リニア ) フレームバッファが使用されていないときは NULL となる。
表示モードによりアドレスは異なる場合がある。framebuf_size はハードウェアで実装されているフレームバッファのバイトサイズを示す。
実際に使用されるフレームバッファのサイズではなく、全体のサイズである。mainmem_size は、フレームバッファとして使用されている主メモリサイズを示す。