Appendix: Figure Definitions¶

This appendix provides a reference for defining figures in NED files.

Built-in Figure Types¶

The following table lists the figure types supported by OMNeT++.

Additional figure types can be defined with the custom:``<type>`` syntax; see the FigureType below.

Attribute Types¶

This section lists the available attribute types and their value syntaxes.

bool

:

true or false.

int

:

An integer.

double

:

A real number.

double01

:

A real number in the interval [0,1].

degrees

:

A real number that will be interpreted as degrees.

string

:

A string. It only needs to be enclosed in quotes if it contains a comma, a semicolon, an unmatched close parenthesis, or any other character that prevents it from being properly parsed as a property value.

Anchor

:

c, center, n, e, s, w, nw, ne, se, sw, start, middle, or end. The last three are only valid for text figures.

Arrowhead

:

none, simple, triangle, or barbed.

CapStyle

:

butt, square, or round.

Color

:

A color in HTML format (#rrggbb), a color in HSB format (@hhssbb), or a valid SVG color name.

Dimensions

: width, height

Size given as width and height.

FigureType

:

One of the built-in figure types (e.g. line or arc, see Built-in Figure Types), or a figure type registered with Register_Figure().

FillRule

:

evenodd or nonzero.

Font

: typeface, size, style

All three items are optional. size is the font size in points. style is a space-separated list of zero or more of the following words: normal, bold, italic, underline.

ImageName

:

The name of an image.

Interpolation

:

none, fast, or best.

JoinStyle

:

bevel, miter, or round.

LineStyle

:

solid, dotted, or dashed.

Point

: x, y

A point with coordinates \((x,y)\).

Point2

: x1, y1, x2, y2

Two points: \((x1,y1)\) and \((x2,y2)\).

PointList

: x1, y1, x2, y2, x3, y3…

A list of points such as \((x1,y1)\), \((x2,y2)\), \((x3,y3)\), etc.

Rectangle

: x, y, width, height

A rectangle given by its top-left corner and dimensions.

TagList

: tag1, tag2, tag3…

A list of string tags.

Tint

: Color, double01

Specifies the tint color and the amount of tinting for images.

Transform

:

One or more transform steps. A step can be one of the following:

translate(\(x\),\(y\)),

rotate(\(deg\)),

rotate(\(deg\),\(centerx\),\(centery\)),

scale(\(s\)), scale(\(sx\),\(sy\)),

scale(\(s\),\(centerx\),\(centery\)),

scale(\(sx\),\(sy\),\(centerx\),\(centery\)),

skewx(\(coeff\)),

skewx(\(coeff\),\(centery\)),

skewy(\(coeff\)),

skewy(\(coeff\),\(centerx\)),

matrix(\(a\),\(b\),\(c\),\(d\),\(t1\),\(t2\))

Figure Attributes¶

This section lists the attributes accepted by individual figure types. Types enclosed in parentheses are abstract types that cannot be used directly; their sole purpose is to provide a base for more specialized types.