examples/particles/imageparticle/imageparticle.qml

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
   4 ** Contact: http://www.qt-project.org/
   5 **
   6 ** This file is part of the examples of the Qt Toolkit.
   7 **
   8 ** $QT_BEGIN_LICENSE:BSD$
   9 ** You may use this file under the terms of the BSD license as follows:
  10 **
  11 ** "Redistribution and use in source and binary forms, with or without
  12 ** modification, are permitted provided that the following conditions are
  13 ** met:
  14 **   * Redistributions of source code must retain the above copyright
  15 **     notice, this list of conditions and the following disclaimer.
  16 **   * Redistributions in binary form must reproduce the above copyright
  17 **     notice, this list of conditions and the following disclaimer in
  18 **     the documentation and/or other materials provided with the
  19 **     distribution.
  20 **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
  21 **     the names of its contributors may be used to endorse or promote
  22 **     products derived from this software without specific prior written
  23 **     permission.
  24 **
  25 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  26 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  27 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  28 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  29 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  30 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  31 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  32 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  33 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  34 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  35 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
  36 **
  37 ** $QT_END_LICENSE$
  38 **
  39 ****************************************************************************/
  40
  41 import QtQuick 2.0
  42 import "../../shared" as Examples
  43
  44 /*!
  45     \title QtQuick.Particles Examples - Affectors
  46     \example particles/imageparticle
  47     \brief This is a collection of examples using Affectors in the QML particle system.
  48     \image qml-imageparticle-example.png
  49
  50     This is a collection of small QML examples relating to using Affectors in the particle system.
  51     Each example is a small QML file emphasizing a particular element or feature.
  52
  53     All at once shows off several of the features of ImageParticle at the same time.
  54     \snippet examples/particles/imageparticle/content/allatonce.qml 0
  55
  56     Colored shows a simple ImageParticle with some color variation.
  57     \snippet examples/particles/imageparticle/content/colored.qml 0
  58
  59     Color Table sets the color over life on the particles to provide a fixed rainbow effect.
  60     \snippet examples/particles/imageparticle/content/colortable.qml 0
  61
  62     Deformation spins and squishes a starfish particle.
  63     \snippet examples/particles/imageparticle/content/colortable.qml spin
  64     \snippet examples/particles/imageparticle/content/colortable.qml deform
  65
  66     Rotation demonstrates the autoRotate property, so that particles rotate in the direction that they travel.
  67
  68     Sharing demonstrates what happens when multiple ImageParticles try to render the same particle.
  69     The following ImageParticle renders the particles inside the ListView:
  70     \snippet examples/particles/imageparticle/content/sharing.qml 0
  71     The following ImageParticle is placed inside the list highlight, and renders the particles above the other ImageParticle.
  72     \snippet examples/particles/imageparticle/content/sharing.qml 1
  73     Note that because it sets the color and alpha in this ImageParticle, it renders the particles in a different color.
  74     Since it doesn't specify anything about the rotation, it shares the rotation with the other ImageParticle so that the flowers are rotated the same way in both.
  75     Note that you can undo rotation in another ImageParticle, you just need to explicity set rotationVariation to 0.
  76
  77     Sprites demonstrates using an image particle to render animated sprites instead of static images for each particle.
  78 */
  79
  80 Item {
  81     height: 480
  82     width: 320
  83     Examples.LauncherList {
  84         id: ll
  85         anchors.fill: parent
  86         Component.onCompleted: {
  87             addExample("All at once", "Uses all ImageParticle features",  Qt.resolvedUrl("content/allatonce.qml"));
  88             addExample("Colored", "Colorized image particles",  Qt.resolvedUrl("content/colored.qml"));
  89             addExample("Color Table", "Color-over-life rainbow particles",  Qt.resolvedUrl("content/colortable.qml"));
  90             addExample("Deformation", "Deformed particles",  Qt.resolvedUrl("content/deformation.qml"));
  91             addExample("Rotation", "Rotated particles",  Qt.resolvedUrl("content/rotation.qml"));
  92             addExample("Sharing", "Multiple ImageParticles on the same particles",  Qt.resolvedUrl("content/sharing.qml"));
  93             addExample("Sprites", "Partiles rendered with sprites",  Qt.resolvedUrl("content/sprites.qml"));
  94         }
  95     }
  96 }