glLineStipple-Funktion

Die glLineStipple-Funktion gibt das Linienstipplemuster an.

Syntax

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

Parameter

Faktor

Ein Multiplikator für jedes Bit im Linienstipplemuster. Wenn der Faktor beispielsweise 3 ist, wird jedes Bit im Muster dreimal verwendet, bevor das nächste Bit im Muster verwendet wird. Der Factor-Parameter wird auf den Bereich [1, 256] geklemmt und ist standardmäßig auf 1 festgelegt.

pattern

Eine 16-Bit-Ganzzahl, deren Bitmuster bestimmt, welche Fragmente einer Linie gezeichnet werden, wenn die Linie gerastert wird. Bit 0 wird zuerst verwendet, und das Standardmuster ist nur eins.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name	Bedeutung
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glLineStipple-Funktion gibt das Linienstipplemuster an. Linienstippen maskieren bestimmte Fragmente, die durch rasterung erzeugt werden; diese Fragmente werden nicht gezeichnet. Die Maskierung wird mithilfe von drei Parametern erreicht: dem 16-Bit-Linienstipplemustermuster, dem Wiederholungsanzahlfaktor und einem ganzzahligen Stipplezähler s.

Leistungsindikator wird bei jedem Aufruf von glBegin und vor dem Generieren jedes Zeilensegments einer glBegin(GL_LINES)/glEnd-Sequenz auf null zurückgesetzt. Sie wird erhöht, nachdem jedes Fragment eines Liniensegments mit Alias für die Einheitsbreite generiert wurde, oder nachdem jedes i-Fragment eines Liniensegments mit i-Breite generiert wurde. Die i-Fragmente , die der Anzahl s zugeordnet sind, werden maskiert, wenn Musterbit (s / Faktor) mod 16 null ist. Andernfalls werden diese Fragmente an den Framebuffer gesendet. Bit null des Musters ist das am wenigsten signifikante Bit.

Antialiasierte Linien werden zu Stichzwecken als Sequenz von Rechtecken mit einerBreite von 1x behandelt. Rectangle s wird basierend auf der Fragmentregel für Aliaslinien gerastert oder nicht. Es zählt Rechtecke und nicht Gruppen von Fragmenten.

Das Zeilenstippen wird mithilfe von glEnable und glDisable mit argument-GL_LINE_STIPPLE aktiviert oder deaktiviert. Wenn diese Option aktiviert ist, wird das Linienstipplemuster wie oben beschrieben angewendet. Wenn es deaktiviert ist, ist es so, als ob das Muster alle eins wären. Anfänglich ist das Zeilenippen deaktiviert.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glLineStipple ab:

glGet mit argument GL_LINE_STIPPLE_PATTERN

glGet mit argument GL_LINE_STIPPLE_REPEAT

glIsEnabled mit Argument GL_LINE_STIPPLE

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glEnd

glLineWidth

glPolygonStipple