/**************************************************************************** ** ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** This file is part of the Qt Mobility Components. ** ** $QT_BEGIN_LICENSE:LGPL$ ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** 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, Digia gives you certain additional ** rights. These rights are described in the Digia 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. ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qdeclarativehapticseffect_p.h" /*! \qmlclass HapticsEffect \brief The HapticsEffect element represents a custom haptic feedback effect. \ingroup qml-feedback-api \inherits FeedbackEffect \since Mobility 1.1 This element is part of the \bold {QtMobility.feedback 1.1} module. This class closely corresponds to the C++ \l QFeedbackHapticsEffect class. \snippet doc/src/snippets/declarative/declarative-feedback.qml Haptics Effect \sa Actuator, QFeedbackHapticsEffect */ QDeclarativeHapticsEffect::QDeclarativeHapticsEffect(QObject *parent) : QDeclarativeFeedbackEffect(parent), m_actuator(0) { d = new QFeedbackHapticsEffect(this); setFeedbackEffect(d); QFeedbackActuator* fa = d->actuator(); QList actuators = QFeedbackActuator::actuators(); foreach (QFeedbackActuator* actuator, actuators) { QDeclarativeFeedbackActuator* dfa; dfa = new QDeclarativeFeedbackActuator(this, actuator); if (fa && *fa == *actuator) { m_actuator = dfa; } m_actuators.push_back(dfa); } } void QDeclarativeHapticsEffect::setDuration(int msecs) { if (msecs != d->duration()) { d->setDuration(msecs); emit durationChanged(); } } int QDeclarativeHapticsEffect::duration() const { return d->duration(); } /*! \qmlproperty double HapticsEffect::intensity The intensity of the main part of the haptics effect, from 0.0 to 1.0. \since Mobility 1.1 */ void QDeclarativeHapticsEffect::setIntensity(qreal intensity) { qreal newIntensity = intensity + 1.0; qreal oldIntensity = d->intensity() + 1.0; if (!qFuzzyCompare(newIntensity, oldIntensity)) { d->setIntensity(intensity); emit intensityChanged(); } } qreal QDeclarativeHapticsEffect::intensity() const { return d->intensity(); } /*! \qmlproperty int HapticsEffect::attackTime The duration of the attack (fade-in) part of the haptics effect. \since Mobility 1.1 */ void QDeclarativeHapticsEffect::setAttackTime(int msecs) { if (msecs != d->attackTime()) { d->setAttackTime(msecs); emit attackTimeChanged(); } } int QDeclarativeHapticsEffect::attackTime() const { return d->attackTime(); } /*! \qmlproperty double HapticsEffect::attackIntensity \since Mobility 1.1 The intensity of the attack (fade-in) part of the haptics effect, from 0.0 to 1.0. */ void QDeclarativeHapticsEffect::setAttackIntensity(qreal intensity) { if (qFuzzyCompare(intensity, d->attackIntensity())) { d->setAttackIntensity(intensity); emit intensityChanged(); } } qreal QDeclarativeHapticsEffect::attackIntensity() const { return d->attackIntensity(); } /*! \qmlproperty int HapticsEffect::fadeTime \since Mobility 1.1 The duration of the fade-out part of the haptics effect. */ void QDeclarativeHapticsEffect::setFadeTime(int msecs) { if (msecs != d->fadeTime()) { d->setFadeTime(msecs); emit fadeTimeChanged(); } } int QDeclarativeHapticsEffect::fadeTime() const { return d->fadeTime(); } void QDeclarativeHapticsEffect::setFadeIntensity(qreal intensity) { if (qFuzzyCompare(intensity, d->fadeIntensity())) { d->setFadeIntensity(intensity); emit fadeIntensityChanged(); } } /*! \qmlproperty double HapticsEffect::fadeIntensity \since Mobility 1.1 The intensity of the fade-out part of the haptics effect, from 0.0 to 1.0. */ qreal QDeclarativeHapticsEffect::fadeIntensity() const { return d->fadeIntensity(); } /*! \qmlproperty int HapticsEffect::period \since Mobility 1.1 The period of the haptics effect. If the period is zero, the effect will not repeat. If it is non-zero, the effect will repeat every period milliseconds. */ void QDeclarativeHapticsEffect::setPeriod(int msecs) { if (msecs != d->period()) { d->setPeriod(msecs); emit periodChanged(); } } int QDeclarativeHapticsEffect::period() const { return d->period(); } /*! \qmlproperty Actuator HapticsEffect::actuator \since Mobility 1.1 The actuator that is used for playing this effect. \sa Actuator */ void QDeclarativeHapticsEffect::setActuator(QDeclarativeFeedbackActuator *actuator) { if (actuator != m_actuator) { if (!actuator || !m_actuator || !(*(actuator->feedbackActuator()) == *(m_actuator->feedbackActuator()))) { m_actuator = actuator; d->setActuator(m_actuator ? m_actuator->feedbackActuator() : 0); emit actuatorChanged(); } } } QDeclarativeFeedbackActuator* QDeclarativeHapticsEffect::actuator() const { return m_actuator; } /*! \qmlproperty list HapticsEffect::availableActuators \since Mobility 1.1 This property holds a list of available actuators. This property is read only. \sa Actuator */ QDeclarativeListProperty QDeclarativeHapticsEffect::availableActuators() { return QDeclarativeListProperty(this, 0, 0 /*appending actuators are not allowed*/, actuator_count, actuator_at, 0 /*removing actuators are not allowed*/); } int QDeclarativeHapticsEffect::actuator_count(QDeclarativeListProperty *prop) { return static_cast(prop->object)->m_actuators.size(); } QDeclarativeFeedbackActuator* QDeclarativeHapticsEffect::actuator_at(QDeclarativeListProperty *prop, int index) { return static_cast(prop->object)->m_actuators.at(index); }