CreateBillboardGroup()
Syntax
Ergebnis = CreateBillboardGroup(#BillboardGroup, MaterialID, StandardBillboardBreite, StandardBillboardHöhe [, x, y, z])Beschreibung
Erstellt eine neue leere Billboard-Gruppe. Das angegebene Material wird von allen Billboards verwendet, die zu dieser Gruppe hinzugefügt werden. Eine gültige 'MaterialID' kann einfach mit dem MaterialID() Befehl ermittelt werden. Die Standardgröße zukünftiger Billboards muss mittels der Parameter 'StandardBillboardBreite' und 'StandardBillboardHöhe' festgelegt werden.
Auch wenn die Größe jedes Billboards separat mit dem ResizeBillboard() Befehl festgelegt werden kann: es ist wichtig zu beachten, dass es sich auf die Leistung niederschlägt, wenn nicht alle Billboards die gleiche Größe verwenden.
Die optionalen x,y und z Parameter können angegeben werden, um die Position der neu erstellten Gruppe innerhalb der Welt festzulegen.
Wenn der beim Aufruf dieses Befehls angegebene numerische Bezeichner (Identifier) bereits zum Erstellen einer Billboard-Gruppe benutzt wurde, dann wird die vorherige Billboard-Gruppe (und ihr gesamter Inhalt) automatisch freigegeben und durch die neue ersetzt.
Parameter
#BillboardGroup - Der numerische Bezeichner (Identifier), welchen Sie beim Aufruf anderer Befehle dieser Library zum Verweis auf die neu erstellte Billboard-Gruppe benutzen wollen.
MaterialID - Die ID-Nummer des Materials, welches für alle mit Hilfe von AddBillboard() zu dieser Gruppe hinzuzufügenden Billboards verwendet werden soll. Die 'MaterialID' kann einfach mit dem MaterialID() Befehl ermittelt werden.
StandardBillboardBreite - Die Standardbreite, in Welt-Einheiten, der dieser Gruppe hinzuzufügenden Billboards.
StandardBillboardHöhe - Die Standardhöhe, in Welt-Einheiten, der dieser Gruppe hinzuzufügenden Billboards.
Die folgenden drei Parameter sind optional, müssen jedoch zusammen angegeben werden.
x - Die absolute X-Position der neuen Billboard-Gruppe innerhalb der Welt.
y - Die absolute Y-Position der neuen Billboard-Gruppe innerhalb der Welt.
z - Die absolute Z-Position der neuen Billboard-Gruppe innerhalb der Welt.
Rückgabewert
Ergebnis - Der von diesem Befehl zurückgegebene Wert wird dafür verwendet, herauszufinden, ob die Billboard-Gruppe erstellt werden konnte oder nicht. Ist der Wert gleich Null, konnte die Billboard-Gruppe nicht erstellt werden. Ist der Wert ungleich Null, dann wurde sie erfolgreich erstellt.
Unterstützte OS
Windows, Linux