public class TLcdDAFIFHelipadDecoder extends ALcdDAFIFSingleModelDecoder
ALcdDAFIFSingleModelDecoder
decodes
helipads from a DAFIF source file. Decoded models have as model descriptor
an instance of TLcdDAFIFHelipadModelDescriptor
.
DAFIF distinguishes three kinds of helipads:
Rectangular helipads are created as a polygon defined by the four corners of the helipad. The two known locations high end and low end are located on the center line of the helipad. The corners of the helipad lie on both sides of the high respectively low end at a distance of half the width.
If there is no location information available in a helipad record, then it will be interpreted as a round helipad which is located at the linked heliport.
Since helipads shorter than 500 feet have only one location, there is no way of knowing what the angle of the rectangle should be when it's drawn. Therefore these helipads will be represented by a polygon containing only one point instead of four. Special Painters must then be used to draw these single point helipads on the map.
The objects in decoded models are based on the AIS domain objects available in com.luciad.ais.model
,
which all implement ILcdDataObject
. This interface provides a generic and
format-independent way of accessing the type and properties (features) of a domain object.
For this decoder, the type of the decoded objects is TLcdDAFIFDataTypes.Helipad
,
which can also be retrieved through ILcdDataObject.getDataType()
.
The available properties of the objects are defined in TLcdDAFIFHelipadDataProperties
.
The values for these properties can be retrieved through ILcdDataObject.getValue(com.luciad.datamodel.TLcdDataProperty)
.
Next to ILcdDataObject
, the objects in decoded models also implement ILcdFeatured
,
the former interface to access the properties (features) of a domain object.
This is still fully supported, and explained in the following comments.
The setHelipadFeaturesToBeDecoded
method allows
the user to specify which DAFIF features are decoded into the featured model objects.
If no features to be decoded are specified, all features will be decoded.
The following fields (taken from the National Imagery and Mapping Agency (NIMA) Product Specifications for Digital Aeronautical Flight Information File (DAFIF), Seventh Edition, May 2001) are supported by the decoder. The list indicates into which feature the fields are decoded.
DAFIF decoders rely on a specific set of key features that uniquely define an object. This set of features must always be included in the set of features to be decoded. For aerodromes the key features are:
Helipads belong to a heliport. The TLcdDAFIFHelipadDecoder
does not decode
the heliports necessary to produce a helipad model. A heliport model should be specified by
using the setHeliportModel
method.
This heliport model should have an index on the IDENTIFICATION
feature. The createRequiredIndex
method can be used to put
this index on the heliport model, if the IDENTIFICATION
feature was decoded into the featured model objects of the heliport model.
DAFIF_PROP_EXTENSION, fRecordCount
Constructor and Description |
---|
TLcdDAFIFHelipadDecoder(ALcdAISObjectFactory aFactory)
Deprecated.
|
TLcdDAFIFHelipadDecoder(ALcdAISObjectFactory aFactory,
Properties aDAFIFProperties)
Deprecated.
|
TLcdDAFIFHelipadDecoder(TLcdAISDataObjectFactory aFactory)
Constructs a new
TLcdDAFIFHelipadDecoder object. |
TLcdDAFIFHelipadDecoder(TLcdAISDataObjectFactory aFactory,
Properties aDAFIFProperties)
Constructs a new
TLcdDAFIFHelipadDecoder object. |
Modifier and Type | Method and Description |
---|---|
protected ILcdModelDescriptor |
createModelDescriptor(String aSource)
Creates and returns the model descriptor to be set on the model returned in the
decode method. |
void |
createRequiredIndex(ILcdFeatureIndexedAnd2DBoundsIndexedModel aModel)
Adds a unique index on specified model of heliports.
|
ILcdModel |
decode(String aSource)
Calls the decode method of
ALcdDAFIFSingleModelDecoder . |
String |
getDecodeFileName()
Returns the name of the file to be decoded.
|
String |
getDisplayName()
Returns a short, displayable name for the format that is decoded by this
ILcdModelDecoder . |
protected void |
handleRecord(int aFormat,
char[] aRecord)
Deals with one record of input.
|
void |
setHelipadDefaultDisplayNameIndex(int aIndex)
Specifies the index of the feature to be used as
display name.
|
void |
setHelipadFeaturesToBeDecoded(String[] aHelipadFeaturesToBeDecoded)
Specifies a list of features to be decoded into the helipad
model objects.
|
void |
setHeliportModel(ILcdFeatureIndexedAnd2DBoundsIndexedModel aHeliportModel)
Specifies a model of heliports.
|
cleanUp, setKeyFeatureNames
addErrorReport, canDecodeSource, getAltitudeType, getBearingTypeForChar, getBounds, getDAFIFProperties, getDataObjectFactory, getDecodingBounds, getDomainFactory, getErrorMessage, getInputStream, getInputStreamFactory, getLocalHorizontalDatum, getModelFilter, getRecordCount, initializeErrorMessage, isStoreOriginalReference, isTraceOn, loadCFGProperties, read, readExactValue, readFormat, readMinLength, readRecord, setBounds, setDAFIFModelFilter, setDAFIFProperties, setDataObjectFactory, setDecodingBounds, setDomainFactory, setInputStreamFactory, setStoreOriginalReference, setTraceOn, transformPointToReferenceDatumSFCT
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
canDecodeSource, decodeModelMetadata, decodeModelMetadata, decodeSource, discoverDataSources
@Deprecated public TLcdDAFIFHelipadDecoder(ALcdAISObjectFactory aFactory)
TLcdDAFIFHelipadDecoder
object. The user
should specify which domainFactory he or she wants to use to create the helipads.aFactory
- the factory to be used to create the helipadspublic TLcdDAFIFHelipadDecoder(TLcdAISDataObjectFactory aFactory)
TLcdDAFIFHelipadDecoder
object. The user
should specify which factory he or she wants to use to create the helipads.aFactory
- the factory to be used to create the helipads@Deprecated public TLcdDAFIFHelipadDecoder(ALcdAISObjectFactory aFactory, Properties aDAFIFProperties)
TLcdDAFIFHelipadDecoder
object.aFactory
- the factory to be used to create the helipadsaDAFIFProperties
- a Properties
object that contains for each domain object
the appropriate file namepublic TLcdDAFIFHelipadDecoder(TLcdAISDataObjectFactory aFactory, Properties aDAFIFProperties)
TLcdDAFIFHelipadDecoder
object.aFactory
- the factory to be used to create the helipadsaDAFIFProperties
- a Properties
object that contains for each domain object
the appropriate file namepublic String getDisplayName()
ILcdModelDecoder
ILcdModelDecoder
.getDisplayName
in interface ILcdModelDecoder
getDisplayName
in class ALcdDAFIFDecoder
ILcdModelDecoder
.public String getDecodeFileName()
ILcdDAFIFDecoder
Each domain object has its own file name. This method returns the name of the data file for the domain objects decoded by this DAFIF decoder.
protected ILcdModelDescriptor createModelDescriptor(String aSource)
ALcdDAFIFSingleModelDecoder
decode
method.createModelDescriptor
in class ALcdDAFIFSingleModelDecoder
aSource
- the source that will be used to decodepublic ILcdModel decode(String aSource) throws IOException
ALcdDAFIFSingleModelDecoder
.
Checks whether a heliport model is set before starting the decode process.
If no heliport model is specified, an IllegalStateException
object
will be thrown.
decode
in interface ILcdModelDecoder
decode
in class ALcdDAFIFSingleModelDecoder
aSource
- either the directory containing the DAFIF source file to decode (if you did not
specify a properties file in the constructor, the default file name will be used) or a .toc file
containing the DAFIF properties (the data file should be in the same directory as the .toc file)IOException
- if an error occurs during the reading processIllegalStateException
- if no waypoint model has been specifiedILcdModelDecoder.canDecodeSource(String)
protected final void handleRecord(int aFormat, char[] aRecord)
ALcdDAFIFSingleModelDecoder
handleRecord
in class ALcdDAFIFSingleModelDecoder
aFormat
- the format of the recordaRecord
- the recordpublic void createRequiredIndex(ILcdFeatureIndexedAnd2DBoundsIndexedModel aModel)
This method should be called before calling setHeliportModel
method.
Please make sure that the ILcdAerodromeFeature.IDENTIFICATION
feature
was decoded into the model objects of the specified heliport model.
If the features mentioned above weren't decoded into the heliports, this method
will cause exceptions to be thrown!
aModel
- a model containing the heliportssetHeliportModel(com.luciad.model.ILcdFeatureIndexedAnd2DBoundsIndexedModel)
public void setHeliportModel(ILcdFeatureIndexedAnd2DBoundsIndexedModel aHeliportModel)
Please make sure there's a unique index on this model!
aHeliportModel
- the heliport model to be used to create the helipadscreateRequiredIndex(com.luciad.model.ILcdFeatureIndexedAnd2DBoundsIndexedModel)
public void setHelipadDefaultDisplayNameIndex(int aIndex)
aIndex
- the index of the feature to be used as display namepublic void setHelipadFeaturesToBeDecoded(String[] aHelipadFeaturesToBeDecoded)
Please make sure that the HELIPORT_ID
and SEQUENCE_NUMBER
are in your list.
aHelipadFeaturesToBeDecoded
- a list of features that should be decoded into the helipad objects