GetComponent

Kategorie: Objekte / Komponenten
Ab Engineversion: 5.1 OC

Beschreibung

Liefert Objektkomponenten.

Syntax

int / id GetComponent(id component, int index, object obj, id definition);

Parameter

component:
[opt] Objektkomponente, dessen Menge zurückgeliefert werden soll. Wenn 0, wird index benutzt und eine Objektkomponente zurückgegeben.
index:
[opt] Index der zurückzuliefernden Komponente. Dieser Parameter wird ignoriert, wenn component angegeben ist. Ansonsten wird eine ID der Komponente zurückgegeben, dessen Menge in einem darauffolgenden GetComponent-Aufruf ermittelt werden kann.
obj:
[opt] Objekt dessen Komponenten abgefragt werden sollen. nil bei lokalem Aufruf. Wenn stattdessen eine definition angegeben ist, wird dieser Parameter ignoriert.
definition:
[opt] Definition, von der die Komponenten abgefragt werden sollen. Wenn nil, wird stattdessen in obj bzw. dem aufrufenden Objekt abgefragt.

Beispiel

var i,cid,num;
while (id = GetComponent(nil, i++, nil, GetID()))
	if ((num = GetComponent(id) - GetComponent(id, 0, nil, GetID())) > 0)
		while (num--) CreateObject(id);
Erzeugt alle Komponenten, die dem aufrufenden Objekt noch fehlen (z.B. bei einer Baustelle), direkt vor selbigem.
Siehe auch: SetComponent, Split2Components
Cucaracha, 2002-05