Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

XRFaceTracker

Expérimental : This class may be changed or removed in future versions.

Hérite de : XRTracker < RefCounted < Object

Un visage suivi.

Description

Une instance de cet objet représente un visage suivi et ses blend shape correspondantes. Les blendshapes proviennent du standard ` Expressions unifiées <https://docs.vrcft.io/docs/tutorial-avatars/tutorial-avatars-extras/unified-blendshapes>`__ et contient des détails et des visuels étendus pour chaque forme de mélange. En outre, ` Comparaison des standards de suivi <https://docs.vrcft.io/docs/tutorial-avatars/tutorial-avatars-extras/compatibility/overview>`__ documente la relation entre les expressions unifiées et les autres standards.

Tant que les trackers de visage sont allumés, ils sont enregistrés avec le XRServer.

Tutoriels

Propriétés

PackedFloat32Array

blend_shapes

PackedFloat32Array()

TrackerType

type

64 (overrides XRTracker)

Méthodes

float

get_blend_shape(blend_shape: BlendShapeEntry) const

void

set_blend_shape(blend_shape: BlendShapeEntry, weight: float)


Énumérations

enum BlendShapeEntry: 🔗

BlendShapeEntry FT_EYE_LOOK_OUT_RIGHT = 0

L'œil droit regarde vers l'extérieur.

BlendShapeEntry FT_EYE_LOOK_IN_RIGHT = 1

L'œil droit regarde vers l'intérieur.

BlendShapeEntry FT_EYE_LOOK_UP_RIGHT = 2

L'œil droit regarde vers le haut.

BlendShapeEntry FT_EYE_LOOK_DOWN_RIGHT = 3

L'œil droit regarde vers le bas.

BlendShapeEntry FT_EYE_LOOK_OUT_LEFT = 4

L'œil gauche regarde vers l'extérieur.

BlendShapeEntry FT_EYE_LOOK_IN_LEFT = 5

L'œil gauche regarde vers l'intérieur.

BlendShapeEntry FT_EYE_LOOK_UP_LEFT = 6

L'œil gauche regarde vers le haut.

BlendShapeEntry FT_EYE_LOOK_DOWN_LEFT = 7

L'œil gauche regarde vers le bas.

BlendShapeEntry FT_EYE_CLOSED_RIGHT = 8

Ferme la paupière droite.

BlendShapeEntry FT_EYE_CLOSED_LEFT = 9

Ferme la paupière gauche.

BlendShapeEntry FT_EYE_SQUINT_RIGHT = 10

Serre les muscles autour de l’œil droit.

BlendShapeEntry FT_EYE_SQUINT_LEFT = 11

Serre les muscles autour de l’œil gauche.

BlendShapeEntry FT_EYE_WIDE_RIGHT = 12

La paupière droite s'élargit au-delà de relaxée.

BlendShapeEntry FT_EYE_WIDE_LEFT = 13

La paupière gauche s'élargit au-delà de relaxée.

BlendShapeEntry FT_EYE_DILATION_RIGHT = 14

Dilate la pupille de l’œil droit.

BlendShapeEntry FT_EYE_DILATION_LEFT = 15

Dilate la pupille de l’œil gauche.

BlendShapeEntry FT_EYE_CONSTRICT_RIGHT = 16

Constricte la pupille de l’œil droit.

BlendShapeEntry FT_EYE_CONSTRICT_LEFT = 17

Constricte la pupille de l’œil gauche.

BlendShapeEntry FT_BROW_PINCH_RIGHT = 18

Le sourcil droit se fronce.

BlendShapeEntry FT_BROW_PINCH_LEFT = 19

Le sourcil gauche se fronce.

BlendShapeEntry FT_BROW_LOWERER_RIGHT = 20

Le sourcil droit extérieur descend.

BlendShapeEntry FT_BROW_LOWERER_LEFT = 21

Le sourcil gauche extérieur descend.

BlendShapeEntry FT_BROW_INNER_UP_RIGHT = 22

Le sourcil droit intérieur monte.

BlendShapeEntry FT_BROW_INNER_UP_LEFT = 23

Le sourcil gauche intérieur monte.

BlendShapeEntry FT_BROW_OUTER_UP_RIGHT = 24

Le sourcil droit extérieur se lève.

BlendShapeEntry FT_BROW_OUTER_UP_LEFT = 25

Le sourcil gauche extérieur se lève.

BlendShapeEntry FT_NOSE_SNEER_RIGHT = 26

Le côté droit du visage ricane.

BlendShapeEntry FT_NOSE_SNEER_LEFT = 27

Le côté gauche du visage ricane.

BlendShapeEntry FT_NASAL_DILATION_RIGHT = 28

Le canal nasal droit se dilate.

BlendShapeEntry FT_NASAL_DILATION_LEFT = 29

Le canal nasal gauche se dilate.

BlendShapeEntry FT_NASAL_CONSTRICT_RIGHT = 30

Le canal nasal droit se resserre.

BlendShapeEntry FT_NASAL_CONSTRICT_LEFT = 31

Le canal nasal gauche se resserre.

BlendShapeEntry FT_CHEEK_SQUINT_RIGHT = 32

Soulève la joue droite.

BlendShapeEntry FT_CHEEK_SQUINT_LEFT = 33

Soulève la joue gauche.

BlendShapeEntry FT_CHEEK_PUFF_RIGHT = 34

Gonfle la joue droite.

BlendShapeEntry FT_CHEEK_PUFF_LEFT = 35

Gonfle la joue gauche.

BlendShapeEntry FT_CHEEK_SUCK_RIGHT = 36

Aspire la joue droite.

BlendShapeEntry FT_CHEEK_SUCK_LEFT = 37

Aspire la joue gauche.

BlendShapeEntry FT_JAW_OPEN = 38

Ouvre le maxillaire.

BlendShapeEntry FT_MOUTH_CLOSED = 39

Ferme la bouche.

BlendShapeEntry FT_JAW_RIGHT = 40

Pousse la mâchoire à droite.

BlendShapeEntry FT_JAW_LEFT = 41

Pousse la mâchoire à gauche.

BlendShapeEntry FT_JAW_FORWARD = 42

Pousse la mandibule en avant.

BlendShapeEntry FT_JAW_BACKWARD = 43

Pousse la mandibule en arrière.

BlendShapeEntry FT_JAW_CLENCH = 44

Fléchit les muscles de la mâchoire.

BlendShapeEntry FT_JAW_MANDIBLE_RAISE = 45

Remonte la mâchoire.

BlendShapeEntry FT_LIP_SUCK_UPPER_RIGHT = 46

La lèvre supérieure droite est rentrée dans la bouche.

BlendShapeEntry FT_LIP_SUCK_UPPER_LEFT = 47

La lèvre supérieure gauche est rentrée dans la bouche.

BlendShapeEntry FT_LIP_SUCK_LOWER_RIGHT = 48

La lèvre inférieure droite est rentrée dans la bouche.

BlendShapeEntry FT_LIP_SUCK_LOWER_LEFT = 49

La lèvre inférieure gauche est rentrée dans la bouche.

BlendShapeEntry FT_LIP_SUCK_CORNER_RIGHT = 50

Le coin de la lèvre droit se plie dans la bouche.

BlendShapeEntry FT_LIP_SUCK_CORNER_LEFT = 51

Le coin de la lèvre gauche se plie dans la bouche.

BlendShapeEntry FT_LIP_FUNNEL_UPPER_RIGHT = 52

La lèvre supérieure droite fait un entonnoir.

BlendShapeEntry FT_LIP_FUNNEL_UPPER_LEFT = 53

La lèvre supérieure gauche fait un entonnoir.

BlendShapeEntry FT_LIP_FUNNEL_LOWER_RIGHT = 54

La lèvre inférieure droite fait un entonnoir.

BlendShapeEntry FT_LIP_FUNNEL_LOWER_LEFT = 55

La lèvre inférieure gauche fait un entonnoir.

BlendShapeEntry FT_LIP_PUCKER_UPPER_RIGHT = 56

La lèvre supérieure droit pousse vers l'extérieur.

BlendShapeEntry FT_LIP_PUCKER_UPPER_LEFT = 57

La lèvre supérieure gauche pousse vers l'extérieur.

BlendShapeEntry FT_LIP_PUCKER_LOWER_RIGHT = 58

La lèvre inférieur droit pousse vers l'extérieur.

BlendShapeEntry FT_LIP_PUCKER_LOWER_LEFT = 59

La lèvre inférieur gauche pousse vers l'extérieur.

BlendShapeEntry FT_MOUTH_UPPER_UP_RIGHT = 60

Le côté en haut à droite des lèvres se lève.

BlendShapeEntry FT_MOUTH_UPPER_UP_LEFT = 61

Le côté en haut à gauche des lèvres se lève.

BlendShapeEntry FT_MOUTH_LOWER_DOWN_RIGHT = 62

Le côté en bas à droite des lèvres se lève.

BlendShapeEntry FT_MOUTH_LOWER_DOWN_LEFT = 63

Le côté en bas à gauche des lèvres se lève.

BlendShapeEntry FT_MOUTH_UPPER_DEEPEN_RIGHT = 64

La lèvre supérieure droit rentre dans la joue.

BlendShapeEntry FT_MOUTH_UPPER_DEEPEN_LEFT = 65

La lèvre supérieure gauche rentre dans la joue.

BlendShapeEntry FT_MOUTH_UPPER_RIGHT = 66

Déplace la lèvre supérieure vers la droite.

BlendShapeEntry FT_MOUTH_UPPER_LEFT = 67

Déplace la lèvre supérieure vers la gauche.

BlendShapeEntry FT_MOUTH_LOWER_RIGHT = 68

Déplace la lèvre inférieure vers la droite.

BlendShapeEntry FT_MOUTH_LOWER_LEFT = 69

Déplace la lèvre inférieure vers la gauche.

BlendShapeEntry FT_MOUTH_CORNER_PULL_RIGHT = 70

La coin droit des lèvres est tiré en diagonal haut vers l'extérieur.

BlendShapeEntry FT_MOUTH_CORNER_PULL_LEFT = 71

La coin gauche des lèvres est tiré en diagonal haut vers l'extérieur.

BlendShapeEntry FT_MOUTH_CORNER_SLANT_RIGHT = 72

Le coin droit des lèvres s'incline vers le haut.

BlendShapeEntry FT_MOUTH_CORNER_SLANT_LEFT = 73

Le coin gauche des lèvres s'incline vers le haut.

BlendShapeEntry FT_MOUTH_FROWN_RIGHT = 74

Le coin droit des lèvres s'incline vers le bas.

BlendShapeEntry FT_MOUTH_FROWN_LEFT = 75

Le coin gauche des lèvres s'incline vers le bas.

BlendShapeEntry FT_MOUTH_STRETCH_RIGHT = 76

Le coin de la lèvre est tiré à l'extérieur et en bas.

BlendShapeEntry FT_MOUTH_STRETCH_LEFT = 77

Le coin de la lèvre est tiré à l'extérieur et en bas.

BlendShapeEntry FT_MOUTH_DIMPLE_RIGHT = 78

Le coin de droite des lèvres est poussé en arrière.

BlendShapeEntry FT_MOUTH_DIMPLE_LEFT = 79

Le coin de gauche des lèvres est poussé en arrière.

BlendShapeEntry FT_MOUTH_RAISER_UPPER = 80

Relève et pousse légèrement vers l'extérieur la bouche supérieure.

BlendShapeEntry FT_MOUTH_RAISER_LOWER = 81

Relève et pousse légèrement vers l'extérieur la bouche inférieure.

BlendShapeEntry FT_MOUTH_PRESS_RIGHT = 82

Le côté droit des lèvres se presse et s’aplatit ensemble verticalement.

BlendShapeEntry FT_MOUTH_PRESS_LEFT = 83

Le côté gauche des lèvres se presse et s’aplatit ensemble verticalement.

BlendShapeEntry FT_MOUTH_TIGHTENER_RIGHT = 84

Le côté droit des lèvres se serre horizontalement.

BlendShapeEntry FT_MOUTH_TIGHTENER_LEFT = 85

Le côté gauche des lèvres se serre horizontalement.

BlendShapeEntry FT_TONGUE_OUT = 86

La langue sort de la bouche de manière visible.

BlendShapeEntry FT_TONGUE_UP = 87

La langue pointe vers le haut.

BlendShapeEntry FT_TONGUE_DOWN = 88

La langue pointe vers le bas.

BlendShapeEntry FT_TONGUE_RIGHT = 89

La langue pointe vers la droite.

BlendShapeEntry FT_TONGUE_LEFT = 90

La langue pointe vers la gauche.

BlendShapeEntry FT_TONGUE_ROLL = 91

Les côtés de la langue se relèvent, créant un entonnoir.

BlendShapeEntry FT_TONGUE_BLEND_DOWN = 92

La langue se courbe vers le haut puis vers le bas à l'intérieur de la bouche.

BlendShapeEntry FT_TONGUE_CURL_UP = 93

La langue se courbe vers le bas puis vers le haut à l'intérieur de la bouche.

BlendShapeEntry FT_TONGUE_SQUISH = 94

La langue se comprime et s'épaissit.

BlendShapeEntry FT_TONGUE_FLAT = 95

La langue s’aplatit et s'affine.

BlendShapeEntry FT_TONGUE_TWIST_RIGHT = 96

La pointe de la langue tourne dans le sens des aiguilles d'une montre, le reste suivant progressivement.

BlendShapeEntry FT_TONGUE_TWIST_LEFT = 97

La pointe de la langue tourne dans le sens inverse des aiguilles d'une montre, le reste suivant progressivement.

BlendShapeEntry FT_SOFT_PALATE_CLOSE = 98

La gorge interne de la bouche se ferme.

BlendShapeEntry FT_THROAT_SWALLOW = 99

La pomme d'Adam avale de manière visible.

BlendShapeEntry FT_NECK_FLEX_RIGHT = 100

La nuque droite se contracte de manière visible.

BlendShapeEntry FT_NECK_FLEX_LEFT = 101

La nuque gauche se contracte de manière visible.

BlendShapeEntry FT_EYE_CLOSED = 102

Ferme les deux paupières.

BlendShapeEntry FT_EYE_WIDE = 103

Élargit les deux paupières.

BlendShapeEntry FT_EYE_SQUINT = 104

Plisse les deux paupières.

BlendShapeEntry FT_EYE_DILATION = 105

Dilate les deux pupilles.

BlendShapeEntry FT_EYE_CONSTRICT = 106

Constricte les deux pupilles.

BlendShapeEntry FT_BROW_DOWN_RIGHT = 107

Tire le sourcil droit en bas et à l'intérieur.

BlendShapeEntry FT_BROW_DOWN_LEFT = 108

Tire le sourcil gauche en bas et à l'intérieur.

BlendShapeEntry FT_BROW_DOWN = 109

Tire les deux sourcils en bas et à l'intérieur.

BlendShapeEntry FT_BROW_UP_RIGHT = 110

Le sourcil droit semble inquiet.

BlendShapeEntry FT_BROW_UP_LEFT = 111

Le sourcil gauche semble inquiet.

BlendShapeEntry FT_BROW_UP = 112

Les deux sourcils semblent inquiets.

BlendShapeEntry FT_NOSE_SNEER = 113

Tout le visage ricane.

BlendShapeEntry FT_NASAL_DILATION = 114

Les deux canaux du nez se dilatent.

BlendShapeEntry FT_NASAL_CONSTRICT = 115

Les deux canaux du nez se constrictent.

BlendShapeEntry FT_CHEEK_PUFF = 116

Gonfle les deux joues.

BlendShapeEntry FT_CHEEK_SUCK = 117

Aspire les deux joues.

BlendShapeEntry FT_CHEEK_SQUINT = 118

Lève les deux joues.

BlendShapeEntry FT_LIP_SUCK_UPPER = 119

Rentre la lèvre supérieure.

BlendShapeEntry FT_LIP_SUCK_LOWER = 120

Rentre la lèvre inférieure.

BlendShapeEntry FT_LIP_SUCK = 121

Rentre les deux lèvres.

BlendShapeEntry FT_LIP_FUNNEL_UPPER = 122

Les lèvres supérieures font un entonnoir.

BlendShapeEntry FT_LIP_FUNNEL_LOWER = 123

Les lèvres inférieures font un entonnoir.

BlendShapeEntry FT_LIP_FUNNEL = 124

Funnels in both lips.

BlendShapeEntry FT_LIP_PUCKER_UPPER = 125

La lèvre supérieure pousse vers l’extérieur.

BlendShapeEntry FT_LIP_PUCKER_LOWER = 126

La lèvre inférieure pousse vers l’extérieur.

BlendShapeEntry FT_LIP_PUCKER = 127

Les lèvres poussent vers l'extérieur.

BlendShapeEntry FT_MOUTH_UPPER_UP = 128

Lève les lèvres supérieures.

BlendShapeEntry FT_MOUTH_LOWER_DOWN = 129

Baisse les lèvres inférieures.

BlendShapeEntry FT_MOUTH_OPEN = 130

La bouche s'ouvre, révélant les dents.

BlendShapeEntry FT_MOUTH_RIGHT = 131

Déplace la bouche vers la droite.

BlendShapeEntry FT_MOUTH_LEFT = 132

Déplace la joue à gauche.

BlendShapeEntry FT_MOUTH_SMILE_RIGHT = 133

Le côté droit de la bouche sourit.

BlendShapeEntry FT_MOUTH_SMILE_LEFT = 134

Le côté gauche de la bouche sourit.

BlendShapeEntry FT_MOUTH_SMILE = 135

La bouche exprime un sourire.

BlendShapeEntry FT_MOUTH_SAD_RIGHT = 136

Le côté droit de la bouche exprime de la tristesse.

BlendShapeEntry FT_MOUTH_SAD_LEFT = 137

Le côté gauche de la bouche exprime de la tristesse.

BlendShapeEntry FT_MOUTH_SAD = 138

La bouche exprime de la tristesse.

BlendShapeEntry FT_MOUTH_STRETCH = 139

La bouche s'étire.

BlendShapeEntry FT_MOUTH_DIMPLE = 140

Les angles de la lèvre se creusent.

BlendShapeEntry FT_MOUTH_TIGHTENER = 141

La bouche se serre.

BlendShapeEntry FT_MOUTH_PRESS = 142

La bouche se presse ensemble.

BlendShapeEntry FT_MAX = 143

Représente la taille de l'énumération BlendShapeEntry.


Descriptions des propriétés

PackedFloat32Array blend_shapes = PackedFloat32Array() 🔗

Le tableau de poids des blend shape de visage avec des indices correspondant à l'énumération BlendShapeEntry.

Note: The returned array is copied and any changes to it will not update the original property value. See PackedFloat32Array for more details.


Descriptions des méthodes

float get_blend_shape(blend_shape: BlendShapeEntry) const 🔗

Renvoie le poids de la blend shape de visage demandée.


void set_blend_shape(blend_shape: BlendShapeEntry, weight: float) 🔗

Définit un poids de blend shape de visage.