Qt Quick 3D QML Types

Dies ist das QML-Frontend für die Verwendung des räumlichen Renderers und des Scenegraphs. Zur Zeit werden alle 3D-Inhalte durch Offscreen-Texturen (FBO) geleitet, so dass sie zu Qt Quick Szenen zusammengesetzt werden können (als QQuickItem).

Importieren Sie das Modul QtQuick3D mit der folgenden Anweisung:

import QtQuick3D

QtQuick3D QML-Typen

BakedLightmap

Spezifiziert gebackene Lightmap-Einstellungen für ein Modell

Buffer

Erzeugt oder referenziert einen Farbpuffer, 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 Basis für Kameras

Command

Supertyp von Befehlen, die als Teil eines Durchgangs in einem Effekt ausgeführt werden

CubeMapTexture

Definiert eine Cube-Map-Textur für die Verwendung in 3D-Szenen

CustomCamera

Definiert eine Kamera mit einer benutzerdefinierten Projektionsmatrix

CustomMaterial

Basiskomponente für die Erstellung von benutzerdefinierten Materialien, die zum Schattieren von Modellen verwendet werden

DebugSettings

Dient zur Konfiguration von Debug-Einstellungen

DirectionalLight

Definiert ein gerichtetes Licht in der Szene

Effect

Basiskomponente für die Erstellung eines Nachbearbeitungseffekts

FileInstancing

Ermöglicht das Lesen von Instanztabellen aus einer Datei

Fog

Legt Nebel-Einstellungen für eine Szene fest

FrustumCamera

Definiert eine PerspectiveCamera mit einem benutzerdefinierten Kegelstumpf

Geometry

Basistyp für benutzerdefinierte Geometrie

InstanceList

Ermöglicht die manuelle Angabe der Instanzierung in QML

InstanceListEntry

Spezifiziert eine Instanz in einer InstanceList

Instancing

Basistyp für Instanztabellen

Joint

Definiert einen Knoten in einer skelettartigen Animationshierarchie

Light

Ein nicht-erstellbarer abstrakter Basistyp für alle Lichter

Lightmapper

Spezifiziert Lightmap-Backing-Einstellungen für eine Szene

Loader3D

Ermöglicht das dynamische Laden eines 3D-Teilbaums von einer URL oder Komponente

Material

Abstrakter Basistyp mit gemeinsamer Funktionalität für Materialien

Model

Ermöglicht das Laden von 3D-Modelldaten

MorphTarget

Definiert die Eigenschaften eines Morph-Ziels

Node

Basiskomponente für ein Objekt, das in einer 3D-Szene existiert

Object3D

Abstrakter Basistyp für alle 3D-Knoten und Ressourcen

OrthographicCamera

Definiert eine Kamera mit einer orthografischen Projektionsmatrix

Pass

Definiert einen Renderpass in einem Effekt

PerspectiveCamera

Definiert eine perspektivische Kamera zur Betrachtung des Inhalts einer 3D-Szene

PointLight

Definiert ein Punktlicht in der Szene

PrincipledMaterial

Ermöglicht die Definition eines Materials für 3D-Elemente unter Verwendung des Metall/Rauheit-Workflows

Quaternion

Bietet Hilfsfunktionen für Quaternion

QuaternionAnimation

Eine PropertyAnimation für Quaternionen

ReflectionProbe

Definiert eine Reflexionssonde in der Szene

RenderExtension

Ein nicht erzeugbarer abstrakter Basistyp für Rendererweiterungen

RenderStats

Liefert Informationen über das Rendering der Szene

Repeater3D

Instanziiert eine Anzahl von Node-basierten Komponenten unter Verwendung eines bereitgestellten Modells

ResourceLoader

Ermöglicht das Vorladen von 3D-Ressourcen

SceneEnvironment

Ermöglicht die Konfiguration, wie eine Szene gerendert wird

SetUniformValue

Definiert einen Wert, der während eines einzelnen Durchgangs gesetzt wird

Shader

Container-Komponente zur Definition von Shader-Code, der von Nachbearbeitungseffekten verwendet wird

Skeleton

Definiert eine skelettartige Animationshierarchie

Skin

Definiert eine Skinning-Animation

SpecularGlossyMaterial

Ermöglicht die Definition eines Materials für 3D-Elemente unter Verwendung des Spiegelungs-/Glanz-Workflows

SpotLight

Definiert ein Spotlight in der Szene

Texture

Definiert eine Textur zur Verwendung in 3D-Szenen

TextureData

Basistyp für benutzerdefinierte Texturdaten

TextureInput

Legt eine Textur fest, die den Shadern eines CustomMaterials oder Effekts ausgesetzt ist

View3D

Stellt ein Ansichtsfenster zur Verfügung, auf dem eine 3D-Szene gerendert wird

QML-Wert-Typen

bounds

Spezifiziert die Grenzen eines Modells

pickResult

Enthält die Ergebnisse einer Auswahl

QtQuick3D.Helpers QML-Typen

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

import QtQuick3D.Helpers

AxisHelper

Visueller Helfer zur Darstellung der 3 Achsen und eines Gitters in einer 3D-Szene

DebugView

View zur Anzeige von Rendering-Statistiken und zur Durchführung von Debug- und Entwickleraktionen

ExtendedSceneEnvironment

Eine SceneEnvironment, die häufig verwendete Rendering-Effekte bereitstellt

GridGeometry

Ein benutzerdefinierter Geometrie-Provider für das Rendering von Gittern

HeightFieldGeometry

Eine Höhenfeld-Geometrie

InfiniteGrid

Zeigt ein unendliches Gitter

InstanceModel

Definiert ein Datenmodell basierend auf einer Instanztabelle

InstanceRange

Legt einen Bereich für RandomInstancing fest

InstanceRepeater

Instanziiert Komponenten auf der Grundlage einer Instanztabelle

LodManager

Manager, der Sichtbarkeitsänderungen auf Detailebene verwaltet

LookAtNode

Ein Hilfsknoten, der automatisch auf einen anderen Knoten gerichtet bleibt

OrbitCameraController

Kamera-Controller, der um einen Ursprung rotiert

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 Population von TextureData aus QML

RandomInstancing

Erzeugt eine zufällige Instanzierungstabelle

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

Affectors modifizieren die Attribute von Partikeln während ihrer Lebensdauer

Attractor3D

Zieht Partikel in Richtung einer Position oder einer Form an

Direction3D

Richtungen weisen den emittierten Partikeln Geschwindigkeiten zu

DynamicBurst3D

Dynamische Emitter Bursts

EmitBurst3D

Deklarative Emitter-Bursts

Gravity3D

Beschleunigt die Partikel auf einen Vektor der angegebenen Größe in der angegebenen Richtung

LineParticle3D

Linienpartikel

ModelBlendParticle3D

Überblendet den Partikeleffekt mit einem 3D-Modell

ModelParticle3D

Partikel unter Verwendung eines Qt Quick 3D Modells

Particle3D

Abstrakte logische Partikel

ParticleAbstractShape3D

Abstrakter Basistyp von Partikelformen

ParticleCustomShape3D

Lädt benutzerdefinierte Partikelformen für Emitter und Affektoren

ParticleEmitter3D

Emitter für logische Partikel

ParticleModelShape3D

Bietet Partikelformen vom Modell für Emitter und Affektoren

ParticleShape3D

Bietet 3D-Formen für Emitter und Affektoren

ParticleSystem3D

Ein System, das Partikel-, Emitter- und Affektortypen umfasst

ParticleSystem3DLogging

Bietet Informationen über das Partikelsystem

PointRotator3D

Rotiert Partikel um einen Drehpunkt

Repeller3D

Partikel-Abstoßer

ScaleAffector3D

Partikel-Skalierungs-Affektor

SpriteParticle3D

Partikel mit einer 2D-Sprite-Textur

SpriteSequence3D

Liefert Bildsequenzmerkmale für die Sprite-Partikel

TargetDirection3D

Zur Angabe einer Richtung zur Zielposition

TrailEmitter3D

Emitter für logische Partikel aus anderen Partikeln

VectorDirection3D

Für die Angabe einer Richtung in Richtung der Zielrichtung

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, von der aus 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 für eine Hand dar

XrInputAction

Stellt eine Aktion von einem Eingabesteuergerät dar

XrItem

Eine virtuelle Oberfläche im 3D-Raum, die 2D-Benutzeroberflächeninhalte enthalten kann

XrOrigin

Ursprungsort für die XrView

XrRuntimeInfo

Zeigt Informationen über die XR-Laufzeit an

XrSpatialAnchor

Verfolgt einen bestimmten Ort oder ein Objekt im realen Raum

XrSpatialAnchorListModel

Bietet ein Modell mit räumlichen Ankern

XrView

Richtet die Ansicht für eine Xr-Anwendung ein

XrVirtualMouse

Bildet 3D-Controller-Eingaben auf Mauseingaben in 2D-Elementen ab

Veraltete QML-Typen

Die folgenden QML-Typen sind jetzt veraltet. Veraltete Typen werden nicht mehr gepflegt. Sie werden bereitgestellt, um alten Quellcode funktionsfähig zu halten, können aber in einer zukünftigen Version entfernt werden. Wir raten dringend davon ab, diese Klassen in neuem Code zu verwenden.

QML-Typen mit veralteten Eigenschaften oder Methoden

Die folgenden QML-Typen enthalten eine oder mehrere Eigenschaften oder Methoden, die jetzt veraltet sind. Obsolete Member werden nicht mehr gepflegt. Sie werden zur Verfügung gestellt, um alten Quellcode funktionsfähig zu halten, aber sie können 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 seine veralteten Mitglieder zu sehen.

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