XSetScreenSaver(3X11)

名前
 XSetScreenSaver, XForceScreenSaver, XActivateScreenSaver, XResetScreenSaver, XGetScreenSaver - スクリーンセイバーの操作

書式
XSetScreenSaver(display, timeout, interval, prefer_blanking, allow_exposures)
      Display *display;
      int timeout, interval;
      int prefer_blanking;
      int allow_exposures;

XForceScreenSaver(display, mode)
      Display *display;
      int mode;

XActivateScreenSaver(display)
      Display *display;

XResetScreenSaver(display)
      Display *display;

XGetScreenSaver(display, timeout_return, interval_return, prefer_blanking_return,
                  allow_exposures_return)
      Display *display;
      int *timeout_return, *interval_return;
      int *prefer_blanking_return;
      int *allow_exposures_return;

引き数

allow_exposures
    スクリーンセイバーの制御値を指定。 のいずれかを指定する。

allow_exposures_return
    スクリーンセイバーの現在の制御値が返される のいずれか)

display
    X サーバへの接続を指定。

interval
    スクリーンセイバー切替えの間隔を秒数で指定。

interval_return
    スクリーンセイバーの起動までの間隔が返される。

mode
    適用されるモードを指定。 か のいずれかを指定。

prefer_blanking
    スクリーンがどのようにブランクするか指定。 のいずれかを指定。

prefer_blanking_return
    スクリーンの現在のブランクの設定が返される のいずれか)。

timeout
    スクリーンセイバーが有効になるまでのタイムアウトを秒数で指定。

timeout_return
    スクリーンセイバーが有効になるまでのタイムアウトが秒数で返される。

説明
タイムアウトとインターバルは秒数で指定する。 タイムアウトが0ならば、スクリーンセイバーは無効化され(しかし、アクティ ブに鳴っているスクリーンセイバーは解除されない)、タイムアウトが -1 な らば、デフォルト値が復元される。 これ以外の負の値を指定するとエラー になる。 タイムアウトがゼロでなければ、 はスクリーンセイバーを有効にする。 インターバルがゼロならば、ランダムパターン動作が無効になる。 指定されたタイムアウトの秒数の間デバイス(キーボード、マウス等)からの入 力がなければ、スクリーンセイバーがアクティブになる。

各スクリーンに対してブランキングが設定され、ハードウェアがビデオ表示の ブランクをサポートしている場合、スクリーンは単にブランクする。 そうでない場合で、露出が可能な場合か、スクリーンが クライアントに イベントを送らずにスクリーン表示を再生成できる場合には、スクリーンはルー トウィンドウの背景タイルでランダムに埋められる。この際には、interval 秒ごとに原点が決め直される。 これ以外の場合にはスクリーンの状態は変化せず、スクリーンセイバーはアク ティブにならない。 キーボードやポインタの次の入力があったときか、 mode に を指定して次の を呼び出した時にスクリーンセイバーは解除され、全てのスクリーンの状態が 復元される。

サーバ依存のスクリーン保護機能が、周期的な画面書き換えをサポートしてい る場合、引き数 interval は書き換え周期の長さのヒントを与える。このヒント がゼロの場合は、周期的な画面書き換えをしてはならないことを示す。 スクリーンの書き換え方法の例としては、カラーマップをごちゃ混ぜにする方 法、アイコンイメージを周期的にスクリーン周りを移動させる方法、スクリー ンをルートウィンドウの背景タイルとし、定期的にランダムに原点を変える方 法が挙げられる。

はエラー を起こすことがある。

指定したモードが であり、かつスクリーンセイバーが現在アクティブでないならば、 はタイムアウト値に0が指定されて無効になっていた場合も含めて、スクリー ンセイバーをアクティブにする。 指定したモードが であり、スクリーンセイバーが現在有効ならば、 は、スクリーンセイバーがアクティブになっていればスクリーンセイバーを無 効にし、アクティブ化のタイマーは(デバイスからの入力があったかのように) 初期状態にリセットする。

はエラー を起こすことがある。

関数 はスクリーンセイバーをアクティブにする。

関数 はスクリーンセイバーをリセットする。

関数 は、現在のスクリーンセイバーの値を取得する。

返り値

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていない限り、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

関連項目
Xlib - C Language X Interface