LayeredLineStyle Class
Represents a line style created by combining one or more visualizers.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class LayeredLineStyle : LineStyleRemarks
This class provides a convenient way to create advanced line styles by combining two or more LineVisualizer, SymbolVisualizer and TextVisualizer objects.
But more importantly, each visualizer will be rendered in a separate render pass, or "sub-layer". In the first render pass, all features will be rendered as usual by the first visualizer of the line style, plus any other visualizers in the layer, in the normal order. After that, the second visualizer will do its rendering, using the same features, and so on. This can make a big visual difference, as shown in the image below. The same effect can be achieved by passing all features through two separate operator chains, but that would require a much more complicated configuration.
 |
Unlike other line styles, the LayeredLineStyle is not scaled when the width of the LineVisualizer it is attached to changes. Except for the rendering order, the behavior of the sub-visualizers is the sames as if they were used independently, without the LayeredLineStyle.
However, the color of the line, as determined by the outer LineVisualizer, is passed down to the sub-visualizer via a special update attribute, currentColor. The value is a string that can be used as an indirect color value by the sub-visualizers. This means that one of the colors of the complete line can be controlled by the LineVisualizer the line style is attached to, rather than by the line style itself.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
ResourceObject
LineStyle
LayeredLineStyle
Platforms
Windows, Linux, Android
LayeredLineStyle Members
The LayeredLineStyle type has the following members.
Constructors
| Name | Description |
|---|---|
| LayeredLineStyle | Initializes a new instance of the LayeredLineStyle class. |
Properties
| Name | Description |
|---|---|
 Crosses1 | Gets the predefined line style used to draw lines in the crosses1 style. Inherited from LineStyle |
| Crosses2 | Gets the predefined line style used to draw lines in the crosses2 style. Inherited from LineStyle |
| Dashes1 | Gets the predefined line style used to draw lines in the dashes1 style. Inherited from LineStyle |
| Dashes2 | Gets the predefined line style used to draw lines in the dashes2 style. Inherited from LineStyle |
| Dashes3 | Gets the predefined line style used to draw lines in the dashes3 style. Inherited from LineStyle |
| Dashes4 | Gets the predefined line style used to draw lines in the dashes4 style. Inherited from LineStyle |
| Dashes5 | Gets the predefined line style used to draw lines in the dashes5 style. Inherited from LineStyle |
| Dashes6 | Gets the predefined line style used to draw lines in the dashes6 style. Inherited from LineStyle |
| Dashes7 | Gets the predefined line style used to draw lines in the dashes7 style. Inherited from LineStyle |
| Dashes8 | Gets the predefined line style used to draw lines in the dashes8 style. Inherited from LineStyle |
| Dashes9 | Gets the predefined line style used to draw lines in the dashes9 style. Inherited from LineStyle |
| Diamonds | Gets the predefined line style used to draw lines in the diamonds style. Inherited from LineStyle |
| Dots1 | Gets the predefined line style used to draw lines in the dots1 style. Inherited from LineStyle |
| Dots2 | Gets the predefined line style used to draw lines in the dots2 style. Inherited from LineStyle |
| Double1 | Gets the predefined line style used to draw lines in the double1 style. Inherited from LineStyle |
| Double2 | Gets the predefined line style used to draw lines in the double2 style. Inherited from LineStyle |
| Highway1 | Gets the predefined line style used to draw lines in the highway1 style. Inherited from LineStyle |
| Highway2 | Gets the predefined line style used to draw lines in the highway2 style. Inherited from LineStyle |
| Highway3 | Gets the predefined line style used to draw lines in the highway3 style. Inherited from LineStyle |
| IsDisposed | Gets a value that tells whether the current LayeredLineStyle has been disposed. Inherited from EngineObject |
| Marks1 | Gets the predefined line style used to draw lines in the marks1 style. Inherited from LineStyle |
| Marks2 | Gets the predefined line style used to draw lines in the marks2 style. Inherited from LineStyle |
| Name | Gets or sets the name of the LayeredLineStyle. Inherited from ResourceObject |
| NativeHandle | Gets the native Carmenta Engine kernel object the current LayeredLineStyle represents. Inherited from EngineObject |
| Pluses1 | Gets the predefined line style used to draw lines in the pluses1 style. Inherited from LineStyle |
| Pluses2 | Gets the predefined line style used to draw lines in the pluses2 style. Inherited from LineStyle |
| Railway1 | Gets the predefined line style used to draw lines in the railway1 style. Inherited from LineStyle |
| Railway2 | Gets the predefined line style used to draw lines in the railway2 style. Inherited from LineStyle |
| SolidLine | Gets the predefined line style that is used to draw solid lines. Inherited from LineStyle |
| Spikes1 | Gets the predefined line style used to draw lines in the spikes1 style. Inherited from LineStyle |
| Spikes2 | Gets the predefined line style used to draw lines in the spikes2 style. Inherited from LineStyle |
| Spikes3 | Gets the predefined line style used to draw lines in the spikes3 style. Inherited from LineStyle |
| Squares | Gets the predefined line style used to draw lines in the squares style. Inherited from LineStyle |
| Triple1 | Gets the predefined line style used to draw lines in the triple1 style. Inherited from LineStyle |
| Triple2 | Gets the predefined line style used to draw lines in the triple2 style. Inherited from LineStyle |
| IUserProperties.UserProperties | Gets the AttributeSet that contains the user properties. Inherited from IUserProperties |
| Visualizers | Gets the list of visualizers used to render this line style. |
Methods
| Name | Description |
|---|---|
| Clone | Creates a copy of an object. Inherited from EngineObject |
| Dispose | Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject |
| Equals | Determines whether this instance is equal to another. Inherited from EngineObject |