Expressions de l'éditeur de graphes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Une expression est une courte formule similaire à Luau qui lit les paramètres du graphe et renvoie une valeur, comme math.clamp((MovementSpeed + 0.5) / MaxSpeed, 0, 1). Utilisez des expressions pour piloter une propriété de nœud ou une transition de machine d'état. Les expressions conservent les transformations de paramètres et les décisions d'animation dans votre graphe, près des nœuds qu'elles pilotent.

Prérequis

Avant de créer une expression, familiarisez-vous avec l'éditeur de graphes d'animation, y compris comment l'ouvrir et créer un graphe d'animation.

Créer une expression

Cet exemple utilise une expression pour piloter la propriété Position d'un Blend1DNode. Configurez le nœud avec une animation d'attente à la position 0 et une animation de course à la position 1. L'expression convertit la vitesse de mouvement du personnage dans la plage de 0 à 1 que le nœud utilise pour mélanger ces animations.

  1. Ajoutez les paramètres de graphe de type Nombre MovementSpeed et MaxSpeed.

    Panneau des paramètres montrant les paramètres de type Nombre MovementSpeed et MaxSpeed.
  2. Faites glisser une connexion depuis la broche de propriété Position du Blend1DNode et sélectionnez Nouvelle Expression.

    Démonstration animée de la création d'un nœud d'expression à partir de la broche de propriété Position de Blend1D.
  3. Entrez l'expression suivante :

    math.clamp(MovementSpeed / MaxSpeed, 0, 1)
    Démonstration animée de l'entrée d'une expression dans un nœud d'expression.
  4. Cliquez en dehors de la boîte d'expression pour la rafraîchir. À mesure que MovementSpeed augmente vers MaxSpeed, le Blend1DNode reçoit une valeur de 0 à 1 et passe de l'animation d'attente à l'animation de course.

Après avoir chargé le graphe sur un AnimationTrack, mettez à jour MovementSpeed et MaxSpeed depuis votre script de jeu avec AnimationTrack:SetParameter(). L'exemple suivant utilise les propriétés MoveDirection et WalkSpeed d'un Humanoid :

Script - Piloter les paramètres d'expression
game:GetService("RunService").Stepped:Connect(function()
animationTrack:SetParameter("MovementSpeed", humanoid.MoveDirection.Magnitude * humanoid.WalkSpeed)
animationTrack:SetParameter("MaxSpeed", humanoid.WalkSpeed)
end)

L'expression s'évalue à mesure que les valeurs des paramètres changent. Pour le flux de travail des paramètres, voir Intégration API.

Ce qui est pris en charge

Le support des expressions inclut les opérations arithmétiques et de comparaison, les expressions logiques et conditionnelles, les appels de fonctions dans la bibliothèque math, la construction et l'accès aux membres pour les valeurs CFrame, Vector2, Vector3 et Color3, ainsi que la concaténation de chaînes. Les sections suivantes énumèrent la syntaxe et les fonctions prises en charge.

Arithmétique et comparaisons

Utilisez les opérations arithmétiques et de comparaison standard, avec l'ordre habituel des opérations. Par exemple, // divise et arrondit vers le bas.

Speed * 2.0 + Offset
(Health / MaxHealth) * 100
DamageMultiplier ^ 2
Count % 3
10 // 3
Speed < 1
Health >= MaxHealth

Les opérateurs de comparaison fonctionnent avec des nombres. Utilisez == et ~= pour comparer des nombres, des booléens ou des chaînes.

Logique et court-circuit

and, or et not suivent la vérité de Luau et l'évaluation par court-circuit. Seuls false et nil sont considérés comme faux.

IsGrounded and GroundSpeed or AirSpeed
not IsDisabled

Expressions if-then-else

Utilisez la forme d'expression conditionnelle de Luau pour créer des branches au sein d'une seule expression :

if Speed > 10 then "sprint" elseif Speed > 2 then "run" else "idle"

Bibliothèque mathématique

Utilisez la bibliothèque math. Les expressions de graphe ne prennent pas encore en charge math.frexp(), math.noise() ou math.randomseed(). math.modf() renvoie actuellement uniquement la portion entière.

math.clamp(Speed / MaxSpeed, 0, 1)
math.sin(Time * 2 * math.pi)
math.atan2(Direction.Y, Direction.X)
math.max(A, B, C)

Construction de vecteurs et accès aux membres

Construisez des valeurs Vector2 et Vector3, effectuez des opérations arithmétiques sur les vecteurs et accédez aux membres des vecteurs tels que Magnitude et Unit.

Vector3.new(math.cos(Time), math.sin(Time), 0)
Vector2.new(InputX, InputY)
MoveDirection.Magnitude * 2.0
Position.X + Offset
Vector3.zero

Construction de Color3 et accès aux membres

Construisez des valeurs Color3 et accédez à leurs canaux de couleur.

Color3.fromRGB(255, 128, 0)
Color.R

Construction de CFrame, accès aux membres et opérations

Construisez des valeurs CFrame, accédez aux membres de CFrame et combinez-les avec des CFrames ou des valeurs Vector3.

CFrame.new(Position, LookAtPosition)
CFrame.Angles(RotationX, RotationY, RotationZ)
CFrame.identity
Transform.LookVector
Transform.Position + Vector3.new(0, 1, 0)

Concaténation de chaînes

Utilisez .. pour concaténer deux chaînes :

"state_" .. CurrentState

Variables locales et expressions multi-lignes

Utilisez une expression multi-lignes pour décomposer une formule en étapes nommées. Une expression multi-lignes prend en charge les déclarations local, return, if/elseif/else, et les expressions autonomes. À l'intérieur d'un corps if ou else, utilisez uniquement return ou une expression autonome ; les instructions if imbriquées et les déclarations locales ne sont pas prises en charge.

local normalizedSpeed = Speed / MaxSpeed
local eased = math.clamp(normalizedSpeed, 0, 1)
return eased
©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.