栅格符号

栅格符号用于设置栅格（覆盖）图层的样式。栅格是一个信息数组，数组中的每个单元格包含一个或多个值，存储为“带区”。

栅格符号的完整语法是：

symbolizers:
- raster:
    opacity: <expression>
    channels:
      gray:
        <channel_options>
      red:
        <channel_options>
      green:
        <channel_options>
      blue:
        <channel_options>
    color-map:
      type: <ramp|interval|values>
      entries:
      - [color, entry_opacity, band_value, text_label]
    contrast-enhancement:
      mode: <normalize|histogram>
      gamma: <expression>
    x-inclusion: <text>

在哪里？

财产

必修的？

描述

默认值

opacity

不

整个显示的不透明度。有效值是介于 0 （完全透明）和 1 （完全不透明）。

1

channels

不

选择要显示的波段和显示方法。

不适用

gray

不

将单个波段显示为灰度图像。不能与一起使用 red ， green 和 blue . 这个 <channel_options> 可以是带区名称或包含 name: 和 contrast-enhancement: （可选）。

1

red

不

将三个波段显示为RGB图像。必须与一起使用 green 和 blue .不能与一起使用 gray . 这个 <channel_options> 可以是带区名称或包含 name: 和 contrast-enhancement: （可选）。

1

green

不

将三个波段显示为RGB图像。必须与一起使用 red 和 blue .不能与一起使用 gray . 这个 <channel_options> 可以是带区名称或包含 name: 和 contrast-enhancement: （可选）。

2

blue

不

将三个波段显示为RGB图像。必须与一起使用 red 和 green .不能与一起使用 gray . 这个 <channel_options> 可以是带区名称或包含 name: 和 contrast-enhancement: （可选）。见下面的例子。

3

color-map

不

创建颜色到网格值的映射。只能与单波段一起使用。

不适用

type

不

颜色映射的类型。选项包括 ramp ，插入值列表； interval 非插值值列表；以及 values ，其中值需要精确匹配才能绘制。

ramp

entries

不

颜色映射的值。语法是元组列表。

不适用

color

是的

特定颜色映射项的颜色。值是标准颜色值。

不适用

entry_opacity

是的

特定颜色映射项的不透明度。有效值是介于 0 （完全透明）和 1 （完全不透明）。

不适用

band_value

是的

用于特定颜色映射项的网格值。值依赖于数据。此值处或周围的行为由颜色渐变确定 type .

不适用

text_label

不

特定颜色映射项的标签

空白

contrast-enhancement

不

修改显示器的对比度

不适用

mode

不

对比度增强的类型。选项包括 normalize （拉伸对比度，使最小值和最大值分别设置为黑色和白色）或 histogram （在每个亮度级别生成图像中相同数量的内容）。

normalize

gamma

不

用于对比度调整的乘数值。大于1的值将增加暗度，小于1的值将减少暗度。

1

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

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

财产

必修的？

描述

默认值

x-composite

不

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

不适用

x-composite-base

不

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

false

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

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

财产

必修的？

描述

默认值

x-inclusion

不

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

normal

实例

增强的对比度

此示例采用给定的栅格，并将输出亮度降低2:：

symbolizers:
- raster:
    contrast-enhancement:
      gamma: 0.5
../../../../_images/raster_brightness.png

亮显图像

归一化输出

此示例采用给定的栅格并调整对比度，使最小值最暗，最大值最轻：

symbolizers:
- raster:
    contrast-enhancement:
      mode: normalize
../../../../_images/raster_normalize.png

归一化图像

波段选择

此示例采用带多个波段的栅格，并将波段2输出为灰度图像（这可用于在多波段图像中选择要使用的单个波段 color-map ）：

name: raster
feature-styles:
- name: name
  rules:
  - symbolizers:
    - raster:
        opacity: 1.0
        channels:
          gray: 2
../../../../_images/raster_band_gray.png

灰度带选择

带对比度的选择

此示例采用RGB栅格，使红色的强度加倍，并使绿色带正常化：

name: raster
feature-styles:
- name: name
  rules:
  - symbolizers:
    - raster:
        channels:
          red:
            name: 1
            contrast-enhancement:
              gamma: .5
          green:
            name: 2
            contrast-enhancement:
              mode: normalize
          blue:
            name: 3
../../../../_images/raster_band_contrast.png

带对比度增强的波段选择

颜色渐变

此示例显示从红色到绿色到蓝色的颜色渐变，栅格带值从0到200:：

symbolizers:
- raster:
    color-map:
      type: ramp
      entries:
      - ['#FF0000', 1, 0, red]
      - ['#00FF00', 1, 100, green]
      - ['#0000FF', 1, 200, blue]

在本例中，网格值将应用以下颜色：

  • 小于或等于0的输出颜色为 固体红

  • 0到100之间将具有输出颜色 在红色和绿色之间插入

  • 100到200之间将有一个输出颜色 在绿色和蓝色之间插入

  • 大于200的输出颜色为 纯蓝

../../../../_images/raster_map_ramp.png

带渐变的颜色图

颜色间隔

与上面的示例相同，但是 color-map 类型设置为 intervals ：：

symbolizers:
- raster:
    color-map:
      type: intervals
      entries:
      - ['#FF0000', 1, 0, red]
      - ['#00FF00', 1, 100, green]
      - ['#0000FF', 1, 200, blue]

在本例中，网格值将应用以下颜色：

  • 小于或等于0的输出颜色为 固体红

  • 0到100之间的输出颜色为 纯绿色

  • 100到200之间的输出颜色为 纯蓝

  • 大于200 will 不着色 完全（透明）

../../../../_images/raster_map_intervals.png

带间隔的彩色地图

颜色值

与上面的示例相同，但是 color-map 类型设置为 values ：：

symbolizers:
- raster:
    color-map:
      type: values
      entries:
      - ['#FF0000', 1, 0, red]
      - ['#00FF00', 1, 100, green]
      - ['#0000FF', 1, 200, blue]

在本例中，网格值将应用以下颜色：

  • 等于0的输出颜色为 固体红

  • 等于100的输出颜色为 纯绿色

  • 等于200的输出颜色为 纯蓝

任何其他值（甚至是上述值之间的值）都不会着色。

../../../../_images/raster_map_values.png

带值的颜色映射

Previous: 点符号
Next: 文本符号