표현식은 그래프 매개변수를 읽고 값을 반환하는 짧은 Luau와 유사한 수식입니다. 예를 들어, math.clamp((MovementSpeed + 0.5) / MaxSpeed, 0, 1)와 같은 수식을 사용할 수 있습니다. 표현식을 사용하여 노드 속성이나 상태 기계 전환을 구동할 수 있습니다. 표현식은 매개변수 변환 및 애니메이션 결정을 그래프 내에서 유지하여, 이를 구동하는 노드와 가깝게 위치시킵니다.
전제 조건
표현식을 만들기 전에 애니메이션 그래프 편집기에 익숙해지세요. 여기에는 그래프를 열고 애니메이션 그래프를 만드는 방법이 포함됩니다.
표현식 만들기
이 예제에서는 표현식을 사용하여 Blend1DNode의 위치 속성을 구동합니다. 노드를 구성하여 위치 0에 대기 애니메이션을, 위치 1에 달리기 애니메이션을 설정합니다. 이 표현식은 캐릭터의 이동 속도를 노드가 이 애니메이션들 사이를 혼합하는 데 사용하는 0에서 1 사이의 범위로 변환합니다.
MovementSpeed와 MaxSpeed 숫자 그래프 매개변수를 추가합니다.

Blend1DNode의 위치 속성 핀에서 연결을 드래그하고 새 표현식을 선택합니다.

다음 표현식을 입력합니다:
math.clamp(MovementSpeed / MaxSpeed, 0, 1)
표현식 상자 외부를 클릭하여 새로 고칩니다. MovementSpeed가 MaxSpeed에 가까워짐에 따라 Blend1DNode는 0에서 1 사이의 값을 받아 대기 애니메이션에서 달리기 애니메이션으로 혼합합니다.
그래프를 AnimationTrack에 로드한 후, 게임 플레이 스크립트에서 AnimationTrack:SetParameter()를 사용하여 MovementSpeed와 MaxSpeed를 업데이트합니다. 다음 예제는 MoveDirection 및 WalkSpeed 속성을 사용하는 방법입니다:
game:GetService("RunService").Stepped:Connect(function()
animationTrack:SetParameter("MovementSpeed", humanoid.MoveDirection.Magnitude * humanoid.WalkSpeed)
animationTrack:SetParameter("MaxSpeed", humanoid.WalkSpeed)
end)표현식은 매개변수 값이 변경됨에 따라 평가됩니다. 매개변수 워크플로우에 대한 내용은 API 통합을 참조하세요.
지원되는 내용
표현식 지원에는 산술 및 비교 연산, 논리 및 조건 표현식, math 라이브러리의 함수 호출, CFrame, Vector2, Vector3, Color3 값의 구성 및 멤버 접근, 문자열 연결이 포함됩니다. 다음 섹션에서는 지원되는 구문 및 함수를 나열합니다.
산술 및 비교
표준 산술 및 비교 연산을 사용하며, 일반적인 연산 순서를 따릅니다. 예를 들어, //는 나누고 내림합니다.
Speed * 2.0 + Offset
(Health / MaxHealth) * 100
DamageMultiplier ^ 2
Count % 3
10 // 3
Speed < 1
Health >= MaxHealth비교 연산자는 숫자와 함께 작동합니다. == 및 ~=를 사용하여 숫자, 불리언 또는 문자열을 비교합니다.
논리 및 단락 평가
and, or, not는 Luau의 진리값 및 단락 평가를 따릅니다. 오직 false와 nil만이 거짓으로 간주됩니다.
IsGrounded and GroundSpeed or AirSpeed
not IsDisabledIf-then-else 표현식
Luau의 조건 표현식 형식을 사용하여 단일 표현식 내에서 분기합니다:
if Speed > 10 then "sprint" elseif Speed > 2 then "run" else "idle"수학 라이브러리
math 라이브러리를 사용합니다. 그래프 표현식은 아직 math.frexp(), math.noise(), 또는 math.randomseed()를 지원하지 않습니다. math.modf()는 현재 정수 부분만 반환합니다.
math.clamp(Speed / MaxSpeed, 0, 1)
math.sin(Time * 2 * math.pi)
math.atan2(Direction.Y, Direction.X)
math.max(A, B, C)벡터 구성 및 멤버 접근
Vector2 및 Vector3 값을 구성하고, 벡터 산술을 수행하며, Magnitude 및 Unit과 같은 벡터 멤버에 접근합니다.
Vector3.new(math.cos(Time), math.sin(Time), 0)
Vector2.new(InputX, InputY)
MoveDirection.Magnitude * 2.0
Position.X + Offset
Vector3.zeroColor3 구성 및 멤버 접근
Color3 값을 구성하고 색상 채널에 접근합니다.
Color3.fromRGB(255, 128, 0)
Color.RCFrame 구성, 멤버 접근 및 연산
CFrame 값을 구성하고 CFrame 멤버에 접근하며, CFrame 또는 Vector3 값과 결합합니다.
CFrame.new(Position, LookAtPosition)
CFrame.Angles(RotationX, RotationY, RotationZ)
CFrame.identity
Transform.LookVector
Transform.Position + Vector3.new(0, 1, 0)문자열 연결
..를 사용하여 두 문자열을 연결합니다:
"state_" .. CurrentState지역 변수 및 다중 행 표현식
다중 행 표현식을 사용하여 수식을 명명된 단계로 나눌 수 있습니다. 다중 행 표현식은 local 선언, return, if/elseif/else, 및 독립 표현식을 지원합니다. if 또는 else 본문 내에서는 오직 return 또는 독립 표현식만 사용할 수 있으며, 중첩된 if 문과 지역 선언은 지원되지 않습니다.
local normalizedSpeed = Speed / MaxSpeed
local eased = math.clamp(normalizedSpeed, 0, 1)
return eased