CreateBillboardGroup

CreateBillboardGroup()

Syntax

Ergebnis = CreateBillboardGroup(#BillboardGruppe, MaterialID, StandardBillboardBreite, StandardBillboardHöhe [, x, y, z [, SichtbarkeitsMaske [, Typ]]])

Beschreibung

Erstellt eine neue leere Billboard-Gruppe.

Parameter

#BillboardGruppe Die Nummer zum Identifizieren der neuen Billboard-Gruppe. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.

MaterialID Das Material, welches für alle mittels der AddBillboard() Funktion zu dieser Gruppe hinzugefügten Billboards verwendet werden soll. Um eine gültige Material-ID zu erhalten, verwenden Sie MaterialID().

StandardBillboardBreite Die Standardbreite (in Welt-Einheiten) der zu dieser Gruppe hinzugefügten Billboards. Auch wenn die Größe jedes Billboards separat mit dem ResizeBillboard() Befehl festgelegt werden kann: Es ist wichtig zu beachten, dass es sich negativ auf die Leistung niederschlägt, wenn nicht alle Billboards die gleiche Größe verwenden.

StandardBillboardHöhe Die Standardhöhe (in Welt-Einheiten) der zu dieser Gruppe hinzugefügten Billboards. Auch wenn die Größe jedes Billboards separat mit dem ResizeBillboard() Befehl festgelegt werden kann: es ist wichtig zu beachten, dass es sich negativ auf die Leistung niederschlägt, wenn nicht alle Billboards die gleiche Größe verwenden.

x, y, Z (optional) Die absolute Position der neuen Billboard-Gruppe in der Welt.

SichtbarkeitsMaske (optional) Eine Maske zum Auswählen, auf welcher Kamera die Billboard-Gruppe dargestellt werden soll. Wenn diese Maske mit der bei CreateCamera() angegebenen Maske zusammenpasst, dann wird die Billboard-Gruppe auf der Kamera angezeigt. Siehe CreateEntity() zum Aufbau korrekter Masken. Wenn dieser Parameter weggelassen wird, dann wird die Billboard-Gruppe auf allen Kameras sichtbar sein.
Typ (optional)
Der Billboard-Typ. Dies kann einer der folgenden Werte sein:
  #PB_Billboard_Point: Standard-Punkt-Billboard, immer komplett vor der Kamera und immer aufrecht (Standard).
  #PB_Billboard_Oriented: Billboards sind um einen gemeinsamen Richtungsvektor (als Y-Achse verwendet)
                          ausgerichtet und drehen sich nur um diese, um für die Kamera sichtbar zu sein.
  #PB_Billboard_SelfOriented: Billboards sind um ihren eigenen Richtungsvektor (ihre eigene Y-Achse)
                              ausgerichtet und drehen sich nur um diese, um für die Kamera sichtbar zu sein.
  #PB_Billboard_Perpendicular: Billboards sind senkrecht zu einem gemeinsamen Richtungsvektor (verwendet
                               als Z-Achse, der Blickrichtung) und die X- und Y-Achsen werden von einem
                               gemeinsamen Aufwärts-Vektor ("up vector") bestimmt.
  #PB_Billboard_SelfPerpendicular: Billboards sind senkrecht zu ihrem eigenen Richtungsvektor (ihrer eigenen
                                   Z-Achse, der Blickrichtung) und die X- und Y-Achsen werden von einem
                                   gemeinsamen Aufwärts-Vektor ("up vector") bestimmt.

Rückgabewert

Gibt null zurück, wenn die Billboard-Gruppe nicht erstellt werden konnte. Wenn #PB_Any als Parameter '#BillboardGruppe' verwendet wurde, dann wird die Nummer der neuen Billboard-Gruppe zurückgegeben.

Siehe auch

FreeBillboardGroup(), AddBillboard(), BillboardGroupCommonDirection(), BillboardGroupCommonDirection()

Unterstützte OS

Alle

<- CountBillboards() - Billboard Inhaltsverzeichnis - FreeBillboardGroup() ->

#BillboardGruppe	Die Nummer zum Identifizieren der neuen Billboard-Gruppe. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
MaterialID	Das Material, welches für alle mittels der AddBillboard() Funktion zu dieser Gruppe hinzugefügten Billboards verwendet werden soll. Um eine gültige Material-ID zu erhalten, verwenden Sie MaterialID().
StandardBillboardBreite	Die Standardbreite (in Welt-Einheiten) der zu dieser Gruppe hinzugefügten Billboards. Auch wenn die Größe jedes Billboards separat mit dem ResizeBillboard() Befehl festgelegt werden kann: Es ist wichtig zu beachten, dass es sich negativ auf die Leistung niederschlägt, wenn nicht alle Billboards die gleiche Größe verwenden.
StandardBillboardHöhe	Die Standardhöhe (in Welt-Einheiten) der zu dieser Gruppe hinzugefügten Billboards. Auch wenn die Größe jedes Billboards separat mit dem ResizeBillboard() Befehl festgelegt werden kann: es ist wichtig zu beachten, dass es sich negativ auf die Leistung niederschlägt, wenn nicht alle Billboards die gleiche Größe verwenden.
x, y, Z (optional)	Die absolute Position der neuen Billboard-Gruppe in der Welt.
SichtbarkeitsMaske (optional)	Eine Maske zum Auswählen, auf welcher Kamera die Billboard-Gruppe dargestellt werden soll. Wenn diese Maske mit der bei CreateCamera() angegebenen Maske zusammenpasst, dann wird die Billboard-Gruppe auf der Kamera angezeigt. Siehe CreateEntity() zum Aufbau korrekter Masken. Wenn dieser Parameter weggelassen wird, dann wird die Billboard-Gruppe auf allen Kameras sichtbar sein.
Typ (optional)	Der Billboard-Typ. Dies kann einer der folgenden Werte sein: #PB_Billboard_Point: Standard-Punkt-Billboard, immer komplett vor der Kamera und immer aufrecht (Standard). #PB_Billboard_Oriented: Billboards sind um einen gemeinsamen Richtungsvektor (als Y-Achse verwendet) ausgerichtet und drehen sich nur um diese, um für die Kamera sichtbar zu sein. #PB_Billboard_SelfOriented: Billboards sind um ihren eigenen Richtungsvektor (ihre eigene Y-Achse) ausgerichtet und drehen sich nur um diese, um für die Kamera sichtbar zu sein. #PB_Billboard_Perpendicular: Billboards sind senkrecht zu einem gemeinsamen Richtungsvektor (verwendet als Z-Achse, der Blickrichtung) und die X- und Y-Achsen werden von einem gemeinsamen Aufwärts-Vektor ("up vector") bestimmt. #PB_Billboard_SelfPerpendicular: Billboards sind senkrecht zu ihrem eigenen Richtungsvektor (ihrer eigenen Z-Achse, der Blickrichtung) und die X- und Y-Achsen werden von einem gemeinsamen Aufwärts-Vektor ("up vector") bestimmt.