Update Age affector doc references
[profile/ivi/qtdeclarative.git] / src / particles / qquickmaskextruder.cpp
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 QtQuick module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** GNU Lesser General Public License Usage
10 ** This file may be used under the terms of the GNU Lesser General Public
11 ** License version 2.1 as published by the Free Software Foundation and
12 ** appearing in the file LICENSE.LGPL included in the packaging of this
13 ** file. Please review the following information to ensure the GNU Lesser
14 ** General Public License version 2.1 requirements will be met:
15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
16 **
17 ** In addition, as a special exception, Nokia gives you certain additional
18 ** rights. These rights are described in the Nokia Qt LGPL Exception
19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
20 **
21 ** GNU General Public License Usage
22 ** Alternatively, this file may be used under the terms of the GNU General
23 ** Public License version 3.0 as published by the Free Software Foundation
24 ** and appearing in the file LICENSE.GPL included in the packaging of this
25 ** file. Please review the following information to ensure the GNU General
26 ** Public License version 3.0 requirements will be met:
27 ** http://www.gnu.org/copyleft/gpl.html.
28 **
29 ** Other Usage
30 ** Alternatively, this file may be used in accordance with the terms and
31 ** conditions contained in a signed written agreement between you and Nokia.
32 **
33 **
34 **
35 **
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41
42 #include "qquickmaskextruder_p.h"
43 #include <QtQml/qqml.h>
44 #include <QtQml/qqmlinfo.h>
45 #include <QImage>
46 #include <QDebug>
47 QT_BEGIN_NAMESPACE
48 /*!
49     \qmlclass MaskShape QQuickMaskExtruder
50     \inqmlmodule QtQuick.Particles 2
51     \inherits Shape
52     \brief For representing an image as a shape to affectors and emitters
53     \ingroup qtquick-particles
54
55 */
56 /*!
57     \qmlproperty url QtQuick.Particles2::MaskShape::source
58
59     The image to use as the mask. Areas with non-zero opacity
60     will be considered inside the shape.
61 */
62
63
64 QQuickMaskExtruder::QQuickMaskExtruder(QObject *parent) :
65     QQuickParticleExtruder(parent)
66   , m_lastWidth(-1)
67   , m_lastHeight(-1)
68 {
69 }
70
71 void QQuickMaskExtruder::setSource(QUrl arg)
72 {
73     if (m_source != arg) {
74         m_source = arg;
75
76         m_lastHeight = -1;//Trigger reset
77         m_lastWidth = -1;
78         emit sourceChanged(arg);
79         startMaskLoading();
80     }
81 }
82
83 void QQuickMaskExtruder::startMaskLoading()
84 {
85     m_pix.clear(this);
86     if (m_source.isEmpty())
87         return;
88     m_pix.load(qmlEngine(this), m_source);
89     if (m_pix.isLoading())
90         m_pix.connectFinished(this, SLOT(finishMaskLoading()));
91     else
92         finishMaskLoading();
93 }
94
95 void QQuickMaskExtruder::finishMaskLoading()
96 {
97     if (m_pix.isError())
98         qmlInfo(this) << m_pix.error();
99 }
100
101 QPointF QQuickMaskExtruder::extrude(const QRectF &r)
102 {
103     ensureInitialized(r);
104     if (!m_mask.count() || m_img.isNull())
105         return r.topLeft();
106     const QPointF p = m_mask[rand() % m_mask.count()];
107     //### Should random sub-pixel positioning be added?
108     return p + r.topLeft();
109 }
110
111 bool QQuickMaskExtruder::contains(const QRectF &bounds, const QPointF &point)
112 {
113     ensureInitialized(bounds);//###Current usage patterns WILL lead to different bounds/r calls. Separate list?
114     if (m_img.isNull())
115         return false;
116     QPoint p = point.toPoint() - bounds.topLeft().toPoint();
117     return m_img.rect().contains(p) && (bool)m_img.pixelIndex(p);
118 }
119
120 void QQuickMaskExtruder::ensureInitialized(const QRectF &r)
121 {
122     if (m_lastWidth == r.width() && m_lastHeight == r.height())
123         return;//Same as before
124     if (!m_pix.isReady())
125         return;
126     m_lastWidth = r.width();
127     m_lastHeight = r.height();
128
129     m_mask.clear();
130
131     m_img = m_pix.image().createAlphaMask();
132     m_img = m_img.convertToFormat(QImage::Format_Mono);//Else LSB, but I think that's easier
133     m_img = m_img.scaled(r.size().toSize());//TODO: Do they need aspect ratio stuff? Or tiling?
134     for (int i=0; i<r.width(); i++){
135         for (int j=0; j<r.height(); j++){
136             if (m_img.pixelIndex(i,j))//Direct bit manipulation is presumably more efficient
137                 m_mask << QPointF(i,j);
138         }
139     }
140 }
141 QT_END_NAMESPACE