Der Befehl Grid.init(x, y) erwartet folgende (verpflichtende) Argumente:
Argument | Datentyp | Hinweis |
x | Zahl | ganzzahlig, positiv |
y | Zahl | ganzzahlig, positiv |
Das Gitternetz (Grid) wird zur anschließenden Darstellung farbiger Pixel vorbereitet (initialisiert). Genauer definiert x die Anzahl der Pixel entlang der x-Achse und y die Anzahl der Pixel entlang der y-Achse.
Zudem können folgende Optionen verwendet werden:
Variable | Datentyp | Hinweis | Default-Wert |
width | Zahl | ganzzahlig, positiv | 480 |
background | Farbe | - | none |
style | Zeichenkette | - | svg |
zoom | Zahl | ganzzahlig, positiv | 1 |
scaling | Zeichenkette | on oder off | on |
div | Zeichenkette | - | neues DIV-Element |
Mit width wird die (maximale) Breite der Zeichnung definiert. Die zugehörige Höhe der Zeichnung ergibt sich automatisch gemäß dem Verhältnis von x zu y. Zudem definiert background die Hintergrundfarbe der Zeichenfläche.
Weiterhin ist zu beachten, dass width stets als maximale Breite zu verstehen ist. Ist diese zu groß, wird automatisch auf eine optimale Größe verkleinert. Um dies zu verhindern, kann scaling auf off gesetzt werden.
Bei sehr großen Gitternetzen sollte die Option style auf canvas gesetzt werden. Dies beschleunigt die Darstellung, wobei alle Pixel dann mit einer Größe zoom dargestellt werden. In diesem Falle hat die Option width keinerlei Einfluss auf die Größe der Darstellung des Gitternetzes.
Für Anwender mit HTML-Kenntnissen lässt sich mittels div definieren, welches DIV-Element zur Zeichnung verwendet werden soll. Genauer wird das DIV-Element mit der ID div zur anschließenden Darstellung des Gitternetzes genutzt. Wird die Option nicht verwendet, wird automatisch ein neues DIV-Element erzeugt.