Detailed Description
The QGeoTiledMappingManagerEngine class is provided to make writing Qt Maps and Navigation API plugins for tiled based mapping services easier.
Subclass of QGeoTiledMappingManagerEngine need to provide an implementation of getTileImage().
It is important that the function setTileSize() is called before getTileImage() to ensure that the tile is dealt with correctly after it is fetched. If setTileSize() is not calle dfirst the behaviour is undefined.
A subclass of QGeoTiledMappingManagerEngine will often make use of a subclass fo QGeoTiledMapReply internally, in order to add any engine-specific data (such as a QNetworkReply object for network-based services) to the QGeoTiledMapReply instances used by the engine.
Member Function Documentation
QGeoTiledMappingManagerEngine::QGeoTiledMappingManagerEngine ( const QMap<QString, QVariant> & parameters, QObject * parent = 0 ) [protected]
Constructs a new tiled mapping manager using the parameters parameters and the parent parent.
QGeoTiledMappingManagerEngine::~QGeoTiledMappingManagerEngine () [virtual]
Destroys this tiled mapping manager.
QGeoMapData * QGeoTiledMappingManagerEngine::createMapData () [virtual]
Reimplemented from 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 map widget is looking at. A single manager can be used by several QGraphcisGeoMap 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.
The instance returned by the default implementation will be a QGeoTiledMapData instance. Subclasses of QGeoTiledMappingManagerEngine are free to override this function to return subclasses of QGeoTiledMapData in order to customize the map.
QGeoTiledMapReply * QGeoTiledMappingManagerEngine::getTileImage ( const QGeoTiledMapRequest & request ) [pure virtual]
Requests the map tiled specified by request.
A QGeoTiledMapReply object will be returned, which can be used to manage the fetching of the tile and to return the tile data.
The returned QGeoTiledMapReply object will emit signals indicating if the operation completes or if errors occur.
Once the operation has completed, QGeoTiledMapReply::mapImageData() and QGeoTiledMapReply::mapImageFormat() can be used to generate the tile image.
The user is responsible for deleting the returned reply object, although this can be done in the slot connected to QGeoTiledMapReply::finished() or QGeoTiledMapReply::error() with deleteLater().
void QGeoTiledMappingManagerEngine::setTileSize ( const QSize & tileSize ) [protected]
Sets the size of the tiles returned by this tiled mapping manager to tileSize.
Subclasses of QGeoTiledMappingManagerEngine should use this function to ensure tileSize() provides accurate information.
See also tileSize().
QSize QGeoTiledMappingManagerEngine::tileSize () const
Returns the size of the tiles returned by this tiled mapping manager.
See also setTileSize().
