/* 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 BLACKMISC_ATCSTATION_H #define BLACKMISC_ATCSTATION_H #include "voiceroom.h" #include "aviocomsystem.h" #include "avinformationmessage.h" #include "avcallsign.h" #include "nwuser.h" #include "coordinategeodetic.h" #include "pqfrequency.h" #include "pqlength.h" #include "pqtime.h" #include #include #include namespace BlackMisc { namespace Aviation { /*! * Value object encapsulating information about an ATC station. */ class CAtcStation : public BlackMisc::CValueObject, public BlackMisc::Geo::ICoordinateGeodetic { public: //! Properties by index enum ColumnIndex { IndexCallsign = 0, IndexPixmap, // representing icon IndexCallsignAsString, IndexCallsignAsStringAsSet, IndexController, IndexControllerRealName, IndexControllerId, IndexFrequency, IndexPosition, IndexRange, IndexDistance, IndexIsOnline, IndexBookedFrom, IndexBookedUntil, IndexLatitude, IndexLongitude, IndexAtis, IndexAtisMessage, IndexMetar, IndexMetarMessage, IndexVoiceRoom, IndexVoiceRoomUrl }; //! Default constructor. CAtcStation(); //! Simplified constructor CAtcStation(const QString &callsign); //! ATC station constructor CAtcStation(const CCallsign &callsign, const BlackMisc::Network::CUser &controller, const BlackMisc::PhysicalQuantities::CFrequency &frequency, const BlackMisc::Geo::CCoordinateGeodetic &pos, const BlackMisc::PhysicalQuantities::CLength &range, bool isOnline = false, const QDateTime &bookedFromUtc = QDateTime(), const QDateTime &bookedUntilUtc = QDateTime(), const CInformationMessage &atis = CInformationMessage(CInformationMessage::ATIS), const CInformationMessage &metar = CInformationMessage(CInformationMessage::METAR)); //! \copydoc CValueObject::toQVariant() virtual QVariant toQVariant() const override { return QVariant::fromValue(*this); } //! Equal operator == bool operator ==(const CAtcStation &other) const; //! Unequal operator != bool operator !=(const CAtcStation &other) const; //! Has booking times? bool hasBookingTimes() const { return !(this->m_bookedFromUtc.isNull() && this->m_bookedUntilUtc.isNull()); } //! Has ATIS? bool hasAtis() const { return this->m_atis.hasMessage(); } //! Has METAR? bool hasMetar() const { return this->m_metar.hasMessage(); } //! Get callsign. const CCallsign &getCallsign() const { return m_callsign; } //! Get callsign as string. QString getCallsignAsString() const { return m_callsign.asString(); } //! Set callsign void setCallsign(const CCallsign &callsign) { this->m_callsign = callsign; this->m_controller.setCallsign(callsign);} //! Get controller const BlackMisc::Network::CUser &getController() const { return m_controller; } //! Get controller name. QString getControllerRealName() const { return m_controller.getRealName(); } //! Get controller name. QString getControllerId() const { return m_controller.getId(); } //! Set controller void setController(const BlackMisc::Network::CUser &controller) { this->m_controller = controller; this->m_controller.setCallsign(this->m_callsign); } //! Set controller's name void setControllerRealName(const QString &controllerName) { this->m_controller.setRealName(controllerName); } //! Set controller's id void setControllerId(const QString &controllerId) { this->m_controller.setId(controllerId); } //! Has valid realname? bool hasValidRealName() const { return this->m_controller.hasValidRealName(); } //! Has valid id? bool hasValidId() const { return this->m_controller.hasValidId(); } //! Valid COM frequency bool hasValidFrequency() const { return BlackMisc::Aviation::CComSystem::isValidCivilAviationFrequency(this->getFrequency()); } //! Get frequency. const BlackMisc::PhysicalQuantities::CFrequency &getFrequency() const { return m_frequency; } //! Set frequency void setFrequency(const BlackMisc::PhysicalQuantities::CFrequency &frequency); //! Get the position of the center of the controller's area of visibility. const BlackMisc::Geo::CCoordinateGeodetic &getPosition() const { return m_position; } //! Set position void setPosition(const BlackMisc::Geo::CCoordinateGeodetic &position) { this->m_position = position; } /*! * Syncronize controller data * Updates two stations (namely a booked and online ATC station) with complementary data * \param otherStation */ void syncronizeControllerData(CAtcStation &otherStation); //! Get the radius of the controller's area of visibility. const BlackMisc::PhysicalQuantities::CLength &getRange() const { return m_range; } //! Set range void setRange(const BlackMisc::PhysicalQuantities::CLength &range) { this->m_range = range; } //! Get the distance to own plane const BlackMisc::PhysicalQuantities::CLength &getDistanceToPlane() const { return m_distanceToPlane; } //! Set distance to own plane void setDistanceToPlane(const BlackMisc::PhysicalQuantities::CLength &distance) { this->m_distanceToPlane = distance; } //! Valid distance? bool hasValidDistance() const { return !this->m_distanceToPlane.isNull();} //! Calculcate distance to plane, set it, and also return it BlackMisc::PhysicalQuantities::CLength calculcateDistanceToPlane(const BlackMisc::Geo::CCoordinateGeodetic &position, bool update = true); //! Is station online (or just booked)? bool isOnline() const { return m_isOnline; } //! Set online void setOnline(bool online) { this->m_isOnline = online; } //! Get voice room const BlackMisc::Audio::CVoiceRoom &getVoiceRoom() const { return this->m_voiceRoom; } //! Set voice room void setVoiceRoom(const BlackMisc::Audio::CVoiceRoom &voiceRoom) { this->m_voiceRoom = voiceRoom; } //! Valid voice room? bool hasValidVoiceRoom() const { return this->m_voiceRoom.isValid(); } /*! * Booked date/time if any. * This represents the closest booking within a time frame as there can be multiple bookings. */ const QDateTime &getBookedFromUtc() const { return m_bookedFromUtc; } //! Set booked from void setBookedFromUtc(const QDateTime &from) { this->m_bookedFromUtc = from; } /*! * Booked date/time if any. * This represents the closest booking within a time frame as there can be multiple bookings. */ const QDateTime &getBookedUntilUtc() const { return m_bookedUntilUtc; } //! Has valid booking times? bool hasValidBookingTimes() const { return !this->m_bookedFromUtc.isNull() && this->m_bookedFromUtc.isValid() && !this->m_bookedUntilUtc.isNull() && this->m_bookedUntilUtc.isValid(); } //! Transfer booking times void setBookedFromUntil(const CAtcStation &otherStation) { this->setBookedFromUtc(otherStation.getBookedFromUtc()); this->setBookedUntilUtc(otherStation.getBookedUntilUtc()); } //! Booked now? bool isBookedNow() const; //! Tuned in within 25KHz channel spacing bool isComUnitTunedIn25KHz(const BlackMisc::Aviation::CComSystem &comUnit) const { return comUnit.isActiveFrequencyWithin25kHzChannel(this->getFrequency()); } /*! * When booked, 0 means now, * negative values mean booking in past, * positive values mean booking in future, * no booking dates will result in - 1 year * \return */ BlackMisc::PhysicalQuantities::CTime bookedWhen() const; //! Get ATIS const CInformationMessage &getAtis() const { return m_atis; } //! Set ATIS void setAtis(const CInformationMessage &atis) { this->m_atis = atis;} //! Set ATIS Message void setAtisMessage(const QString &atis) { this->m_atis.setMessage(atis); } //! Get METAR const CInformationMessage &getMetar() const { return m_metar; } //! Set METAR void setMetar(const CInformationMessage &metar) { this->m_metar = metar;} //! Set METAR Message void setMetarMessage(const QString &metar) { this->m_metar.setMessage(metar); } //! Set booked until void setBookedUntilUtc(const QDateTime &until) { this->m_bookedUntilUtc = until; } //! \copydoc ICoordinateGeodetic::latitude virtual const BlackMisc::Geo::CLatitude &latitude() const override { return this->getPosition().latitude(); } //! \copydoc ICoordinateGeodetic::longitude virtual const BlackMisc::Geo::CLongitude &longitude() const override { return this->getPosition().longitude(); } //! \copydoc CValueObject::getValueHash() virtual uint getValueHash() const override; //! \copydoc CValueObject::propertyByIndex() virtual QVariant propertyByIndex(int index) const override; //! \copydoc CValueObject::setPropertyByIndex(variant, index) virtual void setPropertyByIndex(const QVariant &variant, int index) override; //! \copydoc CValueObject::propertyByIndexAsString() virtual QString propertyByIndexAsString(int index, bool i18n = false) const override; //! \copydoc CValueObject::toJson virtual QJsonObject toJson() const override; //! \copydoc CValueObject::fromJson void fromJson(const QJsonObject &json) override; //! Register metadata static void registerMetadata(); //! \copydoc TupleConverter<>::jsonMembers() static const QStringList &jsonMembers(); protected: //! \copydoc CValueObject::convertToQString virtual QString convertToQString(bool i18n = false) const override; //! \copydoc CValueObject::getMetaTypeId virtual int getMetaTypeId() const override; //! \copydoc CValueObject::isA virtual bool isA(int metaTypeId) const override; //! \copydoc CValueObject::compareImpl virtual int compareImpl(const CValueObject &other) const override; //! \copydoc CValueObject::marshallToDbus() virtual void marshallToDbus(QDBusArgument &argument) const override; //! \copydoc CValueObject::unmarshallFromDbus() virtual void unmarshallFromDbus(const QDBusArgument &argument) override; private: BLACK_ENABLE_TUPLE_CONVERSION(CAtcStation) CCallsign m_callsign; BlackMisc::Network::CUser m_controller; BlackMisc::PhysicalQuantities::CFrequency m_frequency; BlackMisc::Geo::CCoordinateGeodetic m_position; BlackMisc::PhysicalQuantities::CLength m_range; BlackMisc::PhysicalQuantities::CLength m_distanceToPlane; // make mutable ? bool m_isOnline; QDateTime m_bookedFromUtc; QDateTime m_bookedUntilUtc; CInformationMessage m_atis; CInformationMessage m_metar; BlackMisc::Audio::CVoiceRoom m_voiceRoom; }; } // namespace } // namespace BLACK_DECLARE_TUPLE_CONVERSION(BlackMisc::Aviation::CAtcStation, (o.m_callsign, o.m_controller, o.m_frequency, o.m_position, o.m_range, o.m_isOnline, o.m_distanceToPlane, o.m_atis, o.m_bookedFromUtc, o.m_bookedUntilUtc, o.m_metar, o.m_voiceRoom)) Q_DECLARE_METATYPE(BlackMisc::Aviation::CAtcStation) #endif // guard