Doc: Revise Dice example

Restructure the content to make it adhere to the application examples
template. Also, add image alt text and add the appropriate section
headings.

Fixes: QTBUG-137895
Pick-to: 6.10 6.9 6.8 6.5
Change-Id: Ie2b804bc286c9aba900e58d382bbc225fd0cca8a
Reviewed-by: Safiyyah Moosa <safiyyah.moosa@qt.io>
Reviewed-by: Jerome Pasion <jerome.pasion@qt.io>
This commit is contained in:
Andreas Eliasson 2025-08-05 13:29:17 +02:00
parent 132a49a176
commit 6fd75ca714
1 changed files with 13 additions and 15 deletions

View File

@ -12,19 +12,21 @@
\meta {tag} {quick,3d,physics, multimedia, sensors} \meta {tag} {quick,3d,physics, multimedia, sensors}
\meta {docdependencies} {QtQuick3DPhysics,QtMultimedia,QtSensors} \meta {docdependencies} {QtQuick3DPhysics,QtMultimedia,QtSensors}
\image dice-screenshot.webp \image {dice-screenshot.webp} {}
\section1 Overview This example application simulates rolling a number of dice on a table. The
application uses QML and relies on a number of Qt modules, including
\l {Qt Quick 3D}, \l {Qt Quick 3D Physics}, \l {Qt Multimedia}, and
\l {Qt Sensors}.
This example application allows you to roll some dice on a table. It's \include examples-run.qdocinc
implemented with QML and relies on a number of Qt modules that are detailed
in the following sections.
This particular example is also available in the google play store as \section1 Relevant modules and classes
Qt Dice.
As with any Qt example you can of course still build the application yourself The example makes use of the \l{Qt Quick 3D}, \l{Qt Multimedia},
for your target of choice. \l{Qt Quick 3D Physics} and \l{Qt Sensors} modules that are separate items
in the \l{Get and Install Qt}{Qt Online Installer}. If the example fails to
compile or run, make sure that you have these required packages installed.
\section1 Simulating the physics of rolling dice \section1 Simulating the physics of rolling dice
@ -50,11 +52,7 @@
A \l{Qt Quick} UI is provided for configuring the physical material of A \l{Qt Quick} UI is provided for configuring the physical material of
the simulated dice, the magnitude of gravity, and the number and size of dice. the simulated dice, the magnitude of gravity, and the number and size of dice.
\include examples-run.qdocinc \section1 Source files
\note The example makes use of the \l{Qt Quick 3D}, \l{Qt Multimedia},
\l{Qt Quick 3D Physics} and \l{Qt Sensors} modules which are separate items
in the \l{Get and Install Qt}{Qt Online Installer}. If the example fails to
configure, please make sure that you have these required packages installed.
\sa {Qt Quick Examples and Tutorials} {All Qt Examples}
*/ */