En esta página

Qt Quick Física 3D: ejemplo de impulsor

Muestra el uso de cuerpos de activación e información de colisión.

Captura de pantalla de una representación en 3D en la que se ve una esfera azul sobre una superficie verde, un bloque rectangular rosa encima de ella y una esfera roja flotando en la parte superior

Este ejemplo muestra cómo utilizar cuerpos de activación e información de colisión. La escena consta de un plano estático verde, una esfera dinámica roja, un cuerpo de activación en forma de caja rosa y una esfera estática azul. Cuando la esfera roja se superpone al cuerpo de activación, se vuelve amarilla, y cuando choca con la esfera azul, es repelida.

Configuración

Como es habitual, debemos añadir nuestro « PhysicsWorld »:

PhysicsWorld {
    gravity: Qt.vector3d(0, -490, 0)
    scene: viewport.scene
}

También añadimos un « View3D » donde colocamos los objetos de nuestra escena. En él, tenemos algunos ajustes para el entorno visual:

environment: SceneEnvironment {
    clearColor: "#d6dbdf"
    backgroundMode: SceneEnvironment.Color
}

PerspectiveCamera {
    position: Qt.vector3d(0, 200, 1000)
    clipFar: 2000
    clipNear: 1
}

DirectionalLight {
    eulerRotation.x: -45
    eulerRotation.y: 45
    castsShadow: true
    brightness: 1
    shadowFactor: 50
}

Objetos físicos

Tenemos nuestro plano estático habitual:

StaticRigidBody {
    position: Qt.vector3d(0, -100, 0)
    eulerRotation: Qt.vector3d(-90, 0, 0)
    collisionShapes: PlaneShape {}
    Model {
        source: "#Rectangle"
        scale: Qt.vector3d(500, 500, 1)
        materials: PrincipledMaterial {
            baseColor: "green"
        }
        castsShadows: false
        receivesShadows: true
    }
}

Así es como se define nuestra esfera dinámica:

DynamicRigidBody {
    id: sphere
    massMode: DynamicRigidBody.CustomDensity
    density: 0.00001
    position: Qt.vector3d(0, 600, 0)
    property bool inArea: false
    sendContactReports: true
    receiveTriggerReports: true

    onEnteredTriggerBody: {
        inArea = true
    }
    onExitedTriggerBody: {
        inArea = false
    }

    collisionShapes: SphereShape {}
    Model {
        source: "#Sphere"
        materials: PrincipledMaterial {
            baseColor: sphere.inArea ? "yellow" : "red"
        }
    }
}

La propiedad « inArea » es una propiedad personalizada que utilizamos para detectar cuándo la esfera se superpone al cuerpo del disparador (box trigger). Esto se utiliza luego en la propiedad « baseColor » para que la esfera se vuelva amarilla cuando se superpone a la caja y roja en caso contrario. Dado que queremos que la esfera participe en la notificación de contactos, la propiedad sendContactReports debe establecerse en true. Como también queremos que la esfera reciba notificaciones al entrar y salir de un TriggerBody, la propiedad receiveContactReports también se establece en true. Implementamos los métodos de señal enteredTriggerBody y exitedTriggerBody en la esfera, donde establecemos la propiedad inArea en true o false al entrar o salir del cuerpo de activación.

Veamos ahora el cuerpo del disparador:

TriggerBody {
    position: Qt.vector3d(0, 350, 0)
    scale: Qt.vector3d(1, 2, 1)

    collisionShapes: BoxShape {
        id: boxShape
    }
    Model {
        source: "#Cube"
        materials: PrincipledMaterial {
            baseColor: Qt.rgba(1, 0, 1, 0.2)
            alphaMode: PrincipledMaterial.Blend
        }
    }
}

El tipo QML es un « TriggerBody », que actúa como un cuerpo estático, salvo que sus colisiones están inactivas. En su lugar, activará las llamadas a los métodos « enteredTriggerBody » y « exitedTriggerBody » en la esfera.

Por último, veamos el impulsor:

StaticRigidBody {
    position: Qt.vector3d(0, 0, 0)
    scale: Qt.vector3d(2, 2, 2)
    receiveContactReports: true

    collisionShapes: SphereShape {}

    Model {
        source: "#Sphere"
        materials: PrincipledMaterial {
            baseColor: "blue"
        }
    }

    onBodyContact: (body, positions, impulses, normals) => {
        for (let normal of normals) {
            let velocity = normal.times(-700)
            if (body instanceof DynamicRigidBody) {
                (body as DynamicRigidBody).setLinearVelocity(velocity)
            }
        }
    }
}

Se trata de un cuerpo estático y hemos establecido « receiveContactReports » en « true » para habilitar las funciones de devolución de llamada de colisión. La función de devolución de llamada « bodyContact » se activa cada vez que se detecta una colisión. En el método, llamamos a « setLinearVelocity » para establecer la velocidad lineal en la dirección opuesta al vector normal de la colisión, con el fin de simular un impulsor.

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.