kbbtutorial.h

Go to the documentation of this file.

//
// KBlackBox
//
// A simple game inspired by an emacs module
//
/***************************************************************************
 *   Copyright (c) 2007, Nicolas Roffet                                    *
 *   nicolas-kde@roffet.com                                                *
 *                                                                         *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   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 General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA               *
 ***************************************************************************/

#ifndef KBBTUTORIAL_H
#define KBBTUTORIAL_H



#include <QGroupBox>
class QHideEvent;
class QLabel;
class QProgressBar;
class QWidget;


class KPushButton;
class KTextEdit;


class KBBGraphicsItemTutorialMarker;
class KBBScalableGraphicWidget;



class KBBTutorial : public QGroupBox
{
    Q_OBJECT

    public:
        static int const BALLS = 3;

        static int const COLUMNS = 6;

        static int const ROWS = 6;


        explicit KBBTutorial(QWidget* parent);


        void hideEvent(QHideEvent*);

        bool maySolve();

        bool mayShootRay(const int incomingPosition);

        void setGameWidget(KBBScalableGraphicWidget* gameWidget, KBBGraphicsItemTutorialMarker* marker);

        void setStep(const int step);

        void start();


    private slots:
        void nextStep();

        void previousStep();

        void restoreStyle();


    private:
        static int const FIRST_STEP = 1;

        static int const HIGHLIGHT_TIME = 600;

        static int const LAST_STEP = 11;

        static int const MAY_NOT_USE = -1;

        static int const WIDTH = 275;


        void setNewStepMaxAllowed(const int newStepMax);

        void setTexts(const QString &title, const QString &text, const QString &action);

        void showMarker(const int laserPosition) const;


        KPushButton* m_buttonNext;
        KPushButton* m_buttonPrevious;
        KTextEdit* m_explanation;
        KBBScalableGraphicWidget* m_gameWidget;
        int m_laserToUse;
        KBBGraphicsItemTutorialMarker* m_marker;
        QLabel* m_playerAction;
        QProgressBar* m_progression;

        int m_step;

        int m_stepMaxAllowed;
        QLabel* m_title;
};

#endif //KBBTUTORIAL_H