Qt Quick Física 3D: ejemplo sobre la masa
Muestra diferentes formas de configurar la masa y la inercia de un cuerpo.

Este ejemplo muestra tres formas diferentes de configurar la masa y la inercia de un cuerpo. La escena está formada por tres cuerpos que consisten en tres esferas apiladas verticalmente. Todos estos cuerpos tienen la misma masa, pero sus centros de masa y tensores de inercia difieren, lo que les confiere un comportamiento distinto al chocar.
Configuración
En primer lugar, añadimos nuestro « PhysicsWorld »:
PhysicsWorld {
running: true
gravity: Qt.vector3d(0, -9.81, 0)
typicalLength: 1
typicalSpeed: 10
scene: viewport.scene
}Realizamos la configuración habitual, con un entorno, una cámara y luces:
environment: SceneEnvironment {
clearColor: "lightblue"
backgroundMode: SceneEnvironment.Color
}
PerspectiveCamera {
id: camera
position: Qt.vector3d(0, 2, 5)
eulerRotation: Qt.vector3d(-10, 0, 0)
clipFar: 100
clipNear: 0.01
}
DirectionalLight {
eulerRotation.x: -45
eulerRotation.y: 45
castsShadow: true
brightness: 1
shadowFactor: 50
shadowBias: 0.1
pcfFactor: 0.01
}Objetos físicos
Tenemos nuestro plano estático habitual:
StaticRigidBody {
position: Qt.vector3d(0, 0, 0)
eulerRotation: Qt.vector3d(-90, 0, 0)
collisionShapes: PlaneShape {}
Model {
source: "#Rectangle"
materials: PrincipledMaterial {
baseColor: "green"
}
castsShadows: false
receivesShadows: true
}
}Definimos una clase QML personalizada para nuestro cuerpo, a la que llamamos RolyPoly, ya que se comportan como los llamados juguetes «roly-poly». El RolyPoly es un « DynamicRigidBody » con tres formas esféricas de colisión:
DynamicRigidBody {
id: body
property string color: "blue"
collisionShapes: [
SphereShape {
id: sphere0
diameter: 1
},
SphereShape {
id: sphere1
diameter: 0.8
position: Qt.vector3d(0, 0.6, 0)
},
SphereShape {
id: sphere2
diameter: 0.6
position: Qt.vector3d(0, 1.1, 0)
}
]
Model {
source: "#Sphere"
position: sphere0.position
scale: Qt.vector3d(1,1,1).times(sphere0.diameter*0.01)
materials: PrincipledMaterial {
baseColor: body.color
}
}
Model {
source: "#Sphere"
position: sphere1.position
scale: Qt.vector3d(1,1,1).times(sphere1.diameter*0.01)
materials: PrincipledMaterial {
baseColor: body.color
}
}
Model {
source: "#Sphere"
position: sphere2.position
scale: Qt.vector3d(1,1,1).times(sphere2.diameter*0.01)
materials: PrincipledMaterial {
baseColor: body.color
}
}
}A continuación, añadimos tres «roly-polys» a nuestra escena:
RolyPoly {
position: Qt.vector3d(-2, 0.5, 0)
color: "blue"
mass: 0.9
centerOfMassPosition: Qt.vector3d(0, -0.5, 0)
inertiaTensor: Qt.vector3d(0.217011, 0.0735887, 0.217011)
massMode: DynamicRigidBody.MassAndInertiaTensor
}
RolyPoly {
position: Qt.vector3d(0, 0.5, 0)
color: "purple"
mass: 0.9
centerOfMassPosition: Qt.vector3d(0, -0.5, 0)
inertiaTensor: Qt.vector3d(0.05, 100, 100)
massMode: DynamicRigidBody.MassAndInertiaTensor
}
RolyPoly {
position: Qt.vector3d(2, 0.5, 0)
color: "red"
mass: 0.9
massMode: DynamicRigidBody.Mass
}Los «rolly-poly» morados y azules tienen un centro de masa y un tensor de inercia personalizados. Dado que los cuerpos utilizan una densidad uniforme por defecto y calculan la masa y la inercia automáticamente, establecemos `massMode` en ` DynamicRigidBody.MassAndInertiaTensor` en nuestros cuerpos morados y azules para utilizar, en su lugar, los tensores de masa e inercia que hemos proporcionado. El centro de masa más bajo hará que los cuerpos siempre se mantengan en pie después de ser empujados. El tensor de inercia del cuerpo morado hace que se tambalee fácilmente en una dirección, pero apenas en la otra. El cuerpo rojo tiene un centro de masa calculado automáticamente y, por lo tanto, permanecerá tumbado después de ser derribado.
Lanzamiento de bolas
Para probar el comportamiento de los diferentes cuerpos, añadimos un nodo para lanzar bolas:
Node {
id: shapeSpawner
property var spheres: []
property var sphereComponent: Qt.createComponent("Sphere.qml")
function createBall(position, forward) {
let diameter = 0.2
let speed = 20
let sphere = sphereComponent.createObject(shapeSpawner, {
"position": position,
"sphereDiameter": diameter
})
sphere.setLinearVelocity(forward.times(speed))
var pair = {
"sphere": sphere,
"date": Date.now()
}
spheres.push(pair)
if (sphere === null) {
console.log("Error creating object")
}
}
function clean() {
spheres = spheres.filter(sphere => {
let diff = Date.now() - sphere['date'];
if (diff > 5000) {
sphere['sphere'].destroy();
return false;
}
return true;
});
}
Timer {
interval: 200
running: true
repeat: true
onTriggered: shapeSpawner.clean()
}
}A continuación, añadimos un « WasdController » para poder mover la cámara, apuntar y lanzar bolas a los cuerpos:
WasdController {
speed: 0.01
shiftSpeed: 0.1
controlledObject: camera
Keys.onPressed: (event) => {
handleKeyPress(event);
if (event.key === Qt.Key_Space) {
shapeSpawner.createBall(camera.position, camera.forward);
}
}
Keys.onReleased: (event) => { handleKeyRelease(event) }
}Archivos:
© 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.