public interface ILcdModelReferenceDecoder
ILcdModelReference
that is associated with a data source.
Some formats do not include information about the coordinate system that is used in their data files. For these
formats, an additional model reference file may be placed next to the data file, providing information about the
coordinate system. ILcdModelDecoder
implementations for these formats often allow to configure an
ILcdModelReferenceDecoder
on them, providing the model decoder with the correct coordinate
system information.Modifier and Type | Interface and Description |
---|---|
static class |
ILcdModelReferenceDecoder.ModelReferenceWithSource
A model reference paired with the source file from which it was decoded.
|
Modifier and Type | Method and Description |
---|---|
ILcdModelReference |
decodeModelReference(String aDataSourceName)
Returns the model reference, associated with the specified data source.
|
default ILcdModelReferenceDecoder.ModelReferenceWithSource |
findAndDecodeModelReference(String aDataSourceName)
Finds and decodes the model reference file, associated with the specified data source.
|
ILcdModelReference decodeModelReference(String aDataSourceName) throws IOException
aDataSourceName
- a data source for which to return the model reference; typically a file name or a URL.ILcdModelReference
associated with the data source. While null
is allowed,
implementors are advised to throw an error instead.IOException
- if the ILcdModelReference
cannot be decoded.
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.default ILcdModelReferenceDecoder.ModelReferenceWithSource findAndDecodeModelReference(String aDataSourceName) throws IOException
decodeModelReference(java.lang.String)
and returns the resulting model reference, paired with a null
source, indicating that the source is unknown or does not exist.aDataSourceName
- a data source for which to return the model reference; typically a file name or a URL.ILcdModelReference
and the location of the reference file. Never null
.IOException
- if no model reference file is found, or the ILcdModelReference
cannot be
decoded.
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.