File indexing completed on 2024-10-13 03:43:42

 /*
     SPDX-FileCopyrightText: 2012 Roney Gomes <roney477@gmail.com>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #include <KLocalizedString>
 
 #include <QFont>
 #include <QTimeLine>
 
 #include "kgoldrunner_debug.h"
 #include "kgrview.h"
 #include "kgrscene.h"
 #include "kgrsprite.h"
 #include "kgrrenderer.h"
 
 const StartFrame animationStartFrames [nAnimationTypes] = {
                  RIGHTWALK1,    LEFTWALK1,  RIGHTCLIMB1,    LEFTCLIMB1,
                  CLIMB1,        CLIMB1,     FALL1,          FALL2,
                  DIGBRICK1, // Start frame for OPEN_BRICK.
                  DIGBRICK6};    // Start frame for CLOSE_BRICK.
 
 KGrScene::KGrScene      (KGrView * view)
     :
     QGraphicsScene      (view),
     // Allow FIELDWIDTH * FIELDHEIGHT tiles for the KGoldruner level-layouts,
     // plus 2 more tile widths all around for text areas, frame and spillover
     // for mouse actions (to avoid accidental clicks affecting the desktop).
     m_view              (view),
     m_background        (nullptr),
     m_level             (1),
     m_title             (nullptr),
     m_replayMessage     (nullptr),
     m_livesText         (nullptr),
     m_scoreText         (nullptr),
     m_hasHintText       (nullptr),
     m_pauseResumeText   (nullptr),
     m_heroId            (0),
     m_tilesWide         (FIELDWIDTH  + 2 * 2),
     m_tilesHigh         (FIELDHEIGHT + 2 * 2),
     m_tileSize          (10),
     m_toolbarTileSize   (10),
     m_themeChanged      (true),
     m_topLeftX          (0),
     m_topLeftY          (0),
     m_mouse             (new QCursor()),
     m_fadingTimeLine    (new QTimeLine (1000, this))
 {
     setItemIndexMethod(NoIndex);
 
     m_tiles.fill        (nullptr,     m_tilesWide * m_tilesHigh);
     m_tileTypes.fill    (FREE,  m_tilesWide * m_tilesHigh);
 
     m_renderer  = new KGrRenderer (this);
 
     m_frame = addRect (0, 0, 100, 100);     // Create placeholder for frame.
     m_frame->setVisible (false);
 
     m_spotlight = addRect (0, 0, 100, 100); // Create placeholder for spot.
     m_spotlight->setVisible (false);
 
     m_title = new QGraphicsSimpleTextItem();
     addItem (m_title);
 
     m_replayMessage = new QGraphicsSimpleTextItem();
     addItem (m_replayMessage);
     m_replayMessage->setVisible (false);    // Visible only in demo/replay.
 
     m_livesText = new QGraphicsSimpleTextItem();
     addItem (m_livesText);
 
     m_scoreText = new QGraphicsSimpleTextItem();
     addItem (m_scoreText);
 
     m_hasHintText = new QGraphicsSimpleTextItem();
     addItem (m_hasHintText);
 
     m_pauseResumeText = new QGraphicsSimpleTextItem();
     addItem (m_pauseResumeText);
 
     m_fadingTimeLine->setEasingCurve(QEasingCurve::OutCurve);
     m_fadingTimeLine->setUpdateInterval (50);
     connect(m_fadingTimeLine, &QTimeLine::valueChanged, this, &KGrScene::drawSpotlight);
     connect(m_fadingTimeLine, &QTimeLine::finished, this, &KGrScene::fadeFinished);
 }
 
 KGrScene::~KGrScene()
 {
     delete m_mouse;
     delete m_fadingTimeLine;
 }
 
 void KGrScene::redrawScene ()
 {
     //qCDebug(KGOLDRUNNER_LOG) << "REDRAW: m_sizeChanged" << m_sizeChanged << "m_themeChanged" << m_themeChanged;
     bool redrawToolbar = false;
     if (m_sizeChanged) {
         // Calculate what size of tile will fit in the view.
         QSize size      = m_view->size();
         int tileSize    = qMin (size.width()  / m_tilesWide,
                                 size.height() / m_tilesHigh);
         m_topLeftX   = (size.width()  - m_tilesWide * tileSize)/2.0;
         m_topLeftY   = (size.height() - m_tilesHigh * tileSize)/2.0;
         setSceneRect   (0, 0, size.width(), size.height());
     //qCDebug(KGOLDRUNNER_LOG) << "SIZE" << size << "TL" << m_topLeftX << m_topLeftY << "TILE" << tileSize << "was" << m_tileSize << m_toolbarTileSize;
 
         // Make the fade-out/fade-in rectangle cover the playing area.
         m_spotlight->setRect (m_topLeftX + 2 * tileSize - 1,
                               m_topLeftY + 2 * tileSize - 1,
                               (m_tilesWide - 4) * tileSize + 2,
                               (m_tilesHigh - 4) * tileSize + 2);
         m_maxRadius = (5 * m_spotlight->rect().width() + 4) / 8;
         m_spotlight->setPen (Qt::NoPen);
         m_spotlight->setZValue (10);
         m_spotlight->setVisible (false);
 
         // Set up the gradient to draw the spotlight (black with a hole in it).
         QPointF center        (width() * 0.5, height() * 0.5);
         m_gradient.setCenter  (center);
         m_gradient.setFocalPoint (center);
         m_gradient.setRadius  (m_maxRadius);
         m_gradient.setColorAt (1.00, QColor (0, 0, 0, 255));
         m_gradient.setColorAt (0.85, QColor (0, 0, 0, 0));
 
         int index = 0;
         for (KGameRenderedItem * tile : std::as_const(m_tiles)) {
             if (tile) {
                 setTile (tile, tileSize, index/m_tilesHigh, index%m_tilesHigh);
             }
             index++;
         }
         for (KGrSprite * sprite : std::as_const(m_sprites)) {
             if (sprite) {
                 sprite->changeCoordinateSystem
                         (m_topLeftX, m_topLeftY, tileSize);
             }
         }
 
         if (m_tileSize != tileSize) {
             // Do not expand the toolbar (in edit mode) until there is room for
             // it.  This avoids a nasty expand-contract-expand-contract loop.
             m_toolbarTileSize = ((tileSize > m_tileSize) && (m_topLeftY == 0)) ?
                                   m_tileSize : tileSize;
         }
         // When conditions are right, redraw editing icons, if in edit mode.
         redrawToolbar = ((m_toolbarTileSize != m_tileSize) &&
                          (m_topLeftY > 0)) ? true : false;
         m_tileSize = tileSize;
         m_sizeChanged = false;
     }
 
     // Re-draw text, background and frame if either scene-size or theme changes.
 
     // Resize and draw texts for title, score, lives, hasHint and pauseResume.
     setTextFont (m_title, 0.6);
     setTitle (m_title->text());
     placeTextItems();
 
     // Resize and draw different backgrounds, depending on the level and theme.
     loadBackground (m_level);
 
     if (m_renderer->hasBorder()) {
         // There are border tiles in the theme, so do not draw a frame.
         m_frame->setVisible (false);
     }
     else {
         // There are no border tiles, so draw a frame around the board.
         drawFrame();
     }
 
     if (m_themeChanged) {
         // Fill the scene (and view) with the new background color.  Do this
         // even if the background has no border, to avoid ugly white rectangles
         // appearing if rendering and painting is momentarily a bit slow.
         setBackgroundBrush (m_renderer->borderColor());
 
     // Erase border tiles (if any) and draw new ones, if new theme has them.
         drawBorder();
 
         // Redraw all the tiles, except for borders and tiles of type FREE.
         for (int i = 1; i <= FIELDWIDTH; i++) {
             for (int j = 1; j <= FIELDHEIGHT; j++) {
                 int index = i * m_tilesHigh + j;
                 paintCell (i, j, m_tileTypes[index]);
             }
         }
 
         // Redraw editing icons if theme changes when in edit mode.
         redrawToolbar = true;
         m_themeChanged = false;
     }
 
     if (redrawToolbar) {
         m_toolbarTileSize = m_tileSize; // If game is in edit mode, KGoldrunner
         Q_EMIT redrawEditToolbar(); // object redraws the editToolbar.
     }
 }
 
 void KGrScene::changeTheme()
 {
     m_themeChanged = true;
     redrawScene();
 }
 
 void KGrScene::changeSize()
 {
     m_sizeChanged = true;
     redrawScene();
 }
 
 void KGrScene::setTitle (const QString & newTitle)
 {
     if (! m_title) return;
 
     m_title->setText (newTitle);
     QRectF r = m_title->boundingRect();     // Centre the title.
     m_title->setPos ((sceneRect().width() - r.width())/2,
                       m_topLeftY + (m_tileSize - r.height())/2);
 }
 
 void KGrScene::setReplayMessage (const QString & msg)
 {
     m_replayMessage->setText (msg);
 }
 
 void KGrScene::showReplayMessage (bool onOff)
 {
     m_replayMessage->setVisible (onOff);
 }
 
 void KGrScene::placeTextItems()
 {
     setTextFont (m_replayMessage, 0.5);
     setTextFont (m_livesText, 0.5);
     setTextFont (m_scoreText, 0.5);
     setTextFont (m_hasHintText, 0.5);
     setTextFont (m_pauseResumeText, 0.5);
 
     QRectF r = m_replayMessage->boundingRect();
     m_replayMessage->setPos ((sceneRect().width() - r.width())/2,
                               m_topLeftY + 1.4 * m_tileSize - 0.5 * r.height());
     m_replayMessage->setZValue (10);
 
     qreal totalWidth = 0.0;
     r = m_livesText->boundingRect();
     qreal x = m_topLeftX + 2 * m_tileSize;
     qreal y = sceneRect().height() - m_topLeftY - (m_tileSize + r.height())/2;
 
     m_livesText->setPos (x, y);
     totalWidth += r.width();
 
     r = m_scoreText->boundingRect();
     m_scoreText->setPos (x + totalWidth, y);
     totalWidth += r.width();
 
     r = m_hasHintText->boundingRect();
     m_hasHintText->setPos (x + totalWidth, y);
     totalWidth += r.width();
 
     r = m_pauseResumeText->boundingRect();
     m_pauseResumeText->setPos (x + totalWidth, y);
     totalWidth += r.width();
 
     qreal spacing = ((m_tilesWide - 4) * m_tileSize - totalWidth) / 3.0;
     if (spacing < 0.0)
         return;
 
     m_scoreText->moveBy (spacing, 0.0);
     m_hasHintText->moveBy (2.0 * spacing, 0.0);
     m_pauseResumeText->moveBy (3.0 * spacing, 0.0);
 }
 
 void KGrScene::showLives (long lives)
 {
     if (m_livesText)
         m_livesText->setText (i18n("Lives: %1", QString::number(lives)
                                                 .rightJustified(3, QLatin1Char('0'))));
 }
 
 void KGrScene::showScore (long score)
 {
     if (m_scoreText)
         m_scoreText->setText (i18n("Score: %1", QString::number(score)
                                                 .rightJustified(7, QLatin1Char('0'))));
 }
 
 void KGrScene::setHasHintText (const QString & msg)
 {
     if (m_hasHintText)
         m_hasHintText->setText (msg);
 }
 
 void KGrScene::setPauseResumeText (const QString & msg)
 {
     if (m_pauseResumeText)
         m_pauseResumeText->setText (msg);
 }
 
 void KGrScene::goToBlack()
 {
         drawSpotlight (0);
 }
 
 void KGrScene::fadeIn (bool inOut)
 {
     // For fade-in,  inOut = true,  circle opens,  from 0.0 to 1.0.
     // For fade-out, inOut = false, circle closes, from 1.0 to 0.0.
     m_fadingTimeLine->setDirection (inOut ? QTimeLine::Forward
                                          : QTimeLine::Backward);
     m_fadingTimeLine->start();
 }
 
 void KGrScene::drawSpotlight (qreal ratio)
 {
     if (ratio > 0.99) {
     m_spotlight->setVisible (false);    // End of the close-open cycle.
     return;
     }
     else if (ratio <= 0.01) {
     m_spotlight->setBrush (Qt::black);
     }
     else {
         m_gradient.setRadius (ratio * m_maxRadius);
         m_spotlight->setBrush (QBrush (m_gradient));
     }
 
     m_spotlight->setVisible (true);
 }
 
 void KGrScene::setLevel (unsigned int level)
 {
     if (level == m_level) {
         return;
     }
     m_level = level;
     loadBackground (level); // Load background for level.
 }
 
 void KGrScene::loadBackground (const int level)
 {
     // NOTE: The background picture can be the same size as the level-layout (as
     // in the Egypt theme) OR it can be the same size as the entire viewport.
     // In this example the background is fitted into the level-layout.
     m_background = m_renderer->getBackground (level, m_background);
 
     m_background->setRenderSize (QSize ((m_tilesWide - 4) * m_tileSize,
                                         (m_tilesHigh - 4) * m_tileSize));
     m_background->setPos    (m_topLeftX + 2 * m_tileSize,
                              m_topLeftY + 2 * m_tileSize);
     // Keep the background behind the level layout.
     m_background->setZValue (-1);
 }
 
 void KGrScene::setTile (KGameRenderedItem * tile, const int tileSize,
                         const int i, const int j)
 {
     tile->setRenderSize (QSize (tileSize, tileSize));
     tile->setPos (m_topLeftX + (i+1) * tileSize, m_topLeftY + (j+1) * tileSize);
 }
 
 void KGrScene::setBorderTile (const QString &spriteKey, const int x, const int y)
 {
     int index               = x * m_tilesHigh + y;
     KGameRenderedItem * t   = m_renderer->getBorderItem (spriteKey,
                                                          m_tiles.at(index));
     m_tiles[index]          = t;
 
     if (t) {
         setTile (t, m_tileSize, x, y);
     }
 }
 
 void KGrScene::drawBorder()
 {
     // Corners.
     setBorderTile (QStringLiteral("frame-topleft"), 0, 0);
     setBorderTile (QStringLiteral("frame-topright"), FIELDWIDTH + 1, 0);
     setBorderTile (QStringLiteral("frame-bottomleft"), 0, FIELDHEIGHT + 1);
     setBorderTile (QStringLiteral("frame-bottomright"), FIELDWIDTH + 1, FIELDHEIGHT + 1);
 
     // Upper side.
     for (int i = 1; i <= FIELDWIDTH; i++)
         setBorderTile (QStringLiteral("frame-top"), i, 0);
 
     // Lower side.
     for (int i = 1; i <= FIELDWIDTH; i++)
         setBorderTile (QStringLiteral("frame-bottom"), i, FIELDHEIGHT + 1);
 
     // Left side.
     for (int i = 1; i <= FIELDHEIGHT; i++)
         setBorderTile (QStringLiteral("frame-left"), 0, i);
 
     // Right side.
     for (int i = 1; i <= FIELDHEIGHT; i++)
         setBorderTile (QStringLiteral("frame-right"), FIELDWIDTH + 1, i);
 }
 
 void KGrScene::drawFrame()
 {
     int w = 0.05 * m_tileSize + 0.5;
     w = w < 1 ? 1 : w;
     m_frame->setRect (
     m_topLeftX + (2 * m_tileSize) - (3 * w),
     m_topLeftY + (2 * m_tileSize) - (3 * w),
     FIELDWIDTH  * m_tileSize + 6 * w,
     FIELDHEIGHT * m_tileSize + 6 * w);
     //qCDebug(KGOLDRUNNER_LOG) << "FRAME WIDTH" << w << "tile size" << m_tileSize << "rectangle" << m_frame->rect();
     QPen pen = QPen (m_renderer->textColor());
     pen.setWidth (w);
     m_frame->setPen (pen);
     m_frame->setVisible (true);
 }
 
 void KGrScene::paintCell (const int i, const int j, const char type)
 {
     int index               = i * m_tilesHigh + j;
     KGameRenderedItem * t   = m_renderer->getTileItem (type, m_tiles.at(index));
     m_tiles[index]          = t;
     m_tileTypes[index]      = type;
 
     if (t) {
         setTile (t, m_tileSize, i, j);
     }
 }
 
 int KGrScene::makeSprite (const char type, int i, int j)
 {
     int spriteId;
     KGrSprite * sprite = m_renderer->getSpriteItem (type, TickTime);
 
     if (m_sprites.count(nullptr) > 0 &&
         ((spriteId = m_sprites.lastIndexOf (nullptr)) >= 0)) {
         // Re-use a slot previously occupied by a transient member of the list.
         m_sprites[spriteId] = sprite;
     }
     else {
         // Otherwise, add to the end of the list.
         spriteId = m_sprites.count();
         m_sprites.append (sprite);
     }
 
     int frame1 = animationStartFrames [FALL_L];
 
     switch (type) {
     case HERO:
         m_heroId = spriteId;
         sprite->setZ (1);
         break;
     case ENEMY:
         sprite->setZ (2);
         break;
     case BRICK:
         frame1 = animationStartFrames [OPEN_BRICK];
 
         // The hero and enemies must be painted in front of dug bricks.
         sprite->setZ (0);
 
         // Erase the brick-image so that animations are visible in all themes.
         paintCell (i, j, FREE);
         break;
     default:
         break;
     }
 
     sprite->setFrame (frame1);
     sprite->setCoordinateSystem (m_topLeftX, m_topLeftY, m_tileSize);
     addItem (sprite);       // The sprite can be correctly rendered now.
     sprite->move (i, j, frame1);
     return spriteId;
 }
 
 void KGrScene::animate (bool missed)
 {
     for (KGrSprite * sprite : std::as_const(m_sprites)) {
         if (sprite != nullptr) {
             sprite->animate (missed);
         }
     }
 }
 
 void KGrScene::startAnimation (const int id, const bool repeating,
                                 const int i, const int j, const int time,
                                 const Direction dirn, const AnimationType type)
 {
     // TODO - Put most of this in helper code, based on theme parameters.
     int dx              = 0;
     int dy              = 0;
     int frame           = animationStartFrames [type];
     int nFrames         = 8;
     int nFrameChanges   = 4;
 
     switch (dirn) {
     case RIGHT:
         dx    = +1;
         break;
     case LEFT:
         dx    = -1;
         break;
     case DOWN:
         dy = +1;
         if ((type == FALL_R) || (type == FALL_L)) {
             nFrames = 1;
         }
         else {
             nFrames = 2;
         }
         break;
     case UP:
         dy = -1;
         nFrames = 2;
         break;
     case STAND:
         switch (type) {
         case OPEN_BRICK:
             nFrames = 5;
             break;
         case CLOSE_BRICK:
             nFrames = 4;
             break;
         default:
             // Show a standing hero or enemy, using the previous StartFrame.
             nFrames = 0; 
             break;
         }
         break;
     default:
         break;
     }
 
     // TODO - Generalise nFrameChanges = 4, also the tick time = 20 new sprite.
     m_sprites.at(id)->setAnimation (repeating, i, j, frame, nFrames, dx, dy,
                                     time, nFrameChanges);
 }
 
 void KGrScene::gotGold (const int spriteId, const int i, const int j,
                         const bool spriteHasGold, const bool lost)
 {
     // Hide collected gold or show dropped gold, but not if the gold was lost.
     if (! lost) {
         paintCell (i, j, (spriteHasGold) ? FREE : NUGGET);
     }
 
     // If the rules allow, show whether or not an enemy sprite is carrying gold.
     if (enemiesShowGold && (m_sprites.at(spriteId)->spriteType() == ENEMY)) {
         m_sprites.at(spriteId)->setSpriteKey (spriteHasGold ? QStringLiteral("gold_enemy")
                                                             : QStringLiteral("enemy"));
     }
 }
 
 void KGrScene::showHiddenLadders (const QList<int> & ladders, const int width)
 {
     for (const int &offset : ladders) {
         int i = offset % width;
         int j = offset / width;
         paintCell (i, j, LADDER);
     }
 }
 
 void KGrScene::deleteSprite (const int spriteId)
 {
     QPointF loc     = m_sprites.at(spriteId)->currentLoc();
     bool   brick    = (m_sprites.at(spriteId)->spriteType() == BRICK);
 
     delete m_sprites.at(spriteId);
     m_sprites [spriteId] = nullptr;
 
     if (brick) {
         // Dug-brick sprite erased: restore the tile that was at that location.
         paintCell (loc.x(), loc.y(), BRICK);
     }
 }
 
 void KGrScene::deleteAllSprites()
 {
     qDeleteAll(m_sprites);
     m_sprites.clear();
 }
 
 void KGrScene::preRenderSprites()
 {
     char type[2] = {HERO, ENEMY};
     for (int t = 0; t < 2; t++) {
         KGrSprite * sprite = m_renderer->getSpriteItem (type[t], TickTime);
         sprite->setFrame (1);
         sprite->setRenderSize (QSize (m_tileSize, m_tileSize));
         int count = sprite->frameCount();
 
         // Pre-render all frames of the hero and an enemy, to avoid hiccups in
         // animation during the first few seconds of KGoldrunner execution.
         for (int n = 1; n <= count; n++) {
             sprite->setFrame (n);
         }
         delete sprite;
     }
 }
 
 void KGrScene::setMousePos (const int i, const int j)
 {
     m_mouse->setPos (m_view->mapToGlobal (QPoint (
                      m_topLeftX + (i + 1) * m_tileSize + m_tileSize/2,
                      m_topLeftY + (j + 1) * m_tileSize + m_tileSize/2)));
 }
 
 void KGrScene::getMousePos (int & i, int & j)
 {
     QPoint pos = m_view->mapFromGlobal (m_mouse->pos());
     i = pos.x();
     j = pos.y();
     if (! m_view->isActiveWindow()) {
         i = -2;
     j = -2;
     return;
     }
     // IDW TODO - Check for being outside scene. Use saved m_width and m_height.
 
     i = (i - m_topLeftX)/m_tileSize - 1;
     j = (j - m_topLeftY)/m_tileSize - 1;
 
     // Make sure i and j are within the KGoldrunner playing area.
     i = (i < 1) ? 1 : ((i > FIELDWIDTH)  ? FIELDWIDTH  : i);
     j = (j < 1) ? 1 : ((j > FIELDHEIGHT) ? FIELDHEIGHT : j);
 }
 
 void KGrScene::setTextFont (QGraphicsSimpleTextItem * t, double fontFraction)
 {
     QFont f;
     f.setPixelSize ((int) (m_tileSize * fontFraction + 0.5));
     f.setWeight (QFont::Bold);
     f.setStretch (QFont::Expanded);
     t->setBrush (m_renderer->textColor());
     t->setFont (f);
 }
 
 #include "moc_kgrscene.cpp"