diff options
author | Bea Lam <bea.lam@nokia.com> | 2012-07-03 11:45:26 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-07-05 01:47:53 +0200 |
commit | 422033971f5d74b8ed7dcf3492379403d4d0eb3d (patch) | |
tree | 0b4e599f47fae7ec482e06bc34091c29c9853ab1 /src/quick/doc/src/concepts/effects/topic.qdoc | |
parent | 7481adc7d72665de7873b99f58764f2a6b906c9c (diff) |
Reorganize "concept" pages in QtQuick docs
This removes concepts/topic.qdoc and move this content into individual
concept topic pages under individual directories for each concept to
avoid having a really long "concepts" index page.
This change also:
- Moves components.qdoc ("Defining reusable components") into the
appdevguide/ since it's not specific to QtQuick features - it's more
about how to use a QtQml feature to build QML apps.
- Moves the part of qtqml/doc/src/cppintegration/data.qdoc that
discusses how to use C++ models with QtQuick views into
quick/doc/src/concepts/modelviewsdata/data-cppmodels.qdoc.
Change-Id: Id18a1d56acaaac41714c13cbc94bb3b80f337355
Reviewed-by: Chris Adams <christopher.adams@nokia.com>
Diffstat (limited to 'src/quick/doc/src/concepts/effects/topic.qdoc')
-rw-r--r-- | src/quick/doc/src/concepts/effects/topic.qdoc | 88 |
1 files changed, 88 insertions, 0 deletions
diff --git a/src/quick/doc/src/concepts/effects/topic.qdoc b/src/quick/doc/src/concepts/effects/topic.qdoc new file mode 100644 index 0000000000..aa6b998c49 --- /dev/null +++ b/src/quick/doc/src/concepts/effects/topic.qdoc @@ -0,0 +1,88 @@ +/**************************************************************************** +** +** 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$ +** +****************************************************************************/ + + +/*! +\page qtquick-effects-topic.html +\title Important Concepts In Qt Quick - Graphical Effects +\brief Overview of graphical effects concepts + +\section1 Graphical Effects and Particles + +Visually appealing user-interfaces are more engaging than lacklustre ones. +That said, the designer must bear in mind that visual effects simply provide +a useful way to subtlely communicate to the user (for example, which visual +item is active, or how focus is being transferred). Over-use of visual +effects can actually detract from the user-experience. + +\section1 Visual Transformation + +Visual objects can be transformed. For example, they can be scaled or rotated. +These sort of transformations can provide hints about focus or selection, and +can provide intuitive hints about what events are occurring in an application. + +For information about visual transformations to visual objects, see the +page titled \l{qtquick-effects-transformations.html} +{Qt Quick Transformation Types}. + +\section1 Shader Effects + +Shader effects allow the full, raw power of a graphics processing unit to be +utilized directly via vertex and pixel shaders. Using too many shader effects +can result in increased power usage and sometimes slow performance, but if +used sparingly and carefully, a shader can allow complex and visually appealing +effects to be applied to a visual object (for example, ripples in water). + +For information about shader programs and shader effects, see the page +titled \l{qtquick-effects-shaders.html} +{Qt Quick Shader Effects}. + +\section1 Particles + +A particle system allows explosions, fireworks, smoke, fog and wind effects to +be simulated and displayed to the user. Qt Quick provides a particle system +which allows these sort of complex, 2D simulations to be performed, including +support for environmental effects like gravity and turbulence. +Particles are most commonly used to add subtle and visually appealing effects +to currently selected items in lists or in activity notifiers, and in games. + +For information about particles, see the documentation about the +\l{qtquick-effects-particles.html}{Qt Quick Particle System}. + +\section1 Sprites + +A sprite is an animated image made up of frames. Sprites are commonly found +in games. Qt Quick provides a visual type to display sprites, as well as a +complex, stochastic, frame-transition controller for more complex applications +which use sprites extensively (such as games). + +For information about sprite animations, see the page titled +\l{qtquick-effects-sprites.html}{Sprite Animations}. + + +*/ + |