Point Node

Nodes and paths are space markup elements that define the locations of agents in the space:

Nodes can be connected with paths. Altogether they compose a network. In the network, node defines a place where agents may reside, while paths define the routes that agents may take when moving from one node to another. 

Point node is a node that does not have area, but has just a point size. Usually it defines a transit transportation node in a network.

There are nodes of two other shapes at your hands:

Rectangular node. Use it to draw a rectangular area. 

Polygonal node. Use it to draw an area of complex form.

Polygonal node and Rectangular node are used when your nodes define some areas (offices, rooms, etc.) where agents may stay inside. Use Polygonal node when your area has complex form. If your area is rectangular, use Rectangular node instead. 

 To add a point node

  1. Drag the Point node element from the  Space Markup palette to the graphical diagram.

Properties

General

Name – The name of the node. The name is used to identify and access the node from code.

Ignore – If selected, the node is excluded from the model.

Visible on upper level – If selected, the node is also visible on the upper level where this agent lives.

Lock – If selected, the node shape is locked. Locked shapes do not react to mouse clicks - it is impossible to select them in the graphical editor until you unlock them. 

Visible – Here you specify whether the shape is visible on animation at model runtime, or not. Using the control, choose yes or no.

Color – Shape's fill and outline color. Choose No Color, if you do not want shape to be filled.

Position ans size

X – X-coordinate of the area's start point.

Y – Y-coordinate of the area's start point.

Z – [Enabled if Show in: 3D only option is selected] Z-coordinate of the area, in meters. The value is relative to the Z-coordinate of the area's ground.

Radius – The radius of the point node.

Advanced

Show in – Here you can choose whether you want the shape to be shown both In 2D and 3D animation, or in 2D only, or in 3D only.

Show name – If selected, the shape's name is displayed on the graphical diagram.

Functions

You can dynamically modify shape properties at model runtime using the following API.
Position

Function

Description

double getX()

Returns the X coordinate of the node (namely, the coordinate of its upper left corner).

double getY()

Returns the Y coordinate of the node (namely, the coordinate of its upper left corner).

double getZ()

Returns the Z coordinate of the node (namely, the coordinate of its upper left corner).

Point getXYZ()

Returns the (X, Y, Z) coordinates of the given point.

Visibility

Function

Description

boolean isVisible()

Returns true if the node is visible; returns false otherwise.

void setVisible(boolean v)

Sets the visibility of the node.

Parameter: v - visibility. If v is true - the node is set to be visible, if it is false - not visible.

Color

Function

Description

Color getLineColor()

Returns the color of the node, or null if the node has no color or is textured (in this case use getFillTexture() to get the node's texture).

Texture getLineTexture()

Returns the texture of the node or null if the node has no texture or is colored (in this case use getLineColor() to get the node's color).

void setLineColor
(Color lineColor)

Sets the color of the node.

Parameter: lineColor - the new color, if null, the node is not drawn.

void setLineColor
(Paint lineColor)

Sets the color (or Texture) of the node.

Parameter: fillColor - the new color, if null, the node is not drawn.

Network

Function

Description

Network getNetwork()

Returns the network this markup element belongs to or null if this element is not a part of a network.

int getConnectionsCount()

Returns the number of the node's connections with other nodes.

Path getConnection(int index)

Returns the connection between this node and another node by the provided index.

Parameter: index - the index of required connection in range (0, this.getConnectionsCount() - 1).