Choose your operating system:
Windows
macOS
Linux
자동화 시스템 의 일부인 FBX Test Builder (FBX 테스트 빌더)는 개별 FBX 파일에 대해 별도의 테스트를 만들 수 있도록 해주는 플러그인입니다. FBX 테스트 빌더는 단일 FBX 파일에 대해 임포트 및 리임포트 후 예상 결과 배열과 비교하는 데 사용할 수 있는 테스트 플랜을 만듭니다. 생성되는 테스트 플랜은 JSON 파일에 저장되며, 테스트 대상 FBX 파일과 확장자를 제외한 이름이 같습니다.
FBX 테스트 빌더로 테스트 플랜을 만들면 FBX 파일에 대해 선택된 작업을 한 뒤 예상 결과 배열과 비교하여 완료된 테스트의 성공 또는 실패 여부를 판가름할 수 있습니다.
플러그인 활성화
FBX 자동화 테스트를 만들기 전, 먼저 편집 > Plugins (플러그인) > Testing (테스팅)에서 FBXAutomationTestBuilder 플러그인을 활성화시켜야 합니다.
플러그인 활성화 이후, 엔진을 재시작한 뒤 열어볼 수 있습니다.
FBX 테스트 빌더는 파일 메뉴의 창 > 자동화 툴 > FBX Test Builder 로 열 수 있습니다.
테스트 플랜 만들기
FBX 테스트 빌더를 사용하면, 선택된 Action (액션 또는 동작)을 수행하고 일련의 Expected Results (예상 결과)를 통해 주어진 FBX 파일에 대해 성공 또는 실패 여부를 판단합니다. 이러한 액션 및 결과 세트를 Test Plan (테스트 플랜)이라 합니다.
액션
각 테스트 플랜에 대해, 수행할 수 있는 핵심 액션은 다섯 가지이며, 각 액션에는 저다마 범주가 있어 올바른 테스트를 수행하는 데 사용됩니다. 이러한 액션과 그 범주는 개괄적으로 다음과 같습니다:
액션 |
단계 |
---|---|
Import |
|
Reimport |
|
Add LOD (Level of Detail) |
|
Reimport LOD (Level of Detail) |
|
Import Reload |
|
예상 결과
각 테스트 플랜에 대해, 예상 결과 목록을 평가하여 테스트 성공 또는 실패 여부를 판단합니다.
세팅 |
설명 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Expected Presets Type |
예상 프리셋 유형 - 검사해야 하는 미리 정의된 데이터입니다.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expected Presets Data Integer |
예상 프리셋 데이터 인티저 - 지정된 FBX 파일에 대해 검사할 예상 인티저 값을 입력합니다. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expected Presets Data Float |
예상 프리셋 데이터 플로트 - 지정된 FBX 파일에 대해 검사할 예상 플로트 값을 입력합니다. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expected Presets Data Double |
예상 프리셋 데이터 더블 - 지정된 FBX 파일에 대해 검사할 예상 더블 값을 입력합니다. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expected Presets Data String |
예상 프리셋 데이터 스트링 - 지정된 FBX 파일에 대해 검사할 예상 스트링 값을 입력합니다. |
예상 결과 구성
Expected Result (예상 결과) 구성을 위해, 텍스처와 머티리얼이 여섯 개 쓰인 박스 메시가 포함된 FBX 를 예로 들겠습니다.
-
추가 (+) 버튼을 눌러 Expected Result (예상 결과)를 추가한 뒤 검사에 사용하고자 하는 Expected Preset Type (예상 프리셋 유형)을 선택하세요.
-
테스트하고자 하는 예상 프리셋 유형에 해당하는 Expected Presets Data (예상 프리셋 데이터) 유형을 선택하세요. 이 예제에서는 Mesh Materials Number (메시 머티리얼 수) 유형을 선택하여 포함된 FBX 를 임포트할 때 머티리얼이 여섯 개 들어있는지 검사하도록 하겠습니다.
-
Mesh Materials Number (메시 머티리얼 수) 프리셋 유형에서 기대하는 것은 인티저 하나 뿐이며, (필수 데이터 유형은 위 표 또는 프리셋 툴팁 참고) 이를 통해 임포트중인 머티리얼 수를 검사합니다. Expected Presets Data Integer (예상 프리셋 데이터 인티저)를 한 번 클릭하여 예상 결과 검사를 배열에 추가합니다.
-
배열 요소 0 에는, FBX 와 함께 임포트해야 하는 머티리얼 수를 입력합니다. 이 예제에서 기대하는 머티리얼 수는 6 개입니다.
-
필수 임포트 옵션이 제대로 구성되었는지 확인해야 선택한 예상 프리셋 유형에 필요한 모든 것이 제대로 임포트될 것입니다. 예를 들어 Box FBX 는 FBX 에서 머티리얼과 텍스처를 임포트해야 하므로, Import Materials (머티리얼 임포트)와 Import Textures (텍스처 임포트) 옵션이 켜져있어야 합니다.
-
Save JSON (JSON 저장) 버튼을 누르면 Test Plan (테스트 플랜)이 세션 프론트엔드 자동화 탭에 추가됩니다. 이 파일은 Engine/Import/FBX/[NameOfTheFBX] 에서 찾을 수 있습니다.
-
테스트 실행 이후, 운영 체제는 지정된 LOD(0) 의 메시 머티리얼 수 (6) 가 임포트된 애셋 수와 맞는지 검사합니다.
테스트가 실패한 경우, 자동화 탭에서 실패한 테스트를 선택하면 자동화 테스트 결과 패널 아래에서 그 이유를 확인할 수 있습니다.
또한 메시지 로그 창이 떠 테스트 성공 또는 실패 여부가 표시되며, 세션 프론트엔드 창이 열려있지 않아도 실패 이유를 확인할 수 있습니다.
임포트 옵션
예상 결과 테스트 플랜을 구성한 이후, 테스트하고자 하는 액션이 제대로 임포트/리임포트 설정되어 있는지도 확인해야 합니다. 예를 들어, 머티리얼 일정 갯수를 임포트하는 FBX 를 테스트하는 경우, Import Materials (머티리얼 임포트) 옵션이 켜져있어야 합니다. 이 옵션은 콘텐츠 브라우저를 통해 에디터에 애셋을 임포트할 때 사용할 수 있는 것과 동일한 옵션입니다.
자세한 정보는 FBX 임포트 옵션 레퍼런스 문서를 참고하세요.
테스트 플랜 생성 절차
FBX 테스팅을 위한 테스트 플랜 생성 방법은 다음과 같습니다:
-
테스트하고자 하는 FBX 를 다음 위치로 복사합니다:
[UE4Root]/WorkingWithContent/Importing/FBXEditorAutomation
-
이 폴더 위치에 있는 FBX 는 자동으로 Select an FBX file (FBX 파일 선택) 드롭다운 목록에 채워집니다.
-
Select a Test Plane (테스트 플랜 선택) 드롭다운을 사용하여 Create new plan (새 플랜 생성)을 선택한 뒤 기존의 것을 선택하면 편집합니다.
-
다음 칸을 채웁니다:
General: 일반:
-
Test Plan Name 테스트 플랜 이름 - 테스트 플랜 목록에서 선택하여 사용할 수 있도록 이름을 지어줍니다.
-
Action 액션 - FBX 파일에 실행할 작업 유형을 선택합니다. 예: 임포트, 리임포트, LOD 추가, LOD 리임포트, 임포트 리로드 등입니다.
-
LOD Index LOD 인덱스 - LOD 리임포트를 사용하는 경우, 리임포트하고자 하는 LOD 인덱스를 여기 입력합니다.
-
Delete Folder Assets 폴더 애셋 삭제 - 테스트 플랜 마지막에 임포트된 애셋을 삭제할지 입니다.
Expected Results: 예상 결과:
-
예상 프리셋 유형을 설정하고 테스트 완료에 필요한 필수 데이터를 채웁니다.
Import Options: 임포트 옵션:
-
이 FBX 임포트 테스트를 성공적으로 하기 위해 필요한 임포트 옵션을 설정합니다.
-
-
Save JSON (JSON 저장) 버튼을 눌러 테스트 플랜을 저장하면 자동화 테스팅 도중 이 FBX 파일에 대해 실행시킬 수 있는 테스트로 추가됩니다.