diff options
author | Wolfgang Beck <wolfgang.beck@nokia.com> | 2011-12-08 12:42:35 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2011-12-09 01:43:36 +0100 |
commit | c5ee8b6f82d5a39260121433f95b28f8cf7762eb (patch) | |
tree | 26ed0f0a0644d50131b11557738babdfe087f422 | |
parent | 3b8c985084be2698745386f9618f26b04d475367 (diff) | |
download | qtsensors-c5ee8b6f82d5a39260121433f95b28f8cf7762eb.tar.gz |
Add MAZE tutorial
Change-Id: I076d5071aa27ba10da6885b1d856c24ca6bb4f7d
Sanity-Review: Qt Sanity Bot <qt_sanity_bot@ovi.com>
Reviewed-by: Lincoln Ramsay <lincoln.ramsay@nokia.com>
Reviewed-by: Wolfgang Beck <wolfgang.beck@nokia.com>
-rw-r--r-- | doc/src/examples/sensors.qdoc | 8 | ||||
-rw-r--r-- | doc/src/maze.qdoc | 56 | ||||
-rw-r--r-- | examples/sensors/maze/Maze.qml | 11 |
3 files changed, 67 insertions, 8 deletions
diff --git a/doc/src/examples/sensors.qdoc b/doc/src/examples/sensors.qdoc index 98bf0e0..e20eb35 100644 --- a/doc/src/examples/sensors.qdoc +++ b/doc/src/examples/sensors.qdoc @@ -47,12 +47,4 @@ It was designed as a debugging aid. */ -/*! - \example sensors/maze - \title Maze - \brief The Maze example demonstrates the TiltSensor QML element - \ingroup qtsensors-examples - - The Maze example demonstrates the use of the TiltSensor QML element. -*/ diff --git a/doc/src/maze.qdoc b/doc/src/maze.qdoc new file mode 100644 index 0000000..51520ca --- /dev/null +++ b/doc/src/maze.qdoc @@ -0,0 +1,56 @@ +/**************************************************************************** +** +** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). +** All rights reserved. +** Contact: Nokia Corporation (qt-info@nokia.com) +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:FDL$ +** GNU Free Documentation License +** Alternatively, this file may be used under the terms of the GNU Free +** Documentation License version 1.3 as published by the Free Software +** Foundation and appearing in the file included in the packaging of +** this file. +** +** Other Usage +** Alternatively, this file may be used in accordance with the terms +** and conditions contained in a signed written agreement between you +** and Nokia. +** +** +** +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! + \example sensors/maze + \title Maze + \brief The Maze example demonstrates the TiltSensor QML element + \ingroup qtsensors-examples + +\section1 Overview + To write a QML application that will use the TiltSensor QML sensors element you need to do the following steps: + + Import the QtSensors 5.x declarative plugin: + +\snippet ../examples/sensors/maze/Maze.qml 0 + + Add the Sensor QML elements into your qml file. + + In this example we use the TiltSensor with values based in degrees and an accuracy of 5 degree: + +\snippet ../examples/sensors/maze/Maze.qml 1 + + Starting the sensor can be done by setting the 'enabled' property to true: + +\snippet ../examples/sensors/maze/Maze.qml 2 + + To determine the walk direction of the mouse we use the following if -else statements: + +\snippet ../examples/sensors/maze/Maze.qml 3 + +*/ + diff --git a/examples/sensors/maze/Maze.qml b/examples/sensors/maze/Maze.qml index a0a998a..189f523 100644 --- a/examples/sensors/maze/Maze.qml +++ b/examples/sensors/maze/Maze.qml @@ -40,7 +40,10 @@ //Import the declarative plugins import QtQuick 2.0 + +//! [0] import QtSensors 5.0 +//! [0] //Import the javascript functions for this game import "lib.js" as Lib @@ -159,20 +162,25 @@ Rectangle { } } +//! [1] TiltSensor{ id: tiltSensor unit: TiltSensor.Degrees enabled: true accuracy: 5.0 } +//! [1] //Timer to read out the x and y rotation of the TiltSensor Timer { id: tiltTimer interval: 50; running: false; repeat: true + +//! [2] onTriggered: { if (!tiltSensor.enabled) tiltSensor.enabled = true; +//! [2] if (mouseCtrl === null) return; @@ -185,6 +193,8 @@ Rectangle { //check if we can move the mouse var xval = -1; var yval = -1; + +//! [3] var xstep = 0; if (tiltSensor.yRotation > 0) xstep = 1; @@ -195,6 +205,7 @@ Rectangle { ystep = 1; else if (tiltSensor.xRotation < 0) ystep = -1; +//! [3] if (xstep < 0){ if (mouseCtrl.x > 0){ |