名称

XGetVisualInfo, XMatchVisualInfo, XVisualIDFromVisual − ビジュアル情報を得る

形式

XVisualInfo ∗XGetVisualInfo(display, vinfo_mask, vinfo_template, nitems_return)
      Display ∗display;
      long vinfo_mask;
      XVisualInfo ∗vinfo_template;
      int ∗nitems_return; Status XMatchVisualInfo(display, screen, depth, class, vinfo_return)
      Display ∗display;
      int screen;
      int depth;
      int class;
      XVisualInfo ∗vinfo_return; VisualID XVisualIDFromVisual(visual)
       Visual ∗visual;

引数

classスクリーンのクラスを指定します。

depthスクリーンの深さを指定します。

displayX サーバへのコネクションを指定します。

nitems_return
一致したビジュアル構造体の数を返します。

screenスクリーンを指定します。

visualビジュアルタイプを指定します。

vinfo_maskビジュアルマスクの値を指定します。

vinfo_return一致したビジュアル情報を返します。

vinfo_template
ビジュアル構造体の検索で使用するビジュアル属性を指定します。

解説

XGetVisualInfo 関数は、 vinfo_template で指定された属性と一致するビジュアル構造体のリストを 返します。 ビジュアル構造体が指定された vinfo_mask を使用してテンプレートと 一致しなければ、 XGetVisualInfo は、 NULL を返します。 この関数で返されたデータを解放するには、 XFree を使用します。 XMatchVisualInfo 関数は、スクリーンの指定された深さおよびクラスと一致するビジュアル について、ビジュアル情報を返します。 指定された深さおよびクラスと一致する複数のビジュアルが存在する場合は どのビジュアルが選ばれるかは未定義です。 ビジュアルがあれば、 XMatchVisualInfo は 0 以外の値を返し、ビジュアルに関する情報を vinfo_return に返します。 ビジュアルがなければ、 XMatchVisualInfo は 0 を返します。 XVisualIDFromVisual 関数は、指定されたビジュアルタイプのビジュアル ID を返します。

関連事項

Xlib − C Language X Interface

NEWS-OSRelease 3.3