Obsolete Members for Qt3DCore

Les membres suivants de la classe ` Qt3DCore ` sont obsolètes. Ils sont fournis afin de garantir le bon fonctionnement des anciens codes sources. Nous déconseillons fortement de les utiliser dans les nouveaux codes.

Espaces de noms

Classes

Espaces de noms

[deprecated] namespace Qt3DCore::Quick

Cet espace de noms est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Classes

[deprecated] class Qt3DCore::QAbstractAspect

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

[deprecated] class Qt3DCore::QAbstractFunctor

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

La classe QAbstractFunctor sert de classe de base à tous les foncteurs et générateurs de données du module Qt3DCore.

Lorsqu'un utilisateur définit un nouveau foncteur ou générateur, il doit implémenter la méthode ` QAbstractFunctor::id()`, ce qui doit être effectué à l'aide de la macro ` QT3D_FUNCTOR ` dans la définition de la classe.

[deprecated] class Qt3DCore::QAbstractSkeleton

Cette classe est obsolète. Nous vous déconseillons vivement de l'utiliser dans du nouveau code.

N'utilisez pas cette classe directement. Vous devriez utiliser QSkeletonLoader si vous chargez des données de squelette à partir d'un fichier (ce qui est le plus probable) ou QSkeleton si vous créez vous-même les données de squelette et de maillage texturé (principalement pour les personnes qui développent des éditeurs ou des outils).

[deprecated] class Qt3DCore::QArmature

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Le composant Armature est agrégé par les entités afin de leur permettre de calculer la palette de matrices de transformation de skinning nécessaire au rendu correct des maillages skinnés.

Chaque sommet d'un maillage skinné est associé (lié) à un maximum de 4 articulations d'un squelette. Pour chaque articulation affectant un sommet, le maillage fournit également un poids qui détermine le niveau d’influence de l’articulation correspondante. La palette de skinning utilisée pour effectuer la transformation des sommets skinnés est fournie par l’Armature et est calculée à partir des articulations contenues dans le squelette référencé.

La mise à jour de la transformation locale d’une articulation entraîne le recalcul des matrices de skinning et le déplacement en conséquence des sommets du maillage skinné liés à cette articulation.

[deprecated] class Qt3DCore::QAspectEngine

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

La boucle d'exécution Qt3D est contrôlée par Qt3DRender::QAspectEngine.

Qt3DCore::QAbstractAspect Les sous-classes peuvent être enregistrées en appelant Qt3DCore::QAspectEngine::registerAspect(), qui se chargera d'enregistrer l'aspect et appellera à son tour Qt3DCore::QAbstractAspect::onRegistered() ;

La boucle de simulation est lancée dès qu’une entité racine ( Qt3DCore::QEntity ) est définie sur l’objet ` Qt3DCore::QAspectEngine`. Cette opération est suivie d’un appel à la méthode `onEngineStartup()` sur chaque aspect, afin qu’ils puissent démarrer leur travail de simulation.

La boucle de simulation s’arrête lorsque l’entité racine est définie sur Qt3DCore::QEntityPtr(). Cela appelle la fonction onEngineShutdown() sur chaque aspect afin qu’ils puissent cesser d’effectuer leur travail de simulation.

La définition d'une nouvelle entité racine valide relancerait la boucle de simulation.

[deprecated] class Qt3DCore::QAspectJob

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

[deprecated] class Qt3DCore::QAttribute

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Il existe 3 types d'attributs.

• VertexAttribute: utilisés pour définir les données à lire pour chaque sommet
• IndexAttribute: sert à définir les indices de sommets lorsque des appels de dessin indexés doivent être utilisés
• DrawIndirectAttribute: utilisés pour spécifier le tampon DrawIndirect à utiliser lorsque des appels de dessin indirects sont utilisés

Lorsque vous définissez vos propres attributs, il peut être judicieux de les nommer à l’aide de fonctions d’aide telles que ` QAttribute::defaultPositionAttributeName()` ; cela garantira la compatibilité de votre géométrie avec le picking et les différents matériaux fournis dans le module « Qt3DExtras ».

Voir également QBuffer.

[deprecated] class Qt3DCore::QBackendNode

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

[deprecated] class Qt3DCore::QBackendNodeMapper

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

[since 6.0, deprecated] class Qt3DCore::QBoundingVolume

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Le volume englobant d'une entité est utilisé pour de nombreuses opérations, telles que la sélection ou le culling du cône de vue. Il est normalement calculé en parcourant la géométrie rendue.

QBoundingVolume peut être utilisé lorsque l'application connaît l'étendue de la géométrie, ce qui évite à l'Qt 3D e de devoir la calculer.

Un volume englobant peut être fourni soit sous forme de coordonnées d’étendue minimale et maximale, soit sous la forme d’une géométrie distincte, généralement plus simple, qui approxime le maillage rendu.

Lorsque l’on utilise des étendues minimale et maximale, celles-ci sont considérées comme les coins opposés d’un parallélépipède rectangulaire aligné sur les axes, dans le système de coordonnées local de la géométrie.

QBoundingVolume peut également être utilisé pour interroger le volume englobant calculé d’un GeometryView. Les propriétés implicitMinPoint et implicitMaxPoint seront mises à jour si la géométrie change. Notez que cette opération s’effectue de manière asynchrone sur un thread d’arrière-plan ; vous devez donc vérifier la valeur de implicitPointsValid avant de les lire.

Vous pouvez forcer la mise à jour des limites implicites en appelant ` updateImplicitBounds`. Cela bloquera le thread appelant jusqu’à ce que les résultats soient disponibles.

Cette classe a été introduite dans Qt 6.0.

[deprecated] class Qt3DCore::QBuffer

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Les données peuvent être fournies directement à l'aide de la fonction ` QBuffer::setData()`.

[deprecated] class Qt3DCore::QComponent

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Une « Qt3DCore::QComponent » fournit une tranche verticale de comportement qui peut être attribuée à des instances d’ Qt3DCore::QEntity, et parfois partagée entre elles.

Qt3DCore::QComponent Les sous-classes sont souvent agrégées en groupes qui confèrent un comportement utile à l'entité agrégatrice. Par exemple, pour qu'une entité soit dessinée par l'aspect « Qt3D renderer », elle agrégera très probablement les composants « Qt3DCore::QTransform », « Qt3DRender::QMesh » et « Qt3DRender::QMaterial ».

Voir également Qt3DCore::QEntity.

[since 6.0, deprecated] class Qt3DCore::QCoreSettings

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Le composant QCoreSettings doit être défini comme composant de l'entité racine de la scène (bien qu'il puisse se trouver n'importe où dans le graphe de scène). Il ne doit exister qu'une seule instance.

Elle peut être utilisée pour contrôler certains comportements de ` Qt 3D`.

Cette classe a été introduite dans Qt 6.0.

[deprecated] class Qt3DCore::QEntity

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

En soi, une « Qt3DCore::QEntity » est une coquille vide. Le comportement d’un objet « Qt3DCore::QEntity » est défini par les objets « Qt3DCore::QComponent » auxquels il fait référence. Chaque aspect du backend Qt3D sera capable d’interpréter et de traiter une « Entity » en reconnaissant les composants qui la composent. Un aspect peut décider de ne traiter que les entités composées d’un seul composant « Qt3DCore::QTransform », tandis qu’un autre peut se concentrer sur « Qt3DInput::QMouseHandler ».

Voir également Qt3DCore::QComponent et Qt3DCore::QTransform.

[deprecated] class Qt3DCore::QGeometry

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Une classe ` Qt3DCore::QGeometry ` sert à regrouper une liste d'objets ` Qt3DCore::QAttribute ` afin de former une figure géométrique que Qt3D est capable de rendre à l'aide de `Qt3DCore::QGeometryRenderer`. Un attribut spécial peut être défini afin de calculer le volume englobant de la figure.

[since 6.0, deprecated] class Qt3DCore::QGeometryView

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Un objet ` GeometryView ` contient toutes les informations nécessaires au traitement d'une `Geometry`. Une `Geometry` contient les coordonnées des données géométriques ; ` GeometryView ` spécifie comment interpréter ces données.

Cette classe a été introduite dans Qt 6.0.

[deprecated] class Qt3DCore::QJoint

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Le nœud QJoint sert à créer des squelettes dans le cadre de la prise en charge des maillages skinnés dans Qt 3D. Une articulation peut être transformée à l'aide de ses propriétés d'échelle, de rotation et de translation. Les transformations de tous les sommets du maillage liés à l'articulation seront mises à jour en conséquence.

[deprecated] class Qt3DCore::QNode

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

La propriété d'un QNode est déterminée par la relation parent/enfant QObject entre les nœuds. En soi, un QNode n'a ni apparence visuelle ni signification particulière ; il sert uniquement à construire une structure arborescente basée sur des nœuds.

Le parent d’une instance de QNode ne peut être qu’une autre instance de QNode.

Chaque instance de QNode possède un identifiant unique qui permet de la distinguer des autres instances.

Lorsque des propriétés sont définies sur une sous-classe de QNode, leur signal NOTIFY génère automatiquement des notifications que le backend Qt3D recevra.

Voir également QEntity et QComponent.

[deprecated] class Qt3DCore::QNodeId

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

[deprecated] class Qt3DCore::QSkeleton

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez QSkeleton si vous souhaitez créer manuellement les articulations d'un squelette destiné à être utilisé avec des maillages skinnés. Cela s'adresse principalement aux personnes qui développent des éditeurs, des outils ou des squelettes dynamiques. Il est plus courant qu'une application Qt 3D utilise simplement un squelette et un maillage skinné existants, tels qu'ils ont été créés dans un outil de création de contenu numérique tel que Blender. Pour ce cas d’utilisation, veuillez consulter QSkeletonLoader.

[deprecated] class Qt3DCore::QSkeletonLoader

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez ` SkeletonLoader ` si vous souhaitez charger un squelette complet à partir d'un fichier plutôt que de créer vous-même les articulations à l'aide de `Skeleton` et `Joints`. La création d’un squelette et la liaison des sommets d’un maillage à ce squelette s’effectuent plus facilement dans un outil de création de contenu numérique 3D tel que Blender. Le squelette et le maillage ainsi obtenus peuvent ensuite être exportés dans un format adapté, tel que glTF 2, pour être utilisés par Qt 3D.

[deprecated] class Qt3DCore::QTransform

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Le composant QTransform ne peut pas être partagé entre plusieurs instances de ` QEntity`. La transformation est stockée sous forme de composant QVector3D s d'échelle, QQuaternion de rotation et QVector3D de translation. Les transformations sont appliquées au maillage dans cet ordre. Lorsque la propriété ` QTransform::matrix ` est définie, la transformation est décomposée en ces composants et les signaux correspondants sont émis.

Plusieurs fonctions d’aide sont fournies pour configurer le QTransform ; fromAxisAndAngle et fromAxesAndAngles permettent de définir la rotation autour d’axes spécifiques, fromEulerAngles permet de définir la rotation à partir des angles d’Euler et rotateAround permet de faire pivoter l’objet autour d’un point spécifique par rapport à l’origine locale.