Obsolete Members for Qt3DCore
Los siguientes miembros de la clase ` Qt3DCore ` están obsoletos. Se mantienen para que el código fuente antiguo siga funcionando. Recomendamos encarecidamente no utilizarlos en código nuevo.
Espacios de nombres
(deprecated) namespace | Quick |
Clases
(deprecated) class | QAbstractAspect |
(deprecated) class | QAbstractFunctor |
(deprecated) class | QAbstractSkeleton |
(deprecated) class | QArmature |
(deprecated) class | QAspectEngine |
(deprecated) class | QAspectJob |
(deprecated) class | QAttribute |
(deprecated) class | QBackendNode |
(deprecated) class | QBackendNodeMapper |
(since 6.0, deprecated) class | QBoundingVolume |
(deprecated) class | QBuffer |
(deprecated) class | QComponent |
(since 6.0, deprecated) class | QCoreSettings |
(deprecated) class | QEntity |
(deprecated) class | QGeometry |
(since 6.0, deprecated) class | QGeometryView |
(deprecated) class | QJoint |
(deprecated) class | QNode |
(deprecated) class | QNodeId |
(deprecated) class | QSkeleton |
(deprecated) class | QSkeletonLoader |
(deprecated) class | QTransform |
Espacios de nombres
[deprecated] namespace Qt3DCore::Quick
Este espacio de nombres está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Clases
[deprecated] class Qt3DCore::QAbstractAspect
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
[deprecated] class Qt3DCore::QAbstractFunctor
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
La clase `QAbstractFunctor` se utiliza como clase base para todos los functores y generadores de datos del módulo ` Qt3DCore `.
Cuando el usuario define un nuevo functor o generador, debe implementar el método ` QAbstractFunctor::id()`, lo cual debe hacerse utilizando la macro ` QT3D_FUNCTOR ` en la definición de la clase.
[deprecated] class Qt3DCore::QAbstractSkeleton
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
No utilices esta clase directamente. Debes utilizar QSkeletonLoader si vas a cargar datos de esqueleto desde un archivo (lo más probable) o QSkeleton si vas a crear tú mismo los datos del esqueleto y de la malla con textura (principalmente para quienes crean editores o herramientas).
[deprecated] class Qt3DCore::QArmature
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
El componente «Armature» se agrega a las entidades para que estas puedan calcular la paleta de matrices de transformación de skinning necesarias para renderizar correctamente las mallas con skinning.
Cada vértice de una malla con skinning está asociado (vinculado) a un máximo de 4 articulaciones del esqueleto. Para cada articulación que afecta a un vértice, la malla también proporciona un peso que determina el nivel de influencia de la articulación correspondiente. La paleta de skinning utilizada para realizar la transformación de los vértices con skinning la proporciona Armature y se calcula a partir de las articulaciones contenidas en el esqueleto al que se hace referencia.
Al actualizar la transformación local de una articulación, se vuelven a calcular las matrices de skinning y los vértices de la malla con skinning vinculados a esa articulación se desplazan en consecuencia.
[deprecated] class Qt3DCore::QAspectEngine
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
El bucle de ejecución de Qt3D está controlado por Qt3DRender::QAspectEngine.
Qt3DCore::QAbstractAspect Las subclases pueden registrarse llamando a Qt3DCore::QAspectEngine::registerAspect(), que se encargará de registrar el aspecto y, a su vez, llamará a Qt3DCore::QAbstractAspect::onRegistered();
El bucle de simulación se inicia tan pronto como se establece una entidad raíz ( Qt3DCore::QEntity ) en Qt3DCore::QAspectEngine. A continuación, se llama a onEngineStartup() en cada aspecto para que puedan iniciar su trabajo de simulación.
El bucle de simulación se detiene cuando la entidad raíz se establece en Qt3DCore::QEntityPtr(). Esto llama a onEngineShutdown() en cada aspecto para que puedan dejar de realizar su trabajo de simulación.
Al establecer una nueva entidad raíz válida, se reiniciaría de nuevo el bucle de simulación.
[deprecated] class Qt3DCore::QAspectJob
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
[deprecated] class Qt3DCore::QAttribute
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Hay tres tipos de atributos.
- VertexAttribute: se utilizan para definir los datos que se van a leer por vértice
- IndexAttribute: se utilizan para definir índices de vértices cuando se van a utilizar llamadas de dibujo indexadas
- DrawIndirectAttribute: se utiliza para especificar el búfer DrawIndirect que se utilizará cuando se utilicen llamadas de dibujo indirectas
Nota: cuando un atributo es de tipo ` DrawIndirectAttribute`, solo son relevantes `count`, `stride` y `offset`.
Al proporcionar tus propios atributos, puede ser conveniente nombrarlos utilizando auxiliares como ` QAttribute::defaultPositionAttributeName()` ( ), ya que así te asegurarás de que tu geometría sea compatible con la selección y con los diversos materiales proporcionados en el módulo ` Qt3DExtras `.
Véase también QBuffer.
[deprecated] class Qt3DCore::QBackendNode
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
[deprecated] class Qt3DCore::QBackendNodeMapper
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
[since 6.0, deprecated] class Qt3DCore::QBoundingVolume
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
El volumen delimitador de una entidad se utiliza para muchas operaciones, como la selección o el recorte del frustum de visión. Normalmente se calcula recorriendo la geometría renderizada.
Se puede utilizar `QBoundingVolume` cuando la aplicación conoce la extensión de la geometría, de modo que ` Qt 3D ` no tenga que calcularla.
Un volumen delimitador puede proporcionarse bien como coordenadas de extensión mínima y máxima, bien como una geometría independiente —normalmente más sencilla— que se aproxima a la malla renderizada.
Cuando se utilizan las extensiones mínima y máxima, estas se consideran las esquinas opuestas de una caja delimitadora alineada con los ejes, en el sistema de coordenadas local de la geometría.
QBoundingVolume también se puede utilizar para consultar el volumen delimitador calculado de un ` GeometryView`. Las propiedades ` implicitMinPoint ` y ` implicitMaxPoint ` se actualizarán si la geometría cambia. Ten en cuenta que esto se realiza de forma asíncrona en un hilo en segundo plano, por lo que debes comprobar el valor de ` implicitPointsValid ` antes de leerlas.
Puede forzar la actualización de las extensiones implícitas llamando a updateImplicitBounds. Esto bloqueará el hilo de llamada hasta que los resultados estén disponibles.
Nota: ` GeometryRenderer ` hereda de ` BoundingVolume ` y, por lo tanto, admite tanto la lectura de límites implícitos como el establecimiento de límites explícitos.
Esta clase se introdujo en Qt 6.0.
[deprecated] class Qt3DCore::QBuffer
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Los datos se pueden proporcionar directamente mediante ` QBuffer::setData()`.
[deprecated] class Qt3DCore::QComponent
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Un « Qt3DCore::QComponent » proporciona una sección vertical de comportamiento que se puede asignar a instancias de « Qt3DCore::QEntity » y, en ocasiones, compartir entre ellas.
Qt3DCore::QComponent Las subclases suelen agruparse en conjuntos que aportan un comportamiento útil a la entidad que las agrupa. Por ejemplo, para que una entidad sea dibujada por el renderizador Qt3D, lo más probable es que dicha entidad agrupe los componentes « Qt3DCore::QTransform », « Qt3DRender::QMesh » y « Qt3DRender::QMaterial ».
Véase también Qt3DCore::QEntity.
[since 6.0, deprecated] class Qt3DCore::QCoreSettings
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
El componente QCoreSettings debe configurarse como un componente de la entidad raíz de la escena (aunque podría estar en cualquier lugar del grafo de la escena). Debe haber una única instancia.
Se puede utilizar para controlar parte del comportamiento de « Qt 3D ».
Esta clase se introdujo en Qt 6.0.
[deprecated] class Qt3DCore::QEntity
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Por sí misma, una « Qt3DCore::QEntity » es una estructura vacía. El comportamiento de un objeto « Qt3DCore::QEntity » viene definido por los objetos « Qt3DCore::QComponent » a los que hace referencia. Cada aspecto del backend de Qt3D podrá interpretar y procesar una «Entity» reconociendo de qué componentes está compuesta. Un aspecto puede decidir procesar únicamente entidades compuestas por un único componente « Qt3DCore::QTransform », mientras que otro puede centrarse en « Qt3DInput::QMouseHandler ».
Véase también Qt3DCore::QComponent y Qt3DCore::QTransform.
[deprecated] class Qt3DCore::QGeometry
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
La clase ` Qt3DCore::QGeometry ` se utiliza para agrupar una lista de objetos ` Qt3DCore::QAttribute ` con el fin de formar una figura geométrica que Qt3D pueda representar mediante `Qt3DCore::QGeometryRenderer`. Se pueden establecer atributos especiales para calcular el volumen delimitador de la figura.
[since 6.0, deprecated] class Qt3DCore::QGeometryView
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Un objeto ` GeometryView ` contiene toda la información necesaria para gestionar una `Geometry`. Una `Geometry` contiene las coordenadas de los datos geométricos; ` GeometryView ` especifica cómo interpretar dichos datos.
Esta clase se introdujo en Qt 6.0.
[deprecated] class Qt3DCore::QJoint
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
El nodo QJoint se utiliza para crear esqueletos como parte de la compatibilidad con mallas con esqueleto en Qt 3D. Una articulación puede transformarse mediante sus propiedades de escala, rotación y traslación. Las transformaciones de cualquier vértice de malla vinculado a la articulación se actualizarán en consecuencia.
[deprecated] class Qt3DCore::QNode
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
La propiedad de un QNode viene determinada por la relación padre/hijo QObject entre los nodos. Por sí mismo, un QNode no tiene apariencia visual ni significado concreto; su finalidad es servir de base para construir una estructura de árbol basada en nodos.
El padre de una instancia de QNode solo puede ser otra instancia de QNode.
Cada instancia de QNode tiene un identificador único que permite distinguirla de otras instancias.
Cuando se definen propiedades en una subclase de QNode, su señal NOTIFY generará automáticamente notificaciones que recibirán los componentes del backend de Qt3D.
Véase también QEntity y QComponent.
[deprecated] class Qt3DCore::QNodeId
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
[deprecated] class Qt3DCore::QSkeleton
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Utiliza QSkeleton si deseas crear manualmente las articulaciones de un esqueleto para utilizarlo con mallas con piel. Esto resulta útil principalmente para quienes crean editores, herramientas o esqueletos dinámicos. Lo más habitual es que una aplicación de Qt 3D simplemente utilice un esqueleto y una malla con piel ya existentes, creados en una herramienta de creación de contenido digital como Blender. Para este caso de uso, consulta QSkeletonLoader.
[deprecated] class Qt3DCore::QSkeletonLoader
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Utiliza ` SkeletonLoader ` si deseas cargar un esqueleto completo desde un archivo, en lugar de crear las articulaciones tú mismo utilizando `Skeleton` y `Joints`. La forma más sencilla de crear un esqueleto y vincular los vértices de una malla al esqueleto es utilizar una herramienta de creación de contenido digital en 3D, como Blender. A continuación, el esqueleto y la malla resultantes se pueden exportar en un formato adecuado, como glTF 2, para su uso en Qt 3D.
[deprecated] class Qt3DCore::QTransform
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
El componente QTransform no se puede compartir entre varios QEntity. La transformación se almacena como componentes de escal QVector3D, rotación QQuaternion y traslación QVector3D. Las transformaciones se aplican a la malla en ese orden. Cuando se establece la propiedad QTransform::matrix, esta se descompone en estos componentes de transformación y se emiten las señales correspondientes.
Se proporcionan varias funciones auxiliares para configurar QTransform; fromAxisAndAngle y fromAxesAndAngles pueden utilizarse para establecer la rotación alrededor de ejes específicos, fromEulerAngles puede utilizarse para establecer la rotación basada en ángulos de Euler y rotateAround puede utilizarse para rotar el objeto alrededor de un punto específico relativo al origen local.
© 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.