CreateEntity

CreateEntity()

Syntaxe

Resultat = CreateEntity(#Entity, MeshID, MatiereID, [X, Y, Z [, MasqueSelection [, MasqueVisibilite]])

Description

Crée une nouvelle entité utilisant un mesh et une matière.

Arguments

#Entity Numéro de l'entité.

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

MeshID Le mesh à utiliser.

Pour obtenir un identifiant valide, utiliser MeshID().

Les meshes dynamiques (créés avec l'option #PB_Mesh_Dynamic) ne sont pas autorisés.

MatiereID La matière à utiliser.

Pour obtenir un identifiant valide, utilisez MaterialID().

X, Y, Z (optionnel) La position de la nouvelle entité dans le monde.
MasqueSelection (optionnel)
Utilisé par RayPick() et MousePick() pour sélectionner le groupe d'entités qui sera traité.

Comme il s'agit d'un masque, chaque valeur doit être une puissance de deux et 31 masques différents sont disponibles.

Pour créer une valeur de masque facilement, l'opérateur '<<' peut être utilisé:
  - 1 << 1  : Première valeur de masque valide
  - 1 << 2  : Deuxième valeur de masque valide
  - 1 << 3  : Troisième valeur de masque valide
  - ...
  - 1 << 31 : Dernières valeur de masque valide
Pour faciliter l'utilisation, les constantes doivent être utilisées pour stocker la valeur du masque.

Lorsque vous appelez les fonctions de sélection, les masques peuvent être combinés avec l'opérateur '|' pour sélectionner plus d'un type d'entité.
MasqueVisibilite (optionnel) Un masque à choisir sur la caméra qui affiche l'entité.

Si ce masque correspond au masque spécifié par CreateCamera() alors l'entité sera affichée par la caméra.
Voir l'option 'MasqueSelection' ci-dessus pour construire des masques appropriés.

Si ce paramètre est omis alors l'entité sera visible par toutes les caméras.

Valeur de retour

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

Si l'entité était déjà créée, elle est automatiquement supprimée et remplacée par la nouvelle.

Voir aussi

FreeEntity(), HideEntity(), IsEntity()

OS Supportés

Tous

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

#Entity	Numéro de l'entité. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
MeshID	Le mesh à utiliser. Pour obtenir un identifiant valide, utiliser MeshID(). Les meshes dynamiques (créés avec l'option #PB_Mesh_Dynamic) ne sont pas autorisés.
MatiereID	La matière à utiliser. Pour obtenir un identifiant valide, utilisez MaterialID().
X, Y, Z (optionnel)	La position de la nouvelle entité dans le monde.
MasqueSelection (optionnel)	Utilisé par RayPick() et MousePick() pour sélectionner le groupe d'entités qui sera traité. Comme il s'agit d'un masque, chaque valeur doit être une puissance de deux et 31 masques différents sont disponibles. Pour créer une valeur de masque facilement, l'opérateur '<<' peut être utilisé: - 1 << 1 : Première valeur de masque valide - 1 << 2 : Deuxième valeur de masque valide - 1 << 3 : Troisième valeur de masque valide - ... - 1 << 31 : Dernières valeur de masque valide Pour faciliter l'utilisation, les constantes doivent être utilisées pour stocker la valeur du masque. Lorsque vous appelez les fonctions de sélection, les masques peuvent être combinés avec l'opérateur '\|' pour sélectionner plus d'un type d'entité.
MasqueVisibilite (optionnel)	Un masque à choisir sur la caméra qui affiche l'entité. Si ce masque correspond au masque spécifié par CreateCamera() alors l'entité sera affichée par la caméra. Voir l'option 'MasqueSelection' ci-dessus pour construire des masques appropriés. Si ce paramètre est omis alors l'entité sera visible par toutes les caméras.