SetVertex

Kategorie: Objekte / Vertices
Ab Engineversion: 4.6.5.0 CP (erweitert ab 4.9.5.0 CE)

Beschreibung

Setzt eine Koordinate des indizierten Vertex (siehe DefCore.txt) eines Objekts. Koordinaten in Relation zur Objektmitte.

Syntax

int SetVertex (int iIndex, int iValueToSet, int iValue, object pObj, int iSetCustomPermanent);

Parameter

iIndex:
Index des Vertex.
iValueToSet:
Gibt an, welche Vertexdaten gesetzt werden sollen. 0=VTX_X, 1=VTX_Y, 2=VTX_CNAT, 3=VTX_Friction. Erweitert ab CE.
iValue:
Wert, auf den die Koordinate gesetzt werden soll.
pObj:
[opt] Objekt, dessen Vertices gesetzt werden. 0 bei lokalem Aufruf.
iSetCustomPermanent:
[opt] Wenn 1 (VTX_SetPermanent) oder 2 (VTX_SetPermanentUpd), wird der Wert in den hinteren 25 Vertices gesetzt und aus diesen beim nächsten Shape-Update kopiert. Mit diesem Parameter kann dafür gesorgt werden, dass benutzerdefinierte Vertices auch bei rotierten Objekten erhalten bleiben. Bei Wert 2 werden die gegenwärtigen Objektvertices auch gleich aktualisiert. Ab CE.

Anmerkung

Achtung: Bei jeder Vertexaktualisierung (also beispielsweise dann, wenn sich Fertigstellungswert oder Rotation eines Objekts ändern) werden normalerweise alle Vertices wieder auf die Definitionswerte zurückgesetzt. Um dies zu umgehen, kann der iSetCustomPermanent-Parameter verwendet werden (Beispiel siehe CE-Drache).
Siehe auch: AddVertex, GetVertex, GetVertexNum, RemoveVertex
jwk, August 2002
Sven2, Juni 2004