/* Copyright (C) 2013 * swift Project Community / Contributors * * This file is part of swift project. It is subject to the license terms in the LICENSE file found in the top-level * directory of this distribution and at http://www.swift-project.org/license.html. No part of swift project, * including this file, may be copied, modified, propagated, or distributed except according to the terms * contained in the LICENSE file. */ //! \file #ifndef BLACKCORE_SIMULATOR_H #define BLACKCORE_SIMULATOR_H #include "blackcore/interpolator.h" #include "blackmisc/simulation/simulatorplugininfo.h" #include "blackmisc/simulation/simulatedaircraftlist.h" #include "blackmisc/simulation/aircraftmodellist.h" #include "blackmisc/simulation/ownaircraftprovider.h" #include "blackmisc/simulation/remoteaircraftprovider.h" #include "blackmisc/statusmessagelist.h" #include "blackmisc/aviation/airportlist.h" #include "blackmisc/network/textmessage.h" #include "blackmisc/network/client.h" #include "blackmisc/pixmap.h" #include namespace BlackCore { //! Interface to a simulator. class ISimulator : public QObject { Q_OBJECT public: //! ISimulator status enum SimulatorStatus { Connected = 1 << 0, //!< Is the plugin connected to the simulator? Running = 1 << 1, //!< Is the simulator actually simulating? Paused = 1 << 2, //!< Is the simulator paused? }; //! Render all aircraft const int MaxAircraftInfinite = 100; //! Destructor virtual ~ISimulator() {} //! Are we connected to the simulator? virtual bool isConnected() const = 0; //! Can we connect? virtual bool canConnect() const = 0; //! Is time synchronization on? virtual bool isTimeSynchronized() const = 0; //! Simulator paused? virtual bool isPaused() const = 0; //! Simulator running? virtual bool isSimulating() const = 0; //! Originator const QString &simulatorOriginator() { // string is generated once, the timestamp allows to use multiple // components (as long as they are not generated at the same ms) static const QString o = QString("SIMULATOR:").append(QString::number(QDateTime::currentMSecsSinceEpoch())); return o; } public: //! Connect to simulator virtual bool connectTo() = 0; //! Connect asynchronously to simulator virtual void asyncConnectTo() = 0; //! Disconnect from simulator virtual bool disconnectFrom() = 0; //! Add new remote aircraft to the simulator //! \sa changeRemoteAircraftEnabled to hide a remote aircraft virtual bool addRemoteAircraft(const BlackMisc::Simulation::CSimulatedAircraft &remoteAircraft) = 0; //! Remove remote aircraft from simulator virtual bool removeRemoteAircraft(const BlackMisc::Aviation::CCallsign &callsign) = 0; //! Remove all remote aircraft virtual void removeAllRemoteAircraft() = 0; //! Change remote aircraft per property virtual bool changeRemoteAircraftModel(const BlackMisc::Simulation::CSimulatedAircraft &aircraft, const QString &originator) = 0; //! Aircraft got enabled / disabled virtual bool changeRemoteAircraftEnabled(const BlackMisc::Simulation::CSimulatedAircraft &aircraft, const QString &originator) = 0; //! Update own aircraft cockpit (usually from context) virtual bool updateOwnSimulatorCockpit(const BlackMisc::Aviation::CAircraft &aircraft, const QString &originator) = 0; //! ICAO data for model string virtual BlackMisc::Aviation::CAircraftIcao getIcaoForModelString(const QString &modelString) const = 0; //! Display a status message in the simulator virtual void displayStatusMessage(const BlackMisc::CStatusMessage &message) const = 0; //! Display a text message virtual void displayTextMessage(const BlackMisc::Network::CTextMessage &message) const = 0; //! Aircraft models for available remote aircrafts virtual BlackMisc::Simulation::CAircraftModelList getInstalledModels() const = 0; //! Count of aircraft models for available remote aircrafts virtual int getInstalledModelsCount() const = 0; //! Reload the installed models virtual void reloadInstalledModels() = 0; //! Airports in range virtual BlackMisc::Aviation::CAirportList getAirportsInRange() const = 0; //! Set time synchronization between simulator and user's computer time //! \remarks not all drivers implement this, e.g. if it is an intrinsic simulator feature virtual bool setTimeSynchronization(bool enable, BlackMisc::PhysicalQuantities::CTime offset) = 0; //! Time synchronization offset virtual BlackMisc::PhysicalQuantities::CTime getTimeSynchronizationOffset() const = 0; //! Representing icon for model string virtual BlackMisc::CPixmap iconForModel(const QString &modelString) const = 0; //! Max. rendered aircraft virtual int getMaxRenderedAircraft() const = 0; //! Max. rendered aircraft virtual void setMaxRenderedAircraft(int maxRenderedAircraft) = 0; //! Max. distance for rendered aircraft virtual void setMaxRenderedDistance(BlackMisc::PhysicalQuantities::CLength &distance) = 0; //! Max. distance for rendered aircraft virtual BlackMisc::PhysicalQuantities::CLength getMaxRenderedDistance() const = 0; //! Technical range until aircraft are visible virtual BlackMisc::PhysicalQuantities::CLength getRenderedDistanceBoundary() const = 0; //! Restricted number of aircraft virtual bool isMaxAircraftRestricted() const = 0; //! Restriced distance virtual bool isMaxDistanceRestricted() const = 0; //! Is there a restriction? No rendering -> limited number of aircraft -> unlimited number of aircraft virtual bool isRenderingRestricted() const = 0; //! Delete all restrictions (if any) -> unlimited number of aircraft virtual void deleteAllRenderingRestrictions() = 0; //! Enable debugging messages virtual void enableDebugMessages(bool driver, bool interpolator) = 0; //! Is the aircraft rendered (displayed in simulator)? virtual bool isRenderedAircraft(const BlackMisc::Aviation::CCallsign &callsign) const = 0; //! Highlight the aircraft for given time (or disable highlight) virtual void highlightAircraft(const BlackMisc::Simulation::CSimulatedAircraft &aircraftToHighlight, bool enableHighlight, const BlackMisc::PhysicalQuantities::CTime &displayTime) = 0; //! Is rendering enabled virtual bool isRenderingEnabled() const = 0; signals: //! Simulator combined status void simulatorStatusChanged(int status); //! Emitted when own aircraft model has changed void ownAircraftModelChanged(BlackMisc::Simulation::CSimulatedAircraft aircraft); //! Only a limited number of aircraft displayed void restrictedRenderingChanged(bool restricted); //! A single model has been matched void modelMatchingCompleted(BlackMisc::Simulation::CSimulatedAircraft aircraft); //! Installed aircraft models ready or changed void installedAircraftModelsChanged(); protected: //! Default constructor ISimulator(QObject *parent = nullptr) : QObject(parent) {} //! Emit the combined status //! \sa simulatorStatusChanged; void emitSimulatorCombinedStatus(); }; /*! * Interface to a simulator listener. * * The simulator listener is responsible for letting the core know when * the corresponding simulator is started. */ class ISimulatorListener : public QObject { Q_OBJECT public: //! Constructor //! \sa ISimulatorFactory::createListener(). //! \note msvc2015: use inherited constructor ISimulatorListener(QObject* parent); //! Destructor virtual ~ISimulatorListener() = default; public slots: //! Start listening for the simulator to start. virtual void start() = 0; //! Stops listening. virtual void stop() = 0; signals: //! Emitted when the listener discovers the simulator running. void simulatorStarted(); }; //! Factory pattern class to create instances of ISimulator class ISimulatorFactory { public: //! ISimulatorVirtual destructor virtual ~ISimulatorFactory() {} //! //! Create a new instance of a driver //! \param ownAircraftProvider in memory access to own aircraft data //! \param renderedAircraftProvider in memory access to rendered aircraft data such as situation history and aircraft itself //! \param parent QObject //! \return driver instance //! virtual ISimulator *create( BlackMisc::Simulation::IOwnAircraftProvider *ownAircraftProvider, BlackMisc::Simulation::IRemoteAircraftProvider *renderedAircraftProvider, QObject *parent = nullptr) = 0; //! Simulator listener instance virtual ISimulatorListener *createListener(QObject *parent = nullptr) = 0; }; //! Common base class with providers, interface and some base functionality class CSimulatorCommon : public BlackCore::ISimulator, public BlackMisc::Simulation::COwnAircraftAware, // gain access to in memor own aircraft data public BlackMisc::Simulation::CRemoteAircraftAware // gain access to in memory remote aircraft data { Q_OBJECT public: //! \copydoc ISimulator::getMaxRenderedAircraft virtual int getMaxRenderedAircraft() const override; //! \copydoc ISimulator::setMaxRenderedAircraft virtual void setMaxRenderedAircraft(int maxRenderedAircraft) override; //! \copydoc ISimulator::setMaxRenderedDistance virtual void setMaxRenderedDistance(BlackMisc::PhysicalQuantities::CLength &distance) override; //! \copydoc ISimulator::getMaxRenderedDistance virtual BlackMisc::PhysicalQuantities::CLength getMaxRenderedDistance() const override; //! \copydoc ISimulator::getRenderedDistanceBoundary virtual BlackMisc::PhysicalQuantities::CLength getRenderedDistanceBoundary() const override; //! \copydoc ISimulator::isMaxAircraftRestricted virtual bool isMaxAircraftRestricted() const override; //! \copydoc ISimulator::isMaxDistanceRestricted virtual bool isMaxDistanceRestricted() const override; //! \copydoc ISimulator::enableDebuggingMessages virtual void enableDebugMessages(bool driver, bool interpolator) override; //! \copydoc ISimulator::getInstalledModelsCount virtual int getInstalledModelsCount() const override; //! \copydoc IContextSimulator::highlightAircraft virtual void highlightAircraft(const BlackMisc::Simulation::CSimulatedAircraft &aircraftToHighlight, bool enableHighlight, const BlackMisc::PhysicalQuantities::CTime &displayTime) override; //! \copydoc IContextSimulator::isRenderingEnabled virtual bool isRenderingEnabled() const override; //! \copydoc IContextSimulator::isRenderingRestricted virtual bool isRenderingRestricted() const override; //! \copydoc IContextSimulator::deleteAllRenderingRestrictions virtual void deleteAllRenderingRestrictions(); protected slots: //! Slow timer used to highlight aircraft, can be used for other things too virtual void ps_oneSecondTimer(); protected: //! Constructor CSimulatorCommon( BlackMisc::Simulation::IOwnAircraftProvider *ownAircraftProvider, BlackMisc::Simulation::IRemoteAircraftProvider *remoteAircraftProvider, QObject *parent = nullptr); //! Blink the highlighted aircraft void blinkHighlightedAircraft(); //! Recalculate the restricted aircraft void recalculateRestrictedAircraft(); //! Restore aircraft from backedn data void resetAircraftFromBacked(const BlackMisc::Aviation::CCallsign &callsign); //! Override parts and situation from current interpolator values, if any! void setInitialAircraftSituationAndParts(BlackMisc::Simulation::CSimulatedAircraft &aircraft) const; bool m_debugMessages = false; //!< Display debug messages bool m_blinkCycle = false; //!< use for highlighting IInterpolator *m_interpolator = nullptr; //!< interpolator instance qint64 m_highlightEndTimeMsEpoch = 0; //!< end highlighting int m_timerCounter = 0; //!< allows to calculate n seconds QTimer *m_oneSecondTimer = nullptr; //!< timer BlackMisc::Simulation::CSimulatedAircraftList m_highlightedAircraft; //!< all other aircraft are to be ignored BlackMisc::Aviation::CCallsignSet m_callsignsToBeRendered; //!< callsigns which will be rendered int m_maxRenderedAircraft = MaxAircraftInfinite; //!< max.rendered aircraft BlackMisc::PhysicalQuantities::CLength m_maxRenderedDistance { 0.0, BlackMisc::PhysicalQuantities::CLengthUnit::nullUnit()}; //!< max.distance for rendering }; } // namespace Q_DECLARE_INTERFACE(BlackCore::ISimulatorFactory, "org.swift.pilotclient.BlackCore.SimulatorInterface") #endif // guard