Skinning de vértices
Introducción
Qt Quick 3D admite el skinning de vértices para la animación esquelética de geometrías de malla.
Consulta el ejemplo de «Skinning sencillo » para ver una demostración práctica de la animación esquelética.
En la mayoría de los casos, los desarrolladores de aplicaciones no utilizarán la API de skinning manualmente. El flujo de trabajo habitual consiste en utilizar una herramienta externa de creación de contenido para definir el esqueleto y la piel (lo que a veces también se denomina «rigging»), y luego utilizar la herramienta de importación de recursos de Balsam para convertir el recurso al formato nativo de 3 Qt Quick.
Definición de un esqueleto
La base de la animación esquelética es el esqueleto ( Skeleton). Se trata de una representación abstracta de cómo puede moverse el modelo, inspirada en el funcionamiento del esqueleto físico de los vertebrados. Los «huesos» del esqueleto se representan mediante una jerarquía de nodos de « Joint ». Por supuesto, estos no tienen por qué representar huesos reales.
Skeleton {
id: qmlskeleton
Joint {
id: joint0
index: 0
skeletonRoot: qmlskeleton
Joint {
id: joint1
index: 1
skeletonRoot: qmlskeleton
}
Joint {
id: joint2
index: 2
skeletonRoot: qmlskeleton
}
}
}Conectar un esqueleto a un modelo
Para aplicar un esqueleto a un modelo, configura la propiedad « skeleton » del modelo:
Model {
skeleton: qmlskeleton
...Para que el esqueleto surta efecto, la propiedad « geometry » del modelo debe incluir información de skinning. Esto se consigue incluyendo « vertex attributes » con « JointSemantic » y « WeightSemantic » en el búfer de vértices.
El atributo « JointSemantic » determina cuáles de las articulaciones del esqueleto pueden influir en un vértice determinado. Para ello, utiliza los valores de índice especificados por « Joint.index ». Dado que este atributo contiene 4 índices, un vértice puede recibir la influencia de un máximo de 4 articulaciones.
El atributo « WeightSemantic » describe la intensidad de la influencia de esas articulaciones. Contiene cuatro valores de coma flotante; cada valor determina el peso que se asigna a la articulación con el índice correspondiente en el atributo « JointSemantic ».
Por ejemplo, dado el esqueleto anterior, si un vértice tiene estos atributos:
JointSemantic atributo | WeightSemantic atributo |
|---|---|
QVector4D(2, 0, 0, 0) | QVector4D(1.0, 0.0, 0.0, 0.0) |
ese vértice estará influenciado al 100 % por la articulación 2 y se moverá exactamente lo mismo que dicha articulación. Los tres últimos índices del atributo « JointSemantic » se ignoran, ya que los pesos correspondientes son « 0.0 ».
Como otro ejemplo, con estos atributos:
JointSemantic atributo | WeightSemantic atributo |
|---|---|
QVector4D(1, 2, 0, 0) | QVector4D(0.5, 0.25, 0.0, 0.0) |
el vértice se moverá un 50 % del movimiento de la articulación 1 más un 25 % del movimiento de la articulación 2.
Además, dado que el esqueleto es una representación abstracta, el modelo debe especificar la información geométrica de las articulaciones. Por motivos de rendimiento, esto no se hace especificando la información directamente. En su lugar, « Model.inverseBindPoses » contiene la inversa de la matriz de transformación necesaria para mover cada articulación a su posición inicial.
Animación del esqueleto
La transformación de una articulación en un esqueleto moverá todos los vértices conectados a dicha articulación. Dado que `Joint` hereda de ` Node`, un esqueleto puede animarse simplemente utilizando ` QML animations` estándar.
NumberAnimation {
target: joint1
property: "eulerRotation.z"
duration: 5000
from: -90
to: 90
running: true
}Aunque es posible crear animaciones complejas anidando ` SequentialAnimation`, ` ParallelAnimation ` y ` NumberAnimation`, por lo general resulta más cómodo utilizar animaciones en la línea de tiempo para animar modelos con skinning.
© 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.