NavigationModule.h

Go to the documentation of this file.

#ifndef OSMSCOUT_CLIENT_QT_NAVIGATIONMODULE_H
#define OSMSCOUT_CLIENT_QT_NAVIGATIONMODULE_H
 
/*
 OSMScout - a Qt backend for libosmscout and libosmscout-map
 Copyright (C) 2017 Lukas Karas
 
  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Lesser General Public
  License as published by the Free Software Foundation; either
  version 2.1 of the License, or (at your option) any later version.
 
  This library 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
  Lesser General Public License for more details.
 
  You should have received a copy of the GNU Lesser General Public
  License along with this library; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307  USA
 */
 
#include <osmscoutclient/Settings.h>
#include <osmscoutclient/DBThread.h>
 
#include <osmscoutclientqt/Router.h>
 
#include <osmscout/navigation/Navigation.h>
#include <osmscout/navigation/Engine.h>
#include <osmscout/navigation/Agents.h>
#include <osmscout/navigation/DataAgent.h>
#include <osmscout/navigation/PositionAgent.h>
#include <osmscout/navigation/RouteStateAgent.h>
#include <osmscout/navigation/BearingAgent.h>
#include <osmscout/navigation/RouteInstructionAgent.h>
#include <osmscout/navigation/ArrivalEstimateAgent.h>
#include <osmscout/navigation/SpeedAgent.h>
#include <osmscout/navigation/VoiceInstructionAgent.h>
#include <osmscout/navigation/LaneAgent.h>
 
#include <osmscoutclientqt/ClientQtImportExport.h>
 
#include <QtGlobal>
#include <QObject>
#include <QTimer>
#include <QMediaPlayer>
#include <QDateTime>
 
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
  #include <QMediaPlaylist>
#endif
 
#include <optional>
 
namespace osmscout {
 
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
  using QtMediaPlayerState = QMediaPlayer::State;
#else
  using QtMediaPlayerState = QMediaPlayer::PlaybackState;
#endif
 

class OSMSCOUT_CLIENT_QT_API NavigationModule: public QObject {
  Q_OBJECT
 
private:
  Slot<std::string> voiceDirSlot{
    [this](const std::string &str) { onVoiceChanged(QString::fromStdString(str)); }
  };
 
signals:
  void update(std::list<RouteStep> instructions);
 
  void updateNext(RouteStep nextRouteInstruction);
 
  void rerouteRequest(const osmscout::GeoCoord from,
                      const std::optional<osmscout::Bearing> initialBearing,
                      const osmscout::GeoCoord to);
 
  void positionEstimate(const osmscout::PositionAgent::PositionState state,
                        const osmscout::GeoCoord coord,
                        const std::optional<osmscout::Bearing> bearing);
 
  void arrivalEstimate(QDateTime arrivalEstimate, osmscout::Distance remainingDistance);
 
  void targetReached(const osmscout::Bearing targetBearing,
                     const osmscout::Distance targetDistance);
 
  void currentSpeed(double currentSpeedKmPH);
  void maxAllowedSpeed(double maxAllowedSpeedKmPh);
 
  void laneUpdate(osmscout::LaneAgent::Lane lane);
 
public slots:
  void setupRoute(QtRouteData route,
                  osmscout::Vehicle vehicle);

  void locationChanged(osmscout::GeoCoord coord,
                       bool horizontalAccuracyValid,
                       double horizontalAccuracy);
 
  void onTimeout();
 
  void onVoiceChanged(const QString);
 
  void playerStateChanged(QtMediaPlayerState state);
 
public:
  NavigationModule(QThread *thread,
                   SettingsRef settings,
                   DBThreadRef dbThread);
 
  bool loadRoutableObjects(const GeoBox &box,
                           const Vehicle &vehicle,
                           const std::map<std::string,DatabaseId> &databaseMapping,
                           RoutableObjectsRef &data);
 
  ~NavigationModule() override;
 
private:
  void InitPlayer();
  void ProcessMessages(const std::list<osmscout::NavigationMessageRef>& messages);
  QString sampleFile(osmscout::VoiceInstructionMessage::VoiceSample sample) const;
 
private:
  QThread     *thread;
  SettingsRef settings;
  DistanceUnitSystem units{Locale::ByEnvironmentSafe().GetDistanceUnits()}; // TODO: make possible to override
  DBThreadRef dbThread;
  QTimer      timer;
  std::optional<Bearing> lastBearing;
 
  // voice route instructions
  QString voiceDir;
  // player and playlist should be created in module thread, not in UI thread (constructor)
  // we setup QObject parents, objects are cleaned after Module destruction
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
  QMediaPlaylist *currentPlaylist{nullptr};
#endif
  QMediaPlayer *mediaPlayer{nullptr};
  std::vector<osmscout::VoiceInstructionMessage::VoiceSample> nextMessage;
 
  osmscout::RouteDescriptionRef routeDescription;
 
  using DataAgentInst=DataAgent<NavigationModule>;
  using DataAgentRef=std::shared_ptr<DataAgentInst>;
 
  osmscout::NavigationEngine engine{
      std::make_shared<DataAgent<NavigationModule>>(*this),
      std::make_shared<PositionAgent>(),
      std::make_shared<BearingAgent>(),
      std::make_shared<RouteInstructionAgent<RouteStep, RouteDescriptionBuilder>>(),
      std::make_shared<VoiceInstructionAgent>(units),
      std::make_shared<RouteStateAgent>(),
      std::make_shared<ArrivalEstimateAgent>(),
      std::make_shared<SpeedAgent>(),
      std::make_shared<LaneAgent>()
  };
 
};
 
}
 
#endif // OSMSCOUT_CLIENT_QT_NAVIGATIONMODULE_H