Summary

The NodeDrawer is a view that allows a user to draw a polygon on a plan to create a Node such as a zone, an office, a meeting room etc. It's another way of creating Nodes in the Model from the NodeCreator. In the NodeCreator, you drag&drop Definitions into a Node to create new Nodes. Here you will draw it.

The other difference with the NodeCreator is the interaction with the sources contained under the zone. When you draw a new zone, all sources contained in the zone will be assigned to the new zone. So the NodeDrawer also fulfill a part of the AssignmentView (but for only one Aspect).

The NodeDrawer will also let you use a specific NodeTag that looks for the sources (devices, schedules, points etc.) contained in the zone and will display a drop-down to select one source among the others. So you can define for example a master device or a master schedule. This list can be modified later by editing the zone (you can also edit the zone).

This component needs some configuration before using it, see px file and sources configuration.


Implementation

  • Drag and drop the component in the station.

  • Set the base Ord which will target the ascendant of the Nodes created in the view. 
  • Set the px file that will be displayed in the main part of the Node Drawer. Example: the .px of a floor synoptic
  • Set the Canvas Id, e.g. the canvas to display instead of the entire px (because the px can contain menus etc.). The canvas Id should be the id defined with an id binding from btibCore.
  • Set the Definition Names to propose when the zone is created (separate them by a semicolon). Examples: office;meetingRoom


In previous versions, the NodeDrawer could only be placed inside Nodes. Now with the base Ord, you can place it anywhere.
The baseOrd targets the parent by default, so the NodeDrawer from previous versions still work.


On the view of the NodeDrawer, the canvas from the px should appear. To draw a zone:

  • Click to create points. If there is more than 3 points, click on any existing point to close the zone.
  • You can now choose to create a zone with a new node (default behavior), or create a zone for an existing node.
  • Fill in the information
  • You can click on the zone to edit it or to delete it.
  • A source is considered as in the zone, if the center of the source is in the zone.


It is possible to shift all the zones in the NodeDrawer with shift option. This is useful when the px file have a gap with the NodeDrawer.






Properties

  • Base Ord: The Ord of the ascendant Node.
  • Px File: Path of the Px to display. See px file and sources configuration.
  • Definitions Name: Names of the NodeDefinitions type allowed in the NodeDrawer to create new Nodes. Names have to separated by semicolon ";" and should be case-sensitive (ex: "room;zone"). The NodeDefinitions should be descendants (by b:isIn relation) of the NodeDefinition type of the root Node.
  • Canvas Id: The id of the Canvas Pane in the px file. This Canvas Pane is the root element displayed in NodeDrawer.
  • Ignored Ids:

  • Mode: The mode in which you want the NodeDrawer to work. The standard Mode is the Local Mode. 

  • Gap Policy: Used to adjust drawing view when there is a gap between the drawing view and the px file (false by default).

    For more informations on the "Remote Node Creation With Virtualization" mode, see Remote Node Creation With Virtualization. For more informations on the "Remote Node Propagation" mode, see Remote Node Propagation.

    Both those modes require a good knowledge on Propagation.