shared-libraries/ScStwLibraries/headers/scstwrace.h

/****************************************************************************
 ** ScStw Libraries
 ** Copyright (C) 2020  Itsblue development
 **
 ** 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 3 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, see <http://www.gnu.org/licenses/>.
 ****************************************************************************/

#ifndef SCSTWRACE_H
#define SCSTWRACE_H

#include <QObject>
#include <QDebug>
#include <QTimer>
#include <QEventLoop>
#include "scstwtimer.h"
#include "scstwsoundplayer.h"

/*!
 * \brief The ScStwRace class can be used to measure timings of climbing races with multiple lanes at once.
 *
 * The ScStwRace is a container to manage multiple timers at a time and introduces a propper start sequence
 * with start commands ('At your Marks' and 'Ready') and the official IFSC start signal.
 *
 * ## Basic usage:
 *
 * \code
 * ScStwRace race;
 *
 * // add two timers
 * race.addTimer(new ScStwTimer());
 * race.addTimer(new ScStwTimer());
 *
 * // start a race
 * race.start();
 * \endcode
 *
 */
class ScStwRace : public QObject
{
    Q_OBJECT
    Q_PROPERTY(RaceState state READ getState NOTIFY stateChanged)
    Q_PROPERTY(QVariantList timers READ getTimerDetailList NOTIFY  timersChanged)
    Q_PROPERTY(QVariantList nextStartActionDetails READ getNextStartActionDetails NOTIFY nextStartActionDetailsChanged)

public:
    explicit ScStwRace(QObject *parent = nullptr);

    enum RaceState { IDLE, STARTING, WAITING, RUNNING, STOPPED };
    // will become IDLE, PREPAIRING, WAITING, STARTING, RUNNING, STOPPED later
    Q_ENUM(RaceState)

    enum StartAction { None = -1, AtYourMarks = 0, Ready = 1, Start = 2 };
    Q_ENUM(StartAction)

    enum NextStartActionDetailAttributes {
        NextStartAction = 0,
        NextStartActionTotalDelay = 1,
        NextStartActionDelayProgress = 2
    };
    Q_ENUM(NextStartActionDetailAttributes);

protected:
    StartAction nextStartAction;
    QList<ScStwTimer *> timers;
    void setState(RaceState newState);

private:
    RaceState state;

    QTimer *nextActionTimer;
    QEventLoop *nextActionLoop;

    // sounds
    ScStwSoundPlayer * soundPlayer;

    // some settings
    double soundVolume;
    bool allowAutomaticTimerDisable;
    bool allowAutomaticTimerDisableChanged;

    /*!
     * \brief stores the start action settings
     *
     * \details Stores the settings for the action ScStwRace::AtYourMarks and ScStwRace::Ready. The settings keys are: "Enabled" and "Delay"
     */
    QMap<StartAction, QVariantMap> startActionSettings;


public slots:
    /*!
     * \brief Function to start the race
     *
     * \param asyncronous if the function should just start the start sequence and then quit (true)
     *                    or if if should wait until the start sequence is over and quit after that (false)
     * \return 200: OK; 904: state not matching
     */
    int start(bool asyncronous = true);

    /*!
     * \brief Function to stop the currently running race
     *
     * \return 200: OK; 904: state not matching
     */
    virtual int stop();

    /*!
     * \brief Function to reset a stopped race
     * \return
     */
    virtual int reset();
    virtual int cancel();

    // setters
    bool writeStartActionSetting(StartAction action, bool enabled, int delay);
    bool setSoundVolume(double volume);
    virtual bool addTimer(ScStwTimer *timer);
    void setAllowAutomaticTimerDisable(bool allow);

    // getters
    RaceState getState();
    StartAction getNextStartAction();
    virtual QVariantList getNextStartActionDetails();
    QList<ScStwTimer*> getTimers();
    QVariantList getTimerDetailList();

protected slots:


private slots:
    void refreshTimerStates();
    void handleTimerWantsToBeDisabledChange(ScStwTimer* timer, bool wantsToBeDisabled);
    int handleFalseStart();
    bool playSoundsAndStartTimers(StartAction thisAction);
    void enableAllTimers();

    /**
     * \brief Function to declare the winner and looser timers after a timer has been stopped
     */
    void handleTimerStop();

signals:
    void startTimers();
    void stopTimers(int type);
    void resetTimers();
    void stateChanged(RaceState state);
    void nextStartActionChanged();
    void nextStartActionDetailsChanged();
    void timersChanged();


};

#endif // SCSTWRACE_H