com.supermap.data
类 Environment

java.lang.Object
  com.supermap.data.Environment

public class Environment
extends java.lang.Object

关于开发环境的一些配置信息管理类，比如设置缓存目录、设置零值判断精度等功能，通过此类还可以设置像素与逻辑坐标的比例。

字段摘要

static double	DEFAULT_MAX_EQUAL_ZERO_PRECISION 默认零值判断最大精度。
static double	DEFAULT_MIN_EQUAL_ZERO_PRECISION 默认零值判断最小精度。

方法摘要

static CUDACapability	checkCUDACapability() 检测计算机是否可以利用GPU进行CUDA并行计算。
static OpenCLCapability	checkOpenCLCapability() 检测计算机是否可以利用GPU进行OpenCL并行计算。
long	getAnalystMemorySize() 返回分析模式，包括内存模式和传统模式。
static Charset	getCurrentCharset() 返回当前系统所使用的字符集。
static java.lang.String	getCurrentCulture() 获取当前语言环境
static EngineType[]	getCurrentLoadedEngine() 返回当前已加载引擎的列表。
static EngineInfo[]	getCurrentLoadedEngineInfos() 返回一个数组，表示当前加载引擎信息列表。
static double	getCustomDPIX() 返回水平方向上的 DPI。
static double	getCustomDPIY() 返回垂直方向上的 DPI。
static double	getCustomMapRatioX() 已过时。 已过时。使用getCustomDPIX()替代。 返回水平方向上的像素与逻辑坐标的比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。 举例： 假设屏幕水平方向像素数为1600，逻辑单位等于0.1毫米。如果显示器长150mm，则逻辑坐标 X ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1600：1500＝1.07。
static double	getCustomMapRatioY() 已过时。 已过时。使用getCustomDPIY()替代。 返回垂直方向上的像素与逻辑坐标比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。 举例： 假设屏幕垂直方向像素数为1200，逻辑单位等于0.1毫米。如果显示器高150mm，则逻辑坐标 Y ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1200：1500＝0.8。
static java.lang.String	getElementValue(java.lang.String name) 获取要素值。
static java.lang.String	getFileCacheFolder() 返回数据集文件缓存目录。
static double	getMaxEqualZeroPrecision() 返回判断一个单精度或者双精度数是否为零的最大判断精度。
static int	getMaxStdIO() 获取最大文件IO句柄数
static double	getMinEqualZeroPrecision() 返回判断一个单精度或者双精度数是否为零的最小判断精度。
int	getOMPNumThreads() 返回并行计算所使用的线程数。
static int	getSceneAntialiasValue() 返回全屏反走样系数。
static double	getSystemDPI() 返回系统的DPI，值域为(60，180)，非自定义设置时使用Set抛异常。
static int	GetTileLayerBufferSize() 获取将浏览过的瓦片驻留在内存中的数量上限
static int	GetTileLayerDownLoadThreadCount() 获取网络瓦片下载时的最大线程数
static java.lang.String	getUGOBasePath() 返回当前组件的Bin目录位置，用于检测许可相关文件
static boolean	isClearTypeSupported() 已过时。
static boolean	isCUDAComputingEnabled() 返回是否开启CUDA并行计算模式。
static boolean	isCustomDPIEnabled() 返回是否使用自定义的 DPI。
static boolean	isCustomMapRatioEnabled() 已过时。 已过时。使用isCustomDPIEnabled()替代。 返回是否使用自定义的像素与逻辑坐标的比例，true 时使用自定义的比例，false 时使用系统的像素与逻辑坐标比例。 像素指的是显示设备的像素，逻辑坐标是独立于设备的，它的单位可以是像素，毫米，英寸等，目前 SuperMap 一个逻辑单位等于0.1mm。
static boolean	isHardwareAccelerationEnable() 返回是否开启硬件加速绘制，true表示开启；false表示关闭。
boolean	isMapInflated() 返回是否开启扩大查询范围。
static boolean	isOneLogFilePerProcess() 是否每个进程有一个日志文件。
static boolean	isOpenCLComputingEnabled() 返回是否开启OpenCL并行计算模式。
static boolean	isSceneAntialias() 返回是否开启全屏反走样功能。
static boolean	isUnicodeVersion() 返回判断当前程序版本是否为 Unicode 版本，SuperMap Objects Java 6R(2012) SP2 版本为非 Unicode 版本，返回值为 false。
static void	LoadWrapJ() 加载wrapj
void	setAnalystMemorySize(long value) 设置分析模式，以及内存模式下允许使用的内存大小（为下一版本预留）。
static void	setClearTypeSupported(boolean value) 已过时。
static void	setCUDAComputingEnabled(boolean value) 设置是否开启CUDA并行计算模式。
static void	setCurrentCharset(Charset charset) 设置当前系统所使用的字符集。
static void	setCurrentCulture(java.lang.String value) 设置当前语言环境，如en-US zh-CH等
static void	setCustomDPIEnabled(boolean value) 设置是否使用自定义的 DPI， true 表示使用自定义的 DPI； false 表示使用系统的 DPI。
static void	setCustomDPIX(double value) 设置水平方向上的 DPI。
static void	setCustomDPIY(double value) 设置垂直方向上的 DPI。
static void	setCustomMapRatioEnabled(boolean value) 已过时。 已过时。使用setCustomDPIEnabled()替代。 设置是否使用自定义的像素与逻辑坐标的比例，true 时使用自定义的比例，false 时使用系统的像素与逻辑坐标比例。 像素指的是显示设备的像素，逻辑坐标是独立于设备的，它的单位可以是像素，毫米，英寸等，目前 SuperMap 一个逻辑单位等于0.1mm。
static void	setCustomMapRatioX(double value) 已过时。 已过时。使用setCustomDPIX()替代。 设置水平方向上的像素与逻辑坐标的比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。 举例： 假设屏幕水平方向像素数为1600，逻辑单位等于0.1毫米。如果显示器长150mm，则逻辑坐标 X ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1600：1500＝1.07。
static void	setCustomMapRatioY(double value) 已过时。 已过时。使用setCustomDPIY()替代。 设置垂直方向上的像素与逻辑坐标比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。 举例： 假设屏幕垂直方向像素数为1200，逻辑单位等于0.1毫米。如果显示器高150mm，则逻辑坐标 Y ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1200：1500＝0.8。
static void	setElementValue(java.lang.String name, java.lang.String value) 设置要素值。
static void	setFileCacheFolder(java.lang.String value) 设置数据集文件缓存目录。
static void	setHardwareAccelerationEnable(boolean value) 设置是否开启硬件加速绘制。
void	setMapInflated(boolean value) 设置是否开启扩大查询范围。
static void	setMaxEqualZeroPrecision(double value) 设置判断一个单精度或者双精度数是否为零的最大判断精度。
static void	setMaxStdIO(int value) 设置最大文件IO句柄数
static void	setMinEqualZeroPrecision(double value) 设置判断一个单精度或者双精度数是否为零的最小判断精度。
void	setOMPNumThreads(int value) 设置并行计算所使用的线程数。
static void	setOMPNumThreads(int value, boolean isSaveToXml) 设置并行计算所使用的线程数。
static void	setOneLogFilePerProcess(boolean value) 设置每个进程有一个日志文件。
static void	setOpenCLComputingEnabled(boolean value) 设置是否开启OpenCL并行计算模式。
static void	setSceneAntialias(boolean value) 设置是否开启全屏反走样功能。
static void	setSceneAntialiasValue(int value) 设置全屏反走样系数 全屏反走样系数代表了反走样处理强度的大小，该值越高，代表场景锯齿越小，场景越细腻，同时也会带来更高的系统资源占用率。
static void	setSystemDPI(double value) 设置系统的DPI。
static void	SetTileLayerBufferSize(int size) 设置将浏览过的瓦片驻留在内存中的数量上限
static void	SetTileLayerDownLoadThreadCount(int size) 设置网络瓦片下载时的最大线程数

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

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

字段详细信息

DEFAULT_MAX_EQUAL_ZERO_PRECISION

public static final double DEFAULT_MAX_EQUAL_ZERO_PRECISION

默认零值判断最大精度。系统给定的精度范围的上界，为公有静态只读字段，用户不能修改。

另请参见：

Toolkit, 常量字段值

默认值:

默认值为 1E-10。

DEFAULT_MIN_EQUAL_ZERO_PRECISION

public static final double DEFAULT_MIN_EQUAL_ZERO_PRECISION

默认零值判断最小精度。系统给定的精度范围的下界，为公有静态只读字段，用户不能修改。

另请参见：

Toolkit, 常量字段值

默认值:

默认值为 -1E-10。

方法详细信息

isUnicodeVersion

public static boolean isUnicodeVersion()

返回判断当前程序版本是否为 Unicode 版本，SuperMap Objects Java 6R(2012) SP2 版本为非 Unicode 版本，返回值为 false。

返回：

一个布尔值，用来判断当前程序版本是否为 Unicode 版本，true 表示为 Unicode 版本；false 为非 Unicode 版本。

getMaxEqualZeroPrecision

public static double getMaxEqualZeroPrecision()

返回判断一个单精度或者双精度数是否为零的最大判断精度。如果返回或设置的数值在最小判断精度(MinEqualPrecision)和最大判断精度(MaxEqualPrecision)精度范围之间，就认为它为0。即设 a 为返回或设置的数值，那么当 a 大于等于 MinEqualPrecision 且小于等于 MaxEqualPrecision 时，则认为 a 为0。注意：事实上，MaxEqualPrecision 应该大于等于 MinEqualPrecision，但目前版本的组件代码暂时不对此进行控制。

返回：

判断一个单精度或者双精度数是否为零的判断最大精度。

另请参见：

Toolkit

默认值:

默认值为 1E-10。

setMaxEqualZeroPrecision

public static void setMaxEqualZeroPrecision(double value)

设置判断一个单精度或者双精度数是否为零的最大判断精度。如果返回或设置的数值在最小判断精度(MinEqualPrecision)和最大判断精度(MaxEqualPrecision)精度范围之间，就认为它为0。即设 a 为返回或设置的数值，那么当 a 大于等于 MinEqualPrecision 且小于等于 MaxEqualPrecision 时，则认为 a 为0。注意：事实上，MaxEqualPrecision 应该大于等于 MinEqualPrecision，但目前版本的组件代码暂时不对此进行控制。

参数：

value - 判断一个单精度或者双精度数是否为零的判断最大精度。

另请参见：

Toolkit

getMinEqualZeroPrecision

public static double getMinEqualZeroPrecision()

返回判断一个单精度或者双精度数是否为零的最小判断精度。默认值为。如果返回或设置的数值在最小判断精度(MinEqualPrecision)和最大判断精度(MaxEqualPrecision)精度范围之间，就认为它为0。即设 a 为返回或设置的数值，那么当 a 大于等于 MinEqualPrecision 且小于等于 MaxEqualPrecision 时，则认为 a 为0。注意：事实上，MaxEqualPrecision 应该大于等于 MinEqualPrecision，但目前版本的组件代码暂时不对此进行控制。

返回：

判断一个单精度或者双精度数是否为零的判断最小精度。

另请参见：

Toolkit

默认值:

默认值为 -1E-10。

setMinEqualZeroPrecision

public static void setMinEqualZeroPrecision(double value)

设置判断一个单精度或者双精度数是否为零的最小判断精度。如果返回或设置的数值在最小判断精度(MinEqualPrecision)和最大判断精度(MaxEqualPrecision)精度范围之间，就认为它为0。即设 a 为返回或设置的数值，那么当 a 大于等于 MinEqualPrecision 且小于等于 MaxEqualPrecision 时，则认为 a 为0。注意：事实上，MaxEqualPrecision 应该大于等于 MinEqualPrecision，但目前版本的组件代码暂时不对此进行控制。

参数：

value - 判断一个单精度或者双精度数是否为零的判断最小精度。

另请参见：

Toolkit

getFileCacheFolder

public static java.lang.String getFileCacheFolder()

返回数据集文件缓存目录。

返回：

数据集文件缓存目录。

默认值:

默认值为一个空字符串。

setFileCacheFolder

public static void setFileCacheFolder(java.lang.String value)

设置数据集文件缓存目录。

参数：

value - 数据集文件缓存目录。

LoadWrapJ

public static void LoadWrapJ()

加载wrapj

getCurrentLoadedEngine

public static EngineType[] getCurrentLoadedEngine()

返回当前已加载引擎的列表。返回一个拷贝即可。

返回：

当前加载引擎的列表拷贝。

isCustomMapRatioEnabled

@Deprecated
public static boolean isCustomMapRatioEnabled()

已过时。 已过时。使用isCustomDPIEnabled()替代。 返回是否使用自定义的像素与逻辑坐标的比例，true 时使用自定义的比例，false 时使用系统的像素与逻辑坐标比例。

像素指的是显示设备的像素，逻辑坐标是独立于设备的，它的单位可以是像素，毫米，英寸等，目前 SuperMap 一个逻辑单位等于0.1mm。

返回：

使用自定义的比例返回 true；使用系统的像素与逻辑坐标比例返回 false。

setCustomMapRatioEnabled

@Deprecated
public static void setCustomMapRatioEnabled(boolean value)

已过时。 已过时。使用setCustomDPIEnabled()替代。 设置是否使用自定义的像素与逻辑坐标的比例，true 时使用自定义的比例，false 时使用系统的像素与逻辑坐标比例。

像素指的是显示设备的像素，逻辑坐标是独立于设备的，它的单位可以是像素，毫米，英寸等，目前 SuperMap 一个逻辑单位等于0.1mm。

参数：

value - 一个布尔值指定是否使用自定义的像素与逻辑坐标的比例。

getCustomMapRatioX

@Deprecated
public static double getCustomMapRatioX()

已过时。 已过时。使用getCustomDPIX()替代。 返回水平方向上的像素与逻辑坐标的比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。

举例：

假设屏幕水平方向像素数为1600，逻辑单位等于0.1毫米。如果显示器长150mm，则逻辑坐标 X ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1600：1500＝1.07。

返回：

水平方向上的像素与逻辑坐标的比例值。

setCustomMapRatioX

@Deprecated
public static void setCustomMapRatioX(double value)

已过时。 已过时。使用setCustomDPIX()替代。 设置水平方向上的像素与逻辑坐标的比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。

举例：

假设屏幕水平方向像素数为1600，逻辑单位等于0.1毫米。如果显示器长150mm，则逻辑坐标 X ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1600：1500＝1.07。

参数：

value - 水平方向上的像素与逻辑坐标的比例值。

getCustomMapRatioY

@Deprecated
public static double getCustomMapRatioY()

已过时。 已过时。使用getCustomDPIY()替代。 返回垂直方向上的像素与逻辑坐标比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。

举例：

假设屏幕垂直方向像素数为1200，逻辑单位等于0.1毫米。如果显示器高150mm，则逻辑坐标 Y ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1200：1500＝0.8。

返回：

垂直方向上的像素与逻辑坐标比例值。

setCustomMapRatioY

@Deprecated
public static void setCustomMapRatioY(double value)

已过时。 已过时。使用setCustomDPIY()替代。 设置垂直方向上的像素与逻辑坐标比例值。当 setCustomMapRatioEnable() 方法设置为 true 时有效。

举例：

假设屏幕垂直方向像素数为1200，逻辑单位等于0.1毫米。如果显示器高150mm，则逻辑坐标 Y ＝ 1500；那么水平方向上的像素与逻辑坐标的比例值是：1200：1500＝0.8。

参数：

value - 垂直方向上的像素与逻辑坐标比例值。

setCustomDPIEnabled

public static void setCustomDPIEnabled(boolean value)

设置是否使用自定义的 DPI， true 表示使用自定义的 DPI； false 表示使用系统的 DPI。

参数：

value - 一个布尔值指定是否使用自定义的 DPI。

isCustomDPIEnabled

public static boolean isCustomDPIEnabled()

返回是否使用自定义的 DPI。

返回：

一个布尔值，指定是否使用自定义的 DPI， true 表示使用自定义的 DPI； false 表示使用系统的 DPI。

默认值:

默认值为false。

getCustomDPIX

public static double getCustomDPIX()

返回水平方向上的 DPI。

返回：

返回水平方向上的 DPI。

setCustomDPIX

public static void setCustomDPIX(double value)

设置水平方向上的 DPI。当 isCustomDPIEnabled()返回值为 true 时有效。

参数：

value - 水平方向上的 DPI数值。

getCustomDPIY

public static double getCustomDPIY()

返回垂直方向上的 DPI。

返回：

返回垂直方向上的 DPI。

setCustomDPIY

public static void setCustomDPIY(double value)

设置垂直方向上的 DPI。当 isCustomDPIEnabled()返回值为 true 时有效。

参数：

value - 垂直方向上的 DPI数值。

getSystemDPI

public static double getSystemDPI()

返回系统的DPI，值域为(60，180)，非自定义设置时使用Set抛异常。

返回：

返回系统的的 DPI。

setSystemDPI

public static void setSystemDPI(double value)

设置系统的DPI。

参数：

value - 系统的DPI。

getCurrentLoadedEngineInfos

public static EngineInfo[] getCurrentLoadedEngineInfos()

返回一个数组，表示当前加载引擎信息列表。

返回：

一个数组，表示当前加载引擎信息列表。

getCurrentCharset

public static Charset getCurrentCharset()

返回当前系统所使用的字符集。

返回：

当前系统所使用的字符集。

setCurrentCharset

public static void setCurrentCharset(Charset charset)

设置当前系统所使用的字符集。

参数：

charset - 当前系统所使用的字符集。

isClearTypeSupported

@Deprecated
public static boolean isClearTypeSupported()

已过时。

返回文本是否使用 ClearType 方式进行反走样显示，该设置仅对 Windows 平台有效。

ClearType 是一种绘制文本分别使用像素的红、绿、蓝 (RGB) 组件代替使用整个像素 sub-pixel 字体呈现的方式。它通过使字体的边缘平滑来增加显示，理论上可以让屏幕分辨率提高3倍。尤其适用于液晶显示（LCD）显示，包括平面屏幕监视器和便携式计算机。

返回：

一个布尔值，表示文本是否使用 ClearType 方式进行反走样显示，如果使用返回 true，否则返回 false。

默认值:

默认值为false。

setClearTypeSupported

@Deprecated
public static void setClearTypeSupported(boolean value)

已过时。

设置文本是否使用 ClearType 方式进行反走样显示，该设置仅对 Windows 平台有效。

ClearType 是一种绘制文本分别使用像素的红、绿、蓝 (RGB) 组件代替使用整个像素 sub-pixel 字体呈现的方式。它通过使字体的边缘平滑来增加显示，理论上可以让屏幕分辨率提高3倍。尤其适用于液晶显示（LCD）显示，包括平面屏幕监视器和便携式计算机。

参数：

value - 一个布尔值表示文本是否使用 ClearType 方式进行反走样显示。

isSceneAntialias

public static boolean isSceneAntialias()

返回是否开启全屏反走样功能。

开启全屏反走样功能将会优化场景的细腻程度，减少场景中模型边缘锯齿的出现。

开启全屏反走样功能会增加对系统资源的占用，请根据用户电脑硬件配置，并结合设置全屏反走样系数方法（Environment.setSceneAntialias()）来进行合理设置。

返回：

返回是否开启全屏反走样功能。

默认值:

默认值为false。

setSceneAntialias

public static void setSceneAntialias(boolean value)

设置是否开启全屏反走样功能。

开启全屏反走样功能将会优化场景的细腻程度，减少场景中模型边缘锯齿的出现。

开启全屏反走样功能会增加对系统资源的占用，请根据用户电脑硬件配置，并结合设置全屏反走样系数方法（Environment.setSceneAntialias()）来进行合理设置。

参数：

value - 是否开启全屏反走样功能。

getSceneAntialiasValue

public static int getSceneAntialiasValue()

返回全屏反走样系数。

全屏反走样系数代表了反走样处理强度的大小，该值越高，代表场景锯齿越小，场景越细腻，同时也会带来更高的系统资源占用率。过高的全屏反走样系数可能会引起场景性能的下降，请根据用户电脑硬件配置，并结合设置全屏反走样系数方法（Environment.setSceneAntialias()）来进行合理设置。

全屏反走样系数取值范围为0到16。

返回：

返回全屏反走样系数。

默认值:

默认值为2。

setSceneAntialiasValue

public static void setSceneAntialiasValue(int value)

设置全屏反走样系数

全屏反走样系数代表了反走样处理强度的大小，该值越高，代表场景锯齿越小，场景越细腻，同时也会带来更高的系统资源占用率。过高的全屏反走样系数可能会引起场景性能的下降，请根据用户电脑硬件配置，并结合设置全屏反走样系数方法（Environment.setSceneAntialias()）来进行合理设置。

全屏反走样系数取值范围为0到16。

参数：

value - 全屏反走样系数。

getOMPNumThreads

public int getOMPNumThreads()

返回并行计算所使用的线程数。

返回：

并行计算所使用的线程数。

默认值:

默认值为应用程序启动时读取的 SuperMap.xml 文件中 <OMPNumThreads></OMPNumThreads> 节点的值。

setOMPNumThreads

public void setOMPNumThreads(int value)

设置并行计算所使用的线程数。

目前提供两种方式设置并行计算所使用的线程数，一是通过此方法设置，二是通过修改配置文件 SuperMap.xml 中的 <OMPNumThreads></OMPNumThreads> 节点的值（默认为 2），该配置文件位于“产品安装目录\Bin”目录下。

注意：

1. 应用程序启动时优先读取配置文件中的设置。如果不调用此方法进行修改，则默认使用配置文件中指定的线程数目；如果通过此方法修改线程数目，修改将立即生效，并同步修改配置文件中的值。
2. 配置文件中的线程数目只在应用程序启动时读取一次，如果手动修改配置文件中的该值，必须重新启动应用程序才能生效。
3. 线程数目的有效范围为 1-16。如果配置文件中的线程数目超出范围，则设置无效，使用默认值 2；如果通过此方法设置线程数目超出范围，则会抛出异常。
4. 建议设置线程数与计算机的核数相同，以便充分利用计算机的计算资源。

有关并行计算支持的接口等内容，请参阅《并行计算》说明文档。

参数：

value - 并行计算所使用的线程数。

抛出：

java.lang.IllegalArgumentException - 如果设置值小于等于 0 或大于 16

从以下版本开始：

SuperMap iObjects Java 7.0.0

setOMPNumThreads

public static void setOMPNumThreads(int value,
                                    boolean isSaveToXml)

设置并行计算所使用的线程数。

目前提供两种方式设置并行计算所使用的线程数，一是通过此方法设置，二是通过修改配置文件 SuperMap.xml 中的 <OMPNumThreads></OMPNumThreads> 节点的值（默认为 2），该配置文件位于“产品安装目录\Bin”目录下。

注意：

1. 应用程序启动时优先读取配置文件中的设置。如果不调用此方法进行修改，则默认使用配置文件中指定的线程数目；如果通过此方法修改线程数目，修改将立即生效，并同步修改配置文件中的值。
2. 配置文件中的线程数目只在应用程序启动时读取一次，如果手动修改配置文件中的该值，必须重新启动应用程序才能生效。
3. 线程数目的有效范围为 1-16。如果配置文件中的线程数目超出范围，则设置无效，使用默认值 2；如果通过此方法设置线程数目超出范围，则会抛出异常。
4. 建议设置线程数与计算机的核数相同，以便充分利用计算机的计算资源。

有关并行计算支持的接口等内容，请参阅《并行计算》说明文档。

参数：

value - 并行计算所使用的线程数。

isSaveToXml - 是否保存为xml文件

抛出：

java.lang.IllegalArgumentException - 如果设置值小于等于 0 或大于 16

从以下版本开始：

SuperMap iObjects Java 7.0.0

getAnalystMemorySize

public long getAnalystMemorySize()

返回分析模式，包括内存模式和传统模式。

有关分析模式，请参阅 setAnalystMemorySize 方法。

返回：

分析模式。

从以下版本开始：

SuperMap iObjects Java 7.0.0

默认值:

默认值为应用程序启动时读取的 SuperMap.xml 文件中 <AnalystMemorySize></AnalystMemorySize> 节点的值。0 表示以传统模式分析，-1 表示以内存模式分析。

setAnalystMemorySize

public void setAnalystMemorySize(long value)

设置分析模式，以及内存模式下允许使用的内存大小（为下一版本预留）。

SuperMap 针对部分分析功能，提供可选的分析模式，包括传统模式和内存模式。内存模式与传统模式相比，在提升性能方面具有优势。它通过将分析需要的数据一次性读入内存，从而避免分析过程中频繁与数据引擎交互，进而提升分析的速度。

目前，支持以内存模式进行分析的功能包括：

• 构建网络数据集
1. 通过线数据集构建网络：NetworkBuilder.buildNetwork 方法。
2. 通过点、线数据集构建网络：NetworkBuilder.buildNetwork 方法。

注意：内存模式只支持对一个线数据集，或者一个线数据集和一个点数据集构建网络，对于覆盖两个及以上线（或点）数据集的网络，可先对一个线数据集（及一个点数据集）使用内存模式来构网，然后向该网络追加其他数据（NetworkBuilder.appendToNetwork 方法）。

• 拓扑处理：TopologyProcessing.clean 方法。
• 拓扑预处理：所有 4 个 TopologyValidator.preprocess 重载方法。
• 拓扑构面：所有 2 个 TopologyProcessing.buildRegions 重载方法。
• 数据集重采样：DatasetVector.resample 方法。

注意：内存模式只支持对面数据集重采样。

• 数据集光滑：DatasetVector.smooth 方法。

注意：内存模式只支持对面数据集光滑。

• 矢量数据融合：Generalization.dissolve 方法。
• 碎多边形合并：Generalization.eliminate 方法。
• 栅格提取等值面：所有 14 个SurfaceAnalyst.extractIsoregion 重载方法。
• 叠加分析
1. 多图层相交：相交方式3个OverlayAnalyst.intersect 方法，OverlayAnalyst.intersect 方法，OverlayAnalyst.intersect 方法。
2. 多图层合并：合并方式3个OverlayAnalyst.union 方法，OverlayAnalyst.union 方法，OverlayAnalyst.union 方法。
3. 面内自重叠：OverlayAnalyst.clip 方法，OverlayAnalyst.erase 方法，OverlayAnalyst.identity 方法，OverlayAnalyst.intersect 方法，OverlayAnalyst.union 方法，OverlayAnalyst.update 方法，OverlayAnalyst.xOR 方法。

注意：内存模式只支持相交和合并方式的多图层叠加分析，以及所有方式的面内自重叠的叠加分析。

有两种方法设定分析模式，一是使用此方法指定，二是通过修改 SuperMap.xml 配置文件中的 <AnalystMemorySize></AnalystMemorySize> 节点的值来指定。默认为 0，表示使用传统模式进行分析。

使用以上两种方式时请注意：

1. 支持的值包括 -1 和 0。0 表示使用传统模式进行分析；-1 表示使用内存模式进行分析。设置为 -1 以外的负值将自动修改为 -1，设置为大于 0 的值则自动修改为 0。暂不支持指定内存模式下允许使用的内存大小，该功能为下一版本预留。
2. 应用程序启动时，优先读取配置文件中设置的值。在执行分析之前，通过此方法指定值后，将同步修改配置文件。
3. 配置文件中指定的值只在应用程序启动时读取一次，如果修改，需重新启动应用程序才能生效。
4. 以内存模式分析结束后，占用的内存将自动释放。

参数：

value - 分析模式或内存模式下允许使用的内存大小。

从以下版本开始：

SuperMap iObjects Java 7.0.0

isMapInflated

public boolean isMapInflated()

返回是否开启扩大查询范围。

返回：

一个布尔值，指示是否开启扩大查询范围。返回 true，表示开启扩大查询范围，返回 false，表示不开启。

默认值:

默认值为 false，即不开启扩大查询范围。

getUGOBasePath

public static java.lang.String getUGOBasePath()

返回当前组件的Bin目录位置，用于检测许可相关文件

返回：

boolean

setMapInflated

public void setMapInflated(boolean value)

设置是否开启扩大查询范围。

参数：

value - 一个布尔值，指示是否开启扩大查询范围。返回 true，表示开启扩大查询范围，返回 false，表示不开启。CalculationTerrain.calculateOrthoImage(DatasetGrid, Colors, java.awt.Color, Datasource, String)

setCUDAComputingEnabled

public static void setCUDAComputingEnabled(boolean value)

设置是否开启CUDA并行计算模式。

参数：

value - 一个布尔值，指示是否开启CUDA并行计算模式。

SuperMap 针对部分分析功能，提供CUDA并行计算模式，只要执行计算任务的主机配有NVIDIA的显卡，且计算能力在2.0以上，就会利用GPU的并行计算能力来执行任务。其性能相对普通CPU并行有较大提升。

注意：即使开启了CUDA并行计算模式，如果运行环境即机器显卡不支持CUDA，程序也不会按CUDA并行模式来执行。

目前，支持CUDA并行计算模式的分析功能包括：

• 地形计算
1. 坡度计算：CalculationTerrain.calculateSlope 方法。
2. 坡向计算：CalculationTerrain.calculateAspect 方法。
3. 三维晕渲图（渲染模式）：CalculationTerrain.calculateHillShade 方法。
4. 正射三维影像：所有 2 个 CalculationTerrain.calculateOrthoImage 重载方法。

目前提供两种方式设置是否开启CUDA并行计算模式，一是通过此属性设置，二是通过修改配置文件 SuperMap.xml 中的 <IsCUDAComputingEnabled></IsCUDAComputingEnabled> 节点的值（默认为 false），该配置文件位于“产品安装目录\Bin”目录下。

使用以上两种方式时请注意：

1. 应用程序启动时，优先读取配置文件中设置的值。在执行分析之前，通过此方法指定值后，将同步修改配置文件。
2. 配置文件中指定的值只在应用程序启动时读取一次，如果修改，需重新启动应用程序才能生效。

isCUDAComputingEnabled

public static boolean isCUDAComputingEnabled()

返回是否开启CUDA并行计算模式。

有关CUDA并行计算模式，请参阅 setCUDAComputingEnabled 方法。

返回：

一个布尔值，指示是否开启了CUDA并行计算模式。

从以下版本开始：

SuperMap iObjects Java 7.1.0

默认值:

默认值为应用程序启动时读取的 SuperMap.xml 文件中 <IsCUDAComputingEnabled></IsCUDAComputingEnabled> 节点的值。

checkCUDACapability

public static CUDACapability checkCUDACapability()

检测计算机是否可以利用GPU进行CUDA并行计算。

注意：Linux平台暂不支持此接口。

返回：

计算机是否有能力进行CUDA并行计算的检测结果。

从以下版本开始：

SuperMap iObjects Java 7.1.0

setOpenCLComputingEnabled

public static void setOpenCLComputingEnabled(boolean value)

设置是否开启OpenCL并行计算模式。

参数：

value - 一个布尔值，指示是否开启OpenCL并行计算模式。

SuperMap 针对部分分析功能，提供OpenCL并行计算模式，只要执行计算任务的主机装有OpenCL平台驱动，且有支持OpenCL的可用显卡设备，就会利用GPU的并行计算能力来执行任务。其性能相对普通CPU并行有较大提升。

注意：即使开启了OpenCL并行计算模式，如果运行环境不支持OpenCL，程序也不会按OpenCL并行模式来执行。

目前，支持OpenCL并行计算模式的分析功能包括：

• 地形计算
1. 坡度计算：CalculationTerrain.calculateSlope 方法。
2. 坡向计算：CalculationTerrain.calculateAspect 方法。
3. 三维晕渲图（渲染模式）：CalculationTerrain.calculateHillShade 方法。
4. 曲率计算：CalculationTerrain.calculateCurvature 方法。

目前提供两种方式设置是否开启OpenCL并行计算模式，一是通过此属性设置，二是通过修改配置文件 SuperMap.xml 中的 <IsOpenCLComputingEnabled></IsOpenCLComputingEnabled> 节点的值（默认为 false），该配置文件位于“产品安装目录\Bin”目录下。

使用以上两种方式时请注意：

1. 应用程序启动时，优先读取配置文件中设置的值。在执行分析之前，通过此方法指定值后，将同步修改配置文件。
2. 配置文件中指定的值只在应用程序启动时读取一次，如果修改，需重新启动应用程序才能生效。

isOpenCLComputingEnabled

public static boolean isOpenCLComputingEnabled()

返回是否开启OpenCL并行计算模式。

有关OpenCL并行计算模式，请参阅 setOpenCLComputingEnabled 方法。

返回：

一个布尔值，指示是否开启了OpenCL并行计算模式。

从以下版本开始：

SuperMap iObjects Java 8.0.0

默认值:

默认值为应用程序启动时读取的 SuperMap.xml 文件中 <IsOpenCLComputingEnabled></IsOpenCLComputingEnabled> 节点的值。

checkOpenCLCapability

public static OpenCLCapability checkOpenCLCapability()

检测计算机是否可以利用GPU进行OpenCL并行计算。

注意：仅Windows平台和Linux平台支持此接口。

返回：

计算机是否有能力进行OpenCL并行计算的检测结果。

从以下版本开始：

SuperMap iObjects Java 8.0.0

SetTileLayerBufferSize

public static void SetTileLayerBufferSize(int size)

设置将浏览过的瓦片驻留在内存中的数量上限

参数：

size - 数量

GetTileLayerBufferSize

public static int GetTileLayerBufferSize()

获取将浏览过的瓦片驻留在内存中的数量上限

返回：

数量

SetTileLayerDownLoadThreadCount

public static void SetTileLayerDownLoadThreadCount(int size)

设置网络瓦片下载时的最大线程数

参数：

size - 最大线程数

GetTileLayerDownLoadThreadCount

public static int GetTileLayerDownLoadThreadCount()

获取网络瓦片下载时的最大线程数

返回：

最大线程数

setMaxStdIO

public static void setMaxStdIO(int value)

设置最大文件IO句柄数

参数：

value - 最大文件IO句柄数

getMaxStdIO

public static int getMaxStdIO()

获取最大文件IO句柄数

返回：

最大文件IO句柄数

setCurrentCulture

public static void setCurrentCulture(java.lang.String value)

设置当前语言环境，如en-US zh-CH等

参数：

value - 当前语言环境

getCurrentCulture

public static java.lang.String getCurrentCulture()

获取当前语言环境

返回：

前语言环境

isHardwareAccelerationEnable

public static boolean isHardwareAccelerationEnable()

返回是否开启硬件加速绘制，true表示开启；false表示关闭。目前硬件加速绘制只对动态图层有效。

返回：

返回是否开启硬件加速绘制，true表示开启；false表示关闭。目前硬件加速绘制只对动态图层有效。

setHardwareAccelerationEnable

public static void setHardwareAccelerationEnable(boolean value)

设置是否开启硬件加速绘制。

参数：

value - 一个布尔值，指示是否开启硬件加速绘制，true表示开启；false表示关闭。目前硬件加速绘制只对动态图层有效。

isOneLogFilePerProcess

public static boolean isOneLogFilePerProcess()

是否每个进程有一个日志文件。

返回：

布尔值

setOneLogFilePerProcess

public static void setOneLogFilePerProcess(boolean value)

设置每个进程有一个日志文件。

参数：

value - 一个布尔值

getElementValue

public static java.lang.String getElementValue(java.lang.String name)

获取要素值。

参数：

name - 要素名

返回：

要素名

setElementValue

public static void setElementValue(java.lang.String name,
                                   java.lang.String value)

设置要素值。

参数：

name - 要素名

value - 要素值