BlankRenderEngine
#include <bb/cascades/maps/BlankRenderEngine>
To link against this class, add the following line to your .pro file: LIBS += -lbbcascadesmaps
An empty render engine, which will be used when no other engine can be found.
BlackBerry 10.0.0
Inheritance
| bb::cascades::maps::RenderEngine | ||
| bb::cascades::maps::BlankRenderEngine | ||
Public Functions Index
| BlankRenderEngine (QObject *parent=0) | |
| virtual | ~BlankRenderEngine () |
| virtual bb::cascades::maps::RenderEngine * | newInstance () const |
| virtual QString | elementIdAt (const QPoint &windowCoord) const |
| virtual void | initialize (bb::cascades::maps::RenderEngineConfiguration config) |
| virtual bool | isBaseMapVisible () const |
| virtual void | render () |
| virtual bb::platform::geo::Point | windowToWorld (const QPoint &windowCoord) const |
| virtual QPoint | worldToWindow (const bb::platform::geo::Point &worldCoord) const |
| virtual bb::platform::geo::BoundingBox | calculateBoundingBox (const ViewProperties &view) const |
| virtual void | setViewport (const bb::cascades::maps::ViewProperties &view) |
| virtual void | setMapData (MapData *data) |
| virtual void | setBaseMapVisible (bool visible) |
| virtual void | teardown () |
| virtual bb::cascades::maps::RenderEngineInfo | characteristics () const |
| virtual bb::ImageData | generateMapImage () const |
| virtual bool | coverageSupported (const bb::cascades::maps::ViewProperties ®ion) const |
| virtual int | coveragePriority () const |
RenderEngine (QObject *parent=0) |
Signals Index
Only has inherited signals
| void | coverageUnavailable () |
| void | renderCompleted () |
Public Functions
Basic constructor.
| Parameters | |
|---|---|
| parent |
The parent object to this object. |
BlackBerry 10.0.0
virtual
Destructor.
virtualbb::cascades::maps::RenderEngine *
Creates a new instance of this render engine.
This factory method is only used through the plug-in system.
The new instance of the RenderEngine, never null.
BlackBerry 10.0.0
virtualQString
Gets the element ID of the interactable element at the given window coordinates.
| Parameters | |
|---|---|
| windowCoord |
the location of the point of interest. |
The ID of the element available, or an empty string if no element exists.
BlackBerry 10.0.0
virtual void
Initializes the engine.
BlackBerry 10.0.0
virtual bool
Indicates whether base map data is included in the rendered output.
Base map data includes items such as ground information, roads, and so on.
true if the base map is included.
BlackBerry 10.0.0
virtual void
Initiates a render cycle using the location information previously provided.
Note: This operation will not be called again until it has returned. Thus, there might be a backlog of render requests. It is important that this operation return in a timely fashion so that other messages in the messaging queue can be delivered.
BlackBerry 10.0.0
virtualbb::platform::geo::Point
Converts the screen coordinates to world coordinates.
This is a blocking call (synchronous). See the class level comment titled "Communication Between MapView and RenderEngine".
| Parameters | |
|---|---|
| windowCoord |
The coordinates within the viewport's window to convert. |
The coordinates representing the window's coordinates.
BlackBerry 10.0.0
virtualQPoint
Converts a world coordinate into a screen/window coordinate.
This is a blocking call.
| Parameters | |
|---|---|
| worldCoord |
The world (lat/lon) coordinates to convert. |
The window coordinates representing the world coordinates. The returned coordinates may not be within the current window's view.
BlackBerry 10.0.0
virtualbb::platform::geo::BoundingBox
Calculates a new bounding box based on the view properties provided.
| Parameters | |
|---|---|
| view |
The properties of the view to base the calculation on. |
A bounding box that matches the limits of the view.
BlackBerry 10.0.0
virtual void
Changes the properties of the view.
This call is not an explicit request to initiate a new render. To initiate a new render use RenderEngine::render.
This is a blocking call (synchronous). See the class level comment titled "Communication Between MapView and RenderEngine".
| Parameters | |
|---|---|
| view |
The new view properties. |
BlackBerry 10.0.0
virtual void
Gives the render engine the mapping data container holding non-atlas data.
| Parameters | |
|---|---|
| data |
The container for mapping data. This parameter is owned by the parent MapView instance. |
BlackBerry 10.0.0
virtual void
Sets whether or not the base map should be included in the rendered output.
| Parameters | |
|---|---|
| visible |
true if the base map should be included. |
BlackBerry 10.0.0
virtual void
Provides an opportunity for the engine to perform any shutdown work.
BlackBerry 10.0.0
virtualbb::cascades::maps::RenderEngineInfo
Gets the characteristics of this engine.
The information concerning the characteristics of this engine.
BlackBerry 10.0.0
virtualbb::ImageData
Converts the current map into an image.
The viewport's content as an image.
BlackBerry 10.0.0
virtual bool
Indicates whether this render engine has code coverage for the given region.
Note: Important factors to be considered are center, altitude and bounding box.
| Parameters | |
|---|---|
| region |
The region in question. |
true if this engine has map coverage for the entire region, false if partial coverage or no coverage.
BlackBerry 10.0.0
virtual int
Indicates the priority for which this engine should be used when two engines have coverage over the same area.
Thus, if render engine A and B both have coverage over the current viewport, the render engine with the higher priority will be used.
5: Reserved for Application-provided plug-in
4: 3D System Render Engine
3: 2D System Render Engine
0: Blank Render Engine (no memory consumption)
The priority for this render engine. A higher number equals a higher priority. Numbers range from 0 to 5. 5 indicates an RE should absolutely be used, while 3 indicates a "normal" priority.
BlackBerry 10.0.0
Base Constructor.
| Parameters | |
|---|---|
| parent |
The parent object to this object. |
BlackBerry 10.0.0
Signals
(Only has inherited signals)
void
Emitted when the RenderEngine cannot fully render the current map viewing area.
BlackBerry 10.0.0
void
Indicates to observers that a render cycle has been completed.
BlackBerry 10.0.0