CreateBillboardGroup

CreateBillboardGroup()

Syntaxe

Resultat = CreateBillboardGroup(#BillboardGroup, MatiereID, LargeurBillboard, HauteurBillboard [, X, Y, Z [, MasqueVisibilité [, Type]]]

Description

Créé un nouveau groupe de billboards vide.

Arguments

#BillboardGroup Le numéro du nouveau BillboardGroup.

#PB_Any peut être utilisé pour générer automatiquement ce numéro.

MatiereID La matière spécifiée sera affectée au groupe et par conséquent utilisée par tous les billboards du groupe.

La valeur 'MatiereID' peut être facilement récupérée à l'aide de la commande MaterialID().

LargeurBillboard, HauteurBillboard Les dimensions par défaut (en unité monde) des futurs billboards.

Bien que la taille de chaque futur billboard pourra être definie indépendamment à l'aide de la commande ResizeBillboard(), il est important de garder à l'esprit que des problèmes de performances peuvent très rapidement apparaître si tous les billboards d'un même groupe n'ont pas la même taille.

X, Y, Z (optionnel) La position absolue du nouveau groupe de billboards dans le monde 3D.

MasqueVisibilité (optionnel) Un masque pour choisir sur quelle caméra le groupe de billboards doit être affiché.

Si ce masque correspond au masque spécifié dans CreateCamera() alors l'entité sera visible par la caméra.

Voir CreateEntity() pour construire des masques appropriés.

Si ce paramètre est omis ou #PB_All alors le groupe de billboards sera visible par toutes les caméras.
Type (optionnel)
Peut prendre l'une des valeurs suivantes:
  #PB_Billboard_Point: Billboards de points standards, toujours de face et plein cadre et toujours debout (par défaut). 
  #PB_Billboard_Oriented: Billboards orientés autour d'un vecteur de direction partagé (utilisé comme axe Y) et ne tournent autour de cet axe que pour faire face à la caméra. 
  #PB_Billboard_SelfOriented: Billboards orientés autour de leur propre vecteur de direction (de leur propre axe Y) et ne tournent autour de cet axe que pour faire face à la caméra.
  #PB_Billboard_Perpendicular: Billboards perpendiculaires à un vecteur de direction partagé (utilisé comme axe Z, face à l'écran) et les axes X, Y sont déterminés par un vecteur up commun. 
  #PB_Billboard_SelfPerpendicular: Billboards perpendiculaires à leur propre vecteur de direction (de leur propre axe Z, face à l'écran) et les axes X, Y sont déterminés par par un vecteur up commun.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Remarques

Si le #BillboardGroup est déjà utilisé alors il sera automatiquement détruit (ainsi que tous ses billboards) et remplacé par le nouveau.

Voir aussi

FreeBillboardGroup(), HideBillboardGroup(), IsBillboardGroup(), BillboardGroupID(), AddBillboard(), BillboardGroupCommonDirection(), BillboardGroupCommonDirection()

OS Supportés

Tous

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

#BillboardGroup	Le numéro du nouveau BillboardGroup. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
MatiereID	La matière spécifiée sera affectée au groupe et par conséquent utilisée par tous les billboards du groupe. La valeur 'MatiereID' peut être facilement récupérée à l'aide de la commande MaterialID().
LargeurBillboard, HauteurBillboard	Les dimensions par défaut (en unité monde) des futurs billboards. Bien que la taille de chaque futur billboard pourra être definie indépendamment à l'aide de la commande ResizeBillboard(), il est important de garder à l'esprit que des problèmes de performances peuvent très rapidement apparaître si tous les billboards d'un même groupe n'ont pas la même taille.
X, Y, Z (optionnel)	La position absolue du nouveau groupe de billboards dans le monde 3D.
MasqueVisibilité (optionnel)	Un masque pour choisir sur quelle caméra le groupe de billboards doit être affiché. Si ce masque correspond au masque spécifié dans CreateCamera() alors l'entité sera visible par la caméra. Voir CreateEntity() pour construire des masques appropriés. Si ce paramètre est omis ou #PB_All alors le groupe de billboards sera visible par toutes les caméras.
Type (optionnel)	Peut prendre l'une des valeurs suivantes: #PB_Billboard_Point: Billboards de points standards, toujours de face et plein cadre et toujours debout (par défaut). #PB_Billboard_Oriented: Billboards orientés autour d'un vecteur de direction partagé (utilisé comme axe Y) et ne tournent autour de cet axe que pour faire face à la caméra. #PB_Billboard_SelfOriented: Billboards orientés autour de leur propre vecteur de direction (de leur propre axe Y) et ne tournent autour de cet axe que pour faire face à la caméra. #PB_Billboard_Perpendicular: Billboards perpendiculaires à un vecteur de direction partagé (utilisé comme axe Z, face à l'écran) et les axes X, Y sont déterminés par un vecteur up commun. #PB_Billboard_SelfPerpendicular: Billboards perpendiculaires à leur propre vecteur de direction (de leur propre axe Z, face à l'écran) et les axes X, Y sont déterminés par par un vecteur up commun.