PlaceObjects

Kategorie: Objekte / Erzeugung
Ab Engineversion: 1.0 OC

Beschreibung

Erzeugt amount viele Objekte im angegebenen Zielrechteck (optional) im angegebenen Material. Gibt die Anzahl der Iterationen zurück, oder -1 wenn die Erzeugung fehlschlägt.

Syntax

int PlaceObjects(id definition, int amount, string material_name, int x, int y, int width, int height, bool on_surface, bool no_stuck);

Parameter

definition:

ID des zu platzierenden Objekts

amount:

Menge der zu erzeugenden Objekte

material_name:

Material in which object are to be created. This can be a material name or a string as follows:

material_index	Erzeugung in
"GBackSolid"	Objekte werden in festem Material erzeugt. Siehe auch GBackSolid()
"GBackSemiSolid"	Objekte werden in festem oder flüssigem Material erzeugt. Siehe auch GBackSemiSolid()
"GBackLiquid"	Objekte werden in flüssigem Material erzeugt. Siehe auch GBackLiquid()
"GBackSky"	Objekte werden im freien Himmel erzeugt. Siehe auch GBackSky()

x:

[opt] Linke Kante der Position. Bei lokalem Aufruf Offset zum aufrufenden Objekt.

y:

[opt] Obere Kante der Position. Bei lokalem Aufruf Offset zum aufrufenden Objekt.

width:

[opt] Platzierrechteck Breite. Wenn nicht angegeben wird das Ende der Landschaft angenommen

height:

[opt] Platzierrechteck Höhe. Wenn nicht angegeben wird das Ende der Landschaft angenommen

on_surface:

[opt] Wenn true, werden alle Objekte oberhalb des angegeben Materials erzeugt. (Ohne Berücksichtigung des Zielrechtecks)

no_stuck:

[opt] Wenn true, wird nicht sichergestellt dass des Objekt fest in der Erde ist. Dies ist z.B.: nötig wenn man Objekte im Flüssigkeiten erstellen will.

Anmerkung

Je weniger vom angegeben Material vorhanden ist, desto Rechenintensiver ist die Platzierung.
Es wird sichergestellt, dass keine Endlosschleife entsteht.

Beispiele

PlaceObjects(Loam,20,"Earth",100,0,200)

Erzeugt 20 Lehmklumpen in Erde innherhalb der Koordinaten 100,0 und 200,LandscapeHeight()

PlaceObjects(Fish,10,"GBackLiquid",0,0,0,LandscapeHeight()/2,0,1);

Erzeugt insgesamt 10 Fische in allen Flüssigkeiten die sich in der oberen Landschaftshälfte befinden

Siehe auch: CreateObject

Tyron, 2004-08