애니메이션 노드 테크니컬 가이드

애니메이션 노드는 애님 블루프린트 안에서 쓰이는 것으로, 포즈의 블렌딩이나 본의 직접 조작 같은 작업을 하는데 사용됩니다. 이미 여러가지 애니메이션 노드가 제공되어 있으나, 커스텀 노드를 만들어 어떤 게임의 요구에도 맞출 수 있습니다.

애니메이션 노드의 구조

애니메이션 노드는 두 부분으로 이루어집니다:

• 출력 포즈 생성을 위한 실제 작업을 하는 런타임 구조체
• 노드 제목이나 컨텍스트 메뉴처럼, 그래프 안에서 노드의 시각적인 면과 함수성을 처리하는 에디터 시간 컨테이너 클래스

새로운 애니매이션 노드를 추가하기 위해서는, 위 두가지 다 만들어야 합니다.

노드 계층구조

노드에 계층구조를 만드는 것이 가능은 하지만, abstract 가 아닌 에디터 시간 클래스의 경우 반드시 딱 하나의 런타임 노드가 있어야 합니다 (부모가 abstract 이면서 하나 들어있지 않은 경우가 아니고서야 노드를 추가하지 마세요). 예제로는 UAnimGraphNode_BlendListBase 패밀리를 참고하세요.

런타임 노드

런타임 구조체는 FAnimNode_Base 에서 파생되며, 초기화와 업데이트는 물론 하나 이상의 입력 포즈에서 원하는 출력 포즈를 생성하기 위한 작업을 담당합니다. 또한 노드가 원하는 작업을 하는 데 있어 필요한 입력 포즈 링크라든가 프로퍼티가 있으면 선언해 주기도 합니다.

포즈 입력

런타임 노드에서, 포즈 입력의 노출은 FPoseLink 또는 FComponentSpacePoseLink 유형의 프로퍼티를 만들면 됩니다. FPoseLink 는 애니메이션 블렌딩처럼 로컬 스페이스에서의 포즈 작업시 사용됩니다. FComponentSpacePoseLink 는 스켈레탈 컨트롤러 적용시처럼 컴포넌트 스페이스에서의 작업시 사용됩니다.

노드는 하나의 포즈 입력을 가질 수 있습니다:

로컬 스페이스

	UPROPERTY(Category=Links)
	FPoseLink BasePose;
Copy full snippet

UPROPERTY(Category=Links) FPoseLink BasePose;

컴포넌트 스페이스

	UPROPERTY(Category=Links)
	FComponentSpacePoseLink ComponentPose;
Copy full snippet

UPROPERTY(Category=Links) FComponentSpacePoseLink ComponentPose;

컴포넌트 스페이스 포즈 핀에는 파랑 음영으로 표시됩니다.

또는, 여러 애니메이션 블렌딩을 하는 노드는 둘 이상의 입력을 가질 수도 있습니다:

	UPROPERTY(Category=Links)
	FPoseLink Base;

	UPROPERTY(Category=Links)
	FPoseLink Additive;
Copy full snippet

UPROPERTY(Category=Links) FPoseLink Base; UPROPERTY(Category=Links) FPoseLink Additive;

이 프로퍼티 각각은 포즈 링크를 표시합니다. 이런 유형의 프로퍼티는 항상 입력 핀으로 노출됩니다. 선택적으로 숨긴다든가 디테일 패널에서 수정가능한 프로퍼티로만 사용한다든가 할 수 없습니다.

프로퍼티와 데이터 입력

애니메이션 노드는 알파, 트랜스폼 데이터 등 노드 작업을 수행하는 데 사용되는 프로퍼티를 몇이든 가질 수 있습니다. 이러한 프로퍼티는 다른 프로퍼티와 마찬가지로 선언되는데, UPROPERTY 매크로를 사용합니다.

	UPROPERTY(Category=Settings, meta(PinShownByDefault))
	mutable float Alpha;
Copy full snippet

UPROPERTY(Category=Settings, meta(PinShownByDefault)) mutable float Alpha;

애니메이션 노드의 프로퍼티는 노드에 값을 전달하기 위해 특수한 메타데이터 키를 사용하여 데이터 입력으로 노출시킬 수 있는데, 이를 통해 노드에 사용되는 프로퍼티에 노드 밖에서 계산된 값을 사용할 수 있습니다. 가능한 메타데이터 키는 다음과 같습니다:

(#OptionalPins) 옵션 핀

에디터 노드

에디터 클래스는 UAnimGraphNode_Base 에서 파생되며, 비주얼 노드 제목이나 컨텍스트 메뉴 액션 추가같은 작업을 담당합니다.

에디터 시간 클래스에는 편집가능한 것으로 노출된 런타임 노드 인스턴스가 있어야 합니다.

	UPROPERTY(Category=Settings)
	FAnimNode_ApplyAdditive Node;
Copy full snippet

UPROPERTY(Category=Settings) FAnimNode_ApplyAdditive Node;

제목

페르소나에서 애니메이션 블루프린트 의 그래프에 표시되는 애니메이션 노드 제목 문구와 배경색은 GetNodeTitle, GetNodeTitleColor 함수를 덮어쓰는 것으로 정의합니다.

예를 들어 다음 UAnimGraphNode_ApplyAdditive 노드는 회색 배경에 "Apply Additive" 라고 표시됩니다:

	FLinearColor UAnimGraphNode_ApplyAdditive::GetNodeTitleColor() const
	{
		return FLinearColor(0.75f, 0.75f, 0.75f);
	}

	FString UAnimGraphNode_ApplyAdditive::GetNodeTitle(ENodeTitleType::Type TitleType) const
	{
		return TEXT("Apply Additive");
	}
Copy full snippet

FLinearColor UAnimGraphNode_ApplyAdditive::GetNodeTitleColor() const { return FLinearColor(0.75f, 0.75f, 0.75f); } FString UAnimGraphNode_ApplyAdditive::GetNodeTitle(ENodeTitleType::Type TitleType) const { return TEXT("Apply Additive"); }

툴팁

페르소나에서 노드에 마우스 커서를 올렸을 때 표시되는 툴팁은 GetTooltip 함수를 덮어써서 정의합니다:

	FString UAnimGraphNode_ApplyAdditive::GetTooltip const
	{
		return TEXT("Apply additive animation to normal pose");
	}
Copy full snippet

FString UAnimGraphNode_ApplyAdditive::GetTooltip const { return TEXT("Apply additive animation to normal pose"); }

컨텍스트 메뉴

각 애니메이션 노드는 페르소나에서 그래프의 노드에 우클릭했을 때 뜨는 컨텍스트 메뉴에 노드 전용 옵션을 추가시킬 수 있습니다. 옵션의 추가는 모든 블루프린트 노드의 멤버인 GetContextMenuActions 함수를 사용해서 이루어 집니다.

예를 들어 UAnimGraphNode_LayeredBoneBlend 노드는 새 입력 추가용 메뉴 항목을 더하거나 기존 것을 뺍니다:

	void UAnimGraphNode_LayeredBoneBlend::GetContextMenuActions(const FGraphNodeContextMenuBuilder& Context) const
	{
		if (!Context.bIsDebugging)
		{
			if (Context.Pin != NULL)
			{
				// we only do this for normal BlendList/BlendList by enum, BlendList by Bool doesn't support add/remove pins
				if (Context.Pin->Direction == EGPD_Input)
				{
					//@TODO: Only offer this option on arrayed pins
					Context.MenuBuilder->BeginSection("AnimNodesLayeredBoneBlend", NSLOCTEXT("A3Nodes", "LayeredBoneBlend", "Layered Bone Blend"));
					{
						Context.MenuBuilder->AddMenuEntry(FGraphEditorCommands::Get().RemoveBlendListPin);
					}
					Context.MenuBuilder->EndSection();
				}
			}
			else
			{
				Context.MenuBuilder->BeginSection("AnimNodesLayeredBoneBlend", NSLOCTEXT("A3Nodes", "LayeredBoneBlend", "Layered Bone Blend"));
				{
					Context.MenuBuilder->AddMenuEntry(FGraphEditorCommands::Get().AddBlendListPin);
				}
				Context.MenuBuilder->EndSection();
			}
		}
	}
Copy full snippet

void UAnimGraphNode_LayeredBoneBlend::GetContextMenuActions(const FGraphNodeContextMenuBuilder& Context) const { if (!Context.bIsDebugging) { if (Context.Pin != NULL) { // we only do this for normal BlendList/BlendList by enum, BlendList by Bool doesn't support add/remove pins if (Context.Pin->Direction == EGPD_Input) { //@TODO: Only offer this option on arrayed pins Context.MenuBuilder->BeginSection("AnimNodesLayeredBoneBlend", NSLOCTEXT("A3Nodes", "LayeredBoneBlend", "Layered Bone Blend")); { Context.MenuBuilder->AddMenuEntry(FGraphEditorCommands::Get().RemoveBlendListPin); } Context.MenuBuilder->EndSection(); } } else { Context.MenuBuilder->BeginSection("AnimNodesLayeredBoneBlend", NSLOCTEXT("A3Nodes", "LayeredBoneBlend", "Layered Bone Blend")); { Context.MenuBuilder->AddMenuEntry(FGraphEditorCommands::Get().AddBlendListPin); } Context.MenuBuilder->EndSection(); } } }

파생된 네이티브 Getter

다수의 프로젝트에서는 별도의 UAnimInstance 파생 클래스를 만들어 퍼포먼스를 높이고 있습니다. 그에 보조를 맞추기 위해서는 필요에 따라 새로운 getter 를 추가하면 됩니다. 하지만 그 정상 작동을 위해서는 약간의 구성 절차가 필요합니다.

• getter 함수는 반드시 UFUNCTIONS 태그를 붙여야 합니다.
• 반드시 BlueprintPure 여야 합니다.
• 반드시 AnimGetter="True" 메타데이터를 포함해야 합니다.

또한 구체적인 이름이 있는 파라미터도 정의해야 합니다 (이 부분은 AnimInstance.h 의 베이스 애님 getter 함수 위에도 설명되어 있습니다). 그 파라미터 목록은 다음과 같습니다:

getter 에서 실제 노드를 구하는 헬퍼 함수도 있는데, UAnimInstance 에 존재합니다: