/**************************************************************************** ** ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the Declarative module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** 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. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU General ** Public License version 3.0 as published by the Free Software Foundation ** and appearing in the file LICENSE.GPL included in the packaging of this ** file. Please review the following information to ensure the GNU General ** Public License version 3.0 requirements will be met: ** http://www.gnu.org/copyleft/gpl.html. ** ** 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$ ** ****************************************************************************/ #include "qsgparticleaffector_p.h" #include QT_BEGIN_NAMESPACE /*! \qmlclass Affector QSGParticleAffector \inqmlmodule QtQuick.Particles 2 \brief Affector elements can alter the attributes of logical particles at any point in their lifetime. The base Affector does not alter any attributes, but can be used to emit a signal when a particle meets certain conditions. If an affector has a defined size, then it will only affect particles within its size and position on screen. */ /*! \qmlproperty ParticleSystem QtQuick.Particles2::Affector::system This is the system which will be affected by the element. If the Affector is a direct child of a ParticleSystem, it will automatically be associated with it. */ /*! \qmlproperty list QtQuick.Particles2::Affector::particles Which logical particle groups will be affected. If empty, it will affect all particles. */ /*! \qmlproperty list QtQuick.Particles2::Affector::collisionParticles If any logical particle groups are specified here, then the affector will only be triggered if the particle being examined intersects with a particle of one of these groups. By default, no groups are specified. */ /*! \qmlproperty bool QtQuick.Particles2::Affector::active If active is set to false, this affector will not affect any particles. Usually this is used to conditionally turn an affector on or off. Default value is true. */ /*! \qmlproperty bool QtQuick.Particles2::Affector::onceOff If onceOff is set to true, this affector will only affect each particle once in their lifetimes. Default value is false. */ /*! \qmlproperty Shape QtQuick.Particles2::Affector::shape If a size has been defined, the shape property can be used to affect a non-rectangular area. */ /*! \qmlproperty bool QtQuick.Particles2::Affector::signal If this is set to true, then an affected(x,y) signal will be emitted each time this affector affects a particle. Default value is false. */ QSGParticleAffector::QSGParticleAffector(QSGItem *parent) : QSGItem(parent), m_needsReset(false), m_system(0), m_active(true) , m_updateIntSet(false), m_shape(new QSGParticleExtruder(this)), m_signal(false) { connect(this, SIGNAL(systemChanged(QSGParticleSystem*)), this, SLOT(updateOffsets())); connect(this, SIGNAL(xChanged()), this, SLOT(updateOffsets())); connect(this, SIGNAL(yChanged()), this, SLOT(updateOffsets()));//TODO: in componentComplete and all relevant signals } void QSGParticleAffector::componentComplete() { if (!m_system && qobject_cast(parentItem())) setSystem(qobject_cast(parentItem())); if (!m_system) qWarning() << "Affector created without a particle system specified";//TODO: useful QML warnings, like line number? QSGItem::componentComplete(); } void QSGParticleAffector::affectSystem(qreal dt) { if (!m_active) return; //If not reimplemented, calls affect particle per particle //But only on particles in targeted system/area if (m_updateIntSet){ m_groups.clear(); foreach (const QString &p, m_particles) m_groups << m_system->m_groupIds[p];//###Can this occur before group ids are properly assigned? m_updateIntSet = false; } foreach (QSGParticleGroupData* gd, m_system->m_groupData){ foreach (QSGParticleData* d, gd->data){ if (!d) continue; if (m_groups.isEmpty() || m_groups.contains(d->group)){ if ((m_onceOff && m_onceOffed.contains(qMakePair(d->group, d->index))) || !d->stillAlive()) continue; //Need to have previous location for affected. if signal || shape might be faster? QPointF curPos = QPointF(d->curX(), d->curY()); if (width() == 0 || height() == 0 || m_shape->contains(QRectF(m_offset.x(), m_offset.y(), width(), height()),curPos)){ if (m_collisionParticles.isEmpty() || isColliding(d)){ if (affectParticle(d, dt)){ m_system->m_needsReset << d; if (m_onceOff) m_onceOffed << qMakePair(d->group, d->index); if (m_signal) emit affected(curPos.x(), curPos.y()); } } } } } } } bool QSGParticleAffector::affectParticle(QSGParticleData *d, qreal dt) { Q_UNUSED(d); Q_UNUSED(dt); return m_signal;//If signalling, then we always 'null affect' it. } void QSGParticleAffector::reset(QSGParticleData* pd) {//TODO: This, among other ones, should be restructured so they don't all need to remember to call the superclass if (m_onceOff) if (m_groups.isEmpty() || m_groups.contains(pd->group)) m_onceOffed.remove(qMakePair(pd->group, pd->index)); } void QSGParticleAffector::updateOffsets() { if (m_system) m_offset = m_system->mapFromItem(this, QPointF(0, 0)); } bool QSGParticleAffector::isColliding(QSGParticleData *d) { qreal myCurX = d->curX(); qreal myCurY = d->curY(); qreal myCurSize = d->curSize()/2; foreach (const QString &group, m_collisionParticles){ foreach (QSGParticleData* other, m_system->m_groupData[m_system->m_groupIds[group]]->data){ if (!other->stillAlive()) continue; qreal otherCurX = other->curX(); qreal otherCurY = other->curY(); qreal otherCurSize = other->curSize()/2; if ((myCurX + myCurSize > otherCurX - otherCurSize && myCurX - myCurSize < otherCurX + otherCurSize) && (myCurY + myCurSize > otherCurY - otherCurSize && myCurY - myCurSize < otherCurY + otherCurSize)) return true; } } return false; } QT_END_NAMESPACE