Name Placement Specification - modelint/flatland-model-diagram-editor GitHub Wiki

A Diagram Notation may specify that a given Connector Type be named along with the default placement information for that name. For diagram generation purposes, we leave it to the user to supply a name with a format appropriate to the Diagram Type and Notation. But we can retain layout information so that the user need not specify precise placement of each name. For example, we can say that a certain name be placed in the center of each connector overlaying it, or at a certain distance above a horizontal connector and to the right of a vertical connector.

The name of a Connector is not associated with any particular end of the Connector. In that case you would use a Stem name instead.

images/connector-subsystem/10_name_placement_specification.png

Identifiers

1. Name + Notation + Diagram type

Attributes

Axis buffer

The buffer ensures that there is a minimum distance between the name and either the connector line or a nearby Stem Icon.

Type: Buffer Distance, (h: Distance, v: Distance)

Face buffer

The buffer ensures that there is a minimum distnace between the name and any nearby Node face.

Type: Buffer Distance

Default name

A text value to be used in case the user does not supply a name.

Type: Text

Optional

Whether or not the name is required or optional. If required and no name is supplied a warning can be raised and the default name applied.

Type: Boolean