This document introduces the main concepts used in the Wayfinding Planner (WFP) application.

To keep your data safe and portable, a complete WFP project—including the model and all design metadata—is stored in a single .wfp file.

Model overview

At the heart of the WFP is the model, which represents the physical space and the signage within it. The model is built from several layers:

Levels – horizontal planes at specific elevations. A building floor is a typical level.
Path networks – graphs that describe how visitors move through a level. They consist of path points joined by path segments.
Sign faces – surfaces that display messages. A sign face is attached to a path point and belongs to a sign type, which in turn falls under a sign category.
Messages – instructions or labels shown on sign faces. Messages may be generated automatically from the model or entered manually.

The model, together with project settings such as view positions and display preferences, makes up a Wayfinding Planner project.

Levels

A level represents a two‑dimensional plane at a fixed height above ground. The ground floor of a building is one example. Each level contains its own path network and optional background drawing.

Level view

Below is an example of a level showing the path network, with its path points and path segments, several sign faces, and a floor plan used as a background:

Figure 1 – Level view example.

Level properties

A level has the following properties:

Level code – a short identifier, such as L1. This code is used to generate unique sign face IDs.
Description – a free‑text description (e.g. “Ground floor” or “First floor”).
Elevation – the vertical position of the level relative to ground; it may be positive, negative or zero. Only one level may exist at a given elevation.
Drawing – an optional background image, typically a floor plan or layout. Drawings can be imported from raster (.png, .jpeg, .webp) or vector (.svg) formats. After import, they must be calibrated to set scale. Calibration is a quick manual process (15–20 seconds) and does not require high precision—an accuracy of ±0.5 metre is usually sufficient to compute walking distances.
Path network – the network of path points and path segments that people can use to move around the level.

Path points and segments

A path network comprises path points, which are 2‑D points within the level, and path segments, which are straight lines connecting two path points.

A path point has the following properties:

id – a unique number used to reference the point in e.g., routes. Is shown as part of a Path Point label like P02 where P stands from Point and 02 is the point's unique number 2.
position on the level

Path points fall into three functional types:

Type	Icon	Purpose	Sign face allowed?
Target point		Represents a destination (endpoint) such as a room or attraction. Each target point has a name.	Yes – an identification sign face.
Decision point		A junction where visitors must choose a direction.	Yes – either a direction or navigation sign face.
Supportive point		Helps shape the path network but is not a decision or target.	No – no sign faces are attached.

Path segments link path points and have a single property: length.

Sign faces

A sign face is the surface that displays messages to visitors. In the model, a sign face:

Is attached to a specific path point.
Belongs to a sign type, which inherits from a sign category.
Has a position on the level and a rotation angle measured counter‑clockwise from the positive X‑axis (from left to right), see Figures 2 and 3).

On the level view, sign faces are shown with symbols that indicate their position and field of view:

Figure 2 – Sign face symbol legend.

Sign categories

Sign categories describe the functional purpose of a sign face and determine which types of messages it can show. There are three categories:

Feature	Direction sign faces	Navigation sign faces	Identification sign faces
Typical message	Show names of target points reachable in each direction from the decision point.	Show a directory of all target points on the level.	Show the name of the target point where the sign face is located.
Symbol
Compatible path point	Decision point	Decision point	Target point
Attachment example
Default code prefix	`D`	`N`	`I`

Sign types

Within each category, you define sign types to represent actual sign designs. A sign type specifies:

Sign type code – a unique identifier combining the category prefix and a sequence number (e.g. D2 for the second type in the Direction category).
Description – a short description shown in the user interface and reports.
Fixing – how the sign is mounted (e.g. door‑mounted, flag‑mounted, overhead).
Connectivity – any power or data connections the sign requires.
Dimensions – width × height × depth in millimetres (always in mm, irrespectively of the units used in the model).
Drawing reference – a technical drawing reference needed to produce the sign face.
Outline specification – optional multi‑line text describing the sign face outline.
Directional sensitivity – directions for which automatic messages can be generated: Forward, Left, Right, Backward. Additional diagonal directions (UpLeft, UpRight, DownLeft, DownRight) currently support only manually defined messages.

Sign face identifiers

Every sign face receives a unique identifier formed from the sign type code, level code, and a sequential number:
For example, D2-L0.01 denotes the Direction (the D prefix) sign of type D2 on level L0 with instance number 01.

Direction zones

The 360° field of view of a directional sign face is divided into four quadrants—forward, left, right, and backward—measured from the sign’s rotation angle.

The forward quadrant covers a 90° sector centred on the sign’s line of sight, extending 45° to either side of the rotation angle.Left, right, and backward quadrants each cover the remaining 90° sectors.

A route is assigned to a quadrant based on the angle between the sign’s line of sight and the direction of the first path segment:

Figure 3 – Sign face rotation angle and walking directions.

Messages

Messages are the pieces of text (and, where applicable, their direction) displayed on sign faces.

Each message has the following properties:

Text – the content of the message
Direction – applies only to direction sign faces
Selection flag – controls whether the message is shown or hidden
Creation mode – either automatic or manual

Automatic and Manual Messages

Messages can be created in two ways:

Automatic messages – generated by the application, either instantly (default) or on request.
Manual messages – defined and maintained by the user.

Automatic and manual messages can coexist on the same sign face; for example, you might automatically list common destinations while adding a manually crafted note for a special case.

Message Display

A message can be displayed or hidden by setting or clearing its selection flag, regardless of its type.

Message Generation

The content of the messages generated for a sign face is determined by:

The sign type (and therefore its category and directional sensitivity)
The layout of the path network
The rotation of the sign face

Direction sign faces

For a direction sign face attached to a decision point, WFP generates messages using the following algorithm:

The sign face is virtually repositioned to the decision point for calculation purposes.
For each direction that the sign type is sensitive to, all reachable target points are identified. A route is considered reachable if its first path segment falls within the corresponding direction zone of the sign face.
For each target point, if multiple routes exist, they are compared and only the shortest route is kept for message generation.
If the sign face already has messages, any user-defined properties (such as selection flags or manual messages), when possible, are preserved and applied to the newly generated messages.

Identification sign faces

For an identification sign face, WFP generates messages as follows:

The sign face is always attached to a target point.
The name of that target point is automatically used as the message.

Navigation sign faces

For a navigation sign face attached to a decison point, WFP generates messages as follows:

The names of all target points belonging to the same level are collected.
These names are displayed as the directory on the navigation sign face.

Next steps

Installation and Activation to learn how to install and activate the application,
User interface to learn how to use the interface,
Getting Started for a practical guide to quickly get up to speed.

Core Concepts