나이아가라 스크립트 에디터 레퍼런스

이 페이지는 나이아가라 스크립트 에디터의 사용자 인터페이스(UI)에 대해 설명합니다.

Windows
MacOS
Linux

개요

나이아가라 스크립트 에디터(Niagara Script Editor) 를 사용하면 새로운 모듈, 동적 입력 또는 기타 스크립트를 생성하여 나이아가라 시스템과 이미터에서 사용할 수 있습니다. 모듈 헤더를 더블클릭하면 스크립트 에디터가 열립니다. 이 문서는 스크립트 에디터의 사용자 인터페이스(UI)에 대해 설명하며, 다음 장으로 구성되어 있습니다.

이미지를 클릭하면 전체 크기로 확대됩니다.

  1. 메뉴 바

  2. 툴바

  3. 스크립트 디테일 패널

  4. 파라미터 패널

  5. 통계 패널

  6. 노드 그래프

  7. 나이아가라 메시지 로그 패널

  8. 선택 디테일 패널

메뉴 바

메뉴 바

아래 표에는 나이아가라 에디터 자체에 적용되는 명령만 설명되어 있습니다. 에셋 에디터 또는 언리얼 에디터의 다른 부분을 여는 메뉴에는 추가 명령이 표시될 수 있습니다.

File(파일)

명령

설명

저장(Save)

현재 이미터를 저장합니다.

다른 이름으로 저장(Save As)

현재 이미터를 다른 이름으로 저장합니다.

애셋 열기(Open Asset)

다른 애셋을 선택할 수 있는 창을 표시합니다.

모두 저장(Save All)

프로젝트의 모든 애셋과 레벨을 저장합니다.

저장할 파일 선택(Choose Files to Save)

애셋 및 레벨 저장 옵션이 있는 대화 상자를 표시합니다.

소스 컨트롤에 접속(Connect to Source Control)

소스 콘트롤에 접속해 소스 콘트롤 함수를 콘텐츠에 구현할 수 있도록 대화 상자를 표시합니다.

Edit(편집)

명령

설명

실행 취소(Undo)

이전 동작을 실행 취소합니다.

다시 실행(Redo)

실행 취소 되었던 동작을 다시 실행합니다.

실행 취소 히스토리(Undo History)

모든 실행 취소 액션을 나열하는 다이얼로그를 표시합니다.

Asset(애셋)

명령

설명

콘텐츠 브라우저에서 찾기(Find in Content Browser)

가장 최근에 사용한 콘텐츠 브라우저로 전환하고 해당 콘텐츠 브라우저에서 현재 에셋을 선택합니다.

레퍼런스 뷰어(Reference Viewer)

현재 에셋의 모든 레퍼런스를 보여주는 다이얼로그를 표시합니다.

사이즈 맵(Size Map)

에셋의 대략적인 크기와 에셋이 참조하는 모든 것을 보여주는 인터랙티브 맵을 표시합니다.

애셋 검사(Audit Assets)

애셋 검사 UI 를 열고, 선택된 애셋 관련 정보를 표시합니다.

셰이더 쿡 통계(Shader Cook Statistics)

셰이더 쿡 프로세스의 통계를 표시합니다.

Window(창)

명령

설명

툴바(Toolbar)

툴바를 표시하거나 숨깁니다.

노드 그래프(Node Graph)

노드 그래프를 표시하거나 숨깁니다.

스크립트 디테일(Script Details)

스크립트 디테일 패널을 표시하거나 숨깁니다.

선택 디테일(Script Details)

선택 디테일 패널을 표시하거나 숨깁니다.

시스템 디테일(System Details)

시스템 디테일 패널을 표시하거나 숨깁니다.

파라미터(Parameters)

파라미터 패널을 표시하거나 숨깁니다.

통계(Stats)

통계 패널을 표시하거나 숨깁니다.

나이아가라 메시지 로그(Niagara Message Log)

나이아가라 메시지 로그 패널을 표시하거나 숨깁니다.

툴바

스크립트 에디터 툴바

툴 이름

설명

저장(Save)

저장 아이콘

현재 스크립트를 저장합니다.

탐색(Browse)

탐색 아이콘

가장 최신 콘텐츠 브라우저로 전환하여 현재 에셋을 선택합니다.

적용(Apply)

적용 아이콘

저장되지 않은 변경 내용을 현재 에셋에 적용합니다.

컴파일(Compile)

컴파일 아이콘

변경한 모든 내용을 스크립트로 컴파일합니다.

새로고침(Refresh)

새로고침 아이콘

패널을 새로고침하여 종속성을 정확하게 표시합니다.

<!--

저장(Save)

저장 아이콘

탐색(Browse)

탐색 아이콘

적용(Apply)

적용 아이콘

컴파일(Compile)

컴파일 아이콘

새로고침(Refresh)

새로고침 아이콘

스크립트 디테일 패널

이미지를 클릭하면 전체 크기로 확대됩니다.

세팅

설명

모듈 사용 비트마스크(Module Usage Bitmask)

이 모듈을 참조하는 데 적합한 스크립트 종류를 선택할 때 이 드롭다운을 사용합니다. 하나 이상 선택할 수 있습니다.

카테고리(Category)

사용자가 추가 메뉴를 열 때 이 모듈 또는 스크립트가 어떤 카테고리에 나열되는지 지정하려면 이 필드를 사용합니다. 이 텍스트 필드에 대한 고급 텍스트 설정을 표시하려면 작은 아래쪽 화살표를 클릭하면 됩니다.

제공된 종속성(Provided Dependencies)

이 모듈이 다른 모듈에 제공하는 종속성의 ID 배열을 생성하려면 이 필드를 사용합니다. 더하기 기호(Plus sign) 아이콘( + )을 클릭하여 배열에 엘리먼트를 추가합니다.

필수 종속성(Required Dependencies)

이 배열에는 이 모듈이 스택의 다른 모듈에서 필요로 하는 종속성이 포함되어 있습니다. 각 배열 엘리먼트에 포함된 멤버는 다음과 같습니다.

  • ID : 필수 종속 모듈의 고유 ID입니다.

  • 유형(Type) : 종속성이 이 모듈 이전 또는 이후에 속하는지 여부를 나타냅니다.

  • 스크립트 컨스트레인트(Script Constraints) : 종속성을 제공하는 모듈의 소스 스크립트와 관련된 컨스트레인트를 지정합니다.

  • 설명(Description) : 필수 종속성에 대한 설명을 입력합니다. 이 텍스트 필드에 대한 고급 텍스트 설정을 표시하려면 작은 아래쪽 화살표를 클릭하면 됩니다.

폐기됨(Deprecated)

모듈을 더 이상 사용하지 않을 때 이 박스를 선택합니다. 이 세팅을 활성화하면 그 다음 세팅 2개가 활성화됩니다. 이 박스를 선택하지 않으면 그 다음 세팅 2개는 사용할 수 없게 됩니다.

폐기 메시지(Deprecation Message)

이 모듈이 폐기될 때 표시할 메시지를 입력합니다. 이 텍스트 필드에 대한 고급 텍스트 설정을 표시하려면 작은 아래쪽 화살표를 클릭하면 됩니다.

폐기 추천(Deprecation Recommendation)

폐기된 모듈 대신 추천할 모듈입니다. 드롭다운을 클릭하고 추천 모듈을 선택합니다.

변환 유틸리티(Conversion Utility)

이 필드에서는 커스텀 로직을 쓰거나 선택하여 기존 스크립트 할당 콘텐츠를 이 스크립트로 변환할 수 있습니다.

실험단계(Experimental)

이 상자를 선택하면 이 모듈을 실험단계로 라벨링할 수 있습니다(따라서 지원 기능이 축소됨). 이 박스를 선택하면 그 다음 세팅이 활성화되며, 선택하지 않으면 그 다음 세팅은 사용할 수 없습니다.

실험단계 메시지(Experimental Message)

이 모듈이 실험단계일 경우 이 세팅을 사용하여 모듈을 선택했을 때 표시할 메시지를 입력할 수 있습니다. 이 텍스트 필드에 대한 고급 텍스트 설정을 표시하려면 작은 아래쪽 화살표를 클릭하면 됩니다.

라이브러리에 공개(Expose to Library)

이 상자를 선택하면 라이브러리에 이 모듈을 공개할 수 있습니다.

설명(Description)

이 모듈에 대한 설명을 입력하는 데 사용합니다. 이 텍스트 필드에 대한 고급 텍스트 설정을 표시하려면 작은 아래쪽 화살표를 클릭하면 됩니다.

키워드(Keywords)

이 텍스트 필드에서는 에디터 메뉴에서 이 모듈을 찾기 위해 사용할 수 있는 키워드 목록(반각 스페이스로 구분)을 입력할 수 있습니다.

하이라이트(Highlights)

이 필드에서는 System Overview(시스템 개요)에 아이콘이 나타날 때 모듈에서 표시할 컬러 코딩된 아이콘을 선택할 수 있습니다. 목록은 배열로 구조화되어 있습니다. 더하기 기호(Plus sign) 아이콘( + )을 클릭하여 배열에 추가할 수 있습니다.

스크립트 메타데이터(Script Metadata)

이 필드에서는 값 세트를 키 세트와 쌍으로 연결하는, 정렬되지 않은 연관 컨테이너인 맵을 생성할 수 있습니다.

입력 파라미터(Input Parameters)

이 스크립트에 포함된 입력 파라미터가 나열됩니다. 더하기 기호(Plus sign) 아이콘( + )을 클릭하여 파라미터를 추가할 수 있습니다.

출력 파라미터(Output Parameters)

이 스크립트에 포함된 출력 파라미터가 나열됩니다. 더하기 기호(Plus sign) 아이콘( + )을 클릭하여 파라미터를 추가할 수 있습니다.

<!--

이 배열에는 이 모듈이 스택의 다른 모듈에서 필요로 하는 종속성이 포함되어 있습니다. 각 배열 엘리먼트에 포함된 멤버는 다음과 같습니다.

  • ID : 필수 종속 모듈의 고유 ID입니다.

  • 유형(Type) : 종속성이 이 모듈 이전 또는 이후에 속하는지 여부를 나타냅니다.

  • 스크립트 컨스트레인트(Script Constraints) : 종속성을 제공하는 모듈의 소스 스크립트와 관련된 컨스트레인트를 지정합니다.

  • 설명(Description) : 필수 종속성에 대한 설명을 입력합니다. 이 텍스트 필드에 대한 고급 텍스트 설정을 표시하려면 작은 아래쪽 화살표를 클릭하면 됩니다.

파라미터 패널

파라미터 패널

이 패널에는 편집 중인 모듈에서 사용하는 파라미터가 모두 나열됩니다. 스크립트를 작성 중인 경우 이 패널에서 파라미터를 노드 그래프에 드래그 앤 드롭할 수 있습니다. 아래 표에서는 카테고리와, 카테고리에 대한 설명을 보여줍니다. 더하기 기호(Plus sign) 아이콘( + )을 클릭하여 해당 카테고리에 추가할 파라미터 메뉴를 표시할 수 있습니다. 스크립트를 작성 중인 경우 이 패널에서 파라미터를 그래프에 드래그 앤 드롭할 수도 있습니다.

파라미터 카테고리

설명

시스템 어트리뷰트(System Attributes)

시스템 스테이지에서 작성되는 영구 어트리뷰트로 어디에서나 읽기 가능합니다.

이미터 어트리뷰트(Emitter Attributes)

이미터 스테이지에서 작성되는 영구 어트리뷰트로 이미터와 파티클 스테이지에서 읽기 가능합니다.

파티클 어트리뷰트(Particle Attributes)

파티클 스테이지에서 작성되는 영구 어트리뷰트로 이미터와 파티클 스테이지에서 읽기 가능합니다.

모듈 입력(Module Inputs)

시스템과 이미터 에디터에 모듈 입력을 공개하는 값입니다.

스태틱 스위치(Static Switch)

편집 시에만 설정할 수 있는 값입니다.

모듈 로컬(Modules Locals)

단일 모듈 내에서 쓰고 읽을 수 있는 트랜션트 값입니다. 트랜션트 값은 프레임 간에 또는 단계 간에 유지되지 않습니다.

엔진에서 제공됨(Engine Provided)

엔진에서 제공되는 읽기 전용 값입니다. 이 값의 소스는 시뮬레이션 자체이거나 시뮬레이션 오너일 수 있습니다.

통계 패널

통계 패널

노드 그래프

노드 그래프

작성할 HLSL 스크립트의 시각적 표현으로 UE4에서 사용되는 다른 유형의 노드 그래프와 유사합니다. 그래프의 아무 곳에서나 우클릭하여 선택할 노드 메뉴를 열 수 있습니다. 기존 노드 중 하나에서 입력 또는 출력을 드래그하여 동일한 메뉴를 열 수도 있습니다.

나이아가라 메시지 로그 패널

메시지 로그 패널

스크립트를 컴파일할 때 발생하는 경고나 오류가 있으면 여기에 표시됩니다.

선택 디테일 패널

선택 디테일 패널

이 패널에는 노드 그래프에서 선택한 특정 노드에 대한 디테일이 표시됩니다.

선택한 모든 노드에 대해 이 패널에 정보가 표시되는 것은 아닙니다.

Select Skin
Light
Dark

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼