Rendering of data from the maps module.
Data Structures | |
struct | dwMapsRendererLaneChannel |
struct | dwMapsRendererLaneChannelGeometry |
Typedefs | |
typedef const struct dwMapsRendererObject * | dwConstMapsRendererHandle_t |
Const handle representing vertex data for rendering. More... | |
typedef struct dwMapsRendererObject * | dwMapsRendererHandle_t |
Handle representing vertex data for rendering. More... | |
Functions | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_getRenderCoord (dwVector3f *out, const dwMapsGeoPoint *in, dwConstMapsRendererHandle_t mapsRenderer) |
Get the render coordinates of an query Wgs84 point. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_getWGS84Coord (dwMapsGeoPoint *p, uint32_t screenCoordX, uint32_t screenCoordY, uint32_t tileId, dwRenderEngineHandle_t renderEngine, dwConstMapsRendererHandle_t mapsRenderer) |
Get the WGS84 coordinates of a screen pixel. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_getWGS84CoordFromRenderCoord (dwMapsGeoPoint *p, const dwVector3f *in, dwConstMapsRendererHandle_t mapsRenderer) |
Get the WGS84 coordinates of a render coord. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_getWGS84CoordNDC (dwMapsGeoPoint *p, float32_t x, float32_t y, dwConstRenderEngineHandle_t renderEngine, dwConstMapsRendererHandle_t mapsRenderer) |
Get the WGS84 coordinates of a screen position. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_initialize (dwMapsRendererHandle_t *mapsRenderer, uint32_t maxRenderBufferLineCount, uint32_t maxRenderBufferPointCount, uint32_t maxRenderBufferTriangleCount, bool showMapLineDirections, dwRenderEngineHandle_t renderEngine, dwConstMapHandle_t map) |
Initialize maps renderer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_isPixelCoordInBox (bool *isInBox, uint32_t screenCoordX, uint32_t screenCoordY, const dwMapsGeoPoint *boxCenter, float32_t sizeMeters, uint32_t tileId, dwRenderEngineHandle_t renderEngine, dwConstMapsRendererHandle_t mapsRenderer) |
Check if a window pixel is within a box. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_isPixelCoordInOrientedBox (bool *isInBox, uint32_t screenCoordX, uint32_t screenCoordY, const dwMapsGeoPoint *boxCenter, float32_t bearingRadian, float32_t lengthMeters, float32_t widthMeters, uint32_t tileId, dwRenderEngineHandle_t renderEngine, dwConstMapsRendererHandle_t mapsRenderer) |
Check if a window pixel is within an oriented box. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_moveTopDownModelView (float32_t dx, float32_t dy, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Shift the position of an orthographic top-down camera horizonally and vertically by meters. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_release (dwMapsRendererHandle_t mapsRenderer) |
Release maps renderer and its resources. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderBox (const dwVector3f *position, const dwMapsGeoPoint *origin, float32_t sizeMeters, bool withCenterCross, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Render a square box for local [x,y,z] point in the absolute coordinate system. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderBoxInLocalLayout (const dwVector3f *position, const dwMapsRoadSegmentId roadSegmentId, float32_t sizeMeters, bool withCenterCross, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer, dwConstMapsLocalLayoutHandle_t localLayout) |
Render a square box for local [x,y,z] point in local coordinate system. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderGeoBox (const dwMapsGeoPoint *position, float32_t sizeMeters, bool withCenterCross, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Render a square box. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderGeoPoints (const dwMapsGeoPoint *geoPoints, uint32_t geoPointCount, const dwVector4f *colors, uint32_t colorCount, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add wgs84 points to a render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderGeoPolylines (const dwMapsGeoPolyline *polylines, uint32_t polylineCount, const dwRenderEngineColorRGBA *colors, uint32_t colorCount, bool showLineDirection, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add a wgs84 polyline to a render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderLaneChannel (const dwMapsRendererLaneChannel *laneChannel, const dwVector4f *channelColor, const bool fillChannel, const bool renderDirection, const bool renderDividerPolylines, const dwMapsRoadSegmentId *roadSegmentId, dwConstMapsLocalLayoutHandle_t localLayoutHandle, dwRenderEngineHandle_t renderEngineHandle, dwMapsRendererHandle_t mapsRendererHandle) |
Render a lane channel in LocalLayout. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderLaneChannels (dwRenderEngineHandle_t renderEngineHandle, dwMapsRendererHandle_t mapsRendererHandle) |
Render lane channels populated by the dwMapsRenderer_updateLaneChannels(...) API. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderLanePlan (dwConstLanePlanHandle_t lanePlan, bool showLineDirections, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add a lane plan to the static render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderMap (dwRenderEngineHandle_t renderEngine, bool renderInLocalLayout, dwMapsRendererHandle_t mapsRenderer) |
Render the complete map. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderOrientedBox (const dwVector3f *position, const dwMapsGeoPoint *origin, float32_t bearingRadian, float32_t length, float32_t width, bool withCenterCross, bool withOrientation, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add an oriented box for local [x,y,z] point in absolute coordinate system. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderOrientedBoxInLocalLayout (const dwVector3f *position, const dwMapsRoadSegmentId roadSegmentId, float32_t bearingRadian, float32_t length, float32_t width, bool withCenterCross, bool withOrientation, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer, dwConstMapsLocalLayoutHandle_t localLayout) |
Add an oriented box for local [x,y,z] point in a local coordinate system . More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderOrientedGeoBox (const dwMapsGeoPoint *position, float32_t bearingRadian, float32_t length, float32_t width, bool withCenterCross, bool withOrientation, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add an oriented box. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderPoints (const dwVector3f *points, uint32_t pointsCount, const dwMapsGeoPoint *origins, uint32_t originsCount, const dwVector4f *color, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add local [x,y,z] points in the absolute coordinate system to a render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderPointsInLocalLayout (const dwVector3f *points, uint32_t pointsCount, const dwMapsRoadSegmentId *roadSegmentIds, uint32_t segmentIdCount, const dwVector4f *color, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer, dwConstMapsLocalLayoutHandle_t localLayout) |
Add local [x,y,z] points in a local coordinate system to a render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderPolylines (const dwPolyline3f *polylines, uint32_t polylineCount, const dwMapsGeoPoint *origins, uint32_t originsCount, const dwVector4f *colors, uint32_t colorCount, bool showLineDirection, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Add a local [x,y,z] polyline in the absolute coordinate system to a render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_renderPolylinesInLocalLayout (const dwPolyline3f *polylines, uint32_t polylineCount, const dwVector4f *colors, uint32_t colorCount, const dwMapsRoadSegmentId *roadSegmentIds, uint32_t segmentIdCount, bool showLineDirection, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer, dwConstMapsLocalLayoutHandle_t localLayout) |
Add a local [x,y,z] polyline in a local coordinate system to a render buffer. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_setLocalLayout (const dwMapsRoadSegmentBuffer *roadSegmentBuffer, bool showMapLineDirections, dwConstMapsLocalLayoutHandle_t localLayout, dwMapsRendererHandle_t mapsRenderer) |
computes transformations for road segments relative to the reference road segment and apply them to the map. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_setLookAt (const dwMapsGeoPoint *cameraPos, const dwMapsGeoPoint *lookAtPoint, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Set camera position and orientation of the current tile in the render engine. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_setTopDownModelView (const dwMapsGeoPoint *cameraPos, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Set the position of an orthographic top-down camera. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_setTopDownProjection (float32_t windowHeightInMeters, dwRenderEngineHandle_t renderEngine, dwMapsRendererHandle_t mapsRenderer) |
Set the zoom of an orthographic top-down camera. More... | |
DW_VIZ_API_PUBLIC dwStatus | dwMapsRenderer_updateLaneChannels (const dwMapsRendererLaneChannel *laneChannels, const uint32_t channelCount, const dwVector4f *channelColor, const bool renderDirection, const dwMapsRoadSegmentId *roadSegmentId, dwConstMapsLocalLayoutHandle_t localLayoutHandle, dwMapsRendererHandle_t mapsRendererHandle) |
Update lane channel render buffer. More... | |
struct dwMapsRendererLaneChannel |
Data Fields | ||
---|---|---|
dwMapsRendererLaneChannelGeometry | geometry | |
const dwMapsLaneDividerType * | leftDividerTypes | |
const dwMapsLaneDividerType * | rightDividerTypes |
struct dwMapsRendererLaneChannelGeometry |
Data Fields | ||
---|---|---|
const dwVector3f * | center | |
const dwVector3f * | left | |
uint32_t | pointsCount | |
const dwVector3f * | right |
typedef const struct dwMapsRendererObject* dwConstMapsRendererHandle_t |
Const handle representing vertex data for rendering.
Definition at line 84 of file MapsRenderer.h.
typedef struct dwMapsRendererObject* dwMapsRendererHandle_t |
Handle representing vertex data for rendering.
Definition at line 82 of file MapsRenderer.h.
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_getRenderCoord | ( | dwVector3f * | out, |
const dwMapsGeoPoint * | in, | ||
dwConstMapsRendererHandle_t | mapsRenderer | ||
) |
Get the render coordinates of an query Wgs84 point.
The render coordinate system was fully defined by dwMapsRenderer_setReferencePoint(...) API
[out] | out | Render coordinates of the query point |
[in] | in | A query Wgs84 point |
[in] | mapsRenderer | Maps renderer. |
in
is a nullptr or 'mapsRenderer' is not a valid maps renderer handle. DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_getWGS84Coord | ( | dwMapsGeoPoint * | p, |
uint32_t | screenCoordX, | ||
uint32_t | screenCoordY, | ||
uint32_t | tileId, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwConstMapsRendererHandle_t | mapsRenderer | ||
) |
Get the WGS84 coordinates of a screen pixel.
Assumes origin of the pixels (0,0) to be the top-left corner of the window.
[out] | p | Resulting WGS84 point. |
[in] | screenCoordX | x pixel coordinate (relative to window, not tile) |
[in] | screenCoordY | y pixel coordinate (relative to window, not tile) |
[in] | tileId | Tile id where top down view is rendered (contains camera state), 0 if default tile is used. |
[in] | renderEngine | Render engine handle |
[in] | mapsRenderer | Maps renderer |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_getWGS84CoordFromRenderCoord | ( | dwMapsGeoPoint * | p, |
const dwVector3f * | in, | ||
dwConstMapsRendererHandle_t | mapsRenderer | ||
) |
Get the WGS84 coordinates of a render coord.
[out] | p | Resulting WGS84 point. |
[in] | in | Render coordinates of the query point |
[in] | mapsRenderer | Maps renderer |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_getWGS84CoordNDC | ( | dwMapsGeoPoint * | p, |
float32_t | x, | ||
float32_t | y, | ||
dwConstRenderEngineHandle_t | renderEngine, | ||
dwConstMapsRendererHandle_t | mapsRenderer | ||
) |
Get the WGS84 coordinates of a screen position.
Origin (0.0f,0.0f) is the center of the screen, (-1.0f, -1.0f) represents the bottom left, (1.0f, 1.0f) represents the top right
[out] | p | Resulting position. |
[in] | x | Normalized horizontal screen coordinate, -1 to 1 |
[in] | y | Normalized vertical screen coordinate, -1 to 1 |
[in] | renderEngine | Render engine |
[in] | mapsRenderer | Maps renderer |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_initialize | ( | dwMapsRendererHandle_t * | mapsRenderer, |
uint32_t | maxRenderBufferLineCount, | ||
uint32_t | maxRenderBufferPointCount, | ||
uint32_t | maxRenderBufferTriangleCount, | ||
bool | showMapLineDirections, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwConstMapHandle_t | map | ||
) |
Initialize maps renderer.
[out] | mapsRenderer | Initialized maps renderer. |
[in] | maxRenderBufferLineCount | Maximum number of lines rendered in a single render call |
[in] | maxRenderBufferPointCount | Maximum number of points rendered in a single render call |
[in] | maxRenderBufferTriangleCount | Maximum number of triangles rendered in a single render call |
[in] | showMapLineDirections | If true, the rendered lines for the map lane dividers are shaded, starting with a darker color, getting brighter towards the end. This can be used to visualize the dwMapsRoadSegments. |
[in] | renderEngine | Render engine handle. Used to initialize the render buffer for lane divider lines of the map. |
[in] | map | Map that gets rendered. The render buffer for the map lines gets sized based on the number of lane dividers in the map at this call. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_isPixelCoordInBox | ( | bool * | isInBox, |
uint32_t | screenCoordX, | ||
uint32_t | screenCoordY, | ||
const dwMapsGeoPoint * | boxCenter, | ||
float32_t | sizeMeters, | ||
uint32_t | tileId, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwConstMapsRendererHandle_t | mapsRenderer | ||
) |
Check if a window pixel is within a box.
[out] | isInBox | Result. |
[in] | screenCoordX | x pixel coordinate (relative to window, not tile) |
[in] | screenCoordY | y pixel coordinate (relative to window, not tile) |
[in] | boxCenter | WGS84 coordinates of the box center |
[in] | sizeMeters | Exent of the square box in meters. |
[in] | tileId | ID of the render engine tile that where the box is rendered. 0 if default tile is used. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_isPixelCoordInOrientedBox | ( | bool * | isInBox, |
uint32_t | screenCoordX, | ||
uint32_t | screenCoordY, | ||
const dwMapsGeoPoint * | boxCenter, | ||
float32_t | bearingRadian, | ||
float32_t | lengthMeters, | ||
float32_t | widthMeters, | ||
uint32_t | tileId, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwConstMapsRendererHandle_t | mapsRenderer | ||
) |
Check if a window pixel is within an oriented box.
[out] | isInBox | Result. |
[in] | screenCoordX | x pixel coordinate (relative to window, not tile) |
[in] | screenCoordY | y pixel coordinate (relative to window, not tile) |
[in] | boxCenter | WGS84 coordinates of the box center |
[in] | bearingRadian | Orientation of the box in radian, clockwise. |
[in] | lengthMeters | Length of the box in meters. |
[in] | widthMeters | Width of the box in meters. |
[in] | tileId | ID of the render engine tile that where the box is rendered. 0 if default tile is used. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_moveTopDownModelView | ( | float32_t | dx, |
float32_t | dy, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Shift the position of an orthographic top-down camera horizonally and vertically by meters.
[in] | dx | Longitudinal shift by meters, positive to the right |
[in] | dy | Vertical shift by meters, positive upwards |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_release | ( | dwMapsRendererHandle_t | mapsRenderer | ) |
Release maps renderer and its resources.
[in,out] | mapsRenderer |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderBox | ( | const dwVector3f * | position, |
const dwMapsGeoPoint * | origin, | ||
float32_t | sizeMeters, | ||
bool | withCenterCross, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Render a square box for local [x,y,z] point in the absolute coordinate system.
[in] | position | WGS84 coordinates of the box center. |
[in] | origin | Wgs84 point which defines ENU space of local coordinates. |
[in] | sizeMeters | Extent of the box in meters. |
[in] | withCenterCross | Render a cross in the center of the box to visualize its precise position. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderBoxInLocalLayout | ( | const dwVector3f * | position, |
const dwMapsRoadSegmentId | roadSegmentId, | ||
float32_t | sizeMeters, | ||
bool | withCenterCross, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer, | ||
dwConstMapsLocalLayoutHandle_t | localLayout | ||
) |
Render a square box for local [x,y,z] point in local coordinate system.
[in] | position | WGS84 coordinates of the box center. |
[in] | roadSegmentId | RoadSegmentId of a road segment in the local layout. The road segment should exist in the local layout. |
[in] | sizeMeters | Extent of the box in meters. |
[in] | withCenterCross | Render a cross in the center of the box to visualize its precise position. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
[in] | localLayout | Local layout handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderGeoBox | ( | const dwMapsGeoPoint * | position, |
float32_t | sizeMeters, | ||
bool | withCenterCross, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Render a square box.
[in] | position | WGS84 coordinates of the box center. |
[in] | sizeMeters | Extent of the box in meters. |
[in] | withCenterCross | Render a cross in the center of the box to visualize its precise position. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderGeoPoints | ( | const dwMapsGeoPoint * | geoPoints, |
uint32_t | geoPointCount, | ||
const dwVector4f * | colors, | ||
uint32_t | colorCount, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add wgs84 points to a render buffer.
Overlay arbitrary wgs84 points over the maps data.
[in] | geoPoints | Wgs84 polypoint to render. |
[in] | geoPointCount | Polypoint count |
[in] | colors | Color array |
[in] | colorCount | Number of colors in color array. If no colors are provided, current tile color is used. If there are less colors than polypoints, the last color will be used for the last polypoints. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderGeoPolylines | ( | const dwMapsGeoPolyline * | polylines, |
uint32_t | polylineCount, | ||
const dwRenderEngineColorRGBA * | colors, | ||
uint32_t | colorCount, | ||
bool | showLineDirection, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add a wgs84 polyline to a render buffer.
Overlay an arbitrary wgs84 polyline over the maps data.
[in] | polylines | Wgs84 polylines to render. |
[in] | polylineCount | Polyline count |
[in] | colors | Color array |
[in] | colorCount | Number of colors in color array. If no colors are provided, current tile color is used. If there are less colors than polylines, the last color will be used for the last polylines. |
[in] | showLineDirection | If true, the polyline is shaded to visualize where its direction (darker at the start, brighter at the end). |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderLaneChannel | ( | const dwMapsRendererLaneChannel * | laneChannel, |
const dwVector4f * | channelColor, | ||
const bool | fillChannel, | ||
const bool | renderDirection, | ||
const bool | renderDividerPolylines, | ||
const dwMapsRoadSegmentId * | roadSegmentId, | ||
dwConstMapsLocalLayoutHandle_t | localLayoutHandle, | ||
dwRenderEngineHandle_t | renderEngineHandle, | ||
dwMapsRendererHandle_t | mapsRendererHandle | ||
) |
Render a lane channel in LocalLayout.
[in] | laneChannel | Lane channel to render. |
[in] | channelColor | Channel fill color. |
[in] | fillChannel | If true, channel is filled with channelColor. |
[in] | renderDirection | If true, channel direction is rendered. |
[in] | renderDividerPolylines | If true, channel divider are rendered. |
[in] | roadSegmentId | RoadSegmentId of a road segment in the local layout. The road segment should exist in the local layout. |
[in] | localLayoutHandle | Local layout handle. |
[in] | renderEngineHandle | Render engine handle. |
[in] | mapsRendererHandle | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderLaneChannels | ( | dwRenderEngineHandle_t | renderEngineHandle, |
dwMapsRendererHandle_t | mapsRendererHandle | ||
) |
Render lane channels populated by the dwMapsRenderer_updateLaneChannels(...) API.
[in] | renderEngineHandle | Render engine Handle. |
[in] | mapsRendererHandle | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderLanePlan | ( | dwConstLanePlanHandle_t | lanePlan, |
bool | showLineDirections, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add a lane plan to the static render buffer.
This adds the lane plan lines to the render buffer for static lines, so it overlays the lane plan over the map data.
[in] | lanePlan | Lane plan to be rendered. |
[in] | showLineDirections | If true, the lane plan lines are shaded to visualize where lane plan lines start and end (darker at the start, brighter at the end). This can be used to visualized the lane plane segments. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderMap | ( | dwRenderEngineHandle_t | renderEngine, |
bool | renderInLocalLayout, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Render the complete map.
[in] | renderEngine | Render engine. |
[in] | renderInLocalLayout | If true, map is rendered in Local Layout of a reference roadsegment |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderOrientedBox | ( | const dwVector3f * | position, |
const dwMapsGeoPoint * | origin, | ||
float32_t | bearingRadian, | ||
float32_t | length, | ||
float32_t | width, | ||
bool | withCenterCross, | ||
bool | withOrientation, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add an oriented box for local [x,y,z] point in absolute coordinate system.
Transform position of an oriented box in ENU space coordinates into the absolute coordinate system based on a input Wgs84 origin of a road segment
[in] | position | Center point of the box in local coordinate system. |
[in] | origin | Wgs84 points which defines ENU space of local coordinates. |
[in] | bearingRadian | Rotation of the box in radian. 0 means pointing up (which is north at the reference point for rendering), rotation is clock-wise. |
[in] | length | Length of the box in meters. |
[in] | width | Width of the box in meters. |
[in] | withCenterCross | Render a cross in the center of the box to visualize its precise position. |
[in] | withOrientation | Render an arrow forward, towards 'bearingRadian'. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderOrientedBoxInLocalLayout | ( | const dwVector3f * | position, |
const dwMapsRoadSegmentId | roadSegmentId, | ||
float32_t | bearingRadian, | ||
float32_t | length, | ||
float32_t | width, | ||
bool | withCenterCross, | ||
bool | withOrientation, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer, | ||
dwConstMapsLocalLayoutHandle_t | localLayout | ||
) |
Add an oriented box for local [x,y,z] point in a local coordinate system .
Transform position of an oriented box in ENU space coordinates into the local coordinate system based on a input Wgs84 origin of a road segment
[in] | position | Center point of the box in local coordinate system. |
[in] | roadSegmentId | RoadSegmentId of a road segment in the local layout. The road segment should exist in the local layout. |
[in] | bearingRadian | Rotation of the box in radian. 0 means pointing up (which is north at the reference point for rendering), rotation is clock-wise. |
[in] | length | Length of the box in meters. |
[in] | width | Width of the box in meters. |
[in] | withCenterCross | Render a cross in the center of the box to visualize its precise position. |
[in] | withOrientation | Render an arrow forward, towards 'bearingRadian'. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
[in] | localLayout | Local layout handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderOrientedGeoBox | ( | const dwMapsGeoPoint * | position, |
float32_t | bearingRadian, | ||
float32_t | length, | ||
float32_t | width, | ||
bool | withCenterCross, | ||
bool | withOrientation, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add an oriented box.
Adds an oriented box
[in] | position | Center point of the box. |
[in] | bearingRadian | Rotation of the box in radian. 0 means pointing up (which is north at the reference point for rendering), rotation is clock-wise. |
[in] | length | Length of the box in meters. |
[in] | width | Width of the box in meters. |
[in] | withCenterCross | Render a cross in the center of the box to visualize its precise position. |
[in] | withOrientation | Render an arrow forward, towards 'bearingRadian'. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderPoints | ( | const dwVector3f * | points, |
uint32_t | pointsCount, | ||
const dwMapsGeoPoint * | origins, | ||
uint32_t | originsCount, | ||
const dwVector4f * | color, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add local [x,y,z] points in the absolute coordinate system to a render buffer.
Transform arbitrary local [x,y,z] points in ENU space coordinates into the absolute coordinate system based on input Wgs84 origin of road segments. Overlay resulting points on the maps data.
[in] | points | Local [x,y,z] points to render. |
[in] | pointsCount | Number of points in points array |
[in] | origins | Wgs84 points which defines ENU space of local coordinates. |
[in] | originsCount | Number of origins in origins array, if only one origin is provided it is used to transform all points . |
[in] | color | Color for points |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderPointsInLocalLayout | ( | const dwVector3f * | points, |
uint32_t | pointsCount, | ||
const dwMapsRoadSegmentId * | roadSegmentIds, | ||
uint32_t | segmentIdCount, | ||
const dwVector4f * | color, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer, | ||
dwConstMapsLocalLayoutHandle_t | localLayout | ||
) |
Add local [x,y,z] points in a local coordinate system to a render buffer.
Transform local [x,y,z] points in ENU space coordinates into local coordinate system of a road-segment based on the pre-computed local layout. Overlay resulting point on the maps data.
[in] | points | Local [x,y,z] points to render. |
[in] | pointsCount | Number of points in points array |
[in] | roadSegmentIds | RoadSegmentIds of road segment in the local layout. The road segments should exist in the local layout. |
[in] | segmentIdCount | Number of RoadSegmentIds in the array. |
[in] | color | Color for points |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
[in] | localLayout | Local layout handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderPolylines | ( | const dwPolyline3f * | polylines, |
uint32_t | polylineCount, | ||
const dwMapsGeoPoint * | origins, | ||
uint32_t | originsCount, | ||
const dwVector4f * | colors, | ||
uint32_t | colorCount, | ||
bool | showLineDirection, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Add a local [x,y,z] polyline in the absolute coordinate system to a render buffer.
Transform local [x,y,z] polylines in ENU space coordinates into the absolute coordinate system based on input Wgs84 origins of road segments Overlay resulting polyline on the maps data.
[in] | polylines | Local [x,y,z] polylines to render. |
[in] | polylineCount | Number of polylines in polylines array |
[in] | colors | Color array |
[in] | colorCount | Number of colors in color array. If no colors are provided, current tile color is used. If there are less colors than polylines, the last color will be used for the last polylines. |
[in] | origins | Wgs84 points which defines ENU space of local coordinates. |
[in] | originsCount | Number of origins in origins array, if only one origin is provided it is used for all the polyline transformation. |
[in] | showLineDirection | If true, the polyline is shaded to visualize where its direction (darker at the start, brighter at the end). |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_renderPolylinesInLocalLayout | ( | const dwPolyline3f * | polylines, |
uint32_t | polylineCount, | ||
const dwVector4f * | colors, | ||
uint32_t | colorCount, | ||
const dwMapsRoadSegmentId * | roadSegmentIds, | ||
uint32_t | segmentIdCount, | ||
bool | showLineDirection, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer, | ||
dwConstMapsLocalLayoutHandle_t | localLayout | ||
) |
Add a local [x,y,z] polyline in a local coordinate system to a render buffer.
Transform local [x,y,z] polylines in ENU space coordinates into local coordinate system of a road-segment based on the pre-computed local layout. Overlay resulting polyline on the maps data.
[in] | polylines | Local [x,y,z] polylines to render. |
[in] | polylineCount | Number of polylines in polylines array |
[in] | colors | Color array |
[in] | colorCount | Number of colors in color array. |
[in] | roadSegmentIds | RoadSegmentIds of road segment in the local layout. The road segments should exist in the local layout. |
[in] | segmentIdCount | Number of RoadSegmentIds in the array. |
[in] | showLineDirection | If true, the polyline is shaded to visualize where its direction. (darker at the start, brighter at the end). |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
[in] | localLayout | Handle to local layout for the reference road segment. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_setLocalLayout | ( | const dwMapsRoadSegmentBuffer * | roadSegmentBuffer, |
bool | showMapLineDirections, | ||
dwConstMapsLocalLayoutHandle_t | localLayout, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
computes transformations for road segments relative to the reference road segment and apply them to the map.
[in] | roadSegmentBuffer | Buffer containing the roadsegments for which localLayout is computed |
[in] | showMapLineDirections | If true, the rendered lines for the map lane dividers are shaded, starting with a darker color, getting brighter towards the end. This can be used to visualize the dwMapsRoadSegments. |
[in] | localLayout | Handle to local layout for the reference road segment. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_setLookAt | ( | const dwMapsGeoPoint * | cameraPos, |
const dwMapsGeoPoint * | lookAtPoint, | ||
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Set camera position and orientation of the current tile in the render engine.
[in] | cameraPos | Camera position in WGS84 coordinates. |
[in] | lookAtPoint | Point towards which the camera is looking in WGS84 coordinates. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_setTopDownModelView | ( | const dwMapsGeoPoint * | cameraPos, |
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Set the position of an orthographic top-down camera.
[in] | cameraPos | Camera position in wgs84 coordinates. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_setTopDownProjection | ( | float32_t | windowHeightInMeters, |
dwRenderEngineHandle_t | renderEngine, | ||
dwMapsRendererHandle_t | mapsRenderer | ||
) |
Set the zoom of an orthographic top-down camera.
This is defined by how many meters fit into the height of the window.
[in] | windowHeightInMeters | Required distance covered by window height in meters. |
[in] | renderEngine | Render engine handle. |
[in] | mapsRenderer | Maps renderer handle. |
DW_VIZ_API_PUBLIC dwStatus dwMapsRenderer_updateLaneChannels | ( | const dwMapsRendererLaneChannel * | laneChannels, |
const uint32_t | channelCount, | ||
const dwVector4f * | channelColor, | ||
const bool | renderDirection, | ||
const dwMapsRoadSegmentId * | roadSegmentId, | ||
dwConstMapsLocalLayoutHandle_t | localLayoutHandle, | ||
dwMapsRendererHandle_t | mapsRendererHandle | ||
) |
Update lane channel render buffer.
[in] | laneChannels | List of lane channels to populate render buffer. |
[in] | channelCount | Number of channels. |
[in] | channelColor | Channel fill color. |
[in] | renderDirection | If true, channel direction is rendered. |
[in] | roadSegmentId | RoadSegmentId of a road segment in the local layout. The road segment should exist in the local layout. |
[in] | localLayoutHandle | Local layout handle. |
[in] | mapsRendererHandle | Maps renderer handle. |