path: root/src/location/maps/qgeomappingmanagerengine.cpp

/****************************************************************************
**
** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of the Qt Mobility Components.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Digia gives you certain additional
** rights.  These rights are described in the Digia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
**
** $QT_END_LICENSE$
**
****************************************************************************/

#include "qgeomappingmanagerengine.h"
#include "qgeomappingmanagerengine_p.h"

#include <QNetworkProxy>

QTM_BEGIN_NAMESPACE

/*!
    \class QGeoMappingManagerEngine
    \brief The QGeoMappingManagerEngine class provides an interface and convenience methods
    to implementors of QGeoServiceProvider plugins who want to provides support for displaying
    and interacting with maps.

    \inmodule QtLocation
    \since 1.1

    \ingroup maps-impl

    Subclasses of QGeoMappingManagerEngine need to provide an implementations
    of createMapData(). The QGeoMapData instances returned by createMapData()
    can be used to contain and manage information concerning what a particular
    QGraphicsGeoMap is viewing.

    Most of the other functions configure the reported capabilities of the engine.
    It is important that these functions are called before createMapData() or any of the
    capability reporting functions are used to prevent incorrect or
    inconsistent behaviour.
*/

/*!
    Constructs a new engine with the specified \a parent, using \a parameters
    to pass any implementation specific data to the engine.
    \since 1.1
*/
QGeoMappingManagerEngine::QGeoMappingManagerEngine(const QMap<QString, QVariant> &parameters, QObject *parent)
    : QObject(parent),
      d_ptr(new QGeoMappingManagerEnginePrivate())
{
    Q_UNUSED(parameters)
}

/*!
  \internal
*/
QGeoMappingManagerEngine::QGeoMappingManagerEngine(QGeoMappingManagerEnginePrivate *dd, QObject *parent)
    : QObject(parent),
      d_ptr(dd) {}

/*!
    Destroys this engine.
*/
QGeoMappingManagerEngine::~QGeoMappingManagerEngine()
{
    Q_D(QGeoMappingManagerEngine);
    delete d;
}

/*!
    Sets the name which this engine implementation uses to distinguish itself
    from the implementations provided by other plugins to \a managerName.

    The combination of managerName() and managerVersion() should be unique
    amongst plugin implementations.
    \since 1.1
*/
void QGeoMappingManagerEngine::setManagerName(const QString &managerName)
{
    d_ptr->managerName = managerName;
}

/*!
    Returns the name which this engine implementation uses to distinguish
    itself from the implementations provided by other plugins.

    The combination of managerName() and managerVersion() should be unique
    amongst plugin implementations.
    \since 1.1
*/
QString QGeoMappingManagerEngine::managerName() const
{
    return d_ptr->managerName;
}

/*!
    Sets the version of this engine implementation to \a managerVersion.

    The combination of managerName() and managerVersion() should be unique
    amongst plugin implementations.
    \since 1.1
*/
void QGeoMappingManagerEngine::setManagerVersion(int managerVersion)
{
    d_ptr->managerVersion = managerVersion;
}

/*!
    Returns the version of this engine implementation.

    The combination of managerName() and managerVersion() should be unique
    amongst plugin implementations.
    \since 1.1
*/
int QGeoMappingManagerEngine::managerVersion() const
{
    return d_ptr->managerVersion;
}

/*!
\fn QGeoMapData* QGeoMappingManagerEngine::createMapData()

    Returns a new QGeoMapData instance which will be managed by
    this manager.

    A QGeoMapData instance contains and manages the information about
    what a QGraphicsGeoMap is looking at.  A  single manager can be used by several
    QGraphicsGeoMap instances since each instance has an associated QGeoMapData instance.

    The QGeoMapData instance can be treated as a kind of session object, or
    as a model in a model-view-controller architecture, with QGraphicsGeoMap
    as the view and QGeoMappingManagerEngine as the controller.

    Subclasses of QGeoMappingManagerEngine are free to override this function
    to return subclasses of QGeoMapData in order to customize the
    map.
    \since 1.1
*/

/*!
    Returns a list of the map types supported by this engine.
    \since 1.1
*/
QList<QGraphicsGeoMap::MapType> QGeoMappingManagerEngine::supportedMapTypes() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->supportedMapTypes;
}

/*!
    Returns a list of the connectivity modes supported by this engine.
    \since 1.1
*/
QList<QGraphicsGeoMap::ConnectivityMode> QGeoMappingManagerEngine::supportedConnectivityModes() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->supportedConnectivityModes;
}

/*!
    Returns the minimum zoom level supported by this engine.

    Larger values of the zoom level correspond to more detailed views of the
    map.
    \since 1.1
*/
qreal QGeoMappingManagerEngine::minimumZoomLevel() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->minimumZoomLevel;
}

/*!
    Returns the maximum zoom level supported by this engine.

    Larger values of the zoom level correspond to more detailed views of the
    map.
    \since 1.1
*/
qreal QGeoMappingManagerEngine::maximumZoomLevel() const

{
    Q_D(const QGeoMappingManagerEngine);
    return d->maximumZoomLevel;
}

/*!
    Sets the list of map types supported by this engine to \a mapTypes.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    that supportedMapTypes() provides accurate information.
    \since 1.1
*/
void QGeoMappingManagerEngine::setSupportedMapTypes(const QList<QGraphicsGeoMap::MapType> &mapTypes)
{
    Q_D(QGeoMappingManagerEngine);
    d->supportedMapTypes = mapTypes;
}

/*!
    Sets the list of connectivity modes supported by this engine to \a connectivityModes.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    that supportedConnectivityModes() provides accurate information.

    If createMapData does not specify a connectivity mode the first mode from
    \a connectivityModes will be used, or QGraphicsGeoMap::NoConnectivity will
    be used if \a connectivityModes is empty.
    \since 1.1
*/
void QGeoMappingManagerEngine::setSupportedConnectivityModes(const QList<QGraphicsGeoMap::ConnectivityMode> &connectivityModes)
{
    Q_D(QGeoMappingManagerEngine);
    d->supportedConnectivityModes = connectivityModes;
}

/*!
    Sets the minimum zoom level supported by this engine to \a minimumZoom.

    Larger values of the zoom level correspond to more detailed views of the
    map.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    minimumZoomLevel() provides accurate information.
    \since 1.1
*/
void QGeoMappingManagerEngine::setMinimumZoomLevel(qreal minimumZoom)
{
    Q_D(QGeoMappingManagerEngine);
    d->minimumZoomLevel = minimumZoom;
}

/*!
    Sets the maximum zoom level supported by this engine to \a maximumZoom.

    Larger values of the zoom level correspond to more detailed views of the
    map.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    maximumZoomLevel() provides accurate information.
    \since 1.1
*/
void QGeoMappingManagerEngine::setMaximumZoomLevel(qreal maximumZoom)
{
    Q_D(QGeoMappingManagerEngine);
    d->maximumZoomLevel = maximumZoom;
}

/*!
    Return whether bearing is supported by this engine.
    \since 1.1
*/
bool QGeoMappingManagerEngine::supportsBearing() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->supportsBearing;
}

/*!
    Return whether tilting is supported by this engine.
    \since 1.2
*/
bool QGeoMappingManagerEngine::supportsTilting() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->supportsTilting;
}

/*!
    Returns the minimum tilt supported by this engine.

    Value in degrees where 0 is equivalent to 90 degrees between view and earth's
    surface i.e. looking straight down to earth.
    \since 1.2
*/
qreal QGeoMappingManagerEngine::minimumTilt() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->minimumTilt;
}

/*!
    Returns the maximum tilt supported by this engine.

    Value in degrees where 0 is equivalent to 90 degrees between view and earth's
    surface i.e. looking straight down to earth.
    \since 1.2
*/
qreal QGeoMappingManagerEngine::maximumTilt() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d->maximumTilt;
}

/*!
    Sets the minimum tilt supported by this engine to \a minimumTilt.

    Value in degrees where 0 is equivalent to 90 degrees between view and earth's
    surface i.e. looking straight down to earth.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    minimumTilt() provides accurate information. If no minimum value is set
    by the subclass the value of 0 is used.
    \since 1.2
*/
void QGeoMappingManagerEngine::setMinimumTilt(qreal minimumTilt)
{
    Q_D(QGeoMappingManagerEngine);
    d->minimumTilt = minimumTilt;
}

/*!
    Sets the maximum tilt supported by this engine to \a maximumTilt.

    Value in degrees where 0 is equivalent to 90 degrees between view and earth's
    surface i.e. looking straight down to earth.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    maximumTilt() provides accurate information. If no maximum value is set
    by the subclass the value of 0 is used.
    \since 1.2
*/
void QGeoMappingManagerEngine::setMaximumTilt(qreal maximumTilt)
{
    Q_D(QGeoMappingManagerEngine);
    d->maximumTilt = maximumTilt;
}

/*!
    Sets whether bearing is supported by this engine to \a supportsBearing.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    supportsBearing() provides accurate information. If no value is set
    by the subclass then bearing support is disabled and supportsBearing set
    to false.
    \since 1.2
*/
void QGeoMappingManagerEngine::setSupportsBearing(bool supportsBearing)
{
    Q_D(QGeoMappingManagerEngine);
    d->supportsBearing = supportsBearing;
}

/*!
    Sets whether tilting is supported by this engine to \a supportsTilting.

    Subclasses of QGeoMappingManagerEngine should use this function to ensure
    supportsTilting() provides accurate information. If no value is set
    by the subclass then tilting support is disabled and supportsTilting set
    to false.
    \since 1.2
*/
void QGeoMappingManagerEngine::setSupportsTilting(bool supportsTilting)
{
    Q_D(QGeoMappingManagerEngine);
    d->supportsTilting = supportsTilting;
}

/*!
    Returns whether custom map objects are supported by this engine.

    Custom map objects are map objects based on QGraphicsItem instances, which
    are hard to support in cases where the map rendering is not being
    performed by the Qt Graphics View framwork.
    \since 1.2
*/
bool QGeoMappingManagerEngine::supportsCustomMapObjects() const
{
    Q_D(const QGeoMappingManagerEngine);
    return d_ptr->supportsCustomMapObjects;
}

/*!
    Sets whether custom map objects are supported by this engine to \a supportsCustomMapObjects.

    Custom map objects are map objects based on QGraphicsItem instances, which
    are hard to support in cases where the map rendering is not being
    performed by the Qt Graphics View framwork.
    \since 1.2
*/
void QGeoMappingManagerEngine::setSupportsCustomMapObjects(bool supportsCustomMapObjects)
{
    Q_D(QGeoMappingManagerEngine);
    d_ptr->supportsCustomMapObjects = supportsCustomMapObjects;
}

/*!
    Sets the locale to be used by the this manager to \a locale.

    If this mapping manager supports returning map labels
    in different languages, they will be returned in the language of \a locale.

    The locale used defaults to the system locale if this is not set.
    \since 1.2
*/
void QGeoMappingManagerEngine::setLocale(const QLocale &locale)
{
    d_ptr->locale = locale;
}

/*!
    Returns the locale used to hint to this mapping manager about what
    language to use for map labels.
    \since 1.2
*/
QLocale QGeoMappingManagerEngine::locale() const
{
    return d_ptr->locale;
}

/*******************************************************************************
*******************************************************************************/

QGeoMappingManagerEnginePrivate::QGeoMappingManagerEnginePrivate()
    : managerVersion(-1),
    minimumZoomLevel(0.0),
    maximumZoomLevel(0.0),
    supportsBearing(false),
    supportsTilting(false),
    minimumTilt(0.0),
    maximumTilt(0.0),
    supportsCustomMapObjects(false) {}

QGeoMappingManagerEnginePrivate::~QGeoMappingManagerEnginePrivate() {}

#include "moc_qgeomappingmanagerengine.cpp"

QTM_END_NAMESPACE