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 |
|---|---|
|
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 |
|
| Bibliothek |
|
| DLL |
|