Interface ComplexStrokedLineStyle

Adds a BloomEffect to the complex stroked line.

Bloom is only supported on WebGL maps.

Since

2022.1

The decorations to be painted along the line.

A decoration is a Pattern that is painted once at a specific position along the line.

This property is optional. If it is omitted, no decorations will be painted along the line.

The pattern that is painted if no decoration or regular pattern can be painted. This can happen if a line is too curved, or if there is not enough space to paint the regular pattern.

Some patterns influence whether the fallback pattern is painted or not, and where it is painted. For more information, see the combineWithFallback and combineWithRegular pattern wrappers.

See

• combineWithFallback
• combineWithRegular

The pattern that is repeated along the line. A regular pattern is painted where no decoration is painted, because decorations have priority over the regular pattern.

If there is not enough space to place the regular pattern, the fallback pattern is painted.

Some patterns influence whether the fallback pattern is painted or not, and where it is painted. For more information, see the combineWithFallback and combineWithRegular pattern wrappers.

See

combineWithRegular

The threshold that is used to determine if angles are sharp or not. It is interpreted as an angle in degrees between two line segments. In the context of complex stroking, sharp corners are handled differently than non-sharp corners.

In general, a non-sharp corner is handled as if there were no corner at all. This means that any stroke can just be painted along the corner. As a side-effect, strokes may be deformed. This deformation will be small for corners that are close to 180 degrees wide, meaning for line segments that are almost parallel. The deformation can become quite large for sharper corners though, so take care when you adjust this value.

On the other hand, when a corner is considered sharp, strokes will not be deformed, but they may be dropped instead.

This setting is useful when complex strokes use a uniform shape and color, for example. When you are painting an airspace border using a rectangular stroke along the length of the line, you can set the threshold to 0, for instance.

The value should always be in the [0, 180] degrees range. The default value is 155 degrees.

Note that this setting is only supported on a WebGLMap. On a non-WebGLMap, this threshold is ignored.

Default

155
Copy

Determines the interpretation of units for style properties that express sizes. Supported UnitOfMeasures are:

• UnitOfMeasureRegistry.getUnitOfMeasure("Pixels")
• UnitOfMeasure of type QuantityKindRegistry.getQuantityKind("Length"), for example UnitOfMeasureRegistry.getUnitOfMeasure("Meter")

The unit of measure applies to the width and size properties of the pattern and decorations. The uom determines the interpretation of the values as pixels or as a ground unit that represents the actual size of real-world objects, like for example meter or foot.

The uom property is only supported on geographically referenced maps. Maps configured with cartesian reference do not support LineStyles with a uom set.

The property is optional and the default value is the Pixel unit.

Limitation: complex strokes with a world size will be missing certain pattern aspects when used on a non-WebGL map.

Default

undefined, interpreted as pixels
Copy

Since

2023.0