// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2011 Dennis Nienhüser <nienhueser@kde.org>
//

#ifndef MARBLE_AUDIOOUTPUT_H
#define MARBLE_AUDIOOUTPUT_H

#include <QObject>

namespace Marble
{

class Route;
class AudioOutputPrivate;

/**
  * Audio (mainly voice) output of driving instructions
  */
class AudioOutput : public QObject
{
    Q_OBJECT

public:
    /** Constructor */
    explicit AudioOutput( QObject* parent = nullptr );

    /** Destructor */
    ~AudioOutput() override;

    /**
      * Generate an audible notification (if needed) after the position on the route has changed.
      * No notification will be generated if the turn point with the given index is too far away,
      * has been announced previously, if the output is @see setMuted or the needed sounds cannot
      * be found in the Marble data path.
      * @param route The route
      * @param distanceManeuver The distance in meters to the next turn point
      * @param distanceTarget The distance to the target
      * @param deviated Whether the route is deviated
      */
    void update( const Route &route, qreal distanceManeuver, qreal distanceTarget, bool deviated );

    /** Toggle muting (neither sound nor voice output) */
    void setMuted( bool muted );

    bool isMuted() const;

    /**
      * Change the speaker to use.
      * @param speaker A directory name in audio/speakers in Marble's data path. This directory
      * is expected to contain ogg files containing the instructions: TurnLeft.ogg, RbExit3.ogg etc.
      * Disabled by setSoundEnabled(true) and overridden by setMuted(true).
      * @see setSoundEnabled
      * @see setMuted
      */
    void setSpeaker( const QString &speaker );

    QString speaker() const;

    /**
      * Toggle whether sound output is used instead of a speaker. Overridden by setMuted(true).
      * @see setMuted
      */
    void setSoundEnabled( bool enabled );

    bool isSoundEnabled() const;

private:
    Q_PRIVATE_SLOT( d, void audioOutputFinished() )

    Q_PRIVATE_SLOT( d, void playInstructions() )

    AudioOutputPrivate * const d;
};

}

#endif // MARBLE_AUDIOOUTPUT_H
