Collect

Kategorie: Objekte / Inhalt
Ab Engineversion: 4.9.1.0 GWE

Beschreibung

Sammelt ein Objekt auf. Der Befehl führt dieselben Funktionen aus, als wäre das Objekt durch den normalen Collection-Bereich des Objekts eingesammelt worden (z.B. RejectCollect, Prüfung auf Flagge/Flagge abnehmbar, Hit-Aufruf bei OCF_HitSpeed2, usw.). Die einzigen Unterschiede sind, dass keine Prüfung der Position von pItem auf den Entrance-Bereich von pTarget/this() gemacht wird, und dass pItem nicht auf OCF_Carryable geprüft wird.
Mit diesem Befehl lässt sich beispielsweise das Aufnehmen von Objekten aus Containern heraus realisieren. Wenn die Aufnahme fehlschlug (Beispielsweise durch den RejectCollect-Aufruf oder weil der Container voll war), gibt die Funktion 0 zurück. Ansonsten 1.

Syntax

bool Collect (object pItem, object pTarget);

Parameter

pItem:
Objekt, das aufgesammelt werden soll
pTarget:
[opt] Objekt, das pItem aufsammeln soll. 0 bei lokalem Aufruf.

Beispiel

protected func ControlDig (pClonk)
{
	var obj; if (!(obj = Contents())) return(1);
	if (!Collect(obj, pClonk)) Message("Herausnehmen nicht möglich", pClonk);
	return(1);
}
Auf Graben wird das erste Inhaltsobjekt an den ausgewählten Clonk übergeben.
Siehe auch: Enter
Sven2, Mai 2002