Qt Quick 3D QML Types

공간 렌더러와 시네그래프를 사용하기 위한 QML 프론트엔드입니다. 당분간 모든 3D 콘텐츠는 오프스크린 텍스처(FBO)를 거쳐 Qt Quick 장면( QQuickItem)으로 구성될 수 있습니다.

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

import QtQuick3D

QtQuick3D QML 유형

BakedLightmap	모델에 대한 베이크된 라이트맵 설정을 지정합니다.
Buffer	효과의 패스에 사용할 컬러 버퍼를 생성하거나 참조합니다.
BufferInput	효과 패스에 대한 입력으로 사용할 입력 버퍼를 정의합니다.
Camera	카메라의 추상적 베이스를 정의합니다.
Command	이펙트 패스의 일부로 수행될 명령의 슈퍼타입입니다.
CubeMapTexture	3D 씬에 사용할 큐브 맵 텍스처를 정의합니다.
CustomCamera	커스텀 프로젝션 매트릭스가 있는 카메라를 정의합니다.
CustomMaterial	모델 음영에 사용되는 커스텀 머티리얼을 만들기 위한 기본 컴포넌트입니다.
DebugSettings	디버그 설정을 구성하는 데 사용됩니다.
DirectionalLight	씬에서 방향성 조명을 정의합니다.
Effect	포스트 프로세싱 효과를 만들기 위한 기본 컴포넌트
FileInstancing	파일에서 인스턴스 테이블을 읽을 수 있습니다.
Fog	씬의 포그 설정을 지정합니다.
FrustumCamera	커스텀 프러스텀이 있는 퍼스펙티브 카메라를 정의합니다.
Geometry	커스텀 지오메트리의 기본 유형
InstanceList	QML에서 인스턴스를 수동으로 지정할 수 있습니다.
InstanceListEntry	인스턴스 목록에서 인스턴스를 지정합니다.
Instancing	인스턴스 테이블의 기본 유형
Joint	스켈레탈 애니메이션 계층구조에서 노드를 정의합니다.
Light	모든 라이트에 대한 생성 불가능한 추상 베이스 유형
Lightmapper	씬의 라이트맵 베이킹 설정을 지정합니다.
Loader3D	URL 또는 컴포넌트에서 3D 서브트리를 동적으로 로드할 수 있습니다.
Material	머티리얼에 공통된 기능을 제공하는 추상 베이스 유형
Model	3D 모델 데이터를 로드할 수 있습니다.
MorphTarget	모프 대상의 프로퍼티를 정의합니다.
Node	3D 씬에 존재하는 오브젝트의 베이스 컴포넌트
Object3D	모든 3D 노드 및 리소스의 추상 베이스 유형
OrthographicCamera	직교 투영 매트릭스가 있는 카메라를 정의합니다.
Pass	효과에서 렌더 패스를 정의합니다.
PerspectiveCamera	3D 씬의 콘텐츠를 보기 위한 원근 카메라를 정의합니다.
PointLight	씬에서 포인트 라이트 정의
PrincipledMaterial	금속/거칠기 워크플로를 사용하여 3D 항목의 머티리얼을 정의할 수 있습니다.
Quaternion	쿼터니언을 위한 유틸리티 함수 제공
QuaternionAnimation	쿼터니언을 위한 프로퍼티 애니메이션
ReflectionProbe	씬에서 반사 프로브를 정의합니다.
RenderExtension	렌더 확장을 위한 생성 불가능한 추상 기본 유형
RenderStats	씬 렌더링에 대한 정보를 제공합니다.
Repeater3D	제공된 모델을 사용하여 여러 노드 기반 컴포넌트를 인스턴스화합니다.
ResourceLoader	3D 리소스 사전 로드 허용
SceneEnvironment	씬 렌더링 방식을 구성할 수 있습니다.
SetUniformValue	단일 패스 중에 설정할 값을 정의합니다.
Shader	포스트 프로세싱 효과에 사용되는 셰이더 코드를 정의하기 위한 컨테이너 컴포넌트
Skeleton	스켈레탈 애니메이션 계층구조를 정의합니다.
Skin	스키닝 애니메이션을 정의합니다.
SpecularGlossyMaterial	스페큘러/광택 워크플로를 사용하여 3D 아이템의 머티리얼을 정의할 수 있습니다.
SpotLight	씬에서 스포트라이트 정의
Texture	3D 장면에서 사용할 텍스처를 정의합니다.
TextureData	사용자 정의 텍스처 데이터의 기본 유형
TextureInput	커스텀 머티리얼 또는 이펙트의 셰이더에 노출되는 텍스처를 지정합니다.
View3D	3D 씬을 렌더링할 뷰포트를 제공합니다.

QML 값 유형

bounds	모델의 경계를 지정합니다.
pickResult	선택의 결과를 포함합니다

QtQuick3D.Helpers QML 유형

다음 문과 함께 QtQuick3D.Helpers 모듈을 임포트합니다:

import QtQuick3D.Helpers

AxisHelper	3D 씬에서 3축과 그리드를 표시하는 시각적 도우미
DebugView	렌더링 통계를 표시하고 디버그 및 개발자 작업을 수행하기 위한 뷰
ExtendedSceneEnvironment	일반적으로 사용되는 렌더링 효과를 제공하는 SceneEnvironment
GridGeometry	그리드 렌더링을 위한 커스텀 지오메트리 공급자
HeightFieldGeometry	높이 필드 지오메트리
InfiniteGrid	무한 그리드 표시
InstanceModel	인스턴스 테이블에 기반한 데이터 모델 정의
InstanceRange	랜덤 인스턴싱의 범위를 지정합니다.
InstanceRepeater	인스턴스 테이블을 기반으로 컴포넌트 인스턴스화
LodManager	세부 수준 가시성 변경을 처리하는 관리자
LookAtNode	자동으로 다른 노드를 가리키도록 유지되는 도우미 노드
OrbitCameraController	원점을 중심으로 회전하는 카메라 컨트롤러
ProceduralMesh	QML에서 지오메트리 생성 가능
ProceduralMeshSubset	프로시저럴 메시의 하위 집합을 정의합니다.
ProceduralSkyTextureData	HDR 스카이박스 큐브맵 생성
ProceduralTextureData	QML에서 텍스처데이터 생성 및 팝업을 허용합니다.
RandomInstancing	랜덤 인스턴싱 테이블 생성
WasdController	키와 마우스로 노드 위치 및 방향 제어

QtQuick3D.Asset유용 QML 유형

다음 구문으로 QtQuick3D.AssetUtils 모듈을 임포트합니다:

import QtQuick3D.AssetUtils

RuntimeLoader

런타임에 3D 에셋을 임포트합니다.

QtQuick3D.Particles3D QML 유형

다음 문으로 QtQuick3D.Particles3D 모듈을 임포트합니다:

import QtQuick3D.Particles3D

Affector3D	어펙터는 파티클의 수명 동안 파티클의 속성을 수정합니다.
Attractor3D	위치 - 파티클을 위치나 모양으로 끌어당깁니다.
Direction3D	방향은 방출된 파티클에 속도를 할당합니다.
DynamicBurst3D	동적 이미터 버스트
EmitBurst3D	선언적 이미터 버스트
Gravity3D	파티클을 지정된 방향으로 지정된 크기의 벡터로 가속합니다.
LineParticle3D	라인 파티클
ModelBlendParticle3D	파티클 효과를 3D 모델과 혼합합니다.
ModelParticle3D	Qt Quick 3D 모델을 사용하는 파티클
Particle3D	추상 논리 파티클
ParticleAbstractShape3D	파티클 모양의 추상 기본 유형
ParticleCustomShape3D	이미터 및 이펙터에 대한 커스텀 파티클 모양을 로드합니다.
ParticleEmitter3D	논리적 파티클용 이미터
ParticleModelShape3D	이미터 및 이미터용 모델에서 파티클 모양 제공
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 모델을 나타냅니다.
XrInputAction	입력 컨트롤러의 동작을 나타냅니다.
XrItem	2D 사용자 인터페이스 콘텐츠를 담을 수 있는 3D 공간의 가상 표면
XrOrigin	XrView의 원점 위치
XrRuntimeInfo	XR 런타임에 대한 정보를 표시합니다.
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; Fxaa

G: GaussianBlur

H: HDRBloomTonemap

M: MotionBlur

S: Scatter; SCurveTonemap; Settings

T: TiltShift

V: Vignette

더 이상 사용되지 않는 속성 또는 메서드가 있는 QML 유형

다음 QML 유형에는 현재 사용되지 않는 속성 또는 메서드가 하나 이상 포함되어 있습니다. 사용되지 않는 멤버는 더 이상 유지 관리되지 않습니다. 이전 소스 코드의 작동을 유지하기 위해 제공되었지만 향후 릴리스에서 제거될 수 있습니다. 새 코드에서 이러한 더 이상 사용되지 않는 멤버를 사용하지 않는 것이 좋습니다. 더 이상 사용되지 않는 멤버를 보려면 유형을 클릭하세요.

A: Application

C: Canvas

D: DragHandler

G: Gravity

H: HeightFieldGeometry

L: Light; Locale

M: MouseEvent

P: PinchHandler

Q: Qt

S: Screen

T: TableView; Text; TouchPoint

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