Collect

Kategorie: Objekte / Inhalt
Ab Engineversion: 1.0 OC

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 item auf den Entrance-Bereich von target/this() gemacht wird, und dass item 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 false zurück. Ansonsten true.

Syntax

bool Collect(object item, bool ignore_ocf);

Parameter

item:
Objekt, das aufgesammelt werden soll
ignore_ocf:
Ignores the fact that a container must have OCF_Collection for it to collect an object.

Beispiel

protected func ContainedUse(object clonk)
{
	var obj = Contents();
	if (obj)
		if (!clonk->Collect(obj))
			clonk->Message("Collect not possible.",clonk);
	return true;
}
Mit contained use wird das erste Inhaltsobjekt an den ausgewählten Clonk übergeben.
Siehe auch: Enter
Sven2, 2002-05