Revision control
Copy as Markdown
// Copyright (C) 2022 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\example customshapes
\ingroup quick3dphysics-examples
\title Qt Quick 3D Physics - Custom Shapes Example
\examplecategory {3D}
\brief Demonstrates using different shapes.
\image customshapes-example.jpg {Screenshot of a 3D scene showing a transparent rectangular structure containing solid
geometric shapes, placed on a green terrain with a small multicolored object in a pot next to it}
This example demonstrates loading and spawning several rigid body meshes as well as animating them.
The scene consists of a dice tower, a tablecloth, a cup and a handful of dice. The cup is animated to collect spawning
dice and put them in the dice tower. The dice will then roll down and out on the tablecloth.
\section1 Environment
As usual we have a PhysicsWorld and a View3D. In the View3D we have our environment which sets up a lightprobe:
\snippet customshapes/main.qml environment
\section1 Textures
We define four textures which will be used for the skybox, the tablecloth and the numbers on the dice:
\snippet customshapes/main.qml textures 1
\snippet customshapes/Die.qml textures 2
\section1 Scene
We have a Node which contains our scene with the camera and a directional light:
\snippet customshapes/main.qml scene
\section1 Tablecloth
We add the tablecloth which is a StaticRigidBody consisting of a model with a weave texture and a HeightFieldShape for collision.
\snippet customshapes/main.qml cloth
\section1 Cup
We define the cup as a DynamicRigidBody with a Model and a TriangleMeshShape as the collision shape. It has a Behavior on the \c eulerRotation
and \c position properties as these are part of an animation.
\snippet customshapes/main.qml cup
\section1 Tower
The tower is just a StaticRigidBody with a Model and a TriangleMeshShape for collision.
\snippet customshapes/main.qml tower
\section1 Dice
To generate the dice we use a Component with a custom Die QML object and a Repeater3D.
\snippet customshapes/main.qml dice 1
The Die object contains a DynamicRigidBody with a ConvexMeshShape and a Model.
The position, color, scale and mesh source are randomly generated for each die.
\snippet customshapes/Die.qml dice 2
\section1 Animation
To make the dice move from the cup to the dice tower we animate the cup and move it up and then tip it over.
To make sure that the animation stays in sync with the physical simulation we use an AnimationController which we connect
to the \c onFrameDone signal on the \l PhysicsWorld. After every simulated frame we progress the animation with the elapsed timestep.
\snippet customshapes/main.qml animation
\section1 Controller
Finally a WasdController is added to be able to control the camera using a keyboard:
\snippet customshapes/main.qml controller
*/