'\"! eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.2.0
.ds Dp Feb 16 02:56
.ds Dm  Feb 10 17:2
.ds Xs 60987 10 xgetconfig.gl
.TH GLXGETCONFIG
.\"0 .SH NAME
.SH 名前
.B "glXGetConfig
.\"0 \- return information about GLX visuals
\- GLX のビジュアルに関する情報を返す

.\"0 .SH C SPECIFICATION
.SH 書式
int \f3glXGetConfig\fP(
Display \fI*dpy\fP,
.nf
.ta \w'\f3int \fPglXGetConfig( 'u
	XVisualInfo \fI*vis\fP,
	int \fIattrib\fP,
	int \fI*value\fP )
.fi

.EQ
delim $$
.EN
.\"0 .SH PARAMETERS
.SH 引き数
.TP \w'\fIattrib\fP\ \ 'u 
\f2dpy\fP
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定する。
.TP
\f2vis\fP
.\"0 Specifies the visual to be queried.
問い合わせを行うビジュアルを指定する。
.\"0 It is a pointer to an \f3XVisualInfo\fP structure,
.\"0 not a visual ID or a pointer to a \f3Visual\fP.
これは \f3XVisualInfo\fP 構造体へのポインタであり、\f3Visual\fP への
ポインタやビジュアル ID ではない。
.TP
\f2attrib\fP
.\"0 Specifies the visual attribute to be returned.
ビジュアルに関して取得する属性を指定する。
.TP
\f2value\fP
.\"0 Returns the requested value.
要求した値が返される。
.\"0 .SH DESCRIPTION
.SH 説明
.\"0 \f3glXGetConfig\fP sets \f2value\fP to the \f2attrib\fP value of windows or GLX pixmaps
.\"0 created with respect to \f2vis\fP.
\f3glXGetConfig\fP は \f2value\fP にウィンドウの \f2attrib\fP 値を設定
するか、\f2vis\fP について生成された GLX ピックスマップを設定する。
.\"0 \f3glXGetConfig\fP returns an error code if it fails for any reason.
何らかの理由で設定に失敗すると、\f3glXGetConfig\fP はエラーコードを返
す。
.\"0 Otherwise, zero is returned.
成功すれば 0 を返す。
.P
.\"0 \f2attrib\fP is one of the following:
\f2attrib\fP は以下のいずれかである:
.P
.TP 22
\f3GLX_USE_GL\fP
.\"0 \f3True\fP if OpenGL rendering is supported by this visual,
.\"0 \f3False\fP otherwise.
指定したビジュアルで OpenGL のレンダリングがサポートされていれば
\f3True\fP となり、サポートされていなければ \f3False\fP となる。
.TP
\f3GLX_BUFFER_SIZE\fP
.\"0 Number of bits per color buffer.
カラーバッファごとのビット数。
.\"0 For RGBA visuals, \f3GLX_BUFFER_SIZE\fP is the sum of
.\"0 \f3GLX_RED_SIZE\fP,
.\"0 \f3GLX_GREEN_SIZE\fP,
.\"0 \f3GLX_BLUE_SIZE\fP, and
.\"0 \f3GLX_ALPHA_SIZE\fP.
RGBA ビジュアルの場合には、\f3GLX_BUFFER_SIZE\fP は
\f3GLX_RED_SIZE\fP,
\f3GLX_GREEN_SIZE\fP,
\f3GLX_BLUE_SIZE\fP,
\f3GLX_ALPHA_SIZE\fP の和となる。
.\"0 For color index visuals, \f3GLX_BUFFER_SIZE\fP is the size of the
.\"0 color indexes.
カラーインデックスのビジュアルの場合には、\f3GLX_BUFFER_SIZE\fP はカラー
インデックスの大きさとなる。
.TP
\f3GLX_LEVEL\fP
.\"0 Frame buffer level of the visual.
ビジュアルのフレームバッファレベル。
.\"0 Level zero is the default frame buffer.
レベル 0 はデフォルトのフレームバッファである。
.\"0 Positive levels correspond to frame buffers that overlay the default buffer,
.\"0 and negative levels correspond to frame buffers that underlay the default
.\"0 buffer.
正の値であるレベルはデフォルトのバッファにオーバーレイするバッファに対
応し、負の値であるレベルはデフォルトのバッファにアンダーレイするバッファ
に対応する。
.TP
\f3GLX_RGBA\fP
.\"0 \f3True\fP if color buffers store red, green, blue, and alpha values.
カラーバッファが Red, Green, Blue, アルファ値を持つ場合に 
\f3True\fP となる。
.\"0 \f3False\fP if they store color indexes.
カラーバッファがカラーインデックスを持つ場合に \f3False\fP となる。
.TP
\f3GLX_DOUBLEBUFFER\fP
.\"0 \f3True\fP if color buffers exist in front/back pairs that can be swapped,
.\"0 \f3False\fP otherwise.
カラーバッファが交換可能な前面/背面のペアで構成されている場合に 
\f3True\fP となり、そうでなければ \f3False\fP となる。
.TP
\f3GLX_STEREO\fP
.\"0 \f3True\fP if color buffers exist in left/right pairs,
.\"0 \f3False\fP otherwise.
カラーバッファが右/左のペアから構成されている場合に \f3True\fP となり、
そうでなければ \f3False\fP となる。
.TP
\f3GLX_AUX_BUFFERS\fP
.\"0 Number of auxiliary color buffers that are available.
利用可能な補助カラーバッファの数。
.\"0 Zero indicates that no auxiliary color buffers exist.
0 の場合は、補助カラーバッファが存在しないことを示す。
.TP
\f3GLX_RED_SIZE\fP
.\"0 Number of bits of red stored in each color buffer.
各カラーバッファに格納される Red 値のビット数。
.\"0 Undefined if \f3GLX_RGBA\fP is \f3False\fP.
\f3GLX_RGBA\fP が \f3False\fP の場合は未定義である。
.TP
\f3GLX_GREEN_SIZE\fP
.\"0 Number of bits of green stored in each color buffer.
各カラーバッファに格納される Green 値のビット数。
.\"0 Undefined if \f3GLX_RGBA\fP is \f3False\fP.
\f3GLX_RGBA\fP が \f3False\fP の場合は未定義である。
.TP
\f3GLX_BLUE_SIZE\fP
.\"0 Number of bits of blue stored in each color buffer.
各カラーバッファに格納される Blue 値のビット数。
.\"0 Undefined if \f3GLX_RGBA\fP is \f3False\fP.
\f3GLX_RGBA\fP が \f3False\fP の場合は未定義である。
.TP
\f3GLX_ALPHA_SIZE\fP
.\"0 Number of bits of alpha stored in each color buffer.
各カラーバッファに格納されるアルファ値のビット数。
.\"0 Undefined if \f3GLX_RGBA\fP is \f3False\fP.
\f3GLX_RGBA\fP が \f3False\fP の場合は未定義である。
.TP
\f3GLX_DEPTH_SIZE\fP
.\"0 Number of bits in the depth buffer.
デプスバッファのビット数。
.TP
\f3GLX_STENCIL_SIZE\fP
.\"0 Number of bits in the stencil buffer.
ステンシルバッファのビット数。
.TP
\f3GLX_ACCUM_RED_SIZE\fP
.\"0 Number of bits of red stored in the accumulation buffer.
アキュームレーションバッファに格納される Red 値のビット数。
.TP
\f3GLX_ACCUM_GREEN_SIZE\fP
.\"0 Number of bits of green stored in the accumulation buffer.
アキュームレーションバッファに格納される Green 値のビット数。
.TP
\f3GLX_ACCUM_BLUE_SIZE\fP
.\"0 Number of bits of blue stored in the accumulation buffer.
アキュームレーションバッファに格納される Blue 値のビット数。
.TP
\f3GLX_ACCUM_ALPHA_SIZE\fP
.\"0 Number of bits of alpha stored in the accumulation buffer.
アキュームレーションバッファに格納されるアルファ値のビット数。
.TE
.P
.\"0 The X protocol allows a single visual ID to be instantiated with
.\"0 different numbers of bits per pixel.
X プロトコルでは、単一のビジュアル ID を異なる bpp 値でインスタンス化
させることができる。
.\"0 Windows or GLX pixmaps that will be rendered with OpenGL, however,
.\"0 must be instantiated with a color buffer depth of \f3GLX_BUFFER_SIZE\fP.
しかし、OpenGL でレンダリングされるウィンドウや GLX ピックスマップは、
カラーバッファの深さを \f3GLX_BUFFER_SIZE\fP としてインスタンス化しな
ければならない。
.P
.\"0 Although a GLX implementation can export many visuals that support GL
.\"0 rendering,
.\"0 it must support 
.\"0 at least one RGBA visual. This visual must have at 
.\"0 least one color buffer,
.\"0 a stencil buffer of at least 1 bit,
.\"0 a depth buffer of at least 12 bits,
.\"0 and an accumulation buffer.
GLX の実装では GL レンダリングをサポートするビジュアルをたくさんエクス
ポートすることができるが、少なくとも 1 つの RGBA ビジュアルをサポート
していなければならない。このビジュアルは少なくとも 1 つのカラーバッファ、
少なくとも 1 ビットであるステンシルバッファ、
少なくとも 12 ビットであるデプスバッファ、
1 つのアキュームレーションバッファを持たなければならない。
.\"0 Alpha bitplanes are optional in this visual.
このビジュアルには、アルファビットプレーンはなくても構わない。
.\"0 However,
.\"0 its color buffer size must be as great as that of the
.\"0 deepest \f3TrueColor\fP, \f3DirectColor\fP,
.\"0 \f3PseudoColor\fP, or \f3StaticColor\fP visual supported on level zero,
.\"0 and it must itself be made available on level zero.
しかし、カラーバッファのサイズは、レベル 0 でサポートされている 
\f3TrueColor\fP, \f3DirectColor\fP, \f3PseudoColor\fP, or
\f3StaticColor\fP ビジュアルのうち最も深さが大きいものと同じ大きさでな
ければならず、レベル 0 で自分自身を利用可能にできなければならない。
.P
.\"0 In addition, if the X server exports a \f3PseudoColor\fP 
.\"0 or \f3StaticColor\fP visual on framebuffer level 0, a color index 
.\"0 visual is also required on that level.
さらに、X サーバが \f3PseudoColor\fP ビジュアルか \f3StaticColor\fP 
ビジュアルをフレームバッファ 0 でエクスポートしている場合、
カラーインデックス型のビジュアルもこのレベルで必要とされる。
.\"0 It must have  
.\"0 at least one color buffer,
.\"0 a stencil buffer of at least 1 bit,
.\"0 and a depth buffer of at least 12 bits.
このビジュアルは
少なくとも 1 つのカラーバッファ、
少なくとも 1 ビットであるステンシルバッファ、
少なくとも 12 ビットであるデプスバッファを持たなければならない。
.\"0 This visual must 
.\"0 have as many 
.\"0 color bitplanes as the deepest
.\"0 \f3PseudoColor\fP or \f3StaticColor\fP visual supported on level 0.
このビジュアルは、レベル 0 でサポートされている
\f3PseudoColor\fP ビジュアルと \f3StaticColor\fP ビジュアルのうち深さ
が大きい方と同じだけのカラービットプレーンを持っていなければならない。
.P
.\"0 Applications are best written to select the visual that most closely
.\"0 meets their requirements.
アプリケーションは、これらの条件に最も近いビジュアルを選択するように書
くのが好ましい。
.\"0 Creating windows or GLX pixmaps with unnecessary buffers can result in
.\"0 reduced rendering performance as well as poor resource allocation.
不要なバッファを使ってウィンドウや GLX ピックスマップを生成すると、
レンダリング性能が出なかったり、割り当てられるリソースが乏しくなったり
する。

.\"0 .SH NOTES
.SH 注意
.\"0 \f3XVisualInfo\fP is defined in \f2Xutil.h.\fP
\f3XVisualInfo\fP は \f2Xutil.h\fP において定義されている。
.\"0 It is a structure that includes \f2visual\fP, \f2visualID\fP, \f2screen\fP, and
.\"0 \f2depth\fP elements.
これは \f2visual\fP, \f2visualID\fP, \f2screen\fP, \f2depth\fP 要素を
持つ構造体である。
.\"0 .SH ERRORS
.SH エラー
.\"0 \f3GLX_NO_EXTENSION\fP is returned if \f2dpy\fP does not support the GLX
.\"0 extension.
\f2dpy\fP が GLX 機能拡張をサポートしていなければ、
\f3GLX_NO_EXTENSION\fP が返される。
.P
.\"0 \f3GLX_BAD_SCREEN\fP is returned if the screen of \f2vis\fP does not correspond
.\"0 to a screen.
\f2vis\fP のスクリーンが実際のスクリーンに対応していなければ、
\f3GLX_BAD_SCREEN\fP が返される。
.P
.\"0 \f3GLX_BAD_ATTRIBUTE\fP is returned if \f2attrib\fP is not a valid GLX attribute.
\f2attrib\fP が有効な GLX 属性でなければ、\f3GLX_BAD_ATTRIBUTE\fP が返
される。
.P
.\"0 \f3GLX_BAD_VISUAL\fP is returned if \f2vis\fP doesn't support GLX and an
.\"0 attribute other than \f3GLX_USE_GL\fP is requested.
\f2vis\fP が GLX をサポートしておらず、かつ \f3GLX_USE_GL\fP 以外の属
性がリクエストされた場合には、\f3GLX_BAD_VISUAL\fP が返される。
.\"0 .SH SEE ALSO
.SH 関連項目
\f3glXChooseVisual\fP,
\f3glXCreateContext\fP