커스텀 머티리얼 에디터
머티리얼 에디터 툴
머티리얼 에디터 툴은 QtQuick3D 용 CustomMaterials 을 보다 쉽게 제작할 수 있는 GUI 툴로, 머티리얼의 실시간 미리보기, 구문 강조 표시, 오류 보고, CustomMaterial QML 컴포넌트로 내보내기 기능 등을 제공합니다.
사용 방법
머티리얼 에디터는 명령을 실행하여 시작할 수 있습니다:
$(QTDIR)/bin/materialeditor[.exe]
머티리얼 에디터 창은 왼쪽의 에디터와 오른쪽의 미리보기라는 두 가지 주요 구성 요소로 이루어져 있습니다.
셰이더 편집
에디터 뷰에는 버텍스 셰이더용 에디터와 프래그먼트 셰이더용 에디터가 각각 하나씩 있습니다. 셰이더 스니펫을 편집하면 해당 변경 결과가 미리 보기에 즉시 표시됩니다. 머티리얼을 어셈블할 수 없는 경우 출력 패널에 문제를 설명하는 메시지가 표시됩니다.
CustomMaterial 의 셰이더 스니펫을 작성하는 데 사용되는 언어는 Vulkan 스타일의 GLSL이며 QtQuick3D 전용 키워드는 모두 대문자로 작성되어 쉽게 식별할 수 있습니다. QtQuick3D 특정 키워드도 에디터에서 강조 표시됩니다.
셰이더 스니펫에 사용되는 언어와 나머지 렌더링 파이프라인과의 상호 작용 방식에 대한 자세한 개요는 프로그래머블 머티리얼 문서를 참조하세요.
머티리얼 프로퍼티
머티리얼 프로퍼티 섹션에는 머티리얼에 대한 일반적인 QML 프로퍼티가 포함되어 있습니다. 이러한 속성과 이러한 속성이 머티리얼에 미치는 영향은 CustomMaterial 문서에 자세히 설명되어 있습니다.
미리보기
미리보기 패널에는 현재 머티리얼이 렌더링되는 방식이 표시될 뿐만 아니라 다양한 조건에서 머티리얼이 어떻게 보이는지 확인하기 위해 조정할 수 있는 다양한 컨트롤이 포함되어 있습니다. 이러한 컨트롤을 통해 사용자는 다음을 수행할 수 있습니다: 다른 모델을 선택하고, 이미지 기반 조명 사용을 전환하고, 씬 조명을 켜거나 끄고, 환경의 회전을 조정할 수 있습니다. 마우스를 사용하여 모델 주위를 선회할 수도 있습니다.
유니폼
유니폼 테이블에는 셰이더가 사용하는 유니폼이 나열되어 있습니다. 유니폼은 언제든지 추가, 제거 또는 변경할 수 있지만 셰이더 스니펫에서 사용하는 모든 유니폼은 유니폼 테이블에 추가해야 합니다. 유니폼이 추가되면 두 셰이더 모두에 액세스할 수 있게 됩니다. 머티리얼을 QML 컴포넌트로 내보낼 때 유니폼은 머티리얼 컴포넌트의 프로퍼티가 됩니다.
출력 패널
출력 패널에는 셰이더 스니펫에서 발견된 오류와 같은 진단 메시지가 표시됩니다.
셰이더 가져오기
셰이더 스니펫은 애플리케이션으로 가져올 수 있으며, 파일 확장자는 .vert
및 .frag
이며 일반 텍스트를 포함할 것으로 예상됩니다. 물론 가져온 셰이더 코드가 이미 CustomMaterial 와 호환되는 언어 또는 형식이 아닌 경우 셰이더 스니펫을 수동으로 조정해야 합니다(도구에서 번역을 시도하지 않음).
프로젝트 저장 및 로드.
머티리얼 에디터는 자체 프로젝트 포맷을 사용하여 프로젝트 파일을 저장하거나 로드할 수 있습니다. 머티리얼 에디터 프로젝트 파일의 확장자는 .qmp
입니다.
참고: 머티리얼 에디터의 프로젝트 파일 형식은 런타임 용도가 아니며, 머티리얼 에디터에서만 사용하도록 되어 있습니다.
익스포트.
애플리케이션에서 머티리얼을 사용하려면 QML 컴포넌트로 내보내야 하며, 애플리케이션 메뉴에서 내보내기 대화상자를 열면 됩니다. 내보내기 대화상자에서 출력 폴더, 머티리얼 컴포넌트의 이름, 셰이더 스니펫의 이름을 묻는 메시지가 표시됩니다. 머티리얼이 성공적으로 익스포트되면 출력 폴더에 머티리얼을 설명하는 QML 컴포넌트와 함께 머티리얼에 필요한 셰이더 스니펫 및 텍스처가 포함됩니다.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.