com.supermap.data.conversion
类 ImportSettingDGN

java.lang.Object
  com.supermap.data.conversion.ImportSetting
      com.supermap.data.conversion.ImportSettingDGN

public class ImportSettingDGN
extends ImportSetting

DGN 文件导入的参数设置类。继承自 ImportSetting 类。

该类型在 Windows平台版本中支持，在 Linux版本中不提供。

DGN(Design) 是一种 CAD 文件格式，为美国 Bentley System 公司的 MicroStation 和 Intergraph 公司的 Interactive Graphics Design System(IGDS) CAD 程序所支持。

DGN 主要包括两个版本：V7 DGN 和 V8 DGN，SuperMap 组件产品支持这两个版本的导入。具体版本类型及说明可参见 DGNVersion。

注意：

1. 传入的文件型的数据源和工作空间连接信息，在传入之前不能被打开，否则会导入失败；
2. DGN数据可导入为点、线、面、文本简单数据集和CAD数据集，相关接口setImportingAsCAD；
3. DGN数据导入为简单数据集和CAD数据集，非FME都支持按层导入，FME仅导入为CAD数据集时支持按层导入，相关接口setImportingByLayer；
4. DGN支持风格对照，其中风格对照中的符号对照仅针对单元和共享单元导入为点时起作用，即setImportingCellAsPoint为true，相关接口setImportingCellAsPoint；

说明：

1. DGN二维线、二维线串、二维曲线、二维B样曲线导入为二维线，三维线、三维线串、三维曲线、三维B样曲线导入为三维线，其中二维线首尾重合导入为二维点，三维线首尾重合导入为三维点；
2. DGN二维面、复杂面导入为二维面，三维面导入为三维面；
3. DGN二维圆、三维圆导入CAD数据集为二维圆，导入简单数据集为二维面；
4. DGN二维椭圆、三维椭圆导入CAD数据集为二维椭圆，导入简单数据集为二维面；
5. DGN二维弧、三维弧导入为二维对象：
   • 导入CAD数据集
     • a.扫角为0时，导入为二维点；
     • b.扫角为360度，主轴与辅轴相等时，导入为二维圆；
     • c.扫角为其它值，主轴与辅轴相等时，导入为二维圆弧；
     • d.扫角小于等于1度，主轴与辅轴不相等时，导入为二维线；
     • e.其它情况，导入为二维椭圆弧。
   • 导入简单数据集
     • a.扫角为0时，导入为二维点；
     • b.其它情况，导入为二维线。
6. DGN二维文本、三维文本、标签导入为二维文本，其中字体支持不全，没有的字体默认为Arial，DGN横向文本导入后为左基线对齐，垂直文本导入后为左上角对齐，不支持DGN文本风格颠倒、反向、字间距；
7. DGN多线导入CAD数据集时，轮廓个数大于1导入为复合对象，否则导入为二维线，导入简单数据集时全部为二维线；
8. DGN二维多行文本、三维多行文本、复杂线、标注、二维单元、三维单元、共享单元导入CAD数据集为复合对象；
9. DGN导入后有19个用户字段，如下：

   字段名称	字段说明
   ElementID	元素ID
   MSLINK	DMRS链接,多个之间以','分隔
   ENTITY	DMRS链接表ID,多个之间以','分隔
   DgnLink	DGN链接,多个之间以'|'分隔
   OriginLevel	图层
   OriginLineStyle	线型名称
   CellName	单元或共享单元名称
   CellRotateAngle	单元或共享单元旋转角度
   FillColorIndex	填充颜色ID
   LineColorIndex	线颜色ID
   LineStyle	线型ID
   LineWeight	线宽
   FillColor	填充颜色
   FillMode	填充模式
   X	默认0
   Y	默认0
   Z	默认0
   StringLink	String链接,多个之间以','分隔
   StringLinkID	String链接ID,多个之间以','分隔

10. DGN共享单元有颜色、线型、线宽属性，当某种属性被设置时会覆盖所有子对象的相应属性（例如：共享单元的颜色设置为红色，那么所有子对象的颜色都是红色），导入时存在以下情况：

    （表格中颜色、线型、线宽表示共享单元相应属性是否设置，风格对照表示导入时是否进行风格对照）

    颜色	线型	线宽	风格对照	结果
    是	是	是	否	所有子对象为共享单元颜色、线型、线宽
    是	是	是	是	所有子对象为共享单元线型风格对照后的颜色、线型、线宽
    是	是	否	否	所有子对象为共享单元颜色、线型，子对象本身线宽
    是	是	否	是	所有子对象为共享单元线型风格对照后的颜色、线型，子对象本身风格对照后的线宽
    是	否	是	否	所有子对象为共享单元颜色、线宽，子对象本身线型
    是	否	是	是	所有子对象为共享单元颜色、线宽，子对象本身风格对照后的线型
    否	是	是	否	所有子对象为共享单元线型、线宽，子对象本身颜色
    否	是	是	是	所有子对象为共享单元线型风格对照后的线型、线宽，子对象本身风格对照后的颜色
    是	否	否	否	所有子对象为共享单元颜色，子对象本身线型、线宽
    是	否	否	是	所有子对象为共享单元颜色，子对象本身风格对照后的线型、线宽
    否	是	否	否	所有子对象为共享单元线型，子对象本身颜色、线宽
    否	是	否	是	所有子对象为共享单元线型风格对照后的线型，子对象本身风格对照后的颜色、线宽
    否	否	是	否	所有子对象为共享单元线宽，子对象本身颜色、线型
    否	否	是	是	所有子对象为共享单元线宽，子对象本身风格对照后的颜色、线型
    否	否	否	否	所有子对象为子对象本身颜色、线型、线宽
    否	否	否	是	所有子对象为子对象本身风格对照后的颜色、线型、线宽

构造方法摘要

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

ImportSettingDGN(ImportSettingDGN importSettingDGN)
拷贝构造函数，根据给定的 ImportSettingDGN 对象构造一个与其完全相同的新对象。

ImportSettingDGN(java.lang.String sourceFilePath, Datasource targetDatasource)
根据指定的参数构造 ImportSettingDGN 类的新实例。

ImportSettingDGN(java.lang.String sourceFilePath, Datasource targetDatasource, boolean importingAsCAD)
根据指定的参数构造 ImportSettingDGN 类的新实例。

ImportSettingDGN(java.lang.String sourceFilePath, DatasourceConnectionInfo targetConnectionInfo)
根据指定的参数构造 ImportSettingDGN 类的新实例。

ImportSettingDGN(java.lang.String sourceFilePath, DatasourceConnectionInfo targetConnectionInfo, boolean importingAsCAD)
根据指定的参数构造 ImportSettingDGN 类的新实例。

方法摘要

void	dispose() 释放该对象所占用的资源。
SpatialIndexInfo	getSpatialIndex() 返回空间索引信息。
java.lang.String	getStyleMappingTableFile() 返回风格对照表的存储路径。
boolean	isImportEmptyDataset() 获取是否导入空的数据集
boolean	isImportingAsCAD() 返回导入模式，即导入的目标数据集类型。
boolean	isImportingByLayer() 返回在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集， 否则对应源数据中的每一个图层生成一个 CAD 数据集。
boolean	isImportingCellAsPoint() 返回将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。
void	setImportEmptyDataset(boolean bImportEmptyDT) 设置是否导入空的数据集，默认是不导入的
void	setImportingAsCAD(boolean value) 设置导入模式，即导入目标数据集类型。
void	setImportingByLayer(boolean value) 设置在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集， 否则对应源数据中的每一个图层生成一个 CAD 数据集。
void	setImportingCellAsPoint(boolean value) 设置将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。
void	setSpatialIndex(SpatialIndexInfo spatialIndexInfo) 设置空间索引信息。
void	setStyleMappingTableFile(java.lang.String path) 设置风格对照表的存储路径。

从类 com.supermap.data.conversion.ImportSetting 继承的方法

fromXML, getEncodeType, getImportMode, getSourceFileCharset, getSourceFilePath, getSourceFileType, getSourcePrjCoordSys, getTargetDataInfos, getTargetDataInfos, getTargetDatasetName, getTargetDatasource, getTargetDatasourceConnectionInfo, getTargetEncodeType, getTargetPrjCoordSys, isUseFME, setEncodeType, setFieldValue, setImportMode, setScalingFactor, setSourceFileCharset, setSourceFilePath, setTargetDataInfos, setTargetDatasetName, setTargetDatasource, setTargetDatasourceConnectionInfo, setTargetEncodeType, setTargetPrjCoordSys, setUseFME, toXML

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

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

构造方法详细信息

ImportSettingDGN

public ImportSettingDGN()

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

ImportSettingDGN

public ImportSettingDGN(ImportSettingDGN importSettingDGN)

拷贝构造函数，根据给定的 ImportSettingDGN 对象构造一个与其完全相同的新对象。

参数：

importSettingDGN - 用于初始化 ImportSettingDGN 新实例的对象。

ImportSettingDGN

public ImportSettingDGN(java.lang.String sourceFilePath,
                        Datasource targetDatasource)

根据指定的参数构造 ImportSettingDGN 类的新实例。

参数：

sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。

targetDatasource - 指定导入的目标数据源对象。

ImportSettingDGN

public ImportSettingDGN(java.lang.String sourceFilePath,
                        DatasourceConnectionInfo targetConnectionInfo)

根据指定的参数构造 ImportSettingDGN 类的新实例。

参数：

sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。

targetConnectionInfo - 指定导入的目标数据源连接信息对象。

ImportSettingDGN

public ImportSettingDGN(java.lang.String sourceFilePath,
                        Datasource targetDatasource,
                        boolean importingAsCAD)

根据指定的参数构造 ImportSettingDGN 类的新实例。

参数：

sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。

targetDatasource - 指定导入的目标数据源对象。

importingAsCAD - 是否以 CAD 格式导入。

ImportSettingDGN

public ImportSettingDGN(java.lang.String sourceFilePath,
                        DatasourceConnectionInfo targetConnectionInfo,
                        boolean importingAsCAD)

根据指定的参数构造 ImportSettingDGN 类的新实例。

参数：

sourceFilePath - 指定被导入的 DGN 格式数据的源文件的路径。

targetConnectionInfo - 指定导入的目标数据源连接信息对象。

importingAsCAD - 是否以 CAD 格式导入。

方法详细信息

isImportingAsCAD

public boolean isImportingAsCAD()

返回导入模式，即导入的目标数据集类型。

返回：

一个布尔值，表示是否以 CAD 模式导入。true 表示导入为 CAD 数据集，false 表示导入为数据对应类型的简单矢量数据集。

默认值:

默认值为 true，表示导入为 CAD 数据集。

setImportingAsCAD

public void setImportingAsCAD(boolean value)

设置导入模式，即导入目标数据集类型。

参数：

value - 导入模式，即目标数据集类型，默认为 true，即导入为 CAD 数据集, 否则为数据对应类型的简单矢量数据集。

isImportingCellAsPoint

public boolean isImportingCellAsPoint()

返回将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。默认为 false，即将原有的单元对象以除 cell header 外的所有 要素对象的形式导入，否则在单元对象的位置用点对象代替。

注意：如果导入参数 setImportingAsCAD设置为 false，则此参数设置无效。

返回：

一个布尔值，true 表示单元对象导入为点对象，false 表示单元对象导入为除 cell header 外的所有要素对象。

默认值:

默认值为 false，表示将单元对象以除 cell header 外的所有要素对象的形式导入。

setImportingCellAsPoint

public void setImportingCellAsPoint(boolean value)

设置将 cell（单元）对象导入为点对象(cell header)还是除 cell header 外的所有要素对象。默认导入为除 cell header 外的所有要素对象。

注意：如果导入参数 setImportingAsCAD设置为 false，则此参数设置无效。

参数：

value - 一个布尔值，true 表示单元对象导入为点对象，false 表示单元对象导入为除 cell header 外的所有要素对象。

getSpatialIndex

public SpatialIndexInfo getSpatialIndex()

返回空间索引信息。

返回：

空间索引信息。

setSpatialIndex

public void setSpatialIndex(SpatialIndexInfo spatialIndexInfo)

设置空间索引信息。

参数：

spatialIndexInfo - 空间索引信息。

isImportingByLayer

public boolean isImportingByLayer()

返回在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集， 否则对应源数据中的每一个图层生成一个 CAD 数据集。

注意：如果导入参数 setImportingAsCAD设置为 false，以FME方式导入时此参数设置无效。

返回：

一个布尔值，在导入后的数据中合并源数据中的 CAD 图层信息返回 true，否则返回 false。

默认值:

默认值为 false。

setImportingByLayer

public void setImportingByLayer(boolean value)

设置在导入后的数据中是否合并源数据中的 CAD 图层信息，CAD 是以图层信息来存储的，默认为 false，即所有的图层信息都合并到了一个 CAD 数据集， 否则对应源数据中的每一个图层生成一个 CAD 数据集。

注意：如果导入参数 setImportingAsCAD设置为 false，以FME方式导入时此参数设置无效。

参数：

value - 在导入后的数据中是否合并源数据中的 CAD 图层信息。

getStyleMappingTableFile

public java.lang.String getStyleMappingTableFile()

返回风格对照表的存储路径。

风格对照表是指 SuperMap 系统与其它系统风格（包括：符号、线型、填充等）的对照文件。

风格对照表只对 CAD 类型的数据，如 DXF、DWG、DGN 起作用。在设置风格对照表之前，必须保证数据是以CAD方式导入，且不忽略风格。

返回：

风格对照表的存储路径。

默认值:

默认风格对照表的存储路径为：安装路径/Bin/resource/stmi.stt。

setStyleMappingTableFile

public void setStyleMappingTableFile(java.lang.String path)

设置风格对照表的存储路径。

风格对照表是指 SuperMap 系统与其它系统风格（包括：符号、线型、填充等）的对照文件。

风格对照表只对 CAD 类型的数据，如 DXF、DWG、DGN 起作用。在设置风格对照表之前，必须保证数据是以CAD方式导入，且不忽略风格。

参数：

path - 风格对照表的存储路径。

dispose

public void dispose()

释放该对象所占用的资源。当调用该方法之后，此对象不再可用。

setImportEmptyDataset

public void setImportEmptyDataset(boolean bImportEmptyDT)

设置是否导入空的数据集，默认是不导入的

参数：

bImportEmptyDT - 是否导入空的数据集，true表示导入，false表示不导入

isImportEmptyDataset

public boolean isImportEmptyDataset()

获取是否导入空的数据集

返回：

是否导入空的数据集