Choose your operating system:
Windows
macOS
Linux
클래스, 열거형(enum), 열거형 값, 함수, 구조체, 프로퍼티, 인터페이스 선언시, 메타데이터 지정자를 붙여 엔진과 에디터의 다양한 부분과 어떻게 작동하는지를 제어할 수 있습니다.
메타데이터 지정자 사용법은 일반적인 클래스, 함수, 인터페이스 지정자와는 다릅니다.
클래스, 인터페이스, 함수나 프로퍼티를 선언할 때 지정자를 붙여 엔진 및 에디터 다양한 부분에 대한 작동방식을 지정할 수 있습니다. 메타데이터 지정자를 사용하려면,
UCLASS
,
UINTERFACE
,
UFUNCTION
,
UPROPERTY
매크로에 다음과 같이
meta
를 붙이면 됩니다:
{UCLASS/UINTERFACE/USTRUCT/UFUNCTION/UPROPERTY}(meta=(MetaTag1="Value1", MetaTag2, ..))
메타데이터는 에디터 빌드를 실행할 때 C++ 코드에서 접근할 수 있지만, 출시 제품에는 빠질 것입니다. 게임 로직은 메타데이터를 사용해서는 안됩니다.
클래스 메타데이터 지정자
클래스는 다음과 같은 메타태그 지정자를 사용할 수 있습니다:
클래스 메타 태그 |
효과 |
---|---|
|
존재하면, 블루프린트가 컴포넌트 클래스를 스폰시킬 수 있습니다. |
|
블루프린트 함수 라이브러리에서만 유효합니다. 이 지정자는 이 클래스의 함수를 애니메이션 블루프린트의 비게임 스레드에서 호출가능한 것으로 마킹합니다. |
|
액터 및 컴포넌트 클래스에 사용됩니다. 네이티브 클래스가 틱을 할 수 없으면, 이 액터 또는 컴포넌트를 기반 블루프린트 생성 클래스도, 심지어
|
|
액터 및 컴포넌트 클래스에 사용됩니다. 네이티브 클래스가 틱을 할 수 없으면, 이 액터 또는 컴포넌트를 기반 블루프린트 생성 클래스는,
|
|
비헤이비어 트리 노드에 대해, 클래스가 폐기되어 컴파일 시 경고가 표시됨을 나타냅니다. |
|
클래스가 폐기되면, 그것을 사용하는 블루프린트를 컴파일하려 할 때 표준 폐기 경고에 이 메시지가 추가됩니다. |
|
블루프린트의 이 노드 이름은 코드 생성 이름이 아닌 여기 제공된 값으로 대체됩니다. |
|
블루프린트의 Generic Create Object 노드를 사용하여 클래스의 오브젝트를 스폰하지 않습니다. 이 지정자는 Actor 도 ActorComponent 도 아닌 BlueprintType 클래스에만 의미가 있습니다. |
|
Async Task 노드에 이 클래스의 프록시 오브젝트를 노출시킵니다. |
|
클래스의 첫 서브클래스가 상속된
|
|
이 클래스가 블루프린트 생성을 위한 베이스 클래스로 적합한지( 또는 아닌지)를 나타냅니다.
|
|
덮어쓰기를 허용하지 않을 블루프린트 이벤트 목록입니다. |
|
클래스와 호환되지 않는 인터페이스 목록입니다. |
|
블루프린트 함수 라이브러리 클래스에서 목록의 클래스 사용을 제한시킵니다. |
|
부모 클래스 선택기 대화창처럼 전체 툴팁 표시가 버거운 상황에서 사용할 짧은 툴팁입니다. |
|
이 클래스 소유 그래프에 배치된 블루프린트 노드는 월드 컨텍스트 핀을 반드시 표시해야 합니다. 이 클래스 오브젝트를 월드 컨텍스트로 사용할 수 없어서, 보통 숨겨진 경우에도 마찬가지입니다. |
|
클래스가 계층형 데이터를 사용함을 나타냅니다. 디테일 패널의 계층형 편집 기능 인스턴싱에 사용합니다. |
|
코드 코멘트에서 자동 생성되는 툴팁을 덮어씁니다. |
Enum Metadata Specifiers
Enumerations can use the following Metadata Specifiers:
Enumeration Meta Tag |
Effect |
---|---|
|
Indicates that this Enumeration can be used as flags by integer UPROPERTY variables that are set up with the "Bitmask" Metadata Specifier. |
|
Labels this type as experimental and unsupported. |
|
The quoted string will be used as the name of this Enumeration in the Editor, rather than the default name generated by Unreal Header Tool. |
|
Overrides the automatically generated tooltip from code comments. |
Individual values within an Enumeration have their own Metadata Specifiers. These differ slightly from other Metadata Specifiers in that they use top-level keyword
UMETA
, and are specified after the value they modify, rather than before.
Enumerated Value UMeta Tag |
Effect |
---|---|
|
This value's name will be the text provided here, rather than the code-generated name. |
|
This value will not appear in the Editor. |
|
Overrides the automatically generated tooltip from code comments. |
인터페이스 메타데이터 지정자
인터페이스는 다음과 같은 메타태그 지정자를 사용할 수 있습니다:
인터페이스 메타 태그 |
효과 |
---|---|
|
이 인터페이스는
블루프린트
에서 구현할 수 없습니다 (예를 들면 노출되지 않은 C++ 멤버 메서드만 있는 경우입니다).
|
구조체 메타데이터 지정자
구조체는 다음과 같은 메타태그 지정자를 사용할 수 있습니다:
구조체 메타 태그 |
효과 |
---|---|
|
이 구조체에는 커스텀 Break Struct 노드가 있음을 나타냅니다. 모듈, 클래스, 함수 이름을 제공해야 합니다. |
|
이 구조체에는 커스텀 Make Struct 노드가 있음을 나타냅니다. 모듈, 클래스, 함수 이름을 제공해야 합니다. |
|
Make Struct 및 Break Struct 노드의 핀을 기본으로 숨깁니다. |
|
부모 클래스 선택기 대화창처럼 전체 툴팁 표시가 버거운 상황에서 사용할 짧은 툴팁입니다. |
|
코드 코멘트에서 자동 생성되는 툴팁을 덮어씁니다. |
함수 메타데이터 지정자
함수 메타 태그 |
효과 |
---|---|
|
쉼표로 구분된 파라미터 목록이 (UI 확장이 필요한) 고급 핀으로 표시됩니다. |
|
N 번째 이후 모든 파라미터는 (UI 확장이 필요한) 고급 핀으로 표시됩니다. 예로 'AdvancedDisplay=2' 는 첫째 둘째를 제외한 전부가 고급 파라미터가 됩니다. |
|
|
|
|
|
나열된 파라미터는 참조 전달이라 할지라도, 핀을 연결하지 않고 놔둬도 자동 생성 기본값을 갖습니다. 블루프린트 편의 기능입니다. |
|
블루프린트 함수 라이브러리의 스태틱
|
|
이 함수는 내부 구현 디테일로, 다른 함수 또는 노드 구현에 사용됩니다. 블루프린트 그래프에 바로 노출되지는 않습니다. |
|
이 함수는 블루프린트의 소유 오브젝트에서만 호출 가능합니다. 다른 인스턴스에서는 호출할 수 없습니다. |
|
|
|
|
|
|
|
나열된 파라미터는 모두 와일드카드로 취급됩니다. 이 지정자는
커스텀
|
|
|
|
이 함수를 참조하는 블루프린트는 컴파일 경고를 통해 사용자에게 함수가 폐기되었음을 알립니다.
|
|
함수가 폐기되면, 그것을 사용하는 블루프린트를 컴파일하려 할 때 표준 폐기 경고에 이 메시지가 추가됩니다. |
|
이 함수는 개발 모드에서만 실행됩니다. 출시 제품에 포함시키지 않을 것으로 기대되는 디버그 출력같은 기능에 좋습니다. |
|
블루프린트의 이 노드 이름은 코드 생성 이름이 아닌 여기 제공된 값으로 대체됩니다. |
|
|
|
|
|
함수 호출 대상 오브젝트를 나타내는 데 사용되는 "self"(셀프) 핀을 숨깁니다. 셀프 핀은 호출하는 블루프린트 클래스와 호환되는
|
|
|
|
블루프린트 그래프에서 함수 호출을 위한 노드를 배치할 때처럼, 이 함수 검색 시 사용할 수 있는 키워드 세트를 지정합니다. |
|
잠복성 동작을 나타냅니다. 잠복성 동작은
|
|
잠복성
|
|
|
|
|
|
블루프린트 함수 라이브러리에서만 유효합니다. 이 함수는 소유 클래스의 일반
|
|
부모 클래스 선택기 대화창처럼 전체 툴팁 표시가 버거운 상황에서 사용할 짧은 툴팁입니다. |
|
코드 코멘트에서 자동 생성되는 툴팁을 덮어씁니다. |
|
이 함수는 액터 생성 도중 호출하는 것이 안전하지 않습니다. |
|
|
프로퍼티 메타데이터 지정자
프로퍼티 메타 태그 |
효과 |
---|---|
|
|
|
|
|
|
|
인티저 프로퍼티에 사용됩니다. 0 에서 배열 프로퍼티 길이까지 UI 에 입력할 수 있는 유효 값을 범위제한시킵니다. |
|
|
|
|
|
프로퍼티 디폴트는 블루프린트 컴파일러에 의해 생성되며, 컴파일 이후
|
|
플로트 및 인티저 프로퍼티에 사용됩니다. 프로퍼티에 입력할 수 있는 최소값 N 을 지정합니다. |
|
플로트 및 인티저 프로퍼티에 사용됩니다. 프로퍼티에 입력할 수 있는 최대값 N 을 지정합니다. |
|
이 프로퍼티는 환경설정 (
|
|
|
|
이 프로퍼티는 같은 카테고리에 있으면 소스 코드에서의 순서와 무관하게
|
|
코드 생성 이름 대신 이 프로퍼티에 표시할 이름입니다. |
|
두 프로퍼티에
|
|
프로퍼티가 애셋 유형이며 선택된 애셋의 썸네일을 표시해야함을 나타냅니다. |
|
이 프로퍼티 편집 비활성화 여부를 나타내는 데 사용되는 부울 프로퍼티 이름입니다. 프로퍼티 이름 앞에 "!" 를 붙이면 테스트가 반대로 됩니다. |
|
배열 요소의 순서를 끌어 바꿀 수 없도록 합니다. |
|
|
|
블루프린트 에디터에서 함수 목록을 만들 때 들어있는 함수를 노출시킬 카테고리 목록을 지정합니다. |
|
프로퍼티를 이 클래스 유형에 대한 Spawn Actor 노드에 노출시킬지 지정합니다. |
|
|
|
|
|
|
|
이 부울 프로퍼티는 다른 프로퍼티의 편집 조건 토글로써 인라인으로만 표시되며, 자체 행에는 표시되지 않음을 나타냅니다. |
|
|
|
트랜스폼 또는 로테이터, 아니면 그 배열에 사용됩니다. 프로퍼티를 뷰포트에 이동가능 위젯으로 노출시켜야 함을 나타냅니다. |