GetComponent

Kategorie: Objekte / Komponenten
Ab Engineversion: 4.6.5.0 CP

Beschreibung

Liefert Objektkomponenten.

Syntax

int / id GetComponent (id idComponent, int iIndex, object pObj, id idDef);

Parameter

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

Beispiel

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