TLcdDGNMicroStationModelDecoder (LuciadLightspeed API documentation)

java.lang.Object
- com.luciad.format.dgn.server.TLcdDGNMicroStationModelDecoder

All Implemented Interfaces:: ILcdDGNModelDecoder, ILcdModelDecoder

Deprecated.

Use TLcdDGNModelDecoder instead, which also supports DGN V8 files.

@Deprecated
public class TLcdDGNMicroStationModelDecoder
extends Object
implements ILcdDGNModelDecoder

This model decoder decodes files in the DGN v7, DGN v8, and DWG formats. For retrieving the data, it uses Bentley's DGN API. It can therefore only be executed inside Bentley MicroStation, using the jmdl virtual machine, Bentley's extension of java.

Input files

File	Required	Entry point	Description
*.dgn	x	x	Design file (v7 or v8) containing vector data
*.dwg	x	x	Drawing file containing vector data

Since a DGN file itself doesn't specify a model reference, the corresponding model reference is retrieved with the help of the modelReferenceDecoder or as the defaultModelReference of this decoder. By default, the model reference decoder and the default model reference are unset (i.e. null).

Supported file transfer protocols

This model decoder only decodes files that can be accessed from the running copy of Bentley MicroStation.

Model structure

This model decoder creates a model per DGN file.
All models returned by this model decoder implement ILcd2DBoundsIndexedModel.

Model descriptor

All models returned by this model decoder have a TLcdDGNModelDescriptor. Among other information, the descriptor contains the DGN symbology.
The type name of the model descriptor is the display name of this decoder.

Model elements

Decoded models contain elements that all implement ILcdDGNShape.

The following DGN elements are currently supported:

DGN element type	DGN element name	Decoded object
1	LIBRARY_CELL
2	CELL	`TLcdDGNCell`
3	LINE	`TLcdDGNLine2D`
4	LINE_STRING	`TLcdDGNLineString2D`
5	GROUP_DATA
6	SHAPE	`TLcdDGNShape2D`
7	TEXT_NODE	`TLcdDGNText2D`
9	DESIGN_SETTINGS
10	LEVEL_SYMBOLOGY
11	CURVE	`TLcdDGNCurve2D`
12	COMPLEX_CHAIN	`TLcdDGNComplexChain`
14	COMPLEX_SHAPE	`TLcdDGNComplexShape`
15	ELLIPSE	`TLcdDGNEllipse2D`
16	ARC	`TLcdDGNArc2D`
17	TEXT	`TLcdDGNText2D`
18	3D_SURFACE	`TLcdDGN3DSurface`
19	SOLID	`TLcdDGNSolid`
34	SHARED_CELL_DEFINITION
35	SHARED_CELL_INSTANCE	`TLcdDGNCell`
36	CELL_MULTI_LINE	`TLcdDGNCell`
37	TAG_DATA

The following DGN elements that are not supported (basically splines, 3D surfaces, and rasters):

DGN element type	DGN element name
8	DIGITIZER_SETUP
13	CONIC
20	SUBFIGURE
21	B_SPLINE_CURVE
22	POINT_STRING
23	CONE
24	B_SPLINE_SURFACE
25	B_SPLINE_BOUNDARY
26	B_SPLINE_KNOT
27	B_SPLINE_WEIGHT
28	B_SPLINE
33	DIMENSION
66	APPLICATION
87	RASTER_HEADER
88	RASTER_DATA

Useful settings

By default, all element levels are decoded. You can restrict the decoding to the levels you are interested in, using the following methods:
If you have restricted the levels to be decoded, you can still specify additional levels based on their names, using the following methods:
By default, all element classes are decoded. You can restrict the decoding to the classes you are interested in, using the following methods:
By default, no MSLINK attributes are decoded. You can control the decoding of MSLINK attributes based on the database types you are interested in, using the following methods:
In addition, you will need to specify the entity numbers you are interested in, as described in the following paragraph.
By default, no database attributes (either MSLINK or DMRS) are decoded. You can control the decoding of database attributes based on the database entity numbers you are interested in, using the following methods:
By default, no tag attributes are decoded. You can control the decoding of tag attributes based on the tag set names, using the following methods:
All decoded element attributes can have a String containing a URL assigned to them, for the convenience of the application that uses the decoder:
- setDatabaseURL(String)

Sample code


 ILcdModelDecoder decoder =
   new TLcdDGNMicroStationModelDecoder(new TLcdEPSGModelReferenceDecoder(),
                                       new TLcdGeodeticReference(new TLcdGeodeticDatum()));

 ILcdModel model = decoder.decode("vectordata.dgn");

Performance tips

By default, attributes are not decoded, potentially saving some memory and some processing time.
By default, decoded coordinates are stored as doubles. You can reduce the memory usage of the decoded models by storing coordinates in arrays of floats, using the following methods:
- setUseFloat(boolean)
- isUseFloat()

Thread safety

The decoding of models is not thread-safe.
The decoded models are thread-safe for read access.

Supported versions and specifications

DGN v7 and v8
DWG

Known limitations

This decoder can only be executed inside Bentley MicroStation, using the jmdl virtual machine.
The current implementation does not support splines, 3D surfaces, and rasters.

Requirements

The current implementation requires JMDL 1.3.

See Also:: TLcdDGNModelDecoder

Constructor Summary

Constructors
Constructor and Description
`TLcdDGNMicroStationModelDecoder()` Deprecated. Creates a new `TLcdDGNMicroStationModelDecoder`.
`TLcdDGNMicroStationModelDecoder(ILcdModelReference aDefaultModelReference)` Deprecated. Creates a new `TLcdDGNMicroStationModelDecoder`.
`TLcdDGNMicroStationModelDecoder(ILcdModelReferenceDecoder aModelReferenceDecoder)` Deprecated. Creates a new `TLcdDGNMicroStationModelDecoder`.
`TLcdDGNMicroStationModelDecoder(ILcdModelReferenceDecoder aModelReferenceDecoder, ILcdModelReference aDefaultModelReference)` Deprecated. Creates a new `TLcdDGNMicroStationModelDecoder`.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addAttributeEntity(int aEntity)` Deprecated. Adds an attribute entity number to the set of numbers that is decoded.
`void`	`addElementClass(int aElementClass)` Deprecated. Adds an element class to the list of element classes that is included into decoded models.
`void`	`addLevel(int aLevel)` Deprecated. Adds a level to the list of DGN levels that is included into all decoded models.
`void`	`addLevelName(String aLevelName)` Deprecated. Adds a name of a DGN level to the list of names of DGN levels that are to be included into all decoded models, in addition to the numeric level selection.
`void`	`addTagSet(String aTagSetName)` Deprecated. Adds a tag set name to the set of names that is decoded.
`void`	`addUserAttributeType(int aType)` Deprecated. Adds a DGN MSLINK attribute type to the set of types that is decoded.
`void`	`addUserAttributeType(String aType)` Deprecated. Adds a DGN MSLINK attribute type to the set of types that is decoded.
`boolean`	`canDecodeSource(String aSourceName)` Deprecated. Checks whether this model decoder can decode the specified data source.
`void`	`clearAttributeEntitySelection()` Deprecated. Clears the set of DGN database attributes that is decoded.
`void`	`clearLevelNameSelection()` Deprecated. Clears the list of names of DGN levels that are to be included into all decoded models.
`void`	`clearLevelSelection()` Deprecated. Clears the list of DGN levels that is included into decoded models.
`void`	`clearTagSetSelection()` Deprecated. Clears the set of DGN tag sets that is decoded.
`void`	`clearUserAttributeTypeSelection()` Deprecated. Clears the set of DGN MSLINK attributes that is decoded.
`ILcdModel`	`decode(String aSourceName)` Deprecated. Creates a new model from the given data source.
`String`	`getDatabaseURL()` Deprecated.
`ILcdModelReference`	`getDefaultModelReference()` Deprecated.
`String`	`getDisplayName()` Deprecated. Returns a short, displayable name for the format that is decoded by this `ILcdModelDecoder`.
`int`	`getElementClassSelection()` Deprecated. Gets the the bitmask specifying list of element classes that is included into decoded models.
`ILcdModelReferenceDecoder`	`getModelReferenceDecoder()` Deprecated.
`boolean`	`isUseFloat()` Deprecated.
`void`	`resetAttributeEntitySelection()` Deprecated. Resets the set of DGN database attributes that is decoded.
`void`	`resetElementClassSelection()` Deprecated. Resets the list of DGN element classes that is included into decoded models; As a result, all DGN element classes will be included in the models when decoding DGN files.
`void`	`resetLevelSelection()` Deprecated. Resets the list of DGN levels that is included into decoded models.
`void`	`resetTagSetSelection()` Deprecated. Resets the set of DGN tag sets that is decoded.
`void`	`resetUserAttributeTypeSelection()` Deprecated. Resets the set of DGN MSLINK attributes that is decoded.
`void`	`setAttributeEntitySelection(int[] aEntities)` Deprecated. Sets the set of DGN database attributes that is decoded.
`void`	`setDatabaseURL(String aDatabaseURL)` Deprecated. Sets the default database URL that is assigned to all decoded attributes.
`void`	`setDefaultModelReference(ILcdModelReference aDefaultModelReference)` Deprecated. Sets the default model reference for decoded models, in case the model reference decoder doesn't provide one.
`void`	`setElementClassSelection(int aElementClasses)` Deprecated. Sets the list of element classes that is included into decoded models.
`void`	`setElementClassSelection(int[] aElementClasses)` Deprecated. Sets the list of element classes that is included into decoded models.
`void`	`setLevelNameSelection(String[] aLevelNames)` Deprecated. Sets the list of names of DGN levels that are to be included into all decoded models, in addition to the numeric level selection.
`void`	`setLevelSelection(int[] aLevels)` Deprecated. Sets the list of DGN levels that is included into all decoded models.
`void`	`setModelReferenceDecoder(ILcdModelReferenceDecoder aModelReferenceDecoder)` Deprecated. Sets the model reference decoder that will be used for creating model references for decoded models.
`void`	`setTagSetSelection(String[] aTagSetNames)` Deprecated. Sets the set of DGN tag attributes that is decoded.
`void`	`setUseFloat(boolean aUseFloat)` Deprecated. Specifies whether to use memory-conserving floating point data structures for the decoded models.
`void`	`setUserAttributeTypeSelection(int[] aTypes)` Deprecated. Sets the set of DGN MSLINK attributes that is decoded.
`void`	`setUserAttributeTypeSelection(String[] aTypes)` Deprecated. Sets the set of DGN MSLINK attributes that is decoded.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.luciad.model.ILcdModelDecoder
canDecodeSource, decodeModelMetadata, decodeModelMetadata, decodeSource, discoverDataSources

- Constructor Detail
  - TLcdDGNMicroStationModelDecoder
```
public TLcdDGNMicroStationModelDecoder()
```
    Deprecated.
    
    Creates a new TLcdDGNMicroStationModelDecoder.
  - TLcdDGNMicroStationModelDecoder
```
public TLcdDGNMicroStationModelDecoder(ILcdModelReferenceDecoder aModelReferenceDecoder)
```
    Deprecated.
    
    Creates a new TLcdDGNMicroStationModelDecoder.
    
    Parameters:
    
    aModelReferenceDecoder - the model reference decoder that can assign references to decoded models.
  - TLcdDGNMicroStationModelDecoder
```
public TLcdDGNMicroStationModelDecoder(ILcdModelReference aDefaultModelReference)
```
    Deprecated.
    
    Creates a new TLcdDGNMicroStationModelDecoder.
    
    Parameters:
    
    aDefaultModelReference - the model reference that decoded models will get if the model reference decoder can't decode one.
  - TLcdDGNMicroStationModelDecoder
```
public TLcdDGNMicroStationModelDecoder(ILcdModelReferenceDecoder aModelReferenceDecoder,
                                       ILcdModelReference aDefaultModelReference)
```
    Deprecated.
    
    Creates a new TLcdDGNMicroStationModelDecoder.
    
    Parameters:
    
    aModelReferenceDecoder - the model reference decoder that can assign references to decoded models.
    
    aDefaultModelReference - the model reference that decoded models will get if the model reference decoder can't decode one.
- Method Detail
  - setModelReferenceDecoder
```
public void setModelReferenceDecoder(ILcdModelReferenceDecoder aModelReferenceDecoder)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the model reference decoder that will be used for creating model references for decoded models.
    
    Specified by:
    
    setModelReferenceDecoder in interface ILcdDGNModelDecoder
  - getModelReferenceDecoder
```
public ILcdModelReferenceDecoder getModelReferenceDecoder()
```
    Deprecated.
    
    Specified by:
    
    getModelReferenceDecoder in interface ILcdDGNModelDecoder
  - setDefaultModelReference
```
public void setDefaultModelReference(ILcdModelReference aDefaultModelReference)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the default model reference for decoded models, in case the model reference decoder doesn't provide one.
    
    Specified by:
    
    setDefaultModelReference in interface ILcdDGNModelDecoder
  - getDefaultModelReference
```
public ILcdModelReference getDefaultModelReference()
```
    Deprecated.
    
    Specified by:
    
    getDefaultModelReference in interface ILcdDGNModelDecoder
  - setDatabaseURL
```
public void setDatabaseURL(String aDatabaseURL)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the default database URL that is assigned to all decoded attributes. The URL can then be used by the application.
    
    Specified by:
    
    setDatabaseURL in interface ILcdDGNModelDecoder
  - getDatabaseURL
```
public String getDatabaseURL()
```
    Deprecated.
    
    Specified by:
    
    getDatabaseURL in interface ILcdDGNModelDecoder
  - setUseFloat
```
public void setUseFloat(boolean aUseFloat)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Specifies whether to use memory-conserving floating point data structures for the decoded models.
    
    Specified by:
    
    setUseFloat in interface ILcdDGNModelDecoder
  - isUseFloat
```
public boolean isUseFloat()
```
    Deprecated.
    
    Specified by:
    
    isUseFloat in interface ILcdDGNModelDecoder
  - resetLevelSelection
```
public void resetLevelSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Resets the list of DGN levels that is included into decoded models. As a result, all DGN levels will be included in the models when decoding DGN files.
    
    Specified by:
    
    resetLevelSelection in interface ILcdDGNModelDecoder
  - clearLevelSelection
```
public void clearLevelSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Clears the list of DGN levels that is included into decoded models. As a result, only level 0 will be included in the models when decoding DGN files.
    
    Specified by:
    
    clearLevelSelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.resetLevelSelection(), ILcdDGNModelDecoder.addLevel(int)
  - setLevelSelection
```
public void setLevelSelection(int[] aLevels)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the list of DGN levels that is included into all decoded models. Level 0 is always included, irrespective of the selection setting.
    
    Specified by:
    
    setLevelSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aLevels - the levels to be included in the decoded models. They can be listed in any order, and duplicate numbers are allowed.
  - addLevel
```
public void addLevel(int aLevel)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds a level to the list of DGN levels that is included into all decoded models.
    
    Specified by:
    
    addLevel in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aLevel - the level to be included in the decoded models.
  - clearLevelNameSelection
```
public void clearLevelNameSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Clears the list of names of DGN levels that are to be included into all decoded models. As a result, only levels specified in the numeric level selection will be included.
    
    Specified by:
    
    clearLevelNameSelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.clearLevelSelection(), ILcdDGNModelDecoder.addLevelName(String)
  - setLevelNameSelection
```
public void setLevelNameSelection(String[] aLevelNames)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the list of names of DGN levels that are to be included into all decoded models, in addition to the numeric level selection.
    
    Specified by:
    
    setLevelNameSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aLevelNames - the names of levels to be included in the decoded models. They can be listed in any order, and duplicate names are allowed.
  - addLevelName
```
public void addLevelName(String aLevelName)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds a name of a DGN level to the list of names of DGN levels that are to be included into all decoded models, in addition to the numeric level selection.
    
    Specified by:
    
    addLevelName in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aLevelName - the name of the level to be included in the decoded models.
  - resetElementClassSelection
```
public void resetElementClassSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Resets the list of DGN element classes that is included into decoded models; As a result, all DGN element classes will be included in the models when decoding DGN files.
    
    Specified by:
    
    resetElementClassSelection in interface ILcdDGNModelDecoder
  - setElementClassSelection
```
public void setElementClassSelection(int aElementClasses)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the list of element classes that is included into decoded models. This property allows to exclude certain classes from the decoded models, e.g. construction elements.
    Specified by:
    
    setElementClassSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    aElementClasses - a bitmask, specifying the element classes to be included in the decoded models. It is a logical OR of 1-bits that are shifted left by the following constants:
    
    TLcdDGNDisplayInfo.CLASS_PRIMARY
    TLcdDGNDisplayInfo.CLASS_PATTERN
    TLcdDGNDisplayInfo.CLASS_CONSTRUCTION
    TLcdDGNDisplayInfo.CLASS_DIMENSION
    TLcdDGNDisplayInfo.CLASS_PRIMARY_RULE
    TLcdDGNDisplayInfo.CLASS_LINEAR_PATTERN
    TLcdDGNDisplayInfo.CLASS_CONSTRUCTION_RULE
  - getElementClassSelection
```
public int getElementClassSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Gets the the bitmask specifying list of element classes that is included into decoded models.
    
    Specified by:
    
    getElementClassSelection in interface ILcdDGNModelDecoder
  - setElementClassSelection
```
public void setElementClassSelection(int[] aElementClasses)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the list of element classes that is included into decoded models. This property allows to exclude certain classes from the decoded models, e.g. construction elements.
    Specified by:
    
    setElementClassSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    aElementClasses - the element classes to be included in the decoded models. They can be listed in any order, and duplicate entries are allowed.
    The available DGN element classes are
    
    TLcdDGNDisplayInfo.CLASS_PRIMARY
    TLcdDGNDisplayInfo.CLASS_PATTERN
    TLcdDGNDisplayInfo.CLASS_CONSTRUCTION
    TLcdDGNDisplayInfo.CLASS_DIMENSION
    TLcdDGNDisplayInfo.CLASS_PRIMARY_RULE
    TLcdDGNDisplayInfo.CLASS_LINEAR_PATTERN
    TLcdDGNDisplayInfo.CLASS_CONSTRUCTION_RULE
    See Also:
    
    ILcdDGNModelDecoder.setElementClassSelection(int)
  - addElementClass
```
public void addElementClass(int aElementClass)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds an element class to the list of element classes that is included into decoded models. This property allows to exclude certain classes from the decoded models, e.g. construction elements.
    Specified by:
    
    addElementClass in interface ILcdDGNModelDecoder
    
    Parameters:
    aElementClass - the element class to be included in the decoded models.
    The available DGN element classes are
    
    TLcdDGNDisplayInfo.CLASS_PRIMARY
    TLcdDGNDisplayInfo.CLASS_PATTERN
    TLcdDGNDisplayInfo.CLASS_CONSTRUCTION
    TLcdDGNDisplayInfo.CLASS_DIMENSION
    TLcdDGNDisplayInfo.CLASS_PRIMARY_RULE
    TLcdDGNDisplayInfo.CLASS_LINEAR_PATTERN
    TLcdDGNDisplayInfo.CLASS_CONSTRUCTION_RULE
  - resetUserAttributeTypeSelection
```
public void resetUserAttributeTypeSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Resets the set of DGN MSLINK attributes that is decoded. All MSLINK attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    resetUserAttributeTypeSelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.clearUserAttributeTypeSelection()
  - clearUserAttributeTypeSelection
```
public void clearUserAttributeTypeSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Clears the set of DGN MSLINK attributes that is decoded. None of the MSLINK attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    clearUserAttributeTypeSelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.resetUserAttributeTypeSelection(), ILcdDGNModelDecoder.addUserAttributeType(java.lang.String), ILcdDGNModelDecoder.addUserAttributeType(int)
  - setUserAttributeTypeSelection
```
public void setUserAttributeTypeSelection(String[] aTypes)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the set of DGN MSLINK attributes that is decoded. Only MSLINK attributes with the specified types will now be included in the models when decoding DGN files.
    Note that the attribute entities to be decoded have to be specified as well, using the addAttributeEntity method.
    
    Specified by:
    
    setUserAttributeTypeSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aTypes - a list of MSLINK attribute types, specified as numbers in RAD50 format (strings of length 3, e.g. "ODB"). Note that RAD50 is actually radix 40, with the following 40 digits: <space> A...Z $ . 0...9
  - setUserAttributeTypeSelection
```
public void setUserAttributeTypeSelection(int[] aTypes)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the set of DGN MSLINK attributes that is decoded. Only MSLINK attributes with the specified types will now be included in the models when decoding DGN files.
    
    Specified by:
    
    setUserAttributeTypeSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aTypes - a list of MSLINK attribute types, specified as integers (unsigned shorts, e.g. 0x5e62, which corresponds to 'ODB' in radix 50).
    
    See Also:
    
    ILcdDGNUserAttribute
  - addUserAttributeType
```
public void addUserAttributeType(String aType)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds a DGN MSLINK attribute type to the set of types that is decoded.
    
    Specified by:
    
    addUserAttributeType in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aType - an MSLINK attribute type specified as a number in RAD50 format (a string of length 3, e.g. "ODB"). Note that RAD50 is actually radix 40, with the following 40 digits: <space> A...Z $ . 0...9
    
    See Also:
    
    ILcdDGNModelDecoder.addUserAttributeType(int)
  - addUserAttributeType
```
public void addUserAttributeType(int aType)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds a DGN MSLINK attribute type to the set of types that is decoded. Only MSLINK attributes that have types in this set are decoded.
    Note that the attribute entities to be decoded have to be specified as well, using the addAttributeEntity method.
    
    Specified by:
    
    addUserAttributeType in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aType - an MSLINK attribute type specified as an integer (an unsigned short, e.g. 0x5e62, which corresponds to 'ODB' in radix 50).
    
    See Also:
    
    ILcdDGNModelDecoder.addUserAttributeType(java.lang.String), ILcdDGNUserAttribute
  - resetAttributeEntitySelection
```
public void resetAttributeEntitySelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Resets the set of DGN database attributes that is decoded. All DGN database attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    resetAttributeEntitySelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.clearAttributeEntitySelection()
  - clearAttributeEntitySelection
```
public void clearAttributeEntitySelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Clears the set of DGN database attributes that is decoded. None of the DGN database attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    clearAttributeEntitySelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.resetAttributeEntitySelection(), ILcdDGNModelDecoder.addAttributeEntity(int)
  - setAttributeEntitySelection
```
public void setAttributeEntitySelection(int[] aEntities)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the set of DGN database attributes that is decoded. Only DGN database attributes with the specified entity numbers will now be included in the models when decoding DGN files.
    
    Specified by:
    
    setAttributeEntitySelection in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aEntities - a list of entity numbers of database attributes (user or non-user).
  - addAttributeEntity
```
public void addAttributeEntity(int aEntity)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds an attribute entity number to the set of numbers that is decoded. Only attributes that have entity numbers in this set are decoded.
    Note that, for decoding user attributes, the user attribute types to be decoded have to be specified as well, using the addUserAttributeType method.
    Also note that the fill color, which is also stored as an element attribute, is an exception: it is always decoded as part of the display info.
    
    Specified by:
    
    addAttributeEntity in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aEntity - an entity number of an database attribute (user or non-user).
  - resetTagSetSelection
```
public void resetTagSetSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Resets the set of DGN tag sets that is decoded. All tag sets and their attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    resetTagSetSelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.clearTagSetSelection()
  - clearTagSetSelection
```
public void clearTagSetSelection()
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Clears the set of DGN tag sets that is decoded. None of the tag sets will now be included in the models when decoding DGN files.
    
    Specified by:
    
    clearTagSetSelection in interface ILcdDGNModelDecoder
    
    See Also:
    
    ILcdDGNModelDecoder.resetTagSetSelection(), ILcdDGNModelDecoder.addTagSet(java.lang.String)
  - setTagSetSelection
```
public void setTagSetSelection(String[] aTagSetNames)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Sets the set of DGN tag attributes that is decoded. Only the specified tag sets and their attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    setTagSetSelection in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aTagSetNames - a list of tag set names.
  - addTagSet
```
public void addTagSet(String aTagSetName)
```
    Deprecated.
    
    Description copied from interface: ILcdDGNModelDecoder
    
    Adds a tag set name to the set of names that is decoded. Only the specified tag sets and their attributes will now be included in the models when decoding DGN files.
    
    Specified by:
    
    addTagSet in interface ILcdDGNModelDecoder
    
    Parameters:
    
    aTagSetName - a tag set name.
  - getDisplayName
```
public String getDisplayName()
```
    Deprecated.
    
    Description copied from interface: ILcdModelDecoder
    
    Returns a short, displayable name for the format that is decoded by this ILcdModelDecoder.
    
    Specified by:
    
    getDisplayName in interface ILcdModelDecoder
    
    Returns:
    
    the displayable name of this ILcdModelDecoder.
  - canDecodeSource
```
public boolean canDecodeSource(String aSourceName)
```
    Deprecated.
    
    Description copied from interface: ILcdModelDecoder
    
    Checks whether this model decoder can decode the specified data source. It is acceptable for this method to return true for a source name while decode throws an exception for that same source name.
    For performance reasons, we strongly recommend that this will only be a simple test. For example: check the file extension of a file, but not that the file exists or contains expected content.
    
    Specified by:
    
    canDecodeSource in interface ILcdModelDecoder
    
    Parameters:
    
    aSourceName - the data source to be verified; typically a file name or a URL.
    
    Returns:
    
    true if this decoder can likely decode the data specified by the source name, false otherwise.
    
    See Also:
    
    ILcdModelDecoder.decode(String), ILcdModelDecoder.decodeModelMetadata(String)
  - decode
```
public ILcdModel decode(String aSourceName)
                 throws IOException
```
    Deprecated.
    
    Description copied from interface: ILcdModelDecoder
    
    Creates a new model from the given data source.
    Specified by:
    
    decode in interface ILcdModelDecoder
    
    Parameters:
    
    aSourceName - the data source to be decoded; typically a file name or a URL.
    
    Returns:
    
    A model containing the decoded data. While null is allowed, implementors are advised to throw an error instead.
    
    Throws:
    IOException - for any exceptions caused by IO problems or invalid data. Since decoding invalid data almost always results in RunTimeExceptions (NullPointerException, IndexOutOfBoundsException, IllegalArgumentException, ...) on unexpected places, implementations are advised to catch RuntimeExceptions in their decode() method, and wrap them into an IOException, as illustrated in the code snippet below.
    public ILcdModel decode( String aSourceName ) throws IOException { try (InputStream input = fInputStreamFactory.createInputStream(aSourceName)) { // Perform decoding ... } catch (RuntimeException e) { throw new IOException(e); } }
    InterruptedIOException - When the thread on which this method is called is interrupted: it is recommended to stop the decoding and throw an InterruptedIOException. This same exception can also be used if the decoder shows UI to the user, and the user cancels the decoding through the UI.
    
    See Also:
    
    ILcdModelDecoder.canDecodeSource(String)

Infrastructure StandardsClass TLcdDGNMicroStationModelDecoder

Input files

Supported file transfer protocols

Model structure

Model descriptor

Model elements

Useful settings

Sample code

Performance tips

Thread safety

Supported versions and specifications

Known limitations

Requirements

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.luciad.model.ILcdModelDecoder

Constructor Detail

TLcdDGNMicroStationModelDecoder

TLcdDGNMicroStationModelDecoder

TLcdDGNMicroStationModelDecoder

TLcdDGNMicroStationModelDecoder

Method Detail

setModelReferenceDecoder

getModelReferenceDecoder

setDefaultModelReference

getDefaultModelReference

setDatabaseURL

getDatabaseURL

setUseFloat

isUseFloat

resetLevelSelection

clearLevelSelection

setLevelSelection

addLevel

clearLevelNameSelection

setLevelNameSelection

addLevelName

resetElementClassSelection

setElementClassSelection

getElementClassSelection

setElementClassSelection

addElementClass

resetUserAttributeTypeSelection

clearUserAttributeTypeSelection

setUserAttributeTypeSelection

setUserAttributeTypeSelection

addUserAttributeType

addUserAttributeType

resetAttributeEntitySelection

clearAttributeEntitySelection

setAttributeEntitySelection

addAttributeEntity

resetTagSetSelection

clearTagSetSelection

setTagSetSelection

addTagSet

getDisplayName

canDecodeSource

decode