OpenStreetMapSceneCanvasVisualizer

Package: inet.visualizer.canvas.scene

OpenStreetMapSceneCanvasVisualizer

simple module

C++ definition

Visualizes a stream map given in an OpenStreetMap (openstreetmap.org) file. Other objects of the scene are placed on the map according to the coordinate system module.

<b>See also:</b> ~SceneCanvasVisualizer, ~SceneVisualizer, ~SceneVisualizerBase, ~ISceneVisualizer

<b>See also:</b> ~IGeographicCoordinateSystem, ~SimpleGeographicCoordinateSystem, ~OsgGeographicCoordinateSystem

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Extends

Name Type Description
SceneVisualizerBase simple module

Base module for scene visualizer simple modules. It determines the bounds of the scene, which is the minimum area where the whole simulation fits in. The scene encloses all physical objects and the constraint area of all mobile nodes. The visualizer also provides a timer that can be used to periodically update the user interface independently of the underlying simulation. The actual visualization of the scene is done in derived modules.

Parameters

Name Type Default value Description
displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information

visualizationTargetModule string "^"

Module path relative to the visualizer which determines where the visualization should appear in the user interface, parent module by default

visualizationSubjectModule string "^"

Module path relative to the visualizer which determines what part of the simulation model the visualizer displays in the user interface, parent module by default

tags string ""

Tag added to each visualization for disambiguation in the runtime environment

physicalEnvironmentModule string "physicalEnvironment"

The physical environment module, refers to a top-level submodule by default

networkNodeVisualizerModule string "^.networkNodeVisualizer"

The network node visualizer, refers to a sibling submodule by default

axisLength double nan m

Length of x, y, and z axes, no axis by default

animationSpeed double 0

Always active animation speed independent of any visualization, the value must be in the range (0, +inf)

sceneMinX double nan m

Lower bound of x coordinates in the scene

sceneMinY double nan m

Lower bound of y coordinates in the scene

sceneMinZ double nan m

Lower bound of z coordinates in the scene

sceneMaxX double nan m

Upper bound of x coordinates in the scene

sceneMaxY double nan m

Upper bound of y coordinates in the scene

sceneMaxZ double nan m

Upper bound of z coordinates in the scene

coordinateSystemModule string "coordinateSystem"

The geographic coordinate system, refers to a top-level module by default

mapFile xml

OpenStreetMap map file, e.g. one exported from openstreetmap.org

zIndex double 0

Determines the drawing order of figures relative to other visualizers

adjustBackgroundBox bool true

If true, sets the background box (bgb tag) to match map bounds

Properties

Name Value Description
class OpenStreetMapSceneCanvasVisualizer
display i=block/app

Source code

//
// Visualizes a stream map given in an OpenStreetMap (openstreetmap.org) file.
// Other objects of the scene are placed on the map according to the coordinate system module.
//
// @see ~SceneCanvasVisualizer, ~SceneVisualizer, ~SceneVisualizerBase, ~ISceneVisualizer
// @see ~IGeographicCoordinateSystem, ~SimpleGeographicCoordinateSystem, ~OsgGeographicCoordinateSystem
//
simple OpenStreetMapSceneCanvasVisualizer extends SceneVisualizerBase like ISceneVisualizer
{
    parameters:
        @class(OpenStreetMapSceneCanvasVisualizer);
        string coordinateSystemModule = default("coordinateSystem"); // The geographic coordinate system, refers to a top-level module by default

        xml mapFile; // OpenStreetMap map file, e.g. one exported from openstreetmap.org

        double zIndex = default(0); // Determines the drawing order of figures relative to other visualizers
        bool adjustBackgroundBox = default(true); // If true, sets the background box (bgb tag) to match map bounds
}

File: src/inet/visualizer/canvas/scene/OpenStreetMapSceneCanvasVisualizer.ned