Initial import from the monolithic Qt.
[profile/ivi/qtdeclarative.git] / doc / src / declarative / qtquick-intro.qdoc
1 /****************************************************************************
2 **
3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
6 **
7 ** This file is part of the documentation of the Qt Toolkit.
8 **
9 ** $QT_BEGIN_LICENSE:FDL$
10 ** No Commercial Usage
11 ** This file contains pre-release code and may not be distributed.
12 ** You may use this file in accordance with the terms and conditions
13 ** contained in the Technology Preview License Agreement accompanying
14 ** this package.
15 **
16 ** GNU Free Documentation License
17 ** Alternatively, this file may be used under the terms of the GNU Free
18 ** Documentation License version 1.3 as published by the Free Software
19 ** Foundation and appearing in the file included in the packaging of this
20 ** file.
21 **
22 ** If you have questions regarding the use of this file, please contact
23 ** Nokia at qt-info@nokia.com.
24 ** $QT_END_LICENSE$
25 **
26 ****************************************************************************/
27
28 /*!
29 \page qml-intro.html
30 \title Intro to Qt Quick
31
32 Qt Quick is a collection of technologies that are designed to help developers
33 create the kind of intuitive, modern, and fluid user interfaces that are
34 increasingly used on mobile phones, media players, set-top boxes, and other
35 portable devices. Qt Quick consists of a rich set of user interface
36 \l{QML Elements}{elements}, a \l{QML Syntax}{declarative} language for
37 describing user interfaces, and a language \l{QtDeclarative Module}{runtime}. A
38 collection of C++ APIs is used to integrate these high level features with
39 classic Qt applications. Version 2.1 of the Qt Creator integrated development
40 environment (IDE) introduces tools for developing Qt Quick applications.
41
42 \image qml-clocks-example.png
43
44 \section1 The QML Language
45
46 QML is a high level, scripted language. Its commands, more correctly
47 \e elements, leverage the power and efficiency of the Qt libraries to make easy
48 to use commands that perform intuitive functions. Drawing a rectangle,
49 displaying an image, and application events -- all are possible with declarative
50 programming.
51
52 The language also allows more flexibility of these commands by using
53 \l{About JavaScript}{JavaScript} to implement the high level user interface
54 logic.
55
56 A QML element usually has various \e properties that help define the element.
57 For example, if we created an element called Circle then the radius of the
58 circle would be a property. Building user interfaces by importing these elements
59 is one of the great feature of QML and Qt Quick.
60 \image qml-texteditor5_newfile.png
61
62 \section1 QtDeclarative Module
63
64 To make Qt Quick possible, Qt introduces the \l {QtDeclarative} module. The
65 module creates a JavaScript runtime that QML runs under with a Qt based backend.
66 Because QtDeclarative and QML are built upon Qt, they inherit many of Qt's
67 technology, namely the \l{Signals and Slots}{signals and slots} mechanism and
68 the \l{The Meta-Object System}{meta-object} system. Data created using C++ are
69 directly accessible from QML and QML objects are also accessible from C++ code.
70
71 In conjunction with the QML language, the QtDeclarative module separates the
72 interface logic in QML from the application logic in C++.
73
74 \section1 Creator Tools
75
76 Qt Creator is a complete integrated development environment (IDE) for creating
77 applications with Qt Quick and the Qt application framework.
78
79 \image qmldesigner-visual-editor.png
80
81 The main goal for Qt Creator is meeting the development needs of Qt Quick
82 developers who are looking for simplicity, usability, productivity,
83 extendibility and openness, while aiming to lower the barrier of entry for
84 newcomers to Qt Quick and Qt. The key features of Qt Creator allow UI designers
85 and developers to accomplish the following tasks:
86 \list
87 \o Get started with Qt Quick application development quickly and easily with
88 examples, tutorials, and project wizards.
89 \o Design application user interface with the integrated editor, Qt Quick
90 Designer, or use graphics software to design the user interface and use scripts
91 to export the design to Qt Quick Designer.
92 \o Develop applications with the advanced code editor that provides new powerful
93 features for completing code snippets, refactoring code, and viewing the element
94 hierarchy of QML files.
95 \o Build and deploy Qt Quick applications that target multiple desktop and
96 mobile platforms, such as Microsoft Windows, Mac OS X, Linux, Symbian, and
97 Maemo.
98 \o Debug JavaScript functions and execute JavaScript expressions in the current
99 context, and inspect QML at runtime to explore the object structure, debug
100 animations, and inspect colors.
101 \o Deploy applications to mobile devices and create application installation
102 packages for Symbian and Maemo devices that can be published in the Ovi Store
103 and other channels.
104 \o Easily access information with the integrated context-sensitive Qt Help
105 system.
106 \endlist
107
108 \image qtcreator-target-selector.png
109
110 \section1 Where to Go from Here
111
112 The \l {Qt Quick} page has links to various Qt Quick topics such as QML
113 features, addons, and tools.
114
115 The \l {QML Examples and Demos} page has a gallery of QML applications.
116
117 \section1 License Information
118 \list
119 \o \l{Qt Quick Licensing Information}
120 \endlist
121 */
122
123
124