GetMaterial

Kategorie: Landschaft / Material
Ab Engineversion: 1.0 OC

Beschreibung

Fragt das Material an einer bestimmten Stelle der Landschaft ab. Der zurückgegebene Wert ist ein Materialindex, der mit anderen Indizes zum Beispiel über die Funktion Material() verglichen werden kann. Für Himmel gibt die Funktion -1 zurück.

Syntax

int GetMaterial(int x, int y);

Parameter

x:
X-Position, an der das Material abgefragt werden soll. Offset bei lokalem Aufruf.
y:
Y-Position, an der das Material abgefragt werden soll. Offset bei lokalem Aufruf.

Anmerkung

Die Funktion erfasst nur feste Materialpixel, also beispielsweise keinen herunterrieselnden Schnee. Materialflächen, die nur über den MassMover in Bewegung sind, werden natürlich erfasst.

Beispiel

if(GetMaterial(0, +200) == Material("Oil")) Message("I am rich!");
Teil eines Clonkscripts: Wenn 200 Pixel unterhalb des aufrufenden Objekts Öl ist, wird eine entsprechende Meldung über dem Objekt ausgegeben.
Siehe auch: GBackLiquid, GBackSolid, GetBackMaterial, InsertMaterial, Material
Sven2, 2002-08