线条符号

线条符号用于设置线性（一维）特征的样式。它在某些方面是最简单的符号，因为它只包含一个特征的笔画（轮廓）的工具。

句法

行符号的完整语法是：

symbolizers:
- line:
    stroke-color: <color>
    stroke-width: <expression>
    stroke-opacity: <expression>
    stroke-linejoin: <expression>
    stroke-linecap: <expression>
    stroke-dasharray: <float list>
    stroke-dashoffset: <expression>
    stroke-graphic:
      <graphic_options>
    stroke-graphic-fill:
      <graphic_options>
    offset: <expression>
    geometry: <expression>
    uom: <text>
    x-labelObstacle: <boolean>
    x-composite-base: <boolean>
    x-composite: <text>
    x-inclusion: <text>

在哪里？

财产

必修的？

描述

默认值

stroke-color

不

线条特征的颜色。

'#000000' （黑色）

stroke-width

不

线条特征的宽度，以像素度量。

1

stroke-opacity

不

线条特征的不透明度。有效值是介于 0 （完全透明）和 1 （完全不透明）。

1

stroke-linejoin

不

如何将线段连接在一起。选项包括 mitre （尖角） round （圆角），以及 bevel （对角）。

mitre

stroke-linecap

不

线条特征在其末端的渲染方式。选项包括 butt （锋利的方形边缘） round （圆形边缘），以及 square （略微拉长的方形边缘）。

butt

stroke-dasharray

不

表示线条和间隙长度的数字列表，创建虚线效果。单位是像素，所以 "2 3" 将是一个由2个像素的画线和3个像素的空格组成的重复图案。如果只提供一个数字，这将意味着相等数量的行和间隙。

无破折号

stroke-dashoffset

不

DashArray中用于偏移虚线图形的像素数，用于移动虚线中线条和间隙的位置。

0

stroke-graphic

不

沿笔画使用的图案或图案。输出将始终是线性重复模式，因此与 stroke-width .可以是由公共形状组成的标记，也可以是指向图形的URL。这个 <graphic_options> 应该包含一个包含 symbols: 然后是 external: 或 mark: ，具有适当的参数，如 点符号 第节。不能与一起使用 stroke-graphic-fill .

不适用

stroke-graphic-fill

不

用于填充笔画的图案或图案。要填充的区域直接与 stroke-width .可以是由公共形状组成的标记，也可以是指向图形的URL。这个 <graphic_options> 应该包含一个包含 symbols: 然后是 external: 或 mark: ，具有适当的参数，如 点符号 第节。不能与一起使用 stroke-graphic .

不适用

财产

必修的？

描述

默认值

offset

不

以像素为单位的值，用于相对于特征位置移动绘制的线。

0

财产

必修的？

描述

默认值

geometry

不

指定要用作几何的属性(请参见 SLD中的几何变换 )

找到第一个几何属性（通常命名为 geom 或 the_geom ）

uom

不

用于宽度计算的测量单位(请参见 以地面单位指定符号大小 )

象素

的附加“供应商选项”属性 标记障碍物 ：

财产

必修的？

描述

默认值

x-labelObstacle

不

将符号标记为障碍物，以便通过 text symbolizer 不会绘制在这些功能的顶部。选项包括 true 或 false .请注意，在计算障碍物时使用特征的边界框，因此在将线或多边形符号标记为障碍物时，可能会出现意外的效果。

false

的其他“供应商选项”属性 色彩合成与混色 ：

财产

必修的？

描述

默认值

x-composite

不

允许符号之间的alpha合成和颜色混合选项。

不适用

x-composite-base

不

允许渲染引擎使用符号映射来定义“基本”缓冲区，以便随后使用 x-composite . 请参见 Feature Styles 了解更多详细信息。

false

的其他“供应商选项”属性 渲染选择 ：

财产

必修的？

描述

默认值

x-inclusion

不

定义规则是否应包含在的样式中 legendOnly 或 mapOnly 。

normal

实例

带样式末端的基本线条

这个 linejoin 和 linecap 属性可用于设置任何笔划的连接和端点的样式。此示例使用部分透明的黑色线条绘制线条，线条末端为圆形，角部为锐利（斜接）：：

feature-styles:
- rules:
  - symbolizers:
    - line:
        stroke-color: '#000000'
        stroke-width: 8
        stroke-opacity: 0.5
        stroke-linejoin: mitre
        stroke-linecap: round
../../../../_images/line_basic.png

带样式末端的基本线条

铁路模式

许多地图使用阴影图案来表示铁路。这可以通过使用两个线符号来实现，一个是实心的，一个是虚线的。具体来说， stroke-dasharray 属性用于每24像素创建一条长度为1的虚线：

name: railroad
feature-styles:
- name: name
  rules:
  - symbolizers:
    - line:
        stroke-color: '#000000'
        stroke-width: 1
    - line:
        stroke-color: '#000000'
        stroke-width: 12
        stroke-dasharray: '1 24'
../../../../_images/line_railroad1.png

铁路模式

以单位指定大小

单位 stroke-width ， size 和其他类似的属性默认为像素，这意味着图形在不同的缩放级别上保持不变的大小。或者，可以为值指定单位（英尺或米），因此图形将随着放大或缩小而缩放。此示例绘制固定宽度为8米的道路：

feature-styles:
- rules:
  - symbolizers:
    - line:
        stroke-color: '#000000'
        stroke-width: '8 m'
../../../../_images/line_uomsmall.png

以米为单位测量的线条宽度（缩小）

../../../../_images/line_uombig.png

以米为单位测量的线条宽度（放大）

符号的默认度量单位是使用 uom .此示例使用默认的米为 stroke-width 和 stroke-dasharray 使用仪表。

line:
  uom: metre
  stroke-color: '#000000'
  stroke-width: '8'
  stroke-dasharray: '20 3'
../../../../_images/line-uom.png

行宽和行距（米）

Previous: 符号
Next: 多边形符号