Obsolete Members for Qt3DCore

Die folgenden Mitglieder der Klasse „ Qt3DCore “ sind veraltet. Sie werden bereitgestellt, um die Funktionsfähigkeit von altem Quellcode zu gewährleisten. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Namensräume

Klassen

Namespaces

[deprecated] namespace Qt3DCore::Quick

Dieser Namensraum ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Klassen

[deprecated] class Qt3DCore::QAbstractAspect

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

[deprecated] class Qt3DCore::QAbstractFunctor

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

„QAbstractFunctor“ dient als Basisklasse für alle Funktoren und Datengeneratoren im Modul „ Qt3DCore “.

Wenn ein Benutzer einen neuen Funktor oder Generator definiert, muss er die Methode ` QAbstractFunctor::id()` implementieren, was mithilfe des Makros ` QT3D_FUNCTOR ` in der Klassendefinition erfolgen sollte.

[deprecated] class Qt3DCore::QAbstractSkeleton

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie diese Klasse nicht direkt. Sie sollten „ QSkeletonLoader “ verwenden, wenn Sie Skelettdaten aus einer Datei laden (was am wahrscheinlichsten ist), oder „ QSkeleton “, wenn Sie die Skelett- und Skinned-Mesh-Daten selbst erstellen (hauptsächlich für Entwickler von Editoren oder Werkzeugen).

[deprecated] class Qt3DCore::QArmature

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Die „Armature“-Komponente wird von Entitäten aggregiert, um ihnen die Möglichkeit zu geben, die Palette der für das korrekte Rendern von Skinned-Meshes erforderlichen Skinning-Transformationsmatrizen zu berechnen.

Jeder Scheitelpunkt in einem Skinned-Mesh ist mit bis zu 4 Gelenken in einem Skelett verknüpft (gebunden). Für jedes Gelenk, das einen Scheitelpunkt beeinflusst, stellt das Mesh außerdem ein Gewicht bereit, das den Einflussgrad des entsprechenden Gelenks bestimmt. Die für die Transformation von geskinnten Scheitelpunkten verwendete Skinning-Palette wird von der Armature bereitgestellt und anhand der im referenzierten Skelett enthaltenen Gelenke berechnet.

Die Aktualisierung der lokalen Transformation eines Gelenks führt dazu, dass die Skinning-Matrizen neu berechnet werden und sich die an dieses Gelenk gebundenen Scheitelpunkte des geskinnten Meshes entsprechend verschieben.

[deprecated] class Qt3DCore::QAspectEngine

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Die Qt3D-Ausführungsschleife wird von der Klasse `Qt3DRender::QAspectEngine` gesteuert.

Qt3DCore::QAbstractAspect Unterklassen können durch den Aufruf von `Qt3DCore::QAspectEngine::registerAspect()` registriert werden, wodurch die Registrierung des Aspekts übernommen wird und im Gegenzug `Qt3DCore::QAbstractAspect::onRegistered()` aufgerufen wird;

Die Simulationsschleife wird gestartet, sobald ein Stamm- Qt3DCore::QEntity, auf dem „ Qt3DCore::QAspectEngine “ festgelegt wurde. Darauf folgt ein Aufruf von `onEngineStartup()` für jeden Aspekt, damit diese ihre Simulationsarbeit beginnen können.

Die Simulationsschleife wird gestoppt, wenn die Stamm-Entität auf `Qt3DCore::QEntityPtr()` gesetzt wird. Dies ruft bei jedem Aspekt `onEngineShutdown()` auf, damit diese ihre Simulationsarbeit beenden können.

Das Festlegen einer neuen gültigen Stammentität würde die Simulationsschleife erneut starten.

[deprecated] class Qt3DCore::QAspectJob

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

[deprecated] class Qt3DCore::QAttribute

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Es gibt drei Arten von Attributen.

• VertexAttribute: Dienen zur Definition von Daten, die pro Scheitelpunkt gelesen werden sollen
• IndexAttribute: Dienen zur Definition von Vertex-Indizes, wenn indizierte Zeichenaufrufe verwendet werden sollen
• DrawIndirectAttribute: dient zur Angabe des „DrawIndirect“-Puffers, der bei der Verwendung von indirekten Zeichenaufrufen verwendet werden soll

Wenn Sie eigene Attribute bereitstellen, kann es sinnvoll sein, Ihr Attribut mithilfe von Hilfsfunktionen wie „ QAttribute::defaultPositionAttributeName()“ zu benennen, da dies sicherstellt, dass Ihre Geometrie mit dem Picking und den verschiedenen im Modul „ Qt3DExtras “ bereitgestellten Materialien kompatibel ist.

Siehe auch „ QBuffer “.

[deprecated] class Qt3DCore::QBackendNode

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

[deprecated] class Qt3DCore::QBackendNodeMapper

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

[since 6.0, deprecated] class Qt3DCore::QBoundingVolume

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Das Begrenzungsvolumen einer Entität wird für viele Operationen verwendet, beispielsweise für die Auswahl oder das View-Frustum-Culling. Es wird normalerweise durch Durchlaufen der gerenderten Geometrie berechnet.

„QBoundingVolume“ kann verwendet werden, wenn der Umfang der Geometrie der Anwendung bekannt ist, sodass „ Qt 3D “ diesen nicht berechnen muss.

Ein Begrenzungsvolumen kann entweder als minimale und maximale Ausdehnungskoordinaten oder als separate, meist einfachere Geometrie bereitgestellt werden, die das gerenderte Netz approximiert.

Bei Verwendung von Minimal- und Maximalausdehnungen werden diese als die gegenüberliegenden Ecken eines achsenausgerichteten Begrenzungsrahmens im lokalen Koordinatensystem der Geometrie betrachtet.

Mit „QBoundingVolume“ kann auch das berechnete Begrenzungsvolumen eines „ GeometryView “ abgefragt werden. Die Eigenschaften „ implicitMinPoint “ und „ implicitMaxPoint “ werden aktualisiert, wenn sich die Geometrie ändert. Beachten Sie, dass dies asynchron in einem Hintergrund-Thread erfolgt; daher sollten Sie den Wert von „ implicitPointsValid “ überprüfen, bevor Sie diese Eigenschaften auslesen.

Sie können die Aktualisierung der impliziten Ausdehnungen erzwingen, indem Sie ` updateImplicitBounds` aufrufen. Dies blockiert den aufrufenden Thread, bis die Ergebnisse verfügbar sind.

Diese Klasse wurde in Qt 6.0 eingeführt.

[deprecated] class Qt3DCore::QBuffer

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Daten können direkt über ` QBuffer::setData()` bereitgestellt werden.

[deprecated] class Qt3DCore::QComponent

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Ein „ Qt3DCore::QComponent “ stellt einen vertikalen Ausschnitt an Verhalten bereit, der „ Qt3DCore::QEntity “-Instanzen zugewiesen und manchmal auch von mehreren dieser Instanzen gemeinsam genutzt werden kann.

Qt3DCore::QComponent Unterklassen werden häufig zu Gruppen zusammengefasst, die der aggregierenden Entität nützliches Verhalten verleihen. Um beispielsweise eine Entität zu erstellen, die vom Qt3D-Renderer-Aspekt gezeichnet wird, würde eine Entität höchstwahrscheinlich die Komponenten „ Qt3DCore::QTransform “, „ Qt3DRender::QMesh “ und „ Qt3DRender::QMaterial “ aggregieren.

Siehe auch Qt3DCore::QEntity.

[since 6.0, deprecated] class Qt3DCore::QCoreSettings

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Die Komponente „QCoreSettings“ sollte als Komponente der Stammentität der Szene festgelegt werden (obwohl sie sich an beliebiger Stelle im Szenenbaum befinden könnte). Es sollte nur eine einzige Instanz geben.

Sie kann verwendet werden, um bestimmte Verhaltensweisen von „ Qt 3D “ zu steuern.

Diese Klasse wurde in Qt 6.0 eingeführt.

[deprecated] class Qt3DCore::QEntity

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eine „ Qt3DCore::QEntity “ ist für sich genommen eine leere Hülle. Das Verhalten eines „ Qt3DCore::QEntity “-Objekts wird durch die „ Qt3DCore::QComponent “-Objekte definiert, auf die es verweist. Jeder Qt3D-Backend-Aspekt kann eine „Entity“ interpretieren und verarbeiten, indem er erkennt, aus welchen Komponenten sie besteht. Ein Aspekt entscheidet sich möglicherweise dafür, nur Entitäten zu verarbeiten, die aus einer einzigen „ Qt3DCore::QTransform “-Komponente bestehen, während sich ein anderer auf „ Qt3DInput::QMouseHandler “ konzentriert.

Siehe auch Qt3DCore::QComponent und Qt3DCore::QTransform.

[deprecated] class Qt3DCore::QGeometry

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Eine ` Qt3DCore::QGeometry `-Klasse wird verwendet, um eine Liste von ` Qt3DCore::QAttribute `-Objekten zu einer geometrischen Form zusammenzufassen, die Qt3D mithilfe von `Qt3DCore::QGeometryRenderer` rendern kann. Es können spezielle Attribute festgelegt werden, um das Begrenzungsvolumen der Form zu berechnen.

[since 6.0, deprecated] class Qt3DCore::QGeometryView

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Ein „ GeometryView “ enthält alle Informationen, die zur Verarbeitung einer „Geometry“ erforderlich sind. Eine „Geometry“ enthält die Koordinaten der Geometriedaten – „ GeometryView “ legt fest, wie diese Daten zu interpretieren sind.

Diese Klasse wurde in Qt 6.0 eingeführt.

[deprecated] class Qt3DCore::QJoint

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Der QJoint-Knoten wird verwendet, um Skelette als Teil der Unterstützung für Skinned Meshes in Qt 3D zu erstellen. Ein Gelenk kann über seine Eigenschaften für Skalierung, Rotation und Translation transformiert werden. Die Transformationen aller an das Gelenk gebundenen Mesh-Scheitelpunkte werden entsprechend aktualisiert.

[deprecated] class Qt3DCore::QNode

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Die Zugehörigkeit eines QNode wird durch die „ QObject “-Beziehung zwischen über- und untergeordneten Knoten bestimmt. Ein QNode hat an sich weder ein visuelles Erscheinungsbild noch eine bestimmte Bedeutung; er dient lediglich dazu, eine auf Knoten basierende Baumstruktur aufzubauen.

Der übergeordnete Knoten einer QNode-Instanz kann nur eine andere QNode-Instanz sein.

Jede QNode-Instanz verfügt über eine eindeutige ID, anhand derer sie von anderen Instanzen unterschieden werden kann.

Wenn Eigenschaften in einer QNode-Unterklasse definiert werden, generiert deren NOTIFY-Signal automatisch Benachrichtigungen, die vom Qt3D-Backend empfangen werden.

Siehe auch QEntity und QComponent.

[deprecated] class Qt3DCore::QNodeId

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

[deprecated] class Qt3DCore::QSkeleton

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie „QSkeleton“, wenn Sie die Gelenke eines Skeletts für die Verwendung mit Skinned Meshes manuell erstellen möchten. Dies ist vor allem für Entwickler von Editoren, Werkzeugen oder dynamischen Skeletten von Nutzen. In der Regel nutzt eine „ Qt 3D “-Anwendung einfach ein vorhandenes Skelett und einen Skinned Mesh, die in einem Tool zur Erstellung digitaler Inhalte wie beispielsweise Blender erstellt wurden. Für diesen Anwendungsfall lesen Sie bitte QSkeletonLoader.

[deprecated] class Qt3DCore::QSkeletonLoader

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie „ SkeletonLoader “, wenn Sie ein komplettes Skelett aus einer Datei laden möchten, anstatt die Gelenke selbst mit „Skeleton“ und „Joints“ zu erstellen. Das Erstellen eines Skeletts und das Binden der Scheitelpunkte eines Meshes an das Skelett lässt sich am einfachsten in einem Tool zur Erstellung digitaler 3D-Inhalte wie Blender durchführen. Das resultierende Skelett und Mesh können dann in einem geeigneten Format wie glTF 2 exportiert werden, um von „ Qt 3D “ verarbeitet zu werden.

[deprecated] class Qt3DCore::QTransform

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Die QTransform-Komponente kann nicht von mehreren „ QEntity “-Objekten gemeinsam genutzt werden. Die Transformation wird in Form der Komponenten „ QVector3D “ (Skalierung), „ QQuaternion “ (Rotation) und „ QVector3D “ (Translation) gespeichert. Die Transformationen werden in dieser Reihenfolge auf das Mesh angewendet. Wenn die Eigenschaft „ QTransform::matrix “ gesetzt ist, wird die Transformation in diese Transformationskomponenten zerlegt und entsprechende Signale werden ausgegeben.

Zur Einrichtung der QTransform stehen mehrere Hilfsfunktionen zur Verfügung: Mit „ fromAxisAndAngle “ und „ fromAxesAndAngles “ lässt sich die Drehung um bestimmte Achsen festlegen, mit „ fromEulerAngles “ die Drehung anhand von Eulerwinkeln und mit „ rotateAround “ die Drehung des Objekts um einen bestimmten Punkt relativ zum lokalen Ursprung.