PolyLine

Core::Diagram::PolyLine

Overview

Concrete Class

A curve that consists of one or more chained straight sections.

(Fullscreen Diagram)

Supertypes

• GraphicalPrimitive

Members

Data Properties

Name	Multiplicity	Type	Ordered	Unique
Points	2..*	Point	yes	no	The points of the PolyLine.
Stroke	1	Stroke	no	no	The stroke of the PolyLine.

Geometry

The first straight section of a PolyLine starts at its first Point, i.e., Points[0], and ends at its second Point. For each further Point, another section is drawn that starts at the preceding Point.

Example

We consider a PolyLine with 3 Points:

• (-30, 40),

• (50, 40), and

• (-10, -60).

The PolyLine will look like this:

Mapping to SVG

A PolyLine corresponds to an svg:polyline with these attributes:

• points contains the Points of the PolyLine.

  Each Point \(i\) with position \(x_i\) and \(y_i\) is converted to a string as str(\(x_i\)) + , + str(\(y_i\)). Finally, the points attribute is set to a single string that contains all positions, separated by spaces.

• stroke, stroke-dasharray, stroke-dashoffset and stroke-width are set according to the SVG mapping rules for the Stroke of the PolyLine (see Stroke).

• stroke-linecap = "round" and stroke-linejoin = "round" reflect the heuristic for line caps and line joins.

• vector-effect = "non-scaling-stroke" reflects the heuristic for scaled symbols.

• fill = "none" is required to avoid that the svg:polyline is filled.

Example

We assume that the Stroke of the PolyLine above is 2mm #007fff solid.

{PolyLineSolidSvgCode}

Example

We consider the same PolyLine as in the previous example, except that the Stroke is 2mm #007fff Dash.

{PolyLineDashSvgCode}

Points

Data Property

The points of the PolyLine.

Type: Point

Multiplicity: 2..*

Ordered: yes

Unique: no

Example

[

     Point(

          X = 3.5,

          Y = 5.5),

     Point(

          X = 5.5,

          Y = 7.5)

]

Stroke

Data Property

The stroke of the PolyLine.

Type: Stroke

Multiplicity: 1

Ordered: no

Unique: no

Example

Stroke(

     Color = Color(

          B = 0,

          G = 0,

          R = 128),

     DashStyle = Solid,

     Width = 0.3)

Example in DEXPI XML

<Object type="Core/Diagram.PolyLine">
  <Data property="Points">
    <AggregatedDataValue type="Core/Diagram.Point">
      <Data property="X">
        <Double>3.5</Double>
      </Data>
      <Data property="Y">
        <Double>5.5</Double>
      </Data>
    </AggregatedDataValue>
    <AggregatedDataValue type="Core/Diagram.Point">
      <Data property="X">
        <Double>5.5</Double>
      </Data>
      <Data property="Y">
        <Double>7.5</Double>
      </Data>
    </AggregatedDataValue>
  </Data>
  <Data property="Stroke">
    <AggregatedDataValue type="Core/Diagram.Stroke">
      <Data property="Color">
        <AggregatedDataValue type="Core/Diagram.Color">
          <Data property="B">
            <Integer>0</Integer>
          </Data>
          <Data property="G">
            <Integer>0</Integer>
          </Data>
          <Data property="R">
            <Integer>128</Integer>
          </Data>
        </AggregatedDataValue>
      </Data>
      <Data property="DashStyle">
        <DataReference data="Core/Diagram.DashStyle.Solid"/>
      </Data>
      <Data property="Width">
        <Double>0.3</Double>
      </Data>
    </AggregatedDataValue>
  </Data>
</Object>