File indexing completed on 2024-10-06 03:45:27

 /*
     This file is part of the KDE games kwin4 program
     SPDX-FileCopyrightText: 2006 Martin Heni <kde@heni-online.de>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #include "pixmapsprite.h"
 
 // own
 #include "kfourinline_debug.h"
 // KF
 #include <KConfig>
 #include <KConfigGroup>
 // Qt
 #include <QGraphicsScene>
 // Std
 #include <cmath>
 
 // Constructor for the sprite
 PixmapSprite::PixmapSprite(const QString &id, ThemeManager *theme, int no, QGraphicsScene *canvas)
     : Themeable(id, theme)
     , QGraphicsPixmapItem()
 {
     canvas->addItem(this);
     hide();
     setAcceptHoverEvents(false);
 
     mAnimationState = Idle;
     mNo = no;
     mCurrentFrame = 0;
     mOffsetStatus = true;
 
     if (theme)
         theme->updateTheme(this);
 }
 
 // Constructor for the sprite
 PixmapSprite::PixmapSprite(int no, QGraphicsScene *canvas)
     : Themeable()
     , QGraphicsPixmapItem()
 {
     canvas->addItem(this);
     hide();
 
     mAnimationState = Idle;
     mNo = no;
     mCurrentFrame = 0;
     mOffsetStatus = true;
 }
 
 // Main themeable function. Called for any theme change. The sprites needs to
 // resize and redraw here.
 void PixmapSprite::changeTheme()
 {
     // Clear data
     mFrames.clear();
     mHotspots.clear();
 
     // Get scaling change
     double oldscale = this->getScale();
     double scale = thememanager()->getScale();
     Themeable::setScale(scale);
 
     // Retrieve theme data from configuration
     KConfigGroup config = thememanager()->config(id());
     double width = config.readEntry("width", 1.0);
     double height = config.readEntry("height", 0.0);
     width *= scale;
     height *= scale;
     QPointF pos = config.readEntry("pos", QPointF(1.0, 1.0));
     pos *= scale;
     // Set fixed z value?
     if (config.hasKey("zValue")) {
         double zValue = config.readEntry("zValue", 0.0);
         setZValue(zValue);
     }
 
     // Centering
     bool center = config.readEntry("center", false);
 
     // Animation
     mStartFrame = config.readEntry("start-frame", 0);
     mEndFrame = config.readEntry("end-frame", 0);
     mDelay = config.readEntry("animation-delay", 0);
     QString refframe = config.readEntry("ref-frame", QString());
 
     // Set fixed position or modify current position
     if (config.hasKey("pos")) {
         setPos(pos.x(), pos.y());
     } else {
         setPos(x() * scale / oldscale, y() * scale / oldscale);
     }
 
     // SVG graphics
     QString svgid = config.readEntry("svgid");
     // Read sequence of frame pixmaps when auto ID given
     QPixmap pixmap;
     if (svgid == QLatin1String("auto")) {
         for (int i = mStartFrame; i <= mEndFrame; i++) {
             QString name = QStringLiteral("frame%1").arg(i);
             svgid = config.readEntry(name);
             QSize size;
             if (!refframe.isNull()) {
                 size = thememanager()->pixmapSize(svgid, refframe, width);
             } else if (config.hasKey("height")) {
                 size =QSize(int(width), int(height));
             } else {
                 size = thememanager()->pixmapSize(svgid, width);
             }
             pixmap = thememanager()->getPixmap(svgid, size);
             mFrames.append(pixmap);
             if (center)
                 mHotspots.append(QPointF(size.width() / 2, size.height() / 2));
             else
                 mHotspots.append(QPointF(0.0, 0.0));
         }
     }
     // Read only one named pixmap
     else {
         QSize size;
         if (config.hasKey("height")) {
             size = QSize(int(width), int(height));
         } else {
             size = thememanager()->pixmapSize(svgid, width);
         }
         pixmap = thememanager()->getPixmap(svgid, size);
         mFrames.append(pixmap);
         if (center)
             mHotspots.append(QPointF(size.width() / 2, size.height() / 2));
         else
             mHotspots.append(QPointF(0.0, 0.0));
     }
 
     // Set theme offset (probably not really necessary here)
     QPoint offset = thememanager()->getOffset();
     resetTransform();
     if (mOffsetStatus)
         setTransform(QTransform::fromTranslate(offset.x(), offset.y()), true);
 
     // Set pixmap to sprite
     setFrame(mCurrentFrame, true);
     update();
 }
 
 // Debug only: Retrieve double value from configuration file
 double PixmapSprite::getDoubleValue(const QString &item)
 {
     KConfigGroup config = thememanager()->config(id());
     return config.readEntry(item, 0.0);
 }
 
 // Move the sprite to the given relative position
 void PixmapSprite::setPosition(QPointF pos)
 {
     mStart = pos;
     setPos(mStart.x() * getScale(), mStart.y() * getScale());
 }
 
 // Handle the offset status (true: theme offset, false: no offset)
 void PixmapSprite::setOffsetStatus(bool status)
 {
     mOffsetStatus = status;
     changeTheme();
 }
 
 // Store the logical board coordinates for theme changes
 void PixmapSprite::setLogicalPos(QPoint pos)
 {
     mLPos = pos;
 }
 
 // Retrieve the logical board coordinates for theme changes
 QPoint PixmapSprite::logicalPos()
 {
     return mLPos;
 }
 
 // Start or stop a frame animation
 void PixmapSprite::setAnimation(bool status)
 {
     if (status)
         mAnimationState = Animated;
     else
         mAnimationState = Idle;
     mTime.start();
     setFrame(mStartFrame);
 }
 
 // Specify and start a frame animation
 void PixmapSprite::setAnimation(int start, int end, int delay)
 {
     mDelay = delay;
     mStartFrame = start;
     mEndFrame = end;
     setAnimation(true);
 }
 
 // Set a new bitmap into the sprite. If the number is the same as the
 // current one, nothing is done unless forcing is set to true.
 void PixmapSprite::setFrame(int no, bool force)
 {
     if (!force && no == mCurrentFrame)
         return;
     if (no < 0 || no >= mFrames.count())
         return;
     setPixmap(mFrames.at(no));
 
     QPoint offset = thememanager()->getOffset();
 
     // Set new item's scene transformation: Hotspot plus global theme offset
     resetTransform();
     if (mOffsetStatus) {
         setTransform(QTransform::fromTranslate(-mHotspots.at(no).x() + offset.x(), -mHotspots.at(no).y() + offset.y()), true);
     } else {
         setTransform(QTransform::fromTranslate(-mHotspots.at(no).x(), -mHotspots.at(no).y()), true);
     }
     mCurrentFrame = no;
     update();
 }
 
 // Standard QGI advance method
 void PixmapSprite::advance(int phase)
 {
     int elapsed = mTime.elapsed();
 
     // Ignore phase 0 (collisions)
     if (phase == 0) {
         QGraphicsItem::advance(phase);
         return;
     }
 
     // Handle animation
     if (mAnimationState == Animated) {
         // Frame delay passed?
         int frames = elapsed / mDelay;
         int curFrame = frames % (mEndFrame - mStartFrame) + mStartFrame;
         setFrame(curFrame);
     }
 
     QGraphicsItem::advance(phase);
 }