이 페이지에서

사용자 정의 머티리얼 편집기

머티리얼 편집기 도구

머티리얼 에디터 도구는 머티리얼의 실시간 미리 보기, 구문 강조 표시, 오류 보고, CustomMaterial QML 컴포넌트로 머티리얼을 내보내는 기능을 제공하여 QtQuick3D 용 머티리얼( CustomMaterials ) 제작을 용이하게 해주는 GUI 도구입니다.

사용법

다음 명령을 실행하여 머티리얼 편집기를 실행할 수 있습니다:

$(QTDIR)/bin/materialeditor[.exe]

Material Editor 창은 왼쪽의 편집기와 오른쪽의 미리보기라는 두 가지 주요 구성 요소로 이루어져 있습니다.

셰이더 편집기와 미리보기 패널이 포함된 머티리얼 편집기 창

셰이더 편집

에디터 뷰에는 버텍스 셰이더용과 프래그먼트 셰이더용, 두 개의 에디터가 있습니다. 셰이더 스니펫을 편집하면 변경 사항이 미리보기 창에 즉시 반영됩니다. 머티리얼을 조합할 수 없는 경우, 출력 패널에 문제점을 설명하는 메시지가 표시됩니다.

CustomMaterial 의 셰이더 스니펫을 작성하는 데 사용되는 언어는 Vulkan 스타일의 GLSL이며, QtQuick3D 에 특화된 몇 가지 추가 키워드가 포함되어 있습니다. 이 키워드들은 모두 대문자로 표기되어 있어 쉽게 식별할 수 있습니다. QtQuick3D 전용 키워드는 편집기에서 강조 표시됩니다.

셰이더 스니펫에 사용된 언어와 이 언어가 렌더링 파이프라인의 나머지 부분과 어떻게 상호작용하는지에 대한 자세한 개요는 Programmable Materials 문서를 참조하십시오.

변위 코드가 포함된 버텍스 셰이더 편집기

머티리얼 속성

'머티리얼 속성(Material Properties)' 섹션에는 머티리얼에 대한 일반적인 QML 속성이 포함되어 있습니다. 이러한 속성과 속성이 머티리얼에 미치는 영향에 대한 자세한 내용은 ' CustomMaterial ' 문서에서 확인할 수 있습니다.

블렌드 및 음영 설정이 포함된 재료 속성 패널

미리 보기

미리보기 패널은 현재 머티리얼이 어떻게 렌더링되는지 보여주는 것 외에도, 다양한 조건에서 머티리얼이 어떻게 보이는지 확인하기 위해 조정할 수 있는 여러 컨트롤을 포함하고 있습니다. 이 컨트롤을 통해 사용자는 다른 모델을 선택하고, 이미지 기반 조명( Image Based Lighting) 사용을 전환하고, 씬 조명을 켜거나 끄고, 환경의 회전을 조정할 수 있습니다. 마우스를 사용하여 모델 주위를 회전하며 볼 수도 있습니다.

사용자 정의 재질이 적용된 구체를 보여주는 미리보기 패널

유니폼

유니폼 테이블은 셰이더에서 사용하는 유니폼이 나열된 곳입니다. 유니폼은 언제든지 추가, 제거 또는 변경할 수 있지만, 셰이더 스니펫에서 사용하는 모든 유니폼은 유니폼 테이블에 추가되어야 합니다. 유니폼이 추가되면 두 셰이더 모두에서 사용할 수 있게 됩니다. 머티리얼을 QML 컴포넌트로 내보낼 때, 유니폼은 머티리얼 컴포넌트의 속성이 됩니다.

플로트 매개변수가 포함된 유니폼 패널

출력 패널

출력 패널에는 셰이더 스니펫에서 발견된 오류와 같은 진단 메시지가 표시됩니다.

오류 메시지가 표시된 셰이더 출력 패널

셰이더 가져오기

셰이더 스니펫을 애플리케이션으로 가져올 수 있습니다. 이 파일들은 .vert 및 .frag 확장자를 가지며, 일반 텍스트로 되어 있어야 합니다. 가져온 셰이더 스니펫은 셰이더 코드가 CustomMaterial 와 호환되는 언어나 형식이 아닌 경우, 당연히 수동으로 수정해야 합니다(도구에서는 변환을 시도하지 않습니다).

프로젝트 저장 및 불러오기.

머티리얼 에디터는 자체 프로젝트 형식을 사용하여 프로젝트 파일을 저장하거나 불러올 수 있습니다. 머티리얼 에디터 프로젝트 파일의 확장자는 .qmp 입니다.

참고: 머티리얼에디터의 프로젝트 파일형식은 런타임 사용을 목적으로 하지 않으며, 머티리얼 에디터에서만 사용하도록 설계되었습니다.

내보내기.

애플리케이션에서 머티리얼을 사용하려면 QML 컴포넌트로 내보내야 하며, 이는 애플리케이션 메뉴에서 내보내기 대화 상자를 열어 수행할 수 있습니다. 내보내기 대화 상자에서는 출력 폴더, 머티리얼 컴포넌트의 이름, 셰이더 스니펫의 이름을 입력하라는 메시지가 표시됩니다. 머티리얼이 성공적으로 내보내지면, 출력 폴더에는 머티리얼을 설명하는 QML 컴포넌트와 머티리얼에 필요한 셰이더 스니펫 및 텍스처가 포함됩니다.

자료 내보내기 대화 상자

© 2026 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.