Qt Quick 3D QML Types

Dies ist das QML-Frontend für die Verwendung des räumlichen Renderers und des Szenengrafiksystems. Derzeit werden alle 3D-Inhalte über Offscreen-Texturen (FBO) verarbeitet, damit sie zu „ Qt Quick “-Szenen zusammengesetzt werden können (als „ QQuickItem “).

Importieren Sie das QtQuick3D-Modul mit der folgenden Anweisung:

import QtQuick3D

QtQuick3D-QML-Typen

AddDefine	Fügt der Shader-Kompilierung für einen Durchlauf eine Präprozessor-Definition hinzu
BakedLightmap	Legt die Einstellungen für gebackene Lightmaps für ein Modell fest
Buffer	Erstellt einen Farbpuffer oder verweist auf einen solchen, der für einen Durchgang eines Effekts verwendet werden soll
BufferInput	Definiert einen Eingabepuffer, der als Eingabe für einen Durchlauf eines Effekts verwendet werden soll
Camera	Definiert eine abstrakte Basisklasse für Kameras
ColorAttachment	Definiert eine Farbzuordnung für einen Render-Durchlauf
Command	Supertyp von Befehlen, die als Teil eines Durchgangs in einem Effekt ausgeführt werden sollen
ContentLayer	Singleton, das Layer-Flag-Konstanten zum Gruppieren und Filtern von Szenenknoten bereitstellt
CubeMapTexture	Definiert eine Cube-Map-Textur zur Verwendung in 3D-Szenen
CustomCamera	Definiert eine Kamera mit einer benutzerdefinierten Projektionsmatrix
CustomMaterial	Basis-Komponente zum Erstellen benutzerdefinierter Materialien, die zur Schattierung von Modellen verwendet werden
DebugSettings	Wird zur Konfiguration von Debug-Einstellungen verwendet
DepthStencilAttachment	Definiert ein Depth-Stencil-Attachment für einen RenderPass
DepthTextureAttachment	Definiert eine Tiefentextur-Anbindung für einen Pass
DirectionalLight	Definiert ein gerichtetes Licht in der Szene
Effect	Basiskomponente zum Erstellen eines Post-Processing-Effekts
FileInstancing	Ermöglicht das Einlesen von Instanztabellen aus einer Datei
Fog	Legt Nebeleinstellungen für eine Szene fest
FrustumCamera	Definiert eine „PerspectiveCamera“ mit einem benutzerdefinierten Sichtkegel
Geometry	Basistyp für benutzerdefinierte Geometrie
InstanceList	Ermöglicht die manuelle Festlegung der Instanzierung in QML
InstanceListEntry	Legt eine Instanz in einer InstanceList fest
Instancing	Basistyp für Instanztabellen
Joint	Definiert einen Knoten in einer Skelett-Animationshierarchie
Light	Ein nicht erstellbarer abstrakter Basistyp für alle Lichter
Lightmapper	Legt die Einstellungen für das Baking von Lightmaps für eine Szene fest
Loader3D	Ermöglicht das dynamische Laden eines 3D-Teilbaums über eine URL oder eine Komponente
Material	Abstrakter Basistyp, der Materialien gemeinsame Funktionen bereitstellt
Model	Ermöglicht das Laden von 3D-Modelldaten
MorphTarget	Definiert die Eigenschaften eines Morph-Ziels
Node	Basis-Komponente für ein Objekt, das in einer 3D-Szene vorhanden ist
Object3D	Abstrakter Basistyp aller 3D-Knoten und -Ressourcen
OrthographicCamera	Definiert eine Kamera mit einer orthogonalen Projektionsmatrix
Pass	Definiert einen Render-Pass in einem Effekt
PerspectiveCamera	Definiert eine perspektivische Kamera zur Anzeige des Inhalts einer 3D-Szene
PipelineStateOverride	Definiert Pipeline-Zustandsüberschreibungen für einen einzelnen Durchlauf
PointLight	Definiert eine Punktlichtquelle in der Szene
PrincipledMaterial	Ermöglicht es Ihnen, ein Material für 3D-Objekte mithilfe des Metall-/Rauheits-Workflows zu definieren
Quaternion	Stellt Hilfsfunktionen für Quaternionen bereit
QuaternionAnimation	Eine „PropertyAnimation“ für Quaternionen
ReflectionProbe	Definiert eine Reflexionssonde in der Szene
RenderExtension	Einen nicht erstellbaren abstrakten Basistyp für Render-Erweiterungen
RenderPass	Definiert einen benutzerdefinierten Render-Pass zum Rendern von 3D-Inhalten
RenderPassTexture	Definiert eine Textur, die in einem Durchgang als Renderziel verwendet werden soll
RenderStats	Stellt Informationen zum Rendern der Szene bereit
RenderablesFilter	Definiert einen Filter zur Auswahl der Renderables, auf die in einem Pass eingewirkt werden soll
Repeater3D	Instanziiert eine Reihe von Node-basierten Komponenten unter Verwendung eines bereitgestellten Modells
ResourceLoader	Ermöglicht das Vorladen von 3D-Ressourcen
SceneEnvironment	Ermöglicht die Konfiguration der Art und Weise, wie eine Szene gerendert wird
SetUniformValue	Definiert einen Wert, der während eines einzelnen Durchgangs gesetzt werden soll
Shader	Container-Komponente zur Definition von Shader-Code, der von Post-Processing-Effekten verwendet wird
Skeleton	Definiert eine Skelett-Animationshierarchie
Skin	Definiert eine Skinning-Animation
SkyMaterial	Rendert einen prozeduralen Himmel und generiert bildbasierte Beleuchtungsdaten
SpecularGlossyMaterial	Ermöglicht die Definition eines Materials für 3D-Objekte mithilfe des Specular-/Glossiness-Workflows
SpotLight	Definiert ein Spotlicht in der Szene
SubRenderPass	Rendert einen Teilbereich der Arbeit innerhalb desselben Renderziels wie der übergeordnete RenderPass
Texture	Definiert eine Textur zur Verwendung in 3D-Szenen
TextureData	Basistyp für benutzerdefinierte Texturdaten
TextureInput	Legt eine Textur fest, die den Shadern eines „CustomMaterial“ oder „Effect“ zur Verfügung gestellt wird
TextureProviderExtension	Abstrakter Basistyp für Render-Erweiterungen, die eine Textur erzeugen
View3D	Stellt ein Ansichtsfenster bereit, in dem eine 3D-Szene gerendert werden kann

QML-Werttypen

bounds	Legt die Begrenzungen eines Modells fest
pickResult	Enthält die Ergebnisse einer Auswahl
renderTargetBlend	Definiert Mischparameter für eine einzelne Farbzuordnung eines Renderdurchgangs

QtQuick3D.Helpers-QML-Typen

Importieren Sie das Modul „QtQuick3D.Helpers“ mit der folgenden Anweisung:

import QtQuick3D.Helpers

AxisHelper	Visuelle Hilfe zur Darstellung der 3 Achsen und eines Rasters in einer 3D-Szene
CapsuleGeometry	Stellt die Geometrie für eine Kapsel bereit
ConeGeometry	Stellt Geometrie für einen Kegel bereit
CuboidGeometry	Stellt Geometrie für einen Quader bereit
CylinderGeometry	Stellt Geometrie für einen Zylinder bereit
DebugView	Ansicht zur Anzeige von Rendering-Statistiken sowie zur Durchführung von Debugging- und Entwickleraktionen
ExtendedSceneEnvironment	Eine „SceneEnvironment“, die häufig verwendete Rendering-Effekte bereitstellt
ExtrudedTextGeometry	Stellt Geometrie für extrudierten Text bereit
GridGeometry	Ein benutzerdefinierter Geometrie-Provider zum Rendern von Gittern
HeightFieldGeometry	Eine Höhenfeld-Geometrie
InfiniteGrid	Zeigt ein unendliches Raster an
InstanceModel	Definiert ein Datenmodell auf Basis einer Instanztabelle
InstanceRange	Legt einen Bereich für „RandomInstancing“ fest
InstanceRepeater	Instanziiert Komponenten auf Basis einer Instanztabelle
LodManager	Manager, der Änderungen der Sichtbarkeit von Detailstufen verwaltet
LookAtNode	Ein Hilfsknoten, der automatisch auf einen anderen Knoten verweist
OrbitCameraController	Kamerasteuerung, die sich um einen Ursprung dreht
PlaneGeometry	Stellt Geometrie für eine Ebene bereit
ProceduralMesh	Ermöglicht die Erstellung von Geometrie aus QML
ProceduralMeshSubset	Definiert eine Teilmenge eines „ProceduralMesh“
ProceduralSkyTextureData	Erzeugt eine HDR-Skybox-Cubemap
ProceduralTextureData	Ermöglicht die Erstellung und Befüllung von `TextureData` aus QML
QuadTextureProvider	Wird zum Rendern einer Quad-Textur unter Verwendung eines benutzerdefinierten Fragment-Shaders verwendet
RandomInstancing	Erzeugt eine zufällige Instanzierungstabelle
RenderOutputProvider	Wird als Brücke verwendet, um auf in Pässen bereitgestellte Texturen zuzugreifen
SimpleQuadRenderer	Rendert ein texturiertes Quad im Vollbildmodus auf das Hauptrenderziel
SphereGeometry	Stellt Geometrie für eine Kugel bereit
TorusGeometry	Stellt Geometrie für einen Torus bereit
WasdController	Steuert die Position und Ausrichtung von Knoten mit Tasten und Maus

QtQuick3D.AssetUtils-QML-Typen

Importieren Sie das Modul „QtQuick3D.AssetUtils“ mit der folgenden Anweisung:

import QtQuick3D.AssetUtils

RuntimeLoader

Importiert ein 3D-Asset zur Laufzeit

QtQuick3D.Particles3D-QML-Typen

Importieren Sie das Modul QtQuick3D.Particles3D mit der folgenden Anweisung:

import QtQuick3D.Particles3D

Affector3D	Affektoren ändern die Attribute von Partikeln während ihrer Lebensdauer
Attractor3D	Zieht Partikel zu einer Position oder einer Form hin
Direction3D	Richtungen weisen den emittierten Partikeln eine Geschwindigkeit zu
DynamicBurst3D	Dynamische Emitter-Bursts
EmitBurst3D	Deklarative Emitter-Bursts
Gravity3D	Beschleunigt Partikel auf einen Vektor mit der angegebenen Größe in der angegebenen Richtung
LineParticle3D	Linienpartikel
ModelBlendParticle3D	Kombiniert einen Partikeleffekt mit einem 3D-Modell
ModelParticle3D	Partikel unter Verwendung eines „ Qt Quick 3D “-Modells
Particle3D	Abstraktes logisches Partikel
ParticleAbstractShape3D	Abstrakter Basistyp für Partikelformen
ParticleCustomShape3D	Lädt benutzerdefinierte Partikelformen für Emitter und Affektoren
ParticleEmitter3D	Emittierer für logische Partikel
ParticleModelShape3D	Stellt Partikelformen aus dem Modell für Emitter und Affektoren bereit
ParticleSceneShape3D	Stellt Partikelformen aus einer Szene für Emitter und Affektoren bereit
ParticleShape3D	Stellt 3D-Formen für Emitter und Affektoren bereit
ParticleSystem3D	Ein System, das Partikel-, Emitter- und Affektor-Typen umfasst
ParticleSystem3DLogging	Stellt Informationen zum Partikelsystem bereit
PointRotator3D	Dreht Partikel um einen Drehpunkt
Repeller3D	Partikelabwehr
ScaleAffector3D	Effektor zur Partikelgröße
SpriteParticle3D	Partikel, die eine 2D-Sprite-Textur verwenden
SpriteSequence3D	Stellt Bildsequenzfunktionen für die Sprite-Partikel bereit
TargetDirection3D	Zur Festlegung einer Richtung zur Zielposition
TrailEmitter3D	Emittent für logische Partikel, die von anderen Partikeln erzeugt werden
VectorDirection3D	Zur Festlegung einer Richtung in Richtung der Zielposition
Wander3D	Wendet zufällige Wellenkurven auf Partikel an

QtQuick3D.Xr-QML-Typen

Importieren Sie das Modul „QtQuick3D.Xr“ mit der folgenden Anweisung:

import QtQuick3D.Xr

XrCamera	Verfolgt die räumliche Position und Ausrichtung, aus der der Benutzer eine XR-Szene betrachtet
XrController	Ein verfolgter räumlicher Knoten, der die Position und Ausrichtung eines Eingabecontrollers verfolgt
XrErrorDialog	Benutzerdefinierter Fehlerdialog für PCVR-Anwendungen
XrHandModel	Stellt ein 3D-Modell einer Hand dar
XrHapticEffect	Stellt einen haptischen Effekt dar
XrHapticFeedback	Steuert das haptische Feedback für ein XR-Steuergerät
XrInputAction	Stellt eine Aktion eines Eingabecontrollers dar
XrItem	Eine virtuelle Oberfläche im 3D-Raum, die 2D-Inhalte der Benutzeroberfläche anzeigen kann
XrOrigin	Ursprungsposition für das XrView
XrRuntimeInfo	Zeigt Informationen zur XR-Laufzeit an
XrSimpleHapticEffect	Ermöglicht die Einstellung der Controller-Haptik anhand von Amplitude, Dauer und Frequenz
XrSpatialAnchor	Verfolgt einen bestimmten Ort oder ein bestimmtes Objekt im realen Raum
XrSpatialAnchorListModel	Stellt ein Modell bereit, das räumliche Anker enthält
XrView	Richtet die Ansicht für eine XR-Anwendung ein
XrVirtualMouse	Ordnet die Eingaben des 3D-Controllers den Mauseingaben in 2D-Elementen zu

Veraltete QML-Typen

Die folgenden QML-Typen sind nun veraltet. Veraltete Typen werden nicht mehr weiterentwickelt. Sie werden bereitgestellt, damit alter Quellcode weiterhin funktioniert, können jedoch in einer zukünftigen Version entfernt werden. Wir raten dringend davon ab, diese Klassen in neuem Code zu verwenden.

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-Typen mit veralteten Eigenschaften oder Methoden

Die folgenden QML-Typen enthalten eine oder mehrere Eigenschaften oder Methoden, die mittlerweile veraltet sind. Veraltete Elemente werden nicht mehr gepflegt. Sie werden bereitgestellt, damit alter Quellcode weiterhin funktioniert, können jedoch in einer zukünftigen Version entfernt werden. Wir raten dringend davon ab, diese veralteten Elemente in neuem Code zu verwenden. Klicken Sie auf einen Typ, um dessen veraltete Elemente anzuzeigen.

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.