Location
| Variablentyp: location | |
|---|---|
| | |
| | |
| |
Eine Variable des Typs location enthält die Daten eines Punktes auf der Karte in Form von drei Koordinaten, nämlich dem X-, dem Y- und dem Z-Wert. Der Z-Wert ist dabei die Höhe auf der Karte und kann laut Entwicklerkommentar in der common.j deinen asychnronen Wert zurückliefern. Er kann über GetLocationZ abgefragt, jedoch im Gegensatz zum X- und Y-Wert nicht gesetzt werden. Man kann also davon ausgehen, dass er nicht direkt in der Datenstruktur gespeichert, sondern bei einer Abfrage aus den beiden anderen Werten und anhand der Geländedaten berechnet wird. Der Punkt kann auf der X- und Y-Achse mit der Funktion MoveLocation verschoben werden. Auch wenn die Erzeugungsfunktion nicht "CreateLocation", sondern Location heißt, muss der Punkt wieder mittels RemoveLocation entfernt werden, um Speicherlecks zu vermeiden. Falls nur die X- und die Y-Koordinate übergeben oder erhalten werden müssen, lohnt es sich speichertechnisch betrachtet meist eher mit zwei real-Werten zu arbeiten. In vielen Fällen existieren Alternativen zu den Funktionen, die den Rückgabetyp location haben. So kann man entweder mit GetUnitLoc die Position einer Einheit erhalten oder aber die X- und Y-Koordinate dieser mittels GetUnitX und GetUnitY.
