summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorFrans Englich <frans.englich@nokia.com>2009-10-02 08:48:52 (GMT)
committerFrans Englich <frans.englich@nokia.com>2009-10-02 08:48:52 (GMT)
commitc006edf9b186c4a8a56e888e8f5d1b692e29f1d8 (patch)
treee105f4e2389cd17a5392478160d37230f4118960 /doc
parentfd5e86e65adfdecd7bf8a49764d9c9410d877e44 (diff)
parent2d003378ff5e7621d5dcc810408039cfe13a8c0a (diff)
downloadQt-c006edf9b186c4a8a56e888e8f5d1b692e29f1d8.zip
Qt-c006edf9b186c4a8a56e888e8f5d1b692e29f1d8.tar.gz
Qt-c006edf9b186c4a8a56e888e8f5d1b692e29f1d8.tar.bz2
Merge commit 'qt/4.6' into mmfphonon
Conflicts: src/gui/kernel/qwidget_s60.cpp
Diffstat (limited to 'doc')
-rw-r--r--doc/src/development/designer-manual.qdoc3
-rw-r--r--doc/src/diagrams/programs/standard_views.py42
-rw-r--r--doc/src/getting-started/examples.qdoc4
-rw-r--r--doc/src/images/gradient.pngbin0 -> 222 bytes
-rw-r--r--doc/src/images/graphicseffect-bloom.pngbin0 -> 79982 bytes
-rw-r--r--doc/src/images/graphicseffect-effects.pngbin395669 -> 486123 bytes
-rw-r--r--doc/src/images/graphicseffect-plain.pngbin0 -> 68763 bytes
-rw-r--r--doc/src/images/pbuffers-example.pngbin203754 -> 192554 bytes
-rw-r--r--doc/src/index.qdoc12
-rw-r--r--doc/src/platforms/supported-platforms.qdoc13
-rw-r--r--doc/src/qt-resources.qdoc45
-rw-r--r--doc/src/qt-webpages.qdoc2
-rw-r--r--doc/src/qt4-intro.qdoc87
13 files changed, 179 insertions, 29 deletions
diff --git a/doc/src/development/designer-manual.qdoc b/doc/src/development/designer-manual.qdoc
index 4f4db85..bfd8066 100644
--- a/doc/src/development/designer-manual.qdoc
+++ b/doc/src/development/designer-manual.qdoc
@@ -61,9 +61,6 @@
\l{Getting To Know Qt Designer} document. For a quick tutorial on how to
use \QD, refer to \l{A Quick Start to Qt Designer}.
- Qt Designer 4.6 boasts a long list of improvements. For a detailed list of
- what is new, refer \l{What's New in Qt Designer 4.6}.
-
\image designer-multiple-screenshot.png
For more information on using \QD, you can take a look at the following
diff --git a/doc/src/diagrams/programs/standard_views.py b/doc/src/diagrams/programs/standard_views.py
new file mode 100644
index 0000000..f1d69f6
--- /dev/null
+++ b/doc/src/diagrams/programs/standard_views.py
@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+
+import sys
+from PyQt4.QtCore import QDir, Qt
+from PyQt4.QtGui import *
+
+app = QApplication(sys.argv)
+
+background = QWidget()
+palette = QPalette()
+palette.setColor(QPalette.Window, QColor(Qt.white))
+background.setPalette(palette)
+
+model = QFileSystemModel()
+model.setRootPath(QDir.currentPath())
+
+treeView = QTreeView(background)
+treeView.setModel(model)
+treeView.setRootIndex(model.index(QDir.currentPath()))
+
+listView = QListView(background)
+listView.setModel(model)
+listView.setRootIndex(model.index(QDir.currentPath()))
+
+tableView = QTableView(background)
+tableView.setModel(model)
+tableView.setRootIndex(model.index(QDir.currentPath()))
+
+selection = QItemSelectionModel(model)
+treeView.setSelectionModel(selection)
+listView.setSelectionModel(selection)
+tableView.setSelectionModel(selection)
+
+layout = QHBoxLayout(background)
+layout.addWidget(listView)
+layout.addSpacing(24)
+layout.addWidget(treeView, 1)
+layout.addSpacing(24)
+layout.addWidget(tableView)
+background.show()
+
+sys.exit(app.exec_())
diff --git a/doc/src/getting-started/examples.qdoc b/doc/src/getting-started/examples.qdoc
index 543a2e1..d80308a 100644
--- a/doc/src/getting-started/examples.qdoc
+++ b/doc/src/getting-started/examples.qdoc
@@ -295,6 +295,8 @@
\o \image animation-examples.png
\o
+ These examples show to to use the \l{The Animation Framework}{animation framework}
+ to build highly animated, high-performance GUIs.
\row
\o{2,1} \l{Gestures Examples}{\bold{Gestures}}
@@ -322,6 +324,8 @@
\o \image activeqt-examples.png ActiveQt
\o
+ These examples demonstrate how to write ActiveX controls and control servers
+ with Qt, and how to use ActiveX controls and COM objects in a Qt application.
\row
\o{2,1} \l{Qt Quarterly}{\bold{Qt Quarterly}}
diff --git a/doc/src/images/gradient.png b/doc/src/images/gradient.png
new file mode 100644
index 0000000..2ef36ed
--- /dev/null
+++ b/doc/src/images/gradient.png
Binary files differ
diff --git a/doc/src/images/graphicseffect-bloom.png b/doc/src/images/graphicseffect-bloom.png
new file mode 100644
index 0000000..dace7eb
--- /dev/null
+++ b/doc/src/images/graphicseffect-bloom.png
Binary files differ
diff --git a/doc/src/images/graphicseffect-effects.png b/doc/src/images/graphicseffect-effects.png
index 3709014..609bef9 100644
--- a/doc/src/images/graphicseffect-effects.png
+++ b/doc/src/images/graphicseffect-effects.png
Binary files differ
diff --git a/doc/src/images/graphicseffect-plain.png b/doc/src/images/graphicseffect-plain.png
new file mode 100644
index 0000000..8b4c1c4
--- /dev/null
+++ b/doc/src/images/graphicseffect-plain.png
Binary files differ
diff --git a/doc/src/images/pbuffers-example.png b/doc/src/images/pbuffers-example.png
index bafb05a..c34a6fd 100644
--- a/doc/src/images/pbuffers-example.png
+++ b/doc/src/images/pbuffers-example.png
Binary files differ
diff --git a/doc/src/index.qdoc b/doc/src/index.qdoc
index ed4bbbe..f376af2 100644
--- a/doc/src/index.qdoc
+++ b/doc/src/index.qdoc
@@ -79,15 +79,15 @@
</td>
</tr>
<tr>
- <th class="largeheader">
+ <th class="titleheader">
Fundamentals</th>
- <th class="largeheader">
+ <th class="titleheader">
User Interface Design</th>
- <th class="largeheader">
+ <th class="titleheader">
Technologies</th>
</tr>
<tr>
- <td valign="top" class="largeindex">
+ <td valign="top">
<ul>
<li><a href="object.html">The Qt Object Model</a></li>
<li><a href="eventsandfilters.html">Event System</a></li>
@@ -96,7 +96,7 @@
<li><a href="platform-specific.html">Platform Specifics</a></li>
</ul>
</td>
- <td valign="top" class="largeindex">
+ <td valign="top">
<ul>
<li><a href="widgets-and-layouts.html">Widgets and Layouts</a></li>
<li><a href="application-windows.html">Application Windows</a></li>
@@ -105,7 +105,7 @@
<li><a href="webintegration.html">Integrating Web Content</a></li>
</ul>
</td>
- <td valign="top" class="largeindex">
+ <td valign="top">
<ul>
<li><a href="io.html">Input/Output</a> and <a href="resources.html">Resources</a></li>
<li><a href="network-programming.html">Network Programming</a></li>
diff --git a/doc/src/platforms/supported-platforms.qdoc b/doc/src/platforms/supported-platforms.qdoc
index 5f72ce3..788af67 100644
--- a/doc/src/platforms/supported-platforms.qdoc
+++ b/doc/src/platforms/supported-platforms.qdoc
@@ -78,7 +78,7 @@
\row \o Linux (32 and 64-bit)
\o gcc 4.2
\row \o Microsoft Windows XP
- \o gcc 3.4.2 (MinGW) (32-bit), MSVC 2003, 2005 (32 and 64-bit)
+ \o gcc 4.4 (MinGW) (32-bit), MSVC 2003, 2005 (32 and 64-bit)
\row \o Microsoft Windows Vista
\o MSVC 2005, 2008
\row \o Microsoft Windows Vista 64bit
@@ -104,6 +104,8 @@
\table
\header \o Platform
\o Compilers
+ \row \o Windows XP, Vista
+ \o gcc 3.4.2 (MinGW)
\omit
\row \o Windows 7
\o MSVC 2008
@@ -134,7 +136,14 @@
All platforms not specifically listed above are not supported by Nokia. Nokia does
not run its unit test suite or perform any other internal tests on platforms not
- listed above. Qt users should note, however, that there may be various open source
+ listed above.
+
+ Even though some Tier 3 platforms are available under the Qt Commercial License,
+ technical support is not included in that license.
+ However, \l{Hot to Order}{contact our sales team} to find out about the
+ availability of other services for those platforms.
+
+ Qt users should note, however, that there may be various open source
projects, community users and/or Qt partners who are able to provide assistance with
platforms not supported by Nokia.
diff --git a/doc/src/qt-resources.qdoc b/doc/src/qt-resources.qdoc
new file mode 100644
index 0000000..a7dffe4
--- /dev/null
+++ b/doc/src/qt-resources.qdoc
@@ -0,0 +1,45 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 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:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights. These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+ \page qt-resources.html
+ \image gradient.png
+*/
diff --git a/doc/src/qt-webpages.qdoc b/doc/src/qt-webpages.qdoc
index e02cd19..7287656 100644
--- a/doc/src/qt-webpages.qdoc
+++ b/doc/src/qt-webpages.qdoc
@@ -145,7 +145,7 @@
*/
/*!
- \externalpage http://qt.nokia.com/contact
+ \externalpage http://qt.nokia.com/about/contact-us
\title How to Order
*/
diff --git a/doc/src/qt4-intro.qdoc b/doc/src/qt4-intro.qdoc
index eafae14..47eab16 100644
--- a/doc/src/qt4-intro.qdoc
+++ b/doc/src/qt4-intro.qdoc
@@ -464,6 +464,7 @@
previous releases in the Qt 4 series. This document covers the
most important features in this release, separated by category.
+\omit
A comprehensive list of changes between Qt 4.5 and Qt 4.6 is
included in the \c changes-4.6.0 file
\l{http://qt.nokia.com/developer/changes/changes-4.6.0}{available
@@ -473,6 +474,7 @@
Changes between this release and the previous release are provided
in the \c{changes-%VERSION%} file (also
\l{http://qt.nokia.com/developer/changes/changes-%VERSION%}{available online}).
+\endomit
A list of other Qt 4 features can be found on the \bold{\l{What's
New in Qt 4}} page.
@@ -481,6 +483,14 @@
\tableofcontents
+ \section1 Support for Symbian
+
+ Qt 4.6 is the first release to include support for the Symbian
+ platform, with integration into the S60 framework. The port to
+ Symbian and S60 provides all functionality required to develop
+ rich end-user applications for devices running Symbian 3.1 and
+ later.
+
\section1 Animation Framework
The animation framework helps build highly animated,
@@ -491,8 +501,9 @@
The framework makes it easy to animate \l{QObject}s, including
QWidgets, by allowing Qt properties to be animated. It also allows
creating custom animations and interpolation functions. Graphics
- views are not left out--one can animate \l{QGraphicsWidget}s,
- which inherits from QObject (and thereby enables properties).
+ views are not left out; one can animate \l{QGraphicsWidget}s and
+ new \l{QGraphicsObject}s which inherit from QGraphicsItem
+ (and thereby enable properties).
Animations are controlled using easing curves and can be grouped
together. This enables animations of arbitrary complexity.
@@ -508,6 +519,8 @@
The state machine framework is introduced in 4.6 and is described
below.
+ See \l{The Animation Framework} documentation for more information.
+
\section1 State Machine Framework
The state machine framework provides a robust state chart
@@ -533,6 +546,8 @@
trigger on signals and \l{QEvent}s. By inserting animations into
the state machine, it is also easier to use the framework for
animating GUIs, for instance.
+
+ See \l{The State Machine Framework} documentation for more infromation.
\section1 Multi-touch & Gestures
@@ -552,6 +567,8 @@
\o Enable extensibility.
\endlist
+ See the QTouchEvent and QGesture class documentation for more information.
+
\section1 DOM access API
Web pages and XML both have very complex document object models.
@@ -566,20 +583,7 @@
QList<QWebElement> introSpans = document.findAll("p.intro span");
\endcode
- \section1 Qt3D enablers
-
- As more of Qt, and more of the applications built on Qt go 3D,
- API's should be provided to simplify this. Mainly, the new API
- aims to make it more easy to create 3D applications with OpenGL.
- It will also unify the Qt OpenGL codebase, and enable
- cross-platform 3D codebase.
-
- The main features of the Qt3D enablers are currently: Math
- primitives for matrix multiplication, vectors, quaternions
- (client-side), and API for vertex and fragment shaders, GLSL/ES.
- Future research will, among other things include stencils,
- scissors, vertex buffers and arrays, texture manipulation, and
- geometry shaders.
+ See the QWebElement class documentation for more information.
\section1 Performance Optimizations
@@ -592,10 +596,57 @@
\o Reduced overhead in QNetworkAccessManager.
\o Added the QContiguousCache class, which provides efficient caching of
contiguous data.
+ \o Added support for hardware-accelerated rendering through
+ \l{OpenVG Rendering in Qt}{OpenVG}
\o Removed Win9x support.
\endlist
- \section1 Multimedia Audio Services
+ \section1 Graphics Effects
+
+ Effects can be used to alter the appearance of UI elements such as
+ \l{QGraphicsItem}s and \l{QWidget}s. A range of standard effects such
+ as blurring, colorizing or blooming is provided, and it is possible to
+ implement custom effects.
+
+ \table
+ \row
+ \o
+ \o \img graphicseffect-plain.png
+ \o
+ \row
+ \o \img graphicseffect-blur.png
+ \o \img graphicseffect-colorize.png
+ \o \img graphicseffect-bloom.png
+ \endtable
+
+ See the QGraphicsEffect class documentation for more information.
+
+ \section1 XML Schema Validation
+
+ The QtXmlPatterns module can now be used to validate schemas, either
+ through C++ APIs in the Qt application, or using the xmlpatternsvalidator
+ command line utility. The implementation of XML Schema Validation supports
+ the specification version 1.0 in large parts.
+
+ See the \l{XML Processing} and QXmlSchema class documentation for more
+ information.
+
+ \section1 Qt3D enablers
+
+ As more of Qt, and more of the applications built on Qt go 3D,
+ API's should be provided to simplify this. Mainly, the new API
+ aims to make it more easy to create 3D applications with OpenGL.
+ It will also unify the Qt OpenGL codebase, and enable
+ cross-platform 3D codebase.
+
+ The main features of the Qt3D enablers are currently: Math
+ primitives for matrix multiplication, vectors, quaternions
+ (client-side), and API for vertex and fragment shaders, GLSL/ES.
+ Future research will, among other things include stencils,
+ scissors, vertex buffers and arrays, texture manipulation, and
+ geometry shaders.
+
+ \section1 Multimedia Services
Qt 4.6 comes with new classes for handling audio. These classes
provide low-level access to the system's audio system. By
@@ -605,6 +656,8 @@
functions to query audio devices for which audio formats they
support.
+ See the \l{QtMultimedia Module} documentation for more information.
+
\section1 Classes, functions, and other items introduced in 4.6
Links to classes, function, and other items that were added in