Qt3DAnimation::QVertexBlendAnimation Class
class Qt3DAnimation::QVertexBlendAnimationUna clase que implementa la animación de morphing mediante la mezcla de vértices. Más...
| Encabezado: | #include <qvertexblendanimation.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3danimation) target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake: | QT += 3danimation |
| En QML: | VertexBlendAnimation |
| Heredado de: | Qt3DAnimation::QAbstractAnimation |
| Estado: | Versión preliminar |
Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Propiedades
- interpolator : float
- target : Qt3DRender::QGeometryRenderer*
- targetName : QString
- targetPositions : QList<float>
Funciones públicas
| QVertexBlendAnimation(QObject *parent = nullptr) | |
| void | addMorphTarget(Qt3DAnimation::QMorphTarget *target) |
| float | interpolator() const |
| QList<Qt3DAnimation::QMorphTarget *> | morphTargetList() |
| void | removeMorphTarget(Qt3DAnimation::QMorphTarget *target) |
| void | setMorphTargets(const QList<Qt3DAnimation::QMorphTarget *> &targets) |
| Qt3DRender::QGeometryRenderer * | target() const |
| QString | targetName() const |
| QList<float> | targetPositions() const |
Ranuras públicas
| void | setTarget(Qt3DRender::QGeometryRenderer *target) |
| void | setTargetName(const QString name) |
| void | setTargetPositions(const QList<float> &targetPositions) |
Señales
| void | interpolatorChanged(float interpolator) |
| void | targetChanged(Qt3DRender::QGeometryRenderer *target) |
| void | targetNameChanged(const QString &name) |
| void | targetPositionsChanged(const QList<float> &targetPositions) |
Descripción detallada
Una clase ` Qt3DAnimation::QVertexBlendAnimation ` implementa una animación de morphing con mezcla de vértices hacia un objetivo ` QGeometryRenderer`. La clase `QVertexBlendAnimation` establece el ` QAttributes ` correcto desde el ` morph targets ` hasta el objetivo ` QGeometryRenderer::geometry ` y calcula el interpolador para la posición actual. A diferencia de lo que ocurre con ` QMorphingAnimation`, donde la mezcla se controla mediante pesos de mezcla, aquí la mezcla se produce entre objetivos de morphing secuenciales. La mezcla propiamente dicha entre los atributos debe implementarse en el material. Qt3DAnimation::QMorphPhongMaterial implementa un material con soporte de morphing para el modelo de iluminación Phong. La mezcla se produce entre dos atributos: «base» y «target». Los nombres de los atributos «base» y «target» se toman de los nombres de los objetivos de morphing, donde el atributo «base» conserva el nombre que ya tiene y al nombre del atributo «target» se le añade «Target». El interpolador puede configurarse como un « QParameter » del material utilizado. Todos los objetivos de morphing de la animación deben contener los atributos con los mismos nombres que los de la geometría base.
Documentación de propiedades
[read-only] interpolator : float
Almacena el interpolador entre los atributos de base y de destino.
Funciones de acceso:
| float | interpolator() const |
Señal de notificación:
| void | interpolatorChanged(float interpolator) |
target : Qt3DRender::QGeometryRenderer*
Contiene el objeto `QGeometryRenderer` de destino al que se aplica la animación de transformación.
Funciones de acceso:
| Qt3DRender::QGeometryRenderer * | target() const |
| void | setTarget(Qt3DRender::QGeometryRenderer *target) |
Señal de notificador:
| void | targetChanged(Qt3DRender::QGeometryRenderer *target) |
targetName : QString
Contiene el nombre de la geometría de destino. Se trata de una propiedad de conveniencia que facilita la correspondencia entre la geometría de destino y la animación de transformación. El nombre suele ser el mismo que el de la entidad padre del QGeometryRenderer de destino, aunque no tiene por qué serlo.
Funciones de acceso:
| QString | targetName() const |
| void | setTargetName(const QString name) |
Señal de notificador:
| void | targetNameChanged(const QString &name) |
targetPositions : QList<float>
Contiene los valores de posición del objetivo de transformación. Cada posición de la lista especifica la posición del objetivo de transformación correspondiente con el mismo índice. Los valores deben estar ordenados de menor a mayor. Los valores pueden ser positivos o negativos y no tienen ninguna unidad predefinida.
Funciones de acceso:
| QList<float> | targetPositions() const |
| void | setTargetPositions(const QList<float> &targetPositions) |
Señal de notificador:
| void | targetPositionsChanged(const QList<float> &targetPositions) |
Documentación de las funciones de miembro
[explicit] QVertexBlendAnimation::QVertexBlendAnimation(QObject *parent = nullptr)
Crea un nuevo objeto `QVertexBlendAnimation` con ` parent`.
void QVertexBlendAnimation::addMorphTarget(Qt3DAnimation::QMorphTarget *target)
Añade un nuevo morfo « target » al final de la animación.
QList<Qt3DAnimation::QMorphTarget *> QVertexBlendAnimation::morphTargetList()
Devuelve la lista de objetivos de transformación.
void QVertexBlendAnimation::removeMorphTarget(Qt3DAnimation::QMorphTarget *target)
Elimina el «morph» « target » de la animación.
void QVertexBlendAnimation::setMorphTargets(const QList<Qt3DAnimation::QMorphTarget *> &targets)
Establece el « targets » de la transformación en «animación». Se borran los objetivos anteriores.
© 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.