개요
나이아가라 스크립트 에디터(Niagara Script Editor) 를 사용하면 새로운 모듈, 동적 입력 또는 기타 스크립트를 생성하여 나이아가라 시스템과 이미터에서 사용할 수 있습니다. 모듈 헤더를 더블클릭하면 스크립트 에디터를 열 수 있습니다. 이 문서는 스크립트 에디터의 유저 인터페이스(UI)에 관해 설명하고 있으며, 다음 요소들로 구성되어 있습니다.
이미지를 클릭하면 전체 크기로 표시됩니다.
- 메뉴 바
- 툴바
- 스크립트 디테일(Script Details) 패널
- 파라미터(Parameters) 패널
- 통계(Stats) 패널
- 노드 그래프(Node Graph)
- 나이아가라 메시지 로그(Niagara Message Log) 패널
- 선택 디테일(Selected Details) 패널
메뉴 바
아래 테이블에는 나이아가라 에디터 자체에 적용되는 명령만 설명되어 있습니다. 에셋 에디터 또는 언리얼 에디터의 다른 부분을 여는 메뉴에는 추가 명령이 표시될 수 있습니다.
파일
| 명령 | 설명 |
|---|---|
| 저장(Save) | 현재 이미터를 저장합니다. |
| 다른 이름으로 저장(Save As) | 현재 이미터를 다른 이름으로 저장합니다. |
| 에셋 열기(Open Asset) | 다른 에셋을 선택할 수 있는 창을 표시합니다. |
| 모두 저장(Save All) | 프로젝트의 모든 에셋과 레벨을 저장합니다. |
| 저장할 파일 선택(Choose Files to Save) | 에셋 및 레벨 저장 옵션이 있는 대화창을 표시합니다. |
| 소스 컨트롤에 접속(Connect to Source Control) | 소스 컨트롤에 접속할 수 있는 대화창을 표시하여 소스 컨트롤 함수를 콘텐츠에 구현할 수 있도록 합니다. |
편집
| 명령 | 설명 |
|---|---|
| 실행 취소(Undo) | 이전 액션을 실행 취소합니다. |
| 다시 실행(Redo) | 실행 취소한 액션을 다시 실행합니다. |
| 실행 취소 히스토리(Undo History) | 실행 취소된 모든 액션이 나열된 대화창을 표시합니다. |
에셋
| 명령 | 설명 |
|---|---|
| 콘텐츠 브라우저에서 찾기(Find in Content Browser) | 가장 최근에 사용한 콘텐츠 브라우저로 전환하고 해당 콘텐츠 브라우저에서 현재 에셋을 선택합니다. |
| 레퍼런스 뷰어(Reference Viewer) | 현재 에셋의 모든 레퍼런스를 보여주는 대화창을 표시합니다. |
| 사이즈 맵(Size Map) | 에셋의 대략적인 크기와 해당 에셋이 레퍼런스하는 모든 항목을 보여주는 인터랙티브 맵을 표시합니다. |
| 에셋 검사(Audit Assets) | '에셋 검사' UI를 열고, 선택한 에셋 관련 정보를 표시합니다. |
| 셰이더 쿡 통계(Shader Cook Statistics) | 셰이더 쿡 프로세스의 통계를 표시합니다. |
창
| 명령 | 설명 |
|---|---|
| 툴바(Toolbar) | 툴바를 보여주거나 숨깁니다. |
| 노드 그래프 | 노드 그래프를 표시하거나 숨깁니다. |
| 스크립트 디테일 | '스크립트 디테일' 패널을 보여주거나 숨깁니다. |
| 선택 디테일 | '선택 디테일' 패널을 보여주거나 숨깁니다. |
| 시스템 디테일(System Details) | '시스템 디테일' 패널을 보여주거나 숨깁니다. |
| 파라미터 | '파라미터' 패널을 보여주거나 숨깁니다. |
| 통계 | '통계' 패널을 표시하거나 숨깁니다. |
| 나이아가라 메시지 로그 | '나이아가라 메시지 로그' 패널을 표시하거나 숨깁니다. |
툴바
| 툴 이름 | 설명 |
|---|---|
저장  |
현재 스크립트를 저장합니다. |
탐색(Browse)  |
가장 최신 콘텐츠 브라우저로 전환하여 현재 에셋을 선택합니다. |
적용(Apply)  |
저장되지 않은 변경 내용을 현재 에셋에 적용합니다. |
컴파일(Compile)  |
변경한 모든 내용을 스크립트로 컴파일합니다. |
새로고침(Refresh)  |
패널을 새로 고쳐 종속성을 정확하게 표시합니다. |
스크립트 디테일 패널
이미지를 클릭하면 전체 크기로 표시됩니다.
| 세팅 | 설명 | |
|---|---|---|
| 모듈 사용 비트마스크(Module Usage Bitmask) | 이 모듈을 레퍼런스하는 데 적합한 스크립트 종류를 선택할 때 이 드롭다운을 사용합니다. 하나 이상 선택할 수 있습니다. | |
| 카테고리(Category) | 사용자가 추가 메뉴를 열 때 이 모듈 또는 스크립트가 어떤 카테고리에 나열되는지 지정하기 위해 이 필드를 사용합니다. 이 텍스트 필드에 대한 고급 텍스트 세팅을 표시하려면 작은 아래쪽 화살표를 클릭합니다. | |
| 제공된 종속성(Provided Dependencies) | 이 세팅을 사용하여 이 모듈이 다른 모듈에 제공하는 종속성의 ID 배열을 생성합니다. 더하기 기호 모양의 + 아이콘을 클릭하여 배열에 엘리먼트를 추가합니다. | |
| 필수 종속성(Required Dependencies) | 이 배열에는 이 모듈이 스택의 다른 모듈에서 필요로 하는 종속성이 포함되어 있습니다. 각 배열 엘리먼트에 포함된 멤버는 다음과 같습니다.
|
|
| 지원 중단됨(Deprecated) | 모듈을 더 이상 사용하지 않을 때 이 박스를 선택합니다. 이 세팅을 활성화하면 그 다음 세팅 2개가 활성화됩니다. 이 박스를 선택하지 않으면 그 다음 세팅 2개는 사용할 수 없게 됩니다. | |
| 지원 중단 메시지(Deprecation Message) | 이 모듈이 지원 중단될 때 표시할 메시지를 입력합니다. 이 텍스트 필드에 대한 고급 텍스트 세팅을 표시하려면 작은 아래쪽 화살표를 클릭합니다. | |
| 지원 중단 권장(Deprecation Recommendation) | 지원 중단된 모듈 대신 권장하려는 모듈입니다. 드롭다운을 클릭하여 권장 모듈을 선택합니다. | |
| 변환 유틸리티(Conversion Utility) | 이 필드에서는 커스텀 로직을 쓰거나 선택하여 기존 스크립트 할당 콘텐츠를 이 스크립트로 변환할 수 있습니다. | |
| 실험단계 기능(Experimental) | 이 체크 박스를 선택하면 이 모듈을 실험단계로 라벨링할 수 있습니다(따라서 지원 기능이 축소됨). 이 박스를 선택하면 그 다음 세팅이 활성화되며, 선택하지 않으면 그 다음 세팅은 사용할 수 없습니다. | |
| 실험단계 메시지(Experimental Message) | 이 모듈이 실험단계일 경우 이 세팅을 사용하여 모듈을 선택했을 때 표시할 메시지를 입력할 수 있습니다. 이 텍스트 필드에 대한 고급 텍스트 세팅을 표시하려면 작은 아래쪽 화살표를 클릭합니다. | |
| 라이브러리에 노출(Expose to Library) | 이 체크 박스를 선택하면 라이브러리에 이 모듈을 노출할 수 있습니다. | |
| 설명(Description) | 이 모듈에 대한 설명을 입력하는 데 사용합니다. 이 텍스트 필드에 대한 고급 텍스트 세팅을 표시하려면 작은 아래쪽 화살표를 클릭합니다. | |
| 키워드(Keywords) | 에디터 메뉴에서 이 모듈을 찾는 데 사용할 수 있는 공백으로 구분된 키워드 목록을 입력할 수 있는 텍스트 필드입니다. | |
| 하이라이트(Highlights) | '시스템 개요(System Overview)'에 표시될 때 모듈에 표시할 컬러 코딩된 아이콘을 선택하는 데 사용할 수 있는 필드입니다. 목록은 배열로 구성되어 있습니다. 더하기 기호 모양의 + 아이콘을 클릭하여 배열에 추가할 수 있습니다. | |
| 스크립트 메타데이터(Script Metadata) | 이 필드에서는 값 세트를 키 세트와 쌍으로 연결하는, 정렬되지 않은 연관된 컨테이너인 맵을 생성할 수 있습니다. | |
| 입력 파라미터(Input Parameters) | 이 스크립트에 포함된 입력 파라미터가 나열됩니다. 더하기 기호 모양의 + 아이콘을 클릭하여 파라미터를 추가할 수 있습니다. | |
| 출력 파라미터(Output Parameters) | 이 스크립트에 포함된 출력 파라미터가 나열됩니다. 더하기 기호 모양의 + 아이콘을 클릭하여 파라미터를 추가할 수 있습니다. |
파라미터 패널
이 패널에는 편집 중인 모듈에서 사용하는 파라미터가 모두 나열됩니다. 스크립트를 작성 중인 경우 이 패널에서 파라미터를 노드 그래프에 드래그 앤 드롭할 수 있습니다. 아래 표에서는 카테고리와, 카테고리에 대한 설명을 보여줍니다. 더하기 기호 모양의 + 아이콘을 클릭하여 해당 카테고리에 추가할 파라미터 메뉴를 표시할 수 있습니다. 스크립트를 작성 중인 경우 이 패널에서 파라미터를 그래프에 드래그 앤 드롭할 수도 있습니다.
| 파라미터 카테고리 | 설명 |
|---|---|
| 시스템 어트리뷰트(System Attributes) | 시스템 스테이지에서 작성되는 퍼시스턴트 어트리뷰트로 어디에서나 읽기 가능합니다. |
| 이미터 어트리뷰트(Emitter Attributes) | 이미터 스테이지에서 작성되는 퍼시스턴트 어트리뷰트로, 이미터와 파티클 스테이지에서 읽기 가능합니다. |
| 파티클 어트리뷰트(Particle Attributes) | 파티클 스테이지에서 작성되는 퍼시스턴트 어트리뷰트로, 파티클 스테이지에서 읽기 가능합니다. |
| 모듈 입력(Module Inputs) | 시스템과 이미터 에디터에 모듈 입력을 노출하는 값입니다. |
| 스태틱 스위치(Static Switch) | 값은 에디터 타임에만 설정할 수 있습니다. |
| 모듈 로컬 값(Modules Locals) | 단일 모듈 내에서 쓰고 읽을 수 있는 트랜션트 값입니다. 트랜션트 값은 프레임 간에 또는 단계 간에 유지되지 않습니다. |
| 엔진 제공 값 | 엔진에서 제공되는 읽기 전용 값입니다. 이 값의 소스는 시뮬레이션 자체이거나 시뮬레이션 오너일 수 있습니다. |
통계 패널
노드 그래프
빌딩 중인 HLSL 스크립트의 시각적 표현으로, UE4에서 사용된 기타 노드 그래프 타입과 유사합니다. 그래프의 아무 곳이나 우클릭하여 선택할 노드 메뉴를 열 수 있습니다. 기존 노드 중 하나에서 입력 또는 출력을 드래그하여 동일한 메뉴를 열 수도 있습니다.
나이아가라 메시지 로그 패널
스크립트를 컴파일할 때 경고나 오류가 발생하는 경우 여기에 표시됩니다.
선택 디테일 패널
이 패널에는 노드 그래프에서 선택한 특정 노드에 대한 디테일이 표시됩니다.