LuciadCPillar 2023.1.04
|
A builder to create ComplexStrokeLineStyle objects. More...
#include <luciad/layers/styles/complexstrokes/ComplexStrokeLineStyle.h>
Public Member Functions | |
Builder (Builder &&other) noexcept | |
Builder (const Builder &other) | |
~Builder () | |
Builder & | addDecoration (const ComplexStrokePattern &pattern, double relativePosition) |
Add a decoration to be painted along the line. More... | |
Builder & | addDecoration (const ComplexStrokePattern &pattern, double relativePosition, HorizontalAlignment alignment) |
Add a decoration to be painted along the line. More... | |
ComplexStrokeLineStyle | build () |
Build the ComplexStrokeLineStyle as configured. More... | |
Builder & | fallback (const ComplexStrokePattern &pattern) |
The pattern that is painted if no decoration or regular pattern can be painted. More... | |
Builder & | operator= (Builder other) noexcept |
Builder & | orientation (ComplexStrokeOrientation orientation) |
The orientation of the area that is used to render the complex stroke on for 3D lines. More... | |
Builder & | regular (const ComplexStrokePattern &pattern) |
The pattern that is repeated along the line. More... | |
Builder & | sharpAngleThreshold (double sharpAngleThreshold) |
The threshold that is used to determine if angles are sharp or not. More... | |
A builder to create ComplexStrokeLineStyle objects.
luciad::ComplexStrokeLineStyle::Builder::Builder | ( | const Builder & | other | ) |
|
noexcept |
luciad::ComplexStrokeLineStyle::Builder::~Builder | ( | ) |
Builder & luciad::ComplexStrokeLineStyle::Builder::addDecoration | ( | const ComplexStrokePattern & | pattern, |
double | relativePosition | ||
) |
Add a decoration to be painted along the line.
A decoration is a pattern
.
This method can be called multiple times to add multiple decorations. If this method isn't called, no decorations are added.
The alignment is automatically determined based on relativePosition. Left
if the position is 0.0
, Right
if the location is 1.0
, and Center
if otherwise.
pattern | the decoration to be added. |
relativePosition | the relative position of the decoration on the line, where 0.0 is the start and 1.0 is the end of the entire line. |
luciad::InvalidArgumentException | relativePosition must be in range [0,1] . |
Builder & luciad::ComplexStrokeLineStyle::Builder::addDecoration | ( | const ComplexStrokePattern & | pattern, |
double | relativePosition, | ||
HorizontalAlignment | alignment | ||
) |
Add a decoration to be painted along the line.
A decoration is a pattern
.
This method can be called multiple times to add multiple decorations. If this method isn't called, no decorations are added.
pattern | the decoration to be added. |
relativePosition | the relative position of the decoration on the line, where 0.0 is the start and 1.0 is the end of the entire line. |
alignment | determines how the pattern is aligned to its location. If you use HorizontalAlignment::Center, the middle of the pattern will coincide with the specified location. If you use HorizontalAlignment::Right, the right of the pattern will coincide with the specified location. This means that it will appear at the left of the location. |
luciad::InvalidArgumentException | relativePosition must be in range [0,1] . |
ComplexStrokeLineStyle luciad::ComplexStrokeLineStyle::Builder::build | ( | ) |
Build the ComplexStrokeLineStyle as configured.
At least one of fallback
, regular
or addDecoration
must be called. If none of these are called, a logic exception is thrown.
luciad::LogicException | when neither a regular or a fallback pattern has been set and no decorations have been added. |
Builder & luciad::ComplexStrokeLineStyle::Builder::fallback | ( | const ComplexStrokePattern & | pattern | ) |
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
patterns.
Note that the fallback pattern can be cut off, e.g. when reaching the end of the line, instead of being omitted. This means that a base pattern can be partially drawn.
Builder & luciad::ComplexStrokeLineStyle::Builder::orientation | ( | ComplexStrokeOrientation | orientation | ) |
The orientation of the area that is used to render the complex stroke on for 3D lines.
See ComplexStrokeLineStyle
for more information.
The default, the complex stroke faces the camera
for 3D lines.
orientation | the orientation |
Builder & luciad::ComplexStrokeLineStyle::Builder::regular | ( | const ComplexStrokePattern & | pattern | ) |
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 regular pattern is painted or not, and where it is painted. For more information, see the combineWithRegular
pattern wrapper.
Note that, unlike the fallback stroke, (patterns part of) the regular pattern will not be cut off. That is, each base pattern will always be fully painted or not at all. This is different from the atomic pattern
which is about a composite pattern being painted together or not at all.
Builder & luciad::ComplexStrokeLineStyle::Builder::sharpAngleThreshold | ( | double | sharpAngleThreshold | ) |
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 is 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.
sharpAngleThreshold | the sharpAngleThreshold. |
luciad::InvalidArgumentException | sharpAngleThreshold must be in range [0,180] . |