En esta página

Qt3DAnimation::QVertexBlendAnimation Class

class Qt3DAnimation::QVertexBlendAnimation

Una 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

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.