Settings

This section provides an overview of all available customization settings for the Map application.
You can configure various aspects of the map, including its display, wayfinding behavior, data sources, and interactive elements.

Map

• Select SVG file: Choose the SVG file for the map.
• Default zoom scale: Default value is 1, adjustable between 0.3 and 6.
• Allow zooming: Enable or disable pan-and-zoom functionality.
• 3D type: Select between None, Simple 3D, or Perspective 3D for map visualization.

Wayfinding

• Map ratio: Set the ratio to ensure accurate distance and walking time calculations.
• Wayfinding sensitivity: Defines the sensitivity of wayfinding. For example, a setting of 20 means each point searches within a 20px radius.
• Location behavior: Choose whether locations should be hidden or faded out when wayfinding is active.
• Default start point: Specify the default start location for wayfinding.

Data Sources

The Map widget can function without any external data sources, but integrating them enhances its capabilities.

• Status source: Colors locations based on their availability (e.g., free or busy).
  • Structure: { "Room1": { "roomstate":"busy" } }
  • Room1 represents the location identifier.
  • roomstate defines its status (busy or free).
• Cross reference: Loads additional information for locations.
  • Structure: [ { "id": "Room1" } ]
  • The id should match the location identifier.
  • Objects can contain multiple key-value pairs with extra data.
• Output datasource: The Map widget exports a merged datasource combining the status and cross-reference sources when loaded or updated.

Level Switcher

• Show level switcher: Enable or disable the level switcher functionality.
• Positioning mode: Align the level switcher relative to the widget or content.
• Position: Choose where to display the level switcher.
• Font settings:
  • Font family: Select a font.
  • Font size: Adjust text size.
  • Font style: Apply bold, italic, or underline.
  • Font color: Set text color.

Tooltip

• Allow tooltips: Enable or disable tooltips when hovering over locations.
• Positioning mode: Align tooltips relative to the widget or content.
• Position: Choose where to display tooltips.
• Font settings:
  • Font family: Select a font.
  • Font size: Adjust text size.
  • Font style: Apply bold, italic, or underline.
  • Font color: Set text color.

Popup

• Allow popups: Enable or disable popups for location details.
• Popup timeout: Define how long (in seconds) popups remain open.
• Font settings:
  • Font family: Select a font.
  • Font size: Adjust text size.
  • Font style: Apply bold, italic, or underline.
  • Font color: Set text color.

Routes

• Route color: Set the color of wayfinding paths.
• Route width: Adjust the thickness of routes.
• Route timeout: Define how long (in seconds) selected routes remain visible.
• Allow animations: Enable or disable route animation effects.

Route Details

• Show route details: Enable or disable route details when wayfinding is active.
• Positioning mode: Align route details relative to the widget or content.
• Position: Choose where to display route details.
• Font settings:
  • Font family: Select a font.
  • Font size: Adjust text size.
  • Font style: Apply bold, italic, or underline.
  • Font color: Set text color.

Location

• Display property: Select which property is displayed above locations (None, ID, Label, Title, Description).
• Property position: Define where to display the property within the location.
• Default colors:
  • Default location color: Base color for locations.
  • Hover color: Color when hovering over a location.
• Status colors:
  • Free: Color for available locations.
  • Away: Color for locations marked as "Away".
  • Busy: Color for occupied locations.
  • Do Not Disturb: Color for locations marked "Do Not Disturb".
  • Be Right Back: Color for "Be Right Back" status.
  • Offline: Color for locations that are offline.
• Visibility options:
  • Hide locations by default: Automatically hide all locations at startup.
  • Show status colors: Toggle status-based color display.