com.supermap.mapping
类 LayerSettingGrid

java.lang.Object
  com.supermap.mapping.LayerSetting
      com.supermap.mapping.LayerSettingGrid

public class LayerSettingGrid
extends LayerSetting

栅格图层设置类。

图层分为普通图层和专题图层，栅格图层设置是针对普通图层而言的。栅格图层采用颜色表来显示其像元， 普通图层的风格通过 Layer.getAdditionalSetting() 和 Layer.setAdditionalSetting() 方法来返回或设置。SuperMap 的颜色表是按照 8 比特的 RGB 彩色坐标系来显示像元的，您可以根据像元的属性值来设置其显示颜色值，从而形象直观地表示栅格数据反映的现象。

示例:

以下代码示范了如何设置 DEM 栅格数据集的样式风格，并将其保存到以 GRID 命名的地图中。

假设打开了一个工作空间 workspace 对象，工作空间中存在一个数据源 datasource 对象，该数据源中存在一个名为 DEM 的数据集。地图对象 map 已关联 workspace。

 public void layerSettingGridTest() {
        // 返回名称为 DEM 的栅格数据集
        DatasetGrid dataset = (DatasetGrid) datasource.getDatasets().get("DEM");
        Layer layer1 = m_mapControl.getMap().getLayers().add(dataset, true);

        // 构造一个 Colors 对象并将各种颜色值添加到其中
        Colors colors = new Colors();
        colors.add(java.awt.Color.blue);
        colors.add(java.awt.Color.black);
        colors.add(java.awt.Color.gray);
        colors.add(java.awt.Color.orange);

        // 构造一个 LayerSettingGrid 对象，并设置颜色表和无值数据的颜色
        LayerSettingGrid layerSettingGrid = new LayerSettingGrid();
        layerSettingGrid.setColorTable(colors);
        layerSettingGrid.setSpecialValueColor(java.awt.Color.pink);
        layerSettingGrid.setOpaqueRate(100);

        // 得到图层并设置图层的样式风格
        layer1.setAdditionalSetting(layerSettingGrid);

        // 刷新地图
        map.refresh();

        // 保存地图为 GRID，保存工作空间
        workspace.getMaps().add(workspace.getMaps().getAvailableMapName("grid"), map.toXML());
        workspace.save();

        // 释放资源
        map.dispose();
        dataset.close();
    }
 

构造方法摘要

LayerSettingGrid()
默认构造函数，构造一个新的 LayerSettingGrid 对象。

LayerSettingGrid(LayerSettingGrid layerSettingGrid)
根据已存在的栅格图层设置类的对象来构造一个新的栅格图层设置类的对象。

方法摘要

int	getBrightness() 返回 Grid 图层的亮度，值域范围为 -100 到 100，增加亮度为正，降低亮度为负。
ColorDictionary	getColorDictionary() 返回图层的颜色对照表。
Colors	getColorTable() 返回颜色表。
int	getContrast() 返回 Grid 图层的对比度，值域范围为 -100 到 100，增加对比度为正，降低对比度为负。
ImageInterpolationMode	getImageInterpolationMode() 返回显示图像时使用的插值算法。
int	getOpaqueRate() 返回 Grid 图层显示不透明度。
double	getSpecialValue() 返回图层的特殊值。
java.awt.Color	getSpecialValueColor() 返回栅格数据集特殊值数据的颜色。
LayerSettingType	getType() 返回此图层的类型。
boolean	isSpecialValueTransparent() 返回图层的特殊值（SpecialValue）所处区域是否透明。
void	setBrightness(int value) 设置 Grid 图层的亮度，值域范围为 -100 到 100，增加亮度为正，降低亮度为负。
void	setColorDictionary(ColorDictionary clrDict) 设置图层的颜色对照表。
void	setColorTable(Colors colorTable) 设置颜色表。
void	setContrast(int value) 设置 Grid 图层的对比度，值域范围为 -100 到 100，增加对比度为正，降低对比度为负。
void	setImageInterpolationMode(ImageInterpolationMode value) 设置显示图像时使用的插值算法。
void	setOpaqueRate(int value) 设置 Grid 图层显示的不透明度。
void	setSpecialValue(double value) 设置图层的特殊值。
void	setSpecialValueColor(java.awt.Color value) 设置栅格数据集特殊值数据的颜色。
void	setSpecialValueTransparent(boolean value) 设置图层的特殊值（SpecialValue）所处区域是否透明。

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

LayerSettingGrid

public LayerSettingGrid()

默认构造函数，构造一个新的 LayerSettingGrid 对象。

LayerSettingGrid

public LayerSettingGrid(LayerSettingGrid layerSettingGrid)

根据已存在的栅格图层设置类的对象来构造一个新的栅格图层设置类的对象。

参数：

layerSettingGrid - 指定的栅格图层设置类对象。

方法详细信息

getType

public LayerSettingType getType()

返回此图层的类型。

指定者：

类 LayerSetting 中的 getType

返回：

图层的类型。

getColorTable

public Colors getColorTable()

返回颜色表。

返回：

颜色表。

默认值:

默认值为 {Count=0}。

setColorTable

public void setColorTable(Colors colorTable)

设置颜色表。

参数：

colorTable - 颜色表。

getSpecialValueColor

public java.awt.Color getSpecialValueColor()

返回栅格数据集特殊值数据的颜色。

返回：

栅格数据集特殊值数据的颜色。

默认值:

默认值为 Color.black。

setSpecialValueColor

public void setSpecialValueColor(java.awt.Color value)

设置栅格数据集特殊值数据的颜色。

参数：

value - 栅格数据集特殊值数据的颜色。

getSpecialValue

public double getSpecialValue()

返回图层的特殊值。

在新增一个 Grid 图层时，该方法的返回值与数据集的 NoValue 属性值相等。

返回：

图层的特殊值。

setSpecialValue

public void setSpecialValue(double value)

设置图层的特殊值。

参数：

value - 图层的特殊值。

getBrightness

public int getBrightness()

返回 Grid 图层的亮度，值域范围为 -100 到 100，增加亮度为正，降低亮度为负。亮度值可以保存到工作空间。

返回：

Grid 图层的亮度。

默认值:

默认值为 0。

setBrightness

public void setBrightness(int value)

设置 Grid 图层的亮度，值域范围为 -100 到 100，增加亮度为正，降低亮度为负。亮度值可以保存到工作空间。

参数：

value - Grid 图层的亮度。

getContrast

public int getContrast()

返回 Grid 图层的对比度，值域范围为 -100 到 100，增加对比度为正，降低对比度为负。对比度值可以保存到工作空间。

返回：

Grid 图层的对比度。

默认值:

默认值为 0。

setContrast

public void setContrast(int value)

设置 Grid 图层的对比度，值域范围为 -100 到 100，增加对比度为正，降低对比度为负。对比度值可以保存到工作空间。

参数：

value - Grid 图层的对比度。

getOpaqueRate

public int getOpaqueRate()

返回 Grid 图层显示不透明度。不透明度为一个 0-100 之间的数。0 为不显示；100 为完全不透明。只对栅格图层有效，在地图旋转的情况下也有效。

返回：

Grid 图层显示不透明度。

默认值:

默认值为 100。

setOpaqueRate

public void setOpaqueRate(int value)

设置 Grid 图层显示的不透明度。不透明度为一个 0-100 之间的数。0 为不显示；100 为完全不透明。只对栅格图层有效，在地图旋转的情况下也有效。

参数：

value - Grid 图层显示的不透明度。

isSpecialValueTransparent

public boolean isSpecialValueTransparent()

返回图层的特殊值（SpecialValue）所处区域是否透明。

返回：

一个布尔值，图层的特殊值（SpecialValue）所处区域透明返回 true，否则返回 false。

默认值:

默认值为 false。

setSpecialValueTransparent

public void setSpecialValueTransparent(boolean value)

设置图层的特殊值（SpecialValue）所处区域是否透明。

参数：

value - 图层的特殊值（SpecialValue）所处区域是否透明。

setColorDictionary

public void setColorDictionary(ColorDictionary clrDict)

设置图层的颜色对照表。

参数：

clrDict - 用于指定图层的颜色对照表。

getColorDictionary

public ColorDictionary getColorDictionary()

返回图层的颜色对照表。

支持对获取的颜色对照表的颜色值和高程值灵活的编辑。

注意：在图层中如果没有设置颜色对照表，显示前把颜色表转换成颜色对照表，在图层显示时如果颜色表与颜色对照表相同，以颜色表显示，如果不同，以颜色对照表方式显示。

对颜色表的编辑不再影响图层的显示，图层的显示效果由颜色对照表控制。

返回：

图层的颜色对照表。

setImageInterpolationMode

public void setImageInterpolationMode(ImageInterpolationMode value)

设置显示图像时使用的插值算法。

参数：

value - 指定的插值算法。

getImageInterpolationMode

public ImageInterpolationMode getImageInterpolationMode()

返回显示图像时使用的插值算法。

返回：

返回显示图像时使用的插值算法。