GetMaterialCount

Kategorie: Landschaft / Material
Ab Engineversion: 4.6.5.0 CP

Beschreibung

Liefert die in der Landschaft vorhandene Menge des angegebenen Materials.

Syntax

int GetMaterialCount (int iMaterial, bool fReal);

Parameter

iMaterial:
Materialsindex
fReal:
Wenn true, wird MinHeightCount in der .c4m-Datei von iMaterial ignoriert.

Anmerkung

Ein Rückgabewert -1 bedeutet, daß noch kein gültiger Wert ermittelt werden konnte. Er kann nicht ermittelt werden, wenn nicht mindestens 500 Frames seit Rundenbeginn vergangen sind, oder NoScan in den Szenarieneigenschaften aktiviert ist. Pixel werden nur alle 500 Frames gezählt, d.h. in diesem Zeitraum gibt die Funktion immer den selben Wert zurück.

Beispiel

/* Spielziel erfüllt? */
public func IsFulfilled()
{
  // Gold noch nicht gezählt?
  if ((var iGold=GetMaterialCount(Material("Gold")))==-1) return();
  // noch zu viel?
  if (iGold >= 150) return();
  // noch Goldstücke abzubauen?
  return(!ObjectCount(GOLD));
}
Auszug aus dem Goldminen-Spielzielobjekt (GLDM).
Siehe auch: Material
wipfmetz, August 2002