glAlphaFunc 関数
glAlphaFunc 関数を使用すると、アプリケーションでアルファ テスト関数を設定できます。
構文
void WINAPI glAlphaFunc(
GLenum func,
GLclampf ref
);
パラメーター
-
func
-
アルファ比較関数。 受け入れられるシンボリック定数とその意味を次に示します。
値 説明 - GL_NEVER
決して渡しません。 - GL_LESS
受信したアルファ値が参照値より小さい場合は を渡します。 - GL_EQUAL
受信したアルファ値が参照値と等しい場合に を渡します。 - GL_LEQUAL
受信アルファ値が参照値以下の場合に を渡します。 - GL_GREATER
受信したアルファ値が参照値より大きい場合は を渡します。 - GL_NOTEQUAL
受信したアルファ値が参照値と等しくない場合に を渡します。 - GL_GEQUAL
受信したアルファ値が参照値以上の場合に を渡します。 - GL_ALWAYS
常に が渡されます。 既定値です。 -
ref
-
受信アルファ値を比較する参照値。 この値は 0 ~ 1 の範囲にクランプされます。ここで、0 は可能な限り最も低いアルファ値を表し、1 は可能な限り高い値を表します。 既定の参照は 0 です。
戻り値
この関数は値を返しません。
エラー コード
glGetError 関数では、次のエラー コードを取得できます。
| Name | 意味 |
|---|---|
|
func は受け入れられた値ではありません。 |
|
この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。 |
注釈
アルファ テストでは、受信フラグメントのアルファ値と定数参照値の比較の結果に応じてフラグメントが破棄されます。 glAlphaFunc 関数は、参照関数と比較関数を指定します。 比較は、アルファ テストが有効になっている場合にのみ実行されます。 (GL_ALPHA_TESTの詳細については、「 glEnable」を参照してください。
func パラメーターと ref パラメーターは、ピクセルを描画する条件を指定します。 受信アルファ値は、func で指定された関数を使用して ref と比較されます。 比較に合格すると、受信フラグメントが描画され、後続のステンシルテストと深度バッファー テストで条件付きになります。 比較に失敗した場合、そのピクセル位置のフレームバッファーは変更されません。
glAlphaFunc 関数は、ポイント、線、ポリゴン、ビットマップのスキャン変換、ピクセル描画およびコピー操作の結果を含め、すべてのピクセル書き込みに対して動作します。 glAlphaFunc 関数は、画面クリア操作には影響しません。
アルファ テストは RGBA モードでのみ行われます。
次の関数は 、glAlphaFunc 関数に関連する情報を取得します。
glGet と引数 GL_ALPHA_TEST_FUNC
glGet と引数 GL_ALPHA_TEST_REF
glIsEnabled と引数 GL_ALPHA_TEST
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|