LinkBreakVisualizerBase¶

simple module LinkBreakVisualizerBase

Base module for link break visualizer simple modules. It keeps track of link breaks in a network. Link breaks are not displayed by default, see module parameters for how to enable the visualization. The actual visualization of link breaks is done in derived modules.

This module subscribes to linkBroken on the module determined by the visualizationSubjectModule parameter. If the visualizer receives a link break signal, then it stores the broken link and starts the link break visualization.

Inheritance diagram¶

Known subclasses¶

Name	Type	Description
LinkBreakCanvasVisualizer	simple module	Visualizes link breaks on a 2D canvas. It displays an icon for each link break in the network. See the documentation of the base module for what constitutes a link break. The icon is positioned at the midpoint of the link.
LinkBreakOsgVisualizer	simple module	Visualizes link breaks on a 3D osg scene. It displays an icon for each link break in the network. See the documentation of the base module for what constitutes a link break. The icon is positioned at the middle point of the link.

Extends¶

Name	Type	Description
VisualizerBase	simple module	Base module for visualizer simple modules. It simply provides the visualization target module for 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
displayLinkBreaks	bool	false	Display icons for link breaks, disabled by default
nodeFilter	string	“*”	Which network nodes are considered, matches all nodes by default
interfaceFilter	string	“*”	Which interfaces are considered, matches all interfaces by default
packetFilter	object	“*”	Which packets are considered, matches all packets by default
icon	string	“status/stop”
iconTintAmount	double	0
iconTintColor	string	“”
fadeOutMode	string	“realTime”	Specifies how inactive link breaks fade out
fadeOutTime	double	1s	How quickly link breaks fade away, 1 second by default
fadeOutAnimationSpeed	double	0	Animation speed while there are link breaks, value must be in the range (0, +inf)

Properties¶

Name	Value	Description
class	LinkBreakVisualizerBase
display	i=block/app

Source code¶

//
// Base module for link break visualizer simple modules. It keeps
// track of link breaks in a network. Link breaks are not displayed by
// default, see module parameters for how to enable the visualization. The
// actual visualization of link breaks is done in derived modules.
//
// This module subscribes to `linkBroken` on the module determined by the
// `visualizationSubjectModule` parameter. If the visualizer receives a link break signal,
// then it stores the broken link and starts the link break visualization.
//
// @see ~LinkBreakCanvasVisualizer, ~LinkBreakOsgVisualizer, ~ILinkBreakVisualizer, ~VisualizerBase
//
simple LinkBreakVisualizerBase extends VisualizerBase
{
    parameters:
        bool displayLinkBreaks = default(false); // Display icons for link breaks, disabled by default

        string nodeFilter @mutable = default("*"); // Which network nodes are considered, matches all nodes by default
        string interfaceFilter @mutable = default("*"); // Which interfaces are considered, matches all interfaces by default
        object packetFilter @mutable = default("*"); // Which packets are considered, matches all packets by default

        string icon = default("status/stop");
        double iconTintAmount = default(0);
        string iconTintColor = default("");

        string fadeOutMode @enum("realTime", "animationTime", "simulationTime") = default("realTime"); // Specifies how inactive link breaks fade out
        double fadeOutTime @unit(s) = default(1s); // How quickly link breaks fade away, 1 second by default
        double fadeOutAnimationSpeed = default(0); // Animation speed while there are link breaks, value must be in the range (0, +inf)

        @class(LinkBreakVisualizerBase);
}

File: src/inet/visualizer/base/LinkBreakVisualizerBase.ned