Queue Line

The  Queue Line element is an integral part of the  Service with Lines markup element. It enables you to configure the individual queue line comprising the service: set the limitation on the number of people standing in this queue, and so on.

 To select a queue line

  1. Click the queue line. First click selects the Service with Lines element.
  2. Click the line again to select the queue line.

 To extend a queue line

  1. Right-click the queue shape and select Add points from the context menu.
  2. You are in the drawing mode now. Add new segments with mouse clicks.
  3. Finish drawing by double-clicking at the spot where you want to place the end point of the queue line.

 To remove a queue line point

  1. Double-click the point you want to remove.

Properties

General

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

Show name – If selected, the queue name is displayed in the graphical editor.

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

When the drawn line is fully occupied by people – The options define the queue behavior in case new people join the line when the queue line shape is already fully occupied by people (this option does not deal with the queue capacity limitation defined by the Maximum number of people in the queue parameter). 

Limit the number of people in the queue – If selected, the number of people that can stand in the line is limited to the Maximum number of people in the queue

Maximum number of people in the queue – Defines the logical capacity of the queue: the maximum number of people that can stand in the queue

Position

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

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

Z-coordinate is defined by the ground containing this element. You can, however, adjust the Z-coordinate of individual points of the line within the Points section.

Points

The table located in the Points properties section allows you to view and adjust coordinates of the line points.  

Here you define relative coordinates, not the absolute ones. The first point always has coordinates (0, 0, 0) that cannot be changed.
Other rows of the table define relative coordinates of the successive points. Coordinates of each point are actually offsets of the corresponding point from the start point along X, Y (and optionally Z) axes correspondingly.

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.

Functions

boolean isReverse() - Returns true if the queue is reverse; returns false otherwise.

int size() - Returns the number of pedestrians currently standing in the queue.

List<Agent> getPeds() - Returns the collection of pedestrians standing in the queue. The first pedestrian is the queue head, the last pedestrian is the queue tail.

boolean isCapacityLimited() - Returns true if the queue has limited capacity; returns false otherwise.

int capacity() - Returns the capacity of the queue (the maximum number of pedestrians that can stand in the queue).

setCapacity(int capacity) - Sets the capacity of the queue.
Parameter: capacity - the new capacity value.


Related topics

Service with lines

 Service with area

Service with a "serpentine" queue

 API reference: QueuePath class