Source code
Revision control
Copy as Markdown
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:significant reason:default
#include "qgeosatelliteinfo.h"
#include "private/qgeosatelliteinfo_p.h"
#include <QHash>
#include <QDebug>
#include <QDataStream>
QT_BEGIN_NAMESPACE
QT_IMPL_METATYPE_EXTERN(QGeoSatelliteInfo)
/*!
\class QGeoSatelliteInfo
\inmodule QtPositioning
\ingroup QtPositioning-positioning
\ingroup shared
\since 5.2
\brief The QGeoSatelliteInfo class contains basic information about a satellite.
\sa QGeoSatelliteInfoSource
*/
/*!
\enum QGeoSatelliteInfo::Attribute
Defines the attributes for the satellite information.
\value Elevation The elevation of the satellite, in degrees.
\value Azimuth The azimuth to true north, in degrees.
*/
/*!
\enum QGeoSatelliteInfo::SatelliteSystem
Defines the GNSS system of the satellite.
\value Undefined Not defined.
\value GPS Global Positioning System (USA).
\value GLONASS Global Positioning System (Russia).
\value GALILEO Global navigation satellite system (EU).
\value BEIDOU BeiDou navigation satellite system (China).
\value QZSS Quasi-Zenith Satellite System (Japan).
\value [since 6.12] IRNSS Indian Regional Navigation Satellite System.
\value [since 6.12] SBAS Satellite-based augmentation system.
\value Multiple This type normally indicates that the information is
received from a device that supports multiple satellite systems, and
the satellite system is not explicitly specified. Depending on the
data source, you might use other information to determine the actual
system type. One example of the usage of this type is an NMEA $GNGSA
message, which contains the IDs of the satellites being used, but
does not explicitly mention their system types.
\value CustomType The first type that can be used for user purposes. For
example when reimplementing NMEA data parsing in
\l QNmeaSatelliteInfoSource. User can add more types using
\c {CustomType + 1}, \c {CustomType + 2} and so on.
*/
/*!
Creates a satellite information object.
*/
QGeoSatelliteInfo::QGeoSatelliteInfo()
: d(new QGeoSatelliteInfoPrivate)
{
d->signal = -1;
d->satId = -1;
d->system = QGeoSatelliteInfo::Undefined;
}
/*!
Creates a satellite information object with the values of \a other.
*/
QGeoSatelliteInfo::QGeoSatelliteInfo(const QGeoSatelliteInfo &other)
: d(other.d)
{
}
QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfoPrivate &dd) : d(&dd)
{
}
/*!
\fn QGeoSatelliteInfo::QGeoSatelliteInfo(QGeoSatelliteInfo &&other) noexcept
\since 6.2
Creates a satellite information object by moving from \a other.
Note that a moved-from QGeoSatelliteInfo can only be destroyed or
assigned to. The effect of calling other functions than the destructor
or one of the assignment operators is undefined.
*/
/*!
Destroys a satellite information object.
*/
QGeoSatelliteInfo::~QGeoSatelliteInfo()
{
}
QT_DEFINE_QESDP_SPECIALIZATION_DTOR(QGeoSatelliteInfoPrivate)
/*!
Assigns the values from \a other to this object.
*/
QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(const QGeoSatelliteInfo & other)
{
if (this == &other)
return *this;
d = other.d;
return *this;
}
/*!
\fn QGeoSatelliteInfo &QGeoSatelliteInfo::operator=(QGeoSatelliteInfo &&other) noexcept
\since 6.2
Move-assigns the value from \a other to this object
Note that a moved-from QGeoSatelliteInfo can only be destroyed or
assigned to. The effect of calling other functions than the destructor
or one of the assignment operators is undefined.
*/
/*!
\fn bool QGeoSatelliteInfo::operator==(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Returns \c true if all the parameters of the \a lhs satellite are the same
as those of \a rhs. Otherwise returns \c false.
*/
/*!
\fn bool QGeoSatelliteInfo::operator!=(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
Returns \c true if any of the parameters of the \a lhs satellite are not
the same as those of \a rhs. Otherwise returns \c false.
*/
/*!
\fn void QGeoSatelliteInfo::swap(QGeoSatelliteInfo &other)
\since 6.2
\memberswap{satellite information}
*/
/*!
Sets the Satellite System (GPS, GLONASS, ...) to \a system.
*/
void QGeoSatelliteInfo::setSatelliteSystem(SatelliteSystem system)
{
d.detach();
d->system = system;
}
/*!
\property QGeoSatelliteInfo::satelliteSystem
\brief the satellite system in use, such as GPS or GLONASS.
Returns the Satellite System (GPS, GLONASS, ...)
\note This value can be used together with \l satelliteIdentifier
to uniquely identify a satellite.
\sa satelliteIdentifier
*/
QGeoSatelliteInfo::SatelliteSystem QGeoSatelliteInfo::satelliteSystem() const
{
return d->system;
}
/*!
Sets the satellite identifier number to \a satId.
The satellite identifier number can be used to identify a satellite within
the satellite system.
The actual value may vary, depending on the platform and the selected
backend.
For example, if \e nmea plugin is used, the satellite identifier for GPS
satellite system represents the PRN (Pseudo-random noise) number, and the
satellite identifier for GLONASS satellite system represents the slot
number.
*/
void QGeoSatelliteInfo::setSatelliteIdentifier(int satId)
{
d.detach();
d->satId = satId;
}
/*!
\property QGeoSatelliteInfo::satelliteIdentifier
\brief the satellite identifier number.
The satellite identifier number can be used to identify a satellite within
the satellite system.
The actual value may vary, depending on the platform and the selected
backend.
For example, if \e nmea plugin is used, the satellite identifier for GPS
satellite system represents the PRN (Pseudo-random noise) number, and the
satellite identifier for GLONASS satellite system represents the slot
number.
For NMEA-based backends the satellite identifier can be used to determine
the satellite system type if it is not available from other sources.
{satellite IDs list} to check the ID ranges for different satellite systems.
\note Depending on the platform and the selected backend, the satellite
identifier ranges for different satellite systems may intersect. To uniquely
identify a satellite, a combination of satelliteIndetifier() and
\l satelliteSystem() must be used.
*/
/*!
Returns the satellite identifier number.
\sa satelliteSystem()
*/
int QGeoSatelliteInfo::satelliteIdentifier() const
{
return d->satId;
}
/*!
Sets the signal strength to \a signalStrength, in decibels.
*/
void QGeoSatelliteInfo::setSignalStrength(int signalStrength)
{
d.detach();
d->signal = signalStrength;
}
/*!
\property QGeoSatelliteInfo::signalStrength
\brief the signal strength.
*/
/*!
Returns the signal strength, or -1 if the value has not been set.
*/
int QGeoSatelliteInfo::signalStrength() const
{
return d->signal;
}
/*!
Sets the value for \a attribute to \a value.
*/
void QGeoSatelliteInfo::setAttribute(Attribute attribute, qreal value)
{
d.detach();
d->doubleAttribs[attribute] = value;
}
/*!
Returns the value of the specified \a attribute as a qreal value.
Returns -1 if the value has not been set.
\sa hasAttribute(), setAttribute()
*/
qreal QGeoSatelliteInfo::attribute(Attribute attribute) const
{
return d->doubleAttribs.value(attribute, -1);
}
/*!
Removes the specified \a attribute and its value.
*/
void QGeoSatelliteInfo::removeAttribute(Attribute attribute)
{
const auto it = d->doubleAttribs.constFind(attribute);
if (it != d->doubleAttribs.cend()) {
d.detach();
d->doubleAttribs.erase(it);
}
}
/*!
Returns true if the specified \a attribute is present in this update.
*/
bool QGeoSatelliteInfo::hasAttribute(Attribute attribute) const
{
return d->doubleAttribs.contains(attribute);
}
/*!
\internal
*/
void QGeoSatelliteInfo::detach()
{
if (d)
d.detach();
else
d = new QGeoSatelliteInfoPrivate;
}
bool QGeoSatelliteInfo::equals(const QGeoSatelliteInfo &lhs, const QGeoSatelliteInfo &rhs)
{
return *lhs.d == *rhs.d;
}
#ifndef QT_NO_DEBUG_STREAM
QDebug QGeoSatelliteInfo::debugStreaming(QDebug dbg, const QGeoSatelliteInfo &info)
{
QDebugStateSaver saver(dbg);
dbg.nospace() << "QGeoSatelliteInfo(system=" << info.d->system;
dbg << ", satId=" << info.d->satId;
dbg << ", signal-strength=" << info.d->signal;
const QList<QGeoSatelliteInfo::Attribute> attribs = info.d->doubleAttribs.keys();
for (qsizetype i = 0; i < attribs.size(); ++i) {
dbg << ", ";
switch (attribs[i]) {
case QGeoSatelliteInfo::Elevation:
dbg << "Elevation=";
break;
case QGeoSatelliteInfo::Azimuth:
dbg << "Azimuth=";
break;
}
dbg << info.d->doubleAttribs[attribs[i]];
}
dbg << ')';
return dbg;
}
#endif // QT_NO_DEBUG_STREAM
#ifndef QT_NO_DATASTREAM
/*!
\fn QDataStream &QGeoSatelliteInfo::operator<<(QDataStream &stream, const QGeoSatelliteInfo &info)
Writes the given \a info to the specified \a stream.
\sa {Serializing Qt Data Types}
*/
QDataStream &QGeoSatelliteInfo::dataStreamOut(QDataStream &stream, const QGeoSatelliteInfo &info)
{
stream << info.d->signal;
stream << info.d->doubleAttribs;
stream << info.d->satId;
stream << int(info.d->system);
return stream;
}
#endif // QT_NO_DATASTREAM
#ifndef QT_NO_DATASTREAM
/*!
\fn QDataStream &QGeoSatelliteInfo::operator>>(QDataStream &stream, QGeoSatelliteInfo &info)
Reads satellite information from the specified \a stream into the given
\a info.
\sa {Serializing Qt Data Types}
*/
QDataStream &QGeoSatelliteInfo::dataStreamIn(QDataStream &stream, QGeoSatelliteInfo &info)
{
int system;
stream >> info.d->signal;
stream >> info.d->doubleAttribs;
stream >> info.d->satId;
stream >> system;
info.d->system = (QGeoSatelliteInfo::SatelliteSystem)system;
return stream;
}
#endif // QT_NO_DATASTREAM
QGeoSatelliteInfoPrivate::QGeoSatelliteInfoPrivate() : QSharedData()
{
}
QGeoSatelliteInfoPrivate::QGeoSatelliteInfoPrivate(const QGeoSatelliteInfoPrivate &other)
: QSharedData(other)
{
signal = other.signal;
satId = other.satId;
system = other.system;
doubleAttribs = other.doubleAttribs;
}
QGeoSatelliteInfoPrivate::~QGeoSatelliteInfoPrivate() {}
bool QGeoSatelliteInfoPrivate::operator==(const QGeoSatelliteInfoPrivate &other) const
{
return signal == other.signal
&& satId == other.satId
&& system == other.system
&& doubleAttribs == other.doubleAttribs;
}
QGeoSatelliteInfoPrivate *QGeoSatelliteInfoPrivate::get(const QGeoSatelliteInfo &info)
{
return info.d.data();
}
size_t qHash(const QGeoSatelliteInfo &key, size_t seed) noexcept
{
// Other properties and attributes might change
return qHashMulti(seed, key.d->satId, key.d->system);
}
namespace QTest
{
char *toString(const QGeoSatelliteInfo &info)
{
QString result;
QDebug dbg(&result);
dbg << info;
return qstrdup(qPrintable(result));
}
}
QT_END_NAMESPACE