<<

Inhaltsverzeichnis

Suchen

>>

GR_POLYGON

Funktion

Syntax:

GR_POLYGON(<KOORDINATEN>,<ROT>,<GRUEN>,<BLAU>,
                              <FUELLEN>,<RANDSTAERKE>[,<HANDLE>])

<KOORDINATEN>          = <STRING-AUSDRUCK>
<ROT>                               = <NUM-AUSDRUCK>
<GRUEN>                         = <NUM-AUSDRUCK>
<BLAU>                            = <NUM-AUSDRUCK>
<FUELLEN>                     = <NUM-AUSDRUCK>
<RANDSTAERKE>          = <NUM-AUSDRUCK>

 

Bedeutung:

GR_POLYGON zeichnet ein Polygon auf dem Bildschirm. Ist <FUELLEN> = 0, so wird der Rand des Polygons in der Stärke <RANDSTAERKE> mit der Farbe <ROT>, <GRUEN>, <BLAU> gezeichnet, andernfalls wird das Innere des Polygons mit der Farbe gefüllt.

<RANDSTAERKE> legt bei <FUELLEN> = 0 die Stärke des Randes in Pixel fest.

<KOORDINATEN> enthält durch Strichpunkt getrennt die Koordinaten des Polygons. Jede Koordinate ist in folgender Form anzugeben: Y,X (Y = Y-Koordinate, X = X-Koordinate). Ist die letzte Koordinate in <KOORDINATEN> ungleich der ersten Koordinate, so wird automatisch eine Verbindungslinie zwischen letzter und erster Koordinate erzeugt.

Ist <ROT> < 0 oder <GRUEN> < 0 oder <BLAU> < 0, so wird ein zuvor an gleicher Position mit gleicher Größe gezeichnetes Polygon wieder gelöscht.

<HANDLE> legt unter Java die Windowtiefe oder die Identifizierungsnummer (Split-Handle) eines Split-Windows fest.

GR_POLGON liefert folgende Ergebniswerte:
1             kein Fehler
-1           <KOORDINATEN> ist leer
-2           Die Koordinaten haben nicht die Form Y,X

Unter MS-DOS und UNIX wird stets -1 als Ergebnis geliefert.

Beispiel:

/* Dreieck mit folgenden Koordinaten zeichnen und mit roter Farbe füllen:
/* (5,10)  (5,12.5)  (3.5,11.25)
H% = GR_POLYGON("5,10;5,12.5;3.5,11.25",255,0,0,1,1)

siehe auch:

GR_FILLRECT, GR_LPPOLYGON