summaryrefslogtreecommitdiffstats
path: root/doc/src/examples
diff options
context:
space:
mode:
authorWolfgang Beck <wolfgang.beck@nokia.com>2012-05-25 12:31:38 +1000
committerQt by Nokia <qt-info@nokia.com>2012-05-28 05:02:44 +0200
commit5effd1712aa6f1ae2359762cdadeb70198121f77 (patch)
treed7a48be78f910d7e957252b36a5dbf6f57e786bf /doc/src/examples
parentdd14ea8acf97103868d6dfcafb7b19275e605e97 (diff)
Update Examples using the same name conventions
e.g. Folder of example should start with QtSensorrs_ Example documentation title should start with QtSensors - images folder renamed to content Change-Id: I341fb8510ba3ad64068d786559e8d28af5d135c3 Reviewed-by: Lincoln Ramsay <lincoln.ramsay@nokia.com>
Diffstat (limited to 'doc/src/examples')
-rw-r--r--doc/src/examples/accelbubble.qdoc12
-rw-r--r--doc/src/examples/cubehouse.qdoc60
-rw-r--r--doc/src/examples/grue.qdoc32
-rw-r--r--doc/src/examples/qmlsensorgtestures.qdoc63
-rw-r--r--doc/src/examples/sensorgestures.qdoc8
5 files changed, 149 insertions, 26 deletions
diff --git a/doc/src/examples/accelbubble.qdoc b/doc/src/examples/accelbubble.qdoc
index 962bce67..71885331 100644
--- a/doc/src/examples/accelbubble.qdoc
+++ b/doc/src/examples/accelbubble.qdoc
@@ -26,8 +26,8 @@
****************************************************************************/
/*!
- \example QtSensors/accelbubble
- \title Accel Bubble
+ \example QtSensors/QtSensors_accelbubble
+ \title Qt Sensors - Accel Bubble
\brief The AccelBubble example demonstrates the Legacy Accelerometer QML element.
\ingroup qtsensors-examples
@@ -36,19 +36,19 @@
Import the Legacy Sensors Declarative module.
-\snippet ../examples/QtSensors/accelbubble/main.qml 0
+\snippet ../examples/QtSensors/QtSensors_accelbubble/QtSensors_accelbubble.qml 0
Add an Accelerometer QML element.
-\snippet ../examples/QtSensors/accelbubble/main.qml 1
+\snippet ../examples/QtSensors/QtSensors_accelbubble/QtSensors_accelbubble.qml 1
The accelerometer might run too fast for what we need, so add a timer to read the accelerometer's readings.
-\snippet ../examples/QtSensors/accelbubble/main.qml 2
+\snippet ../examples/QtSensors/QtSensors_accelbubble/QtSensors_accelbubble.qml 2
Use the 'active' property to start the sensor
-\snippet ../examples/QtSensors/accelbubble/main.qml 3
+\snippet ../examples/QtSensors/QtSensors_accelbubble/QtSensors_accelbubble.qml 3
*/
diff --git a/doc/src/examples/cubehouse.qdoc b/doc/src/examples/cubehouse.qdoc
new file mode 100644
index 00000000..278dd865
--- /dev/null
+++ b/doc/src/examples/cubehouse.qdoc
@@ -0,0 +1,60 @@
+/****************************************************************************
+**
+** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/
+**
+** 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 QtSensors/QtSensors_cubehouse
+ \title Qt Sensors - Cube House QML Accelerometer example
+ \ingroup qtsensors-examples
+ \brief The Cube House example demonstrates the use of the accelerometer to drive a camera to create a pseudo-3D effect.
+ \image cubehouse.png
+
+\section1 Overview
+ To write a QML application that will use the QML Accelerometer element from the QtMobility.sensors import you need to to the following steps:
+
+ Import the QtMobility.sensors declarative plugin:
+
+\snippet ../examples/QtSensors/QtSensors_cubehouse/QtSensors_cubehouse.qml 0
+
+ Add the Accelerometer QML elements into your qml file.
+
+\snippet ../examples/QtSensors/QtSensors_cubehouse/QtSensors_cubehouse.qml 1
+
+ In additional two properties are added to save the calculated pitch and roll values:
+
+\snippet ../examples/QtSensors/QtSensors_cubehouse/QtSensors_cubehouse.qml 2
+
+ Reading out the Accelerometer data can be done by implementing the 'onReadingChanged' slot and
+ accessing the 'reading' property from the Accelerometer element:
+
+\snippet ../examples/QtSensors/QtSensors_cubehouse/QtSensors_cubehouse.qml 3
+
+ By using a timer the view can be rotated using the pitch and roll properties from the Accelerometer element:
+
+\snippet ../examples/QtSensors/QtSensors_cubehouse/QtSensors_cubehouse.qml 4
+
+*/
+
diff --git a/doc/src/examples/grue.qdoc b/doc/src/examples/grue.qdoc
index a64528aa..73a67fc1 100644
--- a/doc/src/examples/grue.qdoc
+++ b/doc/src/examples/grue.qdoc
@@ -27,11 +27,11 @@
/*!
\page gruesensorexample.html
- \title Grue Sensor Example
- \brief The Grue sensor example demonstrates all the steps from creating a new sensor to using it.
+ \title Qt Sensors - Grue Sensor Example
+ \brief The Qt Sensors - Grue sensor example demonstrates all the steps from creating a new sensor to using it.
\ingroup qtsensors-examples
- The Grue sensor example demonstrates all the steps from creating a new sensor to using it.
+ The Qt Sensors - Grue sensor example demonstrates all the steps from creating a new sensor to using it.
The sensor definition is placed in a library where client apps can access it. The actual implementation
lives in a plugin.
@@ -57,7 +57,7 @@
*/
/*!
- \example QtSensors/grue/lib
+ \example QtSensors/QtSensors_grue/lib
\title Grue Sensor Definition
\brief The Grue sensor is defined in a library so that applications can use it.
@@ -74,11 +74,11 @@
src/sensors. As such, it contains some generated code that defines the convenience
classes GrueFilter and GrueSensor.
- \sa {Grue Sensor Example}
+ \sa {Qt Sensors - Grue Sensor Example}
*/
/*!
- \example QtSensors/grue/plugin
+ \example QtSensors/QtSensors_grue/plugin
\title Grue Sensor Implementation
\brief The Grue sensor implementation lives in a plugin that is loaded by the Qt Sensors library.
@@ -94,13 +94,13 @@
light sensor. In the start method, the backend should be sure to call the
sensorStopped() or sensorBusy() methods if it cannot start.
- \snippet ../examples/QtSensors/grue/plugin/gruesensorimpl.cpp start
+ \snippet ../examples/QtSensors/QtSensors_grue/plugin/gruesensorimpl.cpp start
The setReading method is needed so that the sensors library knows where the
readings are coming from. This backend has a local copy of the reading so
it passes a pointer to the function.
- \snippet ../examples/QtSensors/grue/plugin/gruesensorimpl.cpp setReading
+ \snippet ../examples/QtSensors/QtSensors_grue/plugin/gruesensorimpl.cpp setReading
However it is also possible to pass null to the setReading method in which
case the sensors library will create an instance and return a pointer.
@@ -119,11 +119,11 @@
The Grue sensor backend is delivered as a plugin. The plugin has a factory object
that registers the types available and does the actual instantiation of the backend.
- \sa {Grue Sensor Example}
+ \sa {Qt Sensors - Grue Sensor Example}
*/
/*!
- \example QtSensors/grue/console_app
+ \example QtSensors/QtSensors_grue/console_app
\title Grue Sensor Console Application
\brief The Grue sensor console application demonstrates use of the Grue sensor.
@@ -131,21 +131,21 @@
access feature of Qt Sensors to avoid a link-time dependency on the Grue Sensor
library.
- \sa {Grue Sensor Example}
+ \sa {Qt Sensors - Grue Sensor Example}
*/
/*!
- \example QtSensors/grue/import
+ \example QtSensors/QtSensors_grue/import
\title Grue Sensor QML Import
\brief The Grue sensor QML import exports the GrueSensor class as a QML element.
This example creates the \e {Grue 1.0} import.
- \sa {Grue Sensor Example}
+ \sa {Qt Sensors - Grue Sensor Example}
*/
/*!
- \example QtSensors/grue/qml_app
+ \example QtSensors/QtSensors_grue
\title Grue Sensor QML Application
\brief The Grue sensor QML application demonstrates use of the GrueSensor QML element.
@@ -154,9 +154,9 @@
this example or it will not be able to find its dependencies.
\code
- qmlscene main.qml
+ qmlscene QtSensors_grue.qml
\endcode
- \sa {Grue Sensor Example}
+ \sa {Qt Sensors - Grue Sensor Example}
*/
diff --git a/doc/src/examples/qmlsensorgtestures.qdoc b/doc/src/examples/qmlsensorgtestures.qdoc
new file mode 100644
index 00000000..1da467a8
--- /dev/null
+++ b/doc/src/examples/qmlsensorgtestures.qdoc
@@ -0,0 +1,63 @@
+/****************************************************************************
+**
+** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/
+**
+** 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 QtSensors/QtSensors_qmlsensorgestures
+ \title Qt Sensors - SensorGesture QML Element example
+ \ingroup qtsensors-examples
+
+ \brief This example demonstrates use of the SensorGesture QML element.
+
+\section1 Overview
+ To write a QML application that will use the gesture plugin you need to to the following steps:
+
+ Import the QtSensors 5.x declarative plugin:
+
+\snippet ../examples/QtSensors/QtSensors_qmlsensorgestures/GestureView.qml 0
+
+ Add the SensorGesture QML element into your qml file.
+
+\snippet ../examples/QtSensors/QtSensors_qmlsensorgestures/GestureView.qml 1
+
+ Each SensorGesture QML element contains a property called gestures.
+
+ In this example an alias 'gestureid' for this property is used.
+
+\snippet ../examples/QtSensors/QtSensors_qmlsensorgestures/GestureView.qml 2
+
+ By using this alias property you define which gestures should be used:
+
+\snippet ../examples/QtSensors/QtSensors_qmlsensorgestures/QtSensors_qmlsensorgestures.qml 3
+
+ A list of all available gestures can be created by calling the 'availableGestures' property:
+
+\snippet ../examples/QtSensors/QtSensors_qmlsensorgestures/GestureList.qml 4
+
+\sa {Qt Sensors - ShakeIt QML Example}
+\sa {Qt Sensor Gestures}
+*/
+
diff --git a/doc/src/examples/sensorgestures.qdoc b/doc/src/examples/sensorgestures.qdoc
index 6da13c85..4940dfb5 100644
--- a/doc/src/examples/sensorgestures.qdoc
+++ b/doc/src/examples/sensorgestures.qdoc
@@ -27,7 +27,7 @@
/*!
\page sensorgestureexample.html
- \title C++ Sensor Gestures Example
+ \title Qt Sensors - C++ Sensor Gestures Example
\ingroup qtsensors-examples
\brief The sensor gesture example demonstrates the steps for creating a C++ application
that uses sensor gestures and the included shake sensor.
@@ -45,17 +45,17 @@
In order to know about custom signals that may be available, we need to ask the QSensorGestureManager about them,
Using the QSensorGesture::gestureIds() function, the manager will return a QStringList of known and valid gesture Ids.
- \snippet ../examples/QtSensors/sensorgestures/mainwindow.cpp 0
+ \snippet ../examples/QtSensors/QtSensors_sensorgestures/mainwindow.cpp 0
We can then use this to create a QSensorGesture object that we can use to connect signals to,
and start the detection process. A QSensorGesture object will take a list of one or more
recognizer ids in it's constructor.
- \snippet ../examples/QtSensors/sensorgestures/mainwindow.cpp 1
+ \snippet ../examples/QtSensors/QtSensors_sensorgestures/mainwindow.cpp 1
and later stop the detection process.
- \snippet ../examples/QtSensors/sensorgestures/mainwindow.cpp 2
+ \snippet ../examples/QtSensors/QtSensors_sensorgestures/mainwindow.cpp 2
The QSensorGesture object will contain all the signals of the valid requested recognizers found on the system.