본문 바로가기
Unreal Engine

Unreal Engine 블루프린트 함수 라이브러리 생성 및 활용

by hfgraphic 2025. 10. 20.
반응형

블루프린트 함수 라이브러리 생성 및 활용

 

다음 섹션으로 넘어가기 전에, 모든 블루프린트에서 전역적으로 사용할 수 있도록 함수매크로를 추가하는 **라이브러리(Library)**를 만드는 방법을 알려드리고자 합니다. 이것은 여러 곳에서 반복적으로 사용해야 하는 함수가 있을 때 매우 유용하며, 라이브러리에 넣어두면 어디서든 접근할 수 있습니다.

 

1. 블루프린트 라이브러리 생성

  1. 새 폴더 생성: 새 폴더를 만들고 이름을 **'Blueprints'**라고 지정합니다. (정리 정돈은 항상 중요합니다.)
  2. 라이브러리 유형 선택: 'Blueprints' 폴더 안에 들어갑니다.
  3. 마우스 오른쪽 버튼을 클릭하여 'Blueprint Function Library (블루프린트 함수 라이브러리)' 또는 **'Blueprint Macro Library (블루프린트 매크로 라이브러리)'**를 선택합니다.
  4. 함수 라이브러리 생성: **'Blueprint Function Library'**를 선택하고 이름을 **'Library'**라고 지정하겠습니다.

 

2. 함수 라이브러리 활용

  1. 접근: 라이브러리를 더블 클릭하면, 우리가 작업했던 이벤트 그래프와 유사해 보이는 그래프가 나타납니다. 하지만 이곳은 라이브러리이며 함수만 포함할 수 있습니다.
  2. 함수 생성: 라이브러리 안에서 함수를 하나 만들겠습니다. 이름을 **'PrintMessage'**라고 하고, 이 함수는 단순히 'Print String' 노드를 포함하게 하겠습니다.
  3. 메시지 설정: 문자열은 **"This is from my library. (이것은 나의 라이브러리에서 온 것입니다.)"**라고 설정합니다.
  4. 호출 및 확인: **Compile (컴파일)**하고, 이벤트 그래프로 돌아가 **'PrintMessage'**를 호출한 다음 **Play (실행)**를 클릭하면, 라이브러리에서 만든 메시지가 출력되는 것을 볼 수 있습니다.

 

3. 라이브러리 사용의 이점

 

  • 전역 접근: 이 함수는 현재 그래프에서뿐만 아니라, 나중에 만들게 될 다수의 블루프린트에서도 모두 사용할 수 있습니다.
  • 시간 절약: 모든 블루프린트 안에 들어가서 동일한 함수를 계속 만드는 것은 시간 낭비입니다. 라이브러리에 자주 사용하는 함수를 만들고 모든 곳에서 호출하여 사용하는 것이 효율적입니다.
  • 주의 사항: 모든 함수를 라이브러리에 만들 필요는 없습니다. 항상 사용해야 하는 특정 함수만 라이브러리에 넣으세요.

 

4. 매크로 라이브러리

  • 매크로 라이브러리함수 라이브러리와 같은 방식으로 생성할 수 있습니다.
  • 매크로 역시 여러 블루프린트에서 사용할 수 있도록 매크로 라이브러리에 넣을 수 있습니다. 또한 매크로 내에서 실행 핀이 필요한 경우(이전에 설명했듯이) 매크로 라이브러리를 사용하면 됩니다.

 

반응형