PacketDropVisualizerBase

simple module

This is a base module for packet drop visualizer simple modules. It keeps track of dropped packets in a network. Packet drops are not displayed by default, see module parameters for how to enable the visualization. The actual visualization of packet drops is done in derived modules.

This module subscribes for packetFromLowerDropped and packetFromUpperDropped on the module determined by the subscriptionModule parameter. If the visualizer receives a packet dropped signal, then it stores the dropped packet and starts the drop visualization.

Inheritance diagram

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

Known subclasses

Name	Type	Description
PacketDropCanvasVisualizer	simple module	This module visualizes packet drops on a 2D canvas. It displays an icon for each packet drop in the network. See the documentation of the base module for what constitutes a packet drop.
PacketDropOsgVisualizer	simple module	This module visualizes packet drops on a 3D osg scene. It displays an icon for each packet drop in the network. See the documentation of the base module for what constitutes a packet drop.

Extends

Name	Type	Description
VisualizerBase	simple module	This is a base module for visualizer simple modules. It simply provides the visualization target module for derived modules.

Parameters

Name	Type	Default value	Description
visualizerTargetModule	string	""	module path relative to the visualizer where the visualization should appear in the user interface, root module by default
tags	string	""	tag added to each visualization for disambiguation in the runtime environment
subscriptionModule	string	""	module where the visualizer subscribes for packet drop signals, root module by default
displayPacketDrops	bool	false	display icons for packet drops, 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	string	"*"	which packets are considered, matches all packets by default
icon	string	"msg/packet_s"	packet drop visualization icon
iconTintAmount	double	0	colorization amount between 0 and 1, disabled by default
iconTintColor	string	""	color for icon tinting, disabled by default
labelFont	string	""	label font, automatic by default
labelColor	string	"black"	label color, black by default
fadeOutMode	string	"realTime"	specifies how inactive packet drops fade out
fadeOutTime	double	1s	how quickly packet drops fade away, 1 second by default
fadeOutAnimationSpeed	double	0	animation speed while there are packet drops, value must be in the range (0, +inf)

Properties

Name	Value	Description
class	PacketDropVisualizerBase
display	i=block/app_s

Source code

//
// This is a base module for packet drop visualizer simple modules. It keeps
// track of dropped packets in a network. Packet drops are not displayed by
// default, see module parameters for how to enable the visualization. The
// actual visualization of packet drops is done in derived modules.
//
// This module subscribes for packetFromLowerDropped and packetFromUpperDropped
// on the module determined by the subscriptionModule parameter. If the
// visualizer receives a packet dropped signal, then it stores the dropped
// packet and starts the drop visualization.
//
// @see ~PacketDropCanvasVisualizer, ~PacketDropOsgVisualizer, ~IPacketDropVisualizer, ~VisualizerBase
//
simple PacketDropVisualizerBase extends VisualizerBase
{
    parameters:
        string subscriptionModule = default("<root>"); // module where the visualizer subscribes for packet drop signals, root module by default

        bool displayPacketDrops = default(false); // display icons for packet drops, 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
        string packetFilter @mutable = default("*"); // which packets are considered, matches all packets by default

        string icon = default("msg/packet_s"); // packet drop visualization icon
        double iconTintAmount = default(0); // colorization amount between 0 and 1, disabled by default
        string iconTintColor = default(""); // color for icon tinting, disabled by default

        string labelFont = default("<default>"); // label font, automatic by default
        string labelColor = default("black"); // label color, black by default

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

        @class(PacketDropVisualizerBase);
}

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