30f07bb62c
the idea is that you register an element animation and get back an id. you can associate a pixmap with that id and off you go. the item gets update() calls whenever the anim changes and you can fetch your precious little pixmap back with a call to animationResult. svn path=/trunk/KDE/kdebase/workspace/libs/plasma/; revision=677782
115 lines
2.7 KiB
C++
115 lines
2.7 KiB
C++
/*
|
|
* Copyright (C) 2007 Aaron Seigo <aseigo@kde.org>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU Library General Public License version 2 as
|
|
* published by the Free Software Foundation
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this program; if not, write to the
|
|
* Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef PHASE_H
|
|
#define PHASE_H
|
|
|
|
#include <QImage>
|
|
#include <QObject>
|
|
|
|
#include <plasma/plasma_export.h>
|
|
|
|
class QGraphicsItem;
|
|
class QTimeLine;
|
|
|
|
namespace Plasma
|
|
{
|
|
|
|
/**
|
|
* @short A system for applying effects to Plasma elements
|
|
*/
|
|
class PLASMA_EXPORT Phase : public QObject
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
enum Animation
|
|
{
|
|
Appear = 0 /*<< When some appears in the Corona */,
|
|
Disappear /*<< When something is about to disappear */,
|
|
Activate /*<< When something is activated or launched, such as an app icon being clicked */,
|
|
FrameAppear /*<< Make a frame appear around an object */
|
|
};
|
|
|
|
enum ElementAnimation
|
|
{
|
|
ElementAppear = 0,
|
|
ElementDisappear
|
|
};
|
|
|
|
enum RenderOp
|
|
{
|
|
RenderBackground = 0 /*<< Render the background of an item */
|
|
};
|
|
|
|
typedef int AnimId;
|
|
|
|
/**
|
|
* Singleton accessor
|
|
**/
|
|
static Phase* self();
|
|
|
|
explicit Phase(QObject * parent = 0);
|
|
~Phase();
|
|
|
|
AnimId startElementAnimation(QGraphicsItem *obj, ElementAnimation);
|
|
void stopElementAnimation(AnimId id);
|
|
void setAnimationPixmap(AnimId id, const QPixmap &pixmap);
|
|
QPixmap animationResult(AnimId id);
|
|
|
|
Q_SIGNALS:
|
|
void animationComplete(QGraphicsItem *item, Animation anim);
|
|
|
|
public Q_SLOTS:
|
|
void animate(QGraphicsItem* item, Animation anim);
|
|
void render(QGraphicsItem* item, QImage& image, RenderOp op);
|
|
|
|
protected Q_SLOTS:
|
|
void appletDestroyed(QObject*);
|
|
|
|
void advanceFrame(int frame, QTimeLine* timeLine);
|
|
void advanceElementFrame(int frame);
|
|
void advanceElementFrame(int frame, AnimId id);
|
|
|
|
/**
|
|
* NEVER call this method directly, as it relies on sender()
|
|
*/
|
|
void advanceFrame(int frame);
|
|
|
|
/**
|
|
* NEVER call this method directly, as it relies on sender()
|
|
*/
|
|
void animationComplete();
|
|
|
|
/**
|
|
* NEVER call this method directly, as it relies on sender()
|
|
*/
|
|
void elementAnimationComplete();
|
|
|
|
private:
|
|
void init();
|
|
|
|
class Private;
|
|
Private * const d;
|
|
};
|
|
|
|
} // namespace Plasma
|
|
|
|
#endif
|
|
|