Formes de collision

Un composant (component) de collision peut utiliser plusieurs formes primitives ou une seule forme complexe.

Formes primitives

Les formes primitives sont la boîte, la sphère et la capsule. Pour ajouter une forme primitive, faites un clic droit sur l’objet de collision et sélectionnez Add Shape :

Forme de boîte

Une boîte possède une position, une rotation et des dimensions (largeur, hauteur et profondeur) :

Forme de sphère

Une sphère possède une position, une rotation et un diamètre :

Forme de capsule

Une capsule possède une position, une rotation, un diamètre et une hauteur :

Formes complexes

Une forme complexe peut être créée à partir d’un composant tilemap ou d’une forme d’enveloppe convexe.

Forme de collision de tilemap

Defold propose une fonctionnalité qui permet de générer facilement des formes physiques pour la source de tuiles utilisée par une tilemap. Le manuel des sources de tuiles explique comment ajouter des groupes de collision à une source de tuiles et affecter des tuiles à ces groupes (exemple).

Pour ajouter des collisions à une tilemap :

1. Ajoutez la tilemap à un objet de jeu (game object) en faisant un clic droit sur l’objet de jeu et en sélectionnant Add Component File. Sélectionnez le fichier de tilemap.
2. Ajoutez un composant d’objet de collision à l’objet de jeu en faisant un clic droit sur l’objet de jeu et en sélectionnant Add Component ▸ Collision Object.
3. Au lieu d’ajouter des formes au composant, définissez la propriété Collision Shape sur le fichier tilemap.
4. Configurez les Properties du composant d’objet de collision comme d’habitude.

Forme d’enveloppe convexe

Defold propose une fonctionnalité qui permet de créer une forme d’enveloppe convexe à partir de trois points ou plus.

1. Créez un fichier de forme d’enveloppe convexe (extension de fichier .convexshape) à l’aide d’un éditeur externe.
2. Modifiez le fichier manuellement à l’aide d’un éditeur de texte ou d’un outil externe (voir ci-dessous)
3. Au lieu d’ajouter des formes au composant d’objet de collision, définissez la propriété Collision Shape sur le fichier de forme convexe.

Format du fichier

Le format de fichier d’enveloppe convexe utilise le même format de données que tous les autres fichiers Defold, à savoir le format texte protobuf. Une forme d’enveloppe convexe définit les points de l’enveloppe. En physique 2D, les points doivent être fournis dans le sens inverse des aiguilles d’une montre. Un nuage de points abstrait est utilisé en mode physique 3D. Exemple en 2D :

shape_type: TYPE_HULL
data: 200.000
data: 100.000
data: 0.0
data: 400.000
data: 100.000
data: 0.0
data: 400.000
data: 300.000
data: 0.0
data: 200.000
data: 300.000
data: 0.0

L’exemple ci-dessus définit les quatre coins d’un rectangle :

 200x300   400x300
    4---------3
    |         |
    |         |
    |         |
    |         |
    1---------2
 200x100   400x100

Outils externes

Plusieurs outils externes peuvent être utilisés pour créer des formes de collision :

• Physics Editor de CodeAndWeb permet de créer des objets de jeu avec des sprites et les formes de collision correspondantes.
• Defold Polygon Editor permet de créer des formes d’enveloppe convexe.
• Physics Body Editor permet de créer des formes d’enveloppe convexe.

Mise à l’échelle des formes de collision

L’objet de collision et ses formes héritent de l’échelle de l’objet de jeu. Pour désactiver ce comportement, décochez la case Allow Dynamic Transforms dans la section Physics de game.project. Notez que seule la mise à l’échelle uniforme est prise en charge et que la plus petite valeur d’échelle sera utilisée si l’échelle n’est pas uniforme.

Redimensionnement des formes de collision

Les formes d’un objet de collision peuvent être redimensionnées à l’exécution à l’aide de physics.set_shape(). Exemple :

-- set capsule shape data
local capsule_data = {
  type = physics.SHAPE_TYPE_CAPSULE,
  diameter = 10,
  height = 20,
}
physics.set_shape("#collisionobject", "my_capsule_shape", capsule_data)

-- set sphere shape data
local sphere_data = {
  type = physics.SHAPE_TYPE_SPHERE,
  diameter = 10,
}
physics.set_shape("#collisionobject", "my_sphere_shape", sphere_data)

-- set box shape data
local box_data = {
  type = physics.SHAPE_TYPE_BOX,
  dimensions = vmath.vector3(10, 10, 5),
}
physics.set_shape("#collisionobject", "my_box_shape", box_data)

Rotation des formes de collision

Rotation des formes de collision en physique 3D

Les formes de collision en physique 3D peuvent être tournées autour de tous les axes.

Rotation des formes de collision en physique 2D

Les formes de collision en physique 2D ne peuvent être tournées qu’autour de l’axe z. Une rotation autour de l’axe x ou y produira des résultats incorrects et doit être évitée, même pour une rotation de 180 degrés destinée à retourner la forme suivant l’axe x ou y. Pour retourner une forme physique, il est recommandé d’utiliser physics.set_hlip(url, flip) et physics.set_vlip(url, flip).

Débogage

Vous pouvez activer le débogage de la physique pour voir les formes de collision à l’exécution.