glPolygonStipple 関数

  • [アーティクル]

glPolygonStipple 関数は、多角形のスチップリング パターンを設定します。

構文

void WINAPI glPolygonStipple(
   const GLubyte *mask
);

パラメーター

mask

glDrawPixels がピクセルを開梱するのと同じ方法でメモリからアンパックされる 32 x 32 のヒント パターンへのポインター。

戻り値

この関数は値を返しません。

エラー コード

glGetError 関数では、次のエラー コードを取得できます。

名前 意味
GL_INVALID_OPERATION
 この関数は、 glBegin の呼び出しと glEnd の対応する呼び出しの間で呼び出されました。

解説

glPolygonStipple 関数は、多角形のスチップリング パターンを設定します。 線のスチップリング ( glLineStipple を参照) のような多角形のスチップリングは、ラスター化によって生成された特定のフラグメントをマスクし、パターンを作成します。 スチップリングは、多角形アンチエイリアシングとは無関係です。

mask パラメーターは、高さと幅の両方が 32 の glDrawPixels に提供されるピクセル データ、GL_COLOR_INDEXのピクセル形式、GL_BITMAPのデータ型と同様に、メモリに格納される 32 x 32 のチップ パターンへのポインターです。 つまり、スティプル パターンは、符号なしバイトでパックされた 1 ビットカラー インデックスの 32 x 32 配列として表されます。 glPixelStore 関数パラメーター (GL_UNPACK_SWAP_BYTESやGL_UNPACK_LSB_FIRSTなど) は、ビットをヒント パターンに組み立てる際に影響します。 ただし、ピクセル転送操作 (シフト、オフセット、ピクセル マップ) は、ヒント画像には適用されません。

引数GL_POLYGON_STIPPLEを使用して、 glEnable と glDisable を使用して多角形のスチップリングを有効または無効にします。 有効にすると、(y w mod 32)番目の行の (y w mod 32) 番目のビットが 1 の場合にのみ、ウィンドウ座標 xw と yw を持つラスター化されたポリゴン フラグメントが OpenGL の次のステージに送信されます。 多角形のスチップリングが無効になっている場合は、スチプル パターンがすべてであるかのように表示されます。

次の関数は 、glPolygonStipple に関連する情報を取得します。

glGetPolygonStipple

glIsEnabled with argument GL_POLYGON_STIPPLE

必要条件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

関連項目

glBegin

glDrawPixels

glEnd

glLineStipple

glPixelStore

glPixelTransfer