glLineStipple 関数

  • [アーティクル]

glLineStipple 関数は、行ヒントパターンを指定します。

構文

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

パラメーター

factor

線のヒント パターン内の各ビットの乗数。 たとえば 、factor が 3 の場合、パターン内の各ビットは、パターン内の次のビットが使用される前に 3 回使用されます。 factor パラメーターは範囲 [1, 256] にクランプされ、既定値は 1 です。

pattern

線がラスター化されるときに描画される線のフラグメントを決定するビット パターンを持つ 16 ビットの整数。 ビット 0 が最初に使用され、既定のパターンがすべてです。

戻り値

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

エラー コード

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

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

解説

glLineStipple 関数は、行ヒントパターンを指定します。 ラインスチップリングは、ラスター化によって生成された特定のフラグメントをマスクします。これらのフラグメントは描画されません。 マスクは、16 ビットのライン スティプル パターン パターン、繰り返しカウント 係数、整数のtipple カウンター s の 3 つのパラメーターを使用して実現されます。

カウンター s は、 glBegin が呼び出されるたびに 0 にリセットされ、 glBegin(GL_LINES)/glEnd シーケンスの各行セグメントが生成される前にリセットされます。 これは、単位幅エイリアス化された線分セグメントの各フラグメントが生成された後、または i 幅線分の各 i フラグメントが生成された後にインクリメントされます。 パターン ビット (s係数) mod 16 が 0 の場合、カウント s / に関連付けられている i フラグメントはマスクされます。 それ以外の場合、これらのフラグメントはフレームバッファーに送信されます。 パターンのビット 0 は最下位ビットです。

アンチエイリアシングされた線は、スチップリングを目的として 1x幅 の四角形のシーケンスとして扱われます。 四角形 の は、エイリアス化された線に対して記述されたフラグメントルールに基づいてラスター化されるか、または基づいていません。フラグメントのグループではなく四角形をカウントします。

引数 GL_LINE_STIPPLE で glEnable と glDisable を使用して、行のスチップリングを有効または無効にします。 有効にすると、上記のように線のヒント パターンが適用されます。 無効にすると、パターンがすべてであるかのように表示されます。 最初は、行のスチップリングは無効になっています。

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

引数GL_LINE_STIPPLE_PATTERNを含む glGet

glGet と引数 GL_LINE_STIPPLE_REPEAT

glIsEnabled with argument GL_LINE_STIPPLE

必要条件

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

関連項目

glBegin

glEnd

glLineWidth

glPolygonStipple