Line Symbolizer
Line Symbolizer
The Simple Line symbolizer draws a line with customizable style. This is the default symbolizer for 1-dimensional geometries (lines).
Supported styling options:
Property | Description |
---|---|
Color | Specifies the color and transparency given to the line. |
Width | Specifies the width of the line |
LineJoin | Determines how lines are rendered at intersections of line segments. |
Style | Specifies how the symbol linework should be drawn. |
DashPattern | Specifies an array of distances that specifies the lengths of alternating dashes and spaces in dashed lines. |
DashOffset | Specifies the distance from the start of a line to the beginning of a dash pattern. |
CapStyle | Specifies how lines are rendered at their ends. - Butt - sharp square edge - Round - rounded edge - Square - slightly elongated square edge |
Offset | Specifies offset from the original line. For positive distance the offset will be at the left side of the input line (relative to the line direction). For a negative distance it’ll be at the right side. |
Geometry Types
The symbolizer can be applied to geometries of any type.
Geometry Dimension | Geometry Types | Rendering Behavior |
---|---|---|
Point | Point, MultiPoint | Draws a line of a small length with a horizontal orientation centered on the point, with two end caps. |
Line | LineString, CircularString, CompoundCurve, LinerRing, MultiCurve, MultiLineString | Draws the line. |
Surface | Polygon, CurvePolygon, MultiPolygon, MultiSurface | Closed outline of the geometry is used as the line string (with no end caps) |
For GeometryCollections, the rendering behavior is determined separately for each geometry inside the collection. Layers with Mixed geometry type follow the logic for GeometryCollections.
Use MixedGeometrySymbolizer to limit a symbolizer to specific geometry types.
Examples
By default the line symbolizer draws black lines:
Here’s how to change line color to blue:
![]() |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
---|
For more advanced scenarios, you might want to adjust the line style dynamically based on feature attribute values. Here’s how to do that:
![]() |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
---|
You might also want to add labels to your lines. Visit Lines Labeling Examples for examples.