Qt Quick 3D QML Types

이것은 공간 렌더러와 씬그래프를 사용하기 위한 QML 프론트엔드입니다. 당분간 모든 3D 콘텐츠는 오프스크린 텍스처(FBO)를 통해 처리되어, Qt Quick 씬( QQuickItem)으로 합성될 수 있도록 합니다.

다음 문장을 사용하여 QtQuick3D 모듈을 임포트하십시오:

import QtQuick3D

QtQuick3D QML 유형

AddDefine	패스에 대한 셰이더 컴파일 시 전처리기 정의(preprocessor define)를 추가합니다
BakedLightmap	모델에 대한 베이킹된 라이트맵 설정을 지정합니다.
Buffer	이펙트의 패스에 사용될 컬러 버퍼를 생성하거나 참조합니다
BufferInput	이펙트의 패스에 입력으로 사용될 입력 버퍼를 정의합니다
Camera	카메라를 위한 추상 기저 클래스를 정의합니다
ColorAttachment	렌더 패스에 사용할 컬러 어태치먼트를 정의합니다
Command	이펙트의 패스 과정에서 수행될 명령어의 슈퍼타입
ContentLayer	씬 노드를 그룹화하고 필터링하기 위한 레이어 플래그 상수를 제공하는 싱글톤
CubeMapTexture	3D 장면에서 사용할 큐브 맵 텍스처를 정의합니다
CustomCamera	사용자 정의 투영 행렬을 가진 카메라를 정의합니다
CustomMaterial	모델의 셰이딩에 사용되는 사용자 정의 머티리얼을 생성하기 위한 기본 컴포넌트
DebugSettings	디버그 설정을 구성하는 데 사용됩니다
DepthStencilAttachment	RenderPass용 뎁스-스텐실 어태치먼트를 정의합니다
DepthTextureAttachment	패스에 대한 깊이 텍스처 어태치먼트를 정의합니다
DirectionalLight	씬 내의 방향성 조명을 정의합니다
Effect	포스트 프로세싱 효과를 생성하기 위한 기본 컴포넌트
FileInstancing	파일에서 인스턴스 테이블을 읽을 수 있게 합니다
Fog	씬에 대한 안개 설정을 지정합니다
FrustumCamera	사용자 정의 프러스텀을 가진 PerspectiveCamera를 정의합니다
Geometry	사용자 정의 지오메트리를 위한 기본 유형
InstanceList	QML에서 인스턴싱을 수동으로 지정할 수 있게 합니다
InstanceListEntry	InstanceList 내의 인스턴스를 지정합니다
Instancing	인스턴스 테이블의 기본 유형
Joint	스켈레탈 애니메이션 계층 구조 내의 노드를 정의합니다
Light	모든 조명에 대한 생성 불가능한 추상 기본 유형
Lightmapper	씬에 대한 라이트맵 베이킹 설정을 지정합니다
Loader3D	URL 또는 컴포넌트에서 3D 하위 트리를 동적으로 불러올 수 있게 합니다
Material	머티리얼에 공통적으로 적용되는 기능을 제공하는 추상 기본 유형
Model	3D 모델 데이터를 로드할 수 있게 합니다
MorphTarget	모프 타깃의 속성을 정의합니다
Node	3D 씬에 존재하는 오브젝트의 기본 컴포넌트
Object3D	모든 3D 노드 및 리소스의 추상 기본 유형
OrthographicCamera	직교 투영 행렬을 가진 카메라를 정의합니다
Pass	이펙트 내의 렌더 패스를 정의합니다
PerspectiveCamera	3D 씬의 콘텐츠를 보기 위한 원근 투영 카메라를 정의합니다
PipelineStateOverride	단일 패스에 대한 파이프라인 상태 재정의 정의
PointLight	씬 내의 포인트 라이트를 정의합니다
PrincipledMaterial	메탈/러프니스 워크플로를 사용하여 3D 아이템용 머티리얼을 정의할 수 있습니다
Quaternion	쿼터니언을 위한 유틸리티 함수를 제공합니다
QuaternionAnimation	쿼터니언용 PropertyAnimation
ReflectionProbe	씬 내 반사 프로브를 정의합니다
RenderExtension	렌더 확장 기능을 위한 생성 불가능한 추상 기본 유형
RenderPass	3D 콘텐츠 렌더링을 위한 사용자 정의 렌더 패스를 정의합니다
RenderPassTexture	패스에서 렌더 타겟으로 사용될 텍스처를 정의합니다
RenderStats	씬 렌더링에 대한 정보를 제공합니다
RenderablesFilter	패스에서 영향을 받을 렌더러블을 선택하기 위한 필터를 정의합니다
Repeater3D	제공된 모델을 사용하여 여러 노드 기반 컴포넌트를 인스턴스화합니다
ResourceLoader	3D 리소스를 미리 불러올 수 있게 합니다
SceneEnvironment	씬이 렌더링되는 방식을 구성할 수 있게 합니다
SetUniformValue	단일 패스 동안 설정될 값을 정의합니다
Shader	포스트 프로세싱 이펙트에서 사용되는 셰이더 코드를 정의하기 위한 컨테이너 컴포넌트
Skeleton	스켈레탈 애니메이션 계층 구조를 정의합니다
Skin	스키닝 애니메이션을 정의합니다
SkyMaterial	프로시저럴 스카이를 렌더링하고 이미지 기반 조명 데이터를 생성합니다
SpecularGlossyMaterial	스페큘러/광택 워크플로를 사용하여 3D 아이템용 머티리얼을 정의할 수 있게 합니다
SpotLight	씬 내에서 스포트라이트를 정의합니다
SubRenderPass	상위 RenderPass와 동일한 렌더 타깃 내에서 작업의 일부를 렌더링합니다
Texture	3D 장면에서 사용할 텍스처를 정의합니다
TextureData	사용자 정의 텍스처 데이터의 기본 유형
TextureInput	CustomMaterial 또는 Effect의 셰이더에 노출되는 텍스처를 지정합니다
TextureProviderExtension	텍스처를 생성하는 렌더 확장 기능을 위한 추상 기본 유형
View3D	3D 씬을 렌더링할 뷰포트를 제공합니다

QML 값 유형

bounds	모델의 경계를 지정합니다
pickResult	픽 결과값을 포함합니다
renderTargetBlend	렌더 패스의 단일 색상 어태치먼트에 대한 블렌딩 매개변수를 정의합니다

QtQuick3D.Helpers QML 유형

다음 문장을 사용하여 QtQuick3D.Helpers 모듈을 가져옵니다:

import QtQuick3D.Helpers

AxisHelper	3D 씬에서 3개의 축과 격자를 표시하기 위한 시각적 헬퍼
CapsuleGeometry	캡슐에 대한 지오메트리를 제공합니다
ConeGeometry	원뿔에 대한 지오메트리를 제공합니다
CuboidGeometry	직육면체에 대한 기하 구조를 제공합니다
CylinderGeometry	원통의 지오메트리를 제공합니다
DebugView	렌더링 통계를 표시하고 디버깅 및 개발자 작업을 수행하는 뷰
ExtendedSceneEnvironment	일반적으로 사용되는 렌더링 효과를 제공하는 SceneEnvironment
ExtrudedTextGeometry	돌출된 텍스트에 대한 지오메트리를 제공합니다
GridGeometry	그리드 렌더링을 위한 사용자 정의 지오메트리 제공자
HeightFieldGeometry	높이 필드 지오메트리
InfiniteGrid	무한 그리드를 표시합니다
InstanceModel	인스턴스 테이블을 기반으로 한 데이터 모델을 정의합니다
InstanceRange	RandomInstancing의 범위를 지정합니다
InstanceRepeater	인스턴스 테이블을 기반으로 컴포넌트를 인스턴스화합니다
LodManager	세부 수준(LOD) 가시성 변경을 처리하는 매니저
LookAtNode	다른 노드를 자동으로 가리키도록 유지되는 헬퍼 노드
OrbitCameraController	원점을 중심으로 회전하는 카메라 컨트롤러
PlaneGeometry	평면에 대한 지오메트리를 제공합니다
ProceduralMesh	QML을 통해 지오메트리를 생성할 수 있도록 함
ProceduralMeshSubset	ProceduralMesh의 하위 집합을 정의합니다
ProceduralSkyTextureData	HDR 스카이박스 큐브맵을 생성합니다
ProceduralTextureData	QML을 통해 TextureData를 생성하고 채울 수 있게 함
QuadTextureProvider	사용자 정의 프래그먼트 셰이더를 사용하여 쿼드 텍스처를 렌더링하는 데 사용됩니다
RandomInstancing	무작위 인스턴싱 테이블을 생성합니다
RenderOutputProvider	패스에서 제공되는 텍스처에 접근하기 위한 브리지로 사용됩니다
SimpleQuadRenderer	전체 화면 텍스처가 적용된 쿼드를 메인 렌더 타깃에 렌더링합니다
SphereGeometry	구(sphere)의 지오메트리를 제공합니다
TorusGeometry	토러스의 지오메트리를 제공합니다
WasdController	키와 마우스를 사용하여 노드의 위치와 방향을 제어합니다

QtQuick3D.AssetUtils QML 유형

다음 문장을 사용하여 QtQuick3D.AssetUtils 모듈을 임포트합니다:

import QtQuick3D.AssetUtils

RuntimeLoader

런타임에 3D 에셋을 가져옵니다

QtQuick3D.Particles3D QML 유형

다음 문장을 사용하여 QtQuick3D.Particles3D 모듈을 임포트합니다:

import QtQuick3D.Particles3D

Affector3D	어펙터는 파티클의 수명 주기 동안 속성을 수정합니다
Attractor3D	입자를 특정 위치나 도형 쪽으로 끌어당깁니다
Direction3D	Directions는 방출된 입자에 속도를 할당합니다
DynamicBurst3D	동적 방출기 버스트
EmitBurst3D	선언형 이미터 버스트
Gravity3D	입자를 지정된 방향으로, 지정된 크기의 벡터만큼 가속시킵니다
LineParticle3D	선 입자
ModelBlendParticle3D	입자 효과를 3D 모델과 블렌딩합니다
ModelParticle3D	Qt Quick 3D 모델을 사용하는 입자
Particle3D	추상 논리 입자
ParticleAbstractShape3D	입자 모양의 추상 기본 유형
ParticleCustomShape3D	이미터 및 어펙터용 사용자 정의 파티클 모양을 불러옵니다
ParticleEmitter3D	논리적 파티클용 이미터
ParticleModelShape3D	이미터 및 어펙터용 모델 기반 파티클 형상 제공
ParticleSceneShape3D	이미저 및 어펙터를 위해 씬에서 입자 형상을 제공합니다
ParticleShape3D	이미터 및 어펙터를 위한 3D 형상 제공
ParticleSystem3D	파티클, 이미터 및 어펙터 유형을 포함하는 시스템
ParticleSystem3DLogging	파티클 시스템에 대한 정보를 제공합니다
PointRotator3D	피벗 지점을 중심으로 파티클을 회전시킵니다
Repeller3D	입자 리펠러
ScaleAffector3D	입자 크기 어펙터
SpriteParticle3D	2D 스프라이트 텍스처를 사용하는 파티클
SpriteSequence3D	스프라이트 파티클에 대한 이미지 시퀀스 기능을 제공합니다
TargetDirection3D	대상 위치를 향한 방향을 지정하기 위해
TrailEmitter3D	다른 파티클에서 발생하는 논리적 파티클을 위한 이미터
VectorDirection3D	목표 방향을 지정하기 위한 용도
Wander3D	파티클에 무작위 파형 곡선을 적용합니다

QtQuick3D.Xr QML 유형

다음 문장을 사용하여 QtQuick3D.Xr 모듈을 임포트합니다:

import QtQuick3D.Xr

XrCamera	사용자가 XR 장면을 보는 공간적 위치와 방향을 추적합니다
XrController	입력 컨트롤러의 위치와 방향을 추적하는 추적된 공간 노드
XrErrorDialog	PCVR 애플리케이션용 사용자 정의 오류 대화 상자
XrHandModel	손을 나타내는 3D 모델
XrHapticEffect	햅틱 효과를 나타냅니다
XrHapticFeedback	XR 컨트롤러의 햅틱 피드백을 제어합니다
XrInputAction	입력 컨트롤러의 동작을 나타냅니다
XrItem	2D 사용자 인터페이스 콘텐츠를 담을 수 있는 3D 공간 내의 가상 표면
XrOrigin	XrView의 원점 위치
XrRuntimeInfo	XR 런타임에 대한 정보를 표시합니다
XrSimpleHapticEffect	진폭, 지속 시간 및 주파수를 사용하여 컨트롤러 햅틱을 설정할 수 있음
XrSpatialAnchor	실제 공간에서 특정 위치나 객체를 추적합니다
XrSpatialAnchorListModel	공간 앵커가 포함된 모델을 제공합니다
XrView	XR 애플리케이션의 뷰를 설정합니다
XrVirtualMouse	3D 컨트롤러 입력을 2D 항목의 마우스 입력으로 매핑합니다

사용 중단된 QML 유형

다음 QML 유형은 이제 더 이상 사용되지 않습니다. 사용 중단된 유형은 더 이상 유지 관리되지 않습니다. 기존 소스 코드가 계속 작동하도록 제공되지만, 향후 릴리스에서 제거될 수 있습니다. 새로운 코드에서는 이러한 클래스를 사용하지 않는 것을 강력히 권장합니다.

A: AdditiveColorGradient

B: Blur; BrushStrokes

C: ChromaticAberration; ColorMaster

D: DefaultMaterial; DepthOfFieldHQBlur; Desaturate; DistortionRipple; DistortionSphere; DistortionSpiral

E: EdgeDetect; Emboss

F: Flip; FunctionSorter; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

사용 중단된 속성이나 메서드가 있는 QML 유형

다음 QML 유형에는 현재 사용이 중단된 하나 이상의 속성이나 메서드가 포함되어 있습니다. 사용이 중단된 멤버는 더 이상 유지 관리되지 않습니다. 이 멤버들은 기존 소스 코드가 계속 작동하도록 제공하기 위한 것이지만, 향후 릴리스에서 제거될 수 있습니다. 새로운 코드에서는 이러한 사용이 중단된 멤버를 사용하지 않을 것을 강력히 권장합니다. 유형을 클릭하면 사용이 중단된 멤버를 확인할 수 있습니다.

A: Application

B: BakedLightmap

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: Model; MouseEvent

P: PinchHandler

Q: Qt

S: Screen; SortFilterProxyModel

T: TableView; Text; TouchPoint

X: XrInputAction

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