CreateEntity()

Syntax

Ergebnis = CreateEntity(#Entity, MeshID, MaterialID, [x, y, z [, PickMaske [, SichtbarkeitsMaske]])
Beschreibung
Erstellt ein neues Entity-Objekt mittels dem angegebenen Mesh und Material.

Parameter

#Entity Die Nummer zum Identifizieren des neuen Entity. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
MeshID Das für die Erstellung des Entity zu verwendende Mesh. Um eine gültige Mesh-ID zu erhalten, verwenden Sie MeshID(). Dynamische Meshes werden nicht unterstützt (= Meshes, welche mit dem #PB_Mesh_Dynamic Flag erstellt wurden).
MaterialID Das für die Erstellung des Entity zu verwendende Material. Um eine gültige Material-ID zu erhalten, verwenden Sie MaterialID().
#PB_Material_None kann als Parameter-Wert verwendet werden, um das dem Mesh zugewiesene .material Skript zu verwenden. Vor der Verwendung von #PB_Material_None sollte Parse3DScripts() aufgerufen werden.
x, y, z (optional) Die Position des neuen Entity in der Welt.
PickMaske (optional) Ein spezieller Wert, der von RayPick() und MousePick() verwendet wird, um auszuwählen, welche Entity-Gruppe behandelt wird. Da es eine Maske ist, sollte jeder Wert eine Potenz von zwei sein. 31 verschiedene Masken sind verfügbar. Um einfach einen Masken-Wert zu erstellen, kann der '<<' Operator verwendet werden:
  - 1 << 1  : erster gültiger Masken-Wert
  - 1 << 2  : zweiter gültiger Masken-Wert
  - 1 << 3  : dritter gültiger Masken-Wert
  - ...
  - 1 << 31 : letzter gültiger Masken-Wert
Um deren Verwendung zu vereinfachen, sollten Konstanten für die Speicherung des Masken-Werts und dessen spätere Verwendung genutzt werden. Beim Aufrufen der "Pick"-Funktionen können Masken mit Hilfe des '|' Operators kombiniert werden, um mehr als einen Typ von Entities auszuwählen.
SichtbarkeitsMaske (optional) Eine Maske, um auszuwählen, auf welcher Kamera das Entity angezeigt werden soll. Wenn diese Maske zu der bei CreateCamera() spezifizierten Maske passt, wird das Entity auf der Kamera dargestellt. Siehe 'PickMaske' zum Erstellen korrekter Masken. Wenn dieser Parameter weggelassen wird, dann wird das Entity auf allen Kameras sichtbar sein.

Rückgabewert

Gibt null zurück, wenn das Entity nicht erstellt werden konnte. Wenn #PB_Any als '#Entity' Parameter verwendet wird, dann wird die neue Entity-Nummer zurückgegeben.

Siehe auch

FreeEntity()

Unterstützte OS

Alle

<- CopyEntity() - Entity Inhaltsverzeichnis - CreateEntityBody() ->