public class TLcdVPFLibrary extends Object
TLcdVPFDatabase
) and contains a set of coverages
(TLcdVPFCoverage)
, all having the same geographic extent (for example Europa & Asia).
All geometry within a VPF library is expressed in the same geographic reference system, associated
with this library.
Optionally, a data quality descriptor can be associated with each coverage.Constructor and Description |
---|
TLcdVPFLibrary(String aPathName,
String aLibraryName,
ILcdBuffer aBuffer)
Creates a
TLcdVPFLibrary which path is aPath and
which name is aLibraryName . |
TLcdVPFLibrary(String aPathName,
String aLibraryName,
ILcdBuffer aBuffer,
boolean aFullDecode)
Creates a
TLcdVPFLibrary which path is aPath and
which name is aLibraryName (see description above). |
Modifier and Type | Method and Description |
---|---|
void |
decodeCAT()
Deprecated.
the
CAT table is decoded automatically on the first attempt to access it.
This method should no longer be called explicitly. |
void |
decodeGRT()
Deprecated.
the
GRT table is decoded automatically on the first attempt to access it.
this method should no longer be called explicitly. |
void |
decodeLHT()
Deprecated.
the
LHT table is decoded automatically on the first attempt to access it.
This method should no longer be called explicitly. |
void |
decodeTILEREF()
Deprecated.
the
TILEREF table is decoded automatically on the first attempt to access it.
This method should no longer be called explicitly. |
boolean |
equals(Object o)
Returns
true if this VPF library is equal to the given object. |
ILcdBounds |
getBounds()
Returns the minimum bounding rectangle (MBR) of this library.
|
TLcdVPFCoverage |
getCoverage(String aCoverageName)
Returns the
TLcdVPFCoverage of this library which name is aCoverageName . |
String[] |
getCoverageNames()
Returns the names of all coverages contained in this library.
|
TLcdVPFCoverage[] |
getCoverages()
Returns an array containing all coverages that are part of this library.
|
TLcdVPFDatabase |
getDatabase()
Returns the database to which this library belongs.
|
TLcdVPFDataQualityDescriptor |
getDataQualityDescriptor()
Returns a description of the data quality of this library,
or
null if no data quality information is available for this library. |
String |
getDescription()
Returns a brief textual description for this entity.
|
ILcdModelReference |
getModelReference()
Returns the
ILcdModelReference describing the geographic reference system in which all
geometry in this library is expressed. |
String |
getName()
Returns the short name of this entity, used as identifier in the VPF database.
|
String |
getPathName()
Returns the path to the directory of this library, for example
/data/vmaplv0/eusproto for
the eusproto library of the vmaplv0 database. |
String |
getProductType()
Returns the VPF product type identifier of this library (for example 'VMAP Level 0').
|
int |
getScale()
Returns the denominator of the source scale of the library.
|
TLcdVPFTile[] |
getTiles()
Returns an array of
TLcdVPFTile objects, representing the tiling scheme used in this
library, or null if this library is not tiled. |
int |
hashCode() |
boolean |
isTiled()
Returns
true if this library uses a tiling scheme for storing its geometry,
false otherwise. |
boolean |
isTraceOn()
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
static void |
setClassTraceOn(boolean aClassTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
void |
setTraceOn(boolean aTraceOn)
Deprecated.
This method has been deprecated. It is recommended to use the
standard Java logging framework directly.
|
String |
toString()
Returns a brief textual description for this library.
|
public TLcdVPFLibrary(String aPathName, String aLibraryName, ILcdBuffer aBuffer) throws TLcdCodecException, FileNotFoundException
TLcdVPFLibrary
which path is aPath
and
which name is aLibraryName
.aPathName
- The path to the directory of this library.aLibraryName
- The name of this library.aBuffer
- This argument is no longer used.TLcdCodecException
- If an IO exception occurs during initialization.FileNotFoundException
- If a required table could not be found.public TLcdVPFLibrary(String aPathName, String aLibraryName, ILcdBuffer aBuffer, boolean aFullDecode) throws TLcdCodecException, FileNotFoundException
TLcdVPFLibrary
which path is aPath
and
which name is aLibraryName
(see description above).aPathName
- The path to the directory of this library.aLibraryName
- The name of this library.aBuffer
- This argument is no longer used.aFullDecode
- This argument is no longer used.TLcdCodecException
- If an IO exception occurs during initialization.FileNotFoundException
- If a required table could not be found.public String getPathName()
/data/vmaplv0/eusproto
for
the eusproto library of the vmaplv0 database.public String getDescription()
public TLcdVPFDatabase getDatabase()
public TLcdVPFCoverage[] getCoverages()
CAT
table is preserved.public String[] getCoverageNames()
CAT
table is preserved.public TLcdVPFCoverage getCoverage(String aCoverageName)
TLcdVPFCoverage
of this library which name is aCoverageName
.
If no coverage exists with the given name, null
is returned.aCoverageName
- the name of the coverage to be returned. This should correspond to the name that
is in the COVERAGE_NAME column of the CAT table.TLcdVPFCoverage
of this library which name is aCoverageName
.NullPointerException
- if aLibraryName == null
public String getProductType()
public int getScale()
public ILcdBounds getBounds()
LAT
table. It is always expressed in geodetic
coordinates.public ILcdModelReference getModelReference()
ILcdModelReference
describing the geographic reference system in which all
geometry in this library is expressed.ILcdModelReference
used within this library.public TLcdVPFDataQualityDescriptor getDataQualityDescriptor()
null
if no data quality information is available for this library.TLcdVPFDataQualityDescriptor
describing the data quality of this library.public TLcdVPFTile[] getTiles()
TLcdVPFTile
objects, representing the tiling scheme used in this
library, or null
if this library is not tiled.TLcdVPFTile
objects, representing the tiling scheme used in this
library.public boolean isTiled()
true
if this library uses a tiling scheme for storing its geometry,
false
otherwise.true
if this library uses a tiling scheme, false
otherwise.public void decodeLHT() throws TLcdCodecException, FileNotFoundException
LHT
table is decoded automatically on the first attempt to access it.
This method should no longer be called explicitly.LHT
table of this library.TLcdCodecException
- if an IO exception occurs during decoding of the LHT
table.FileNotFoundException
- if the LHT
table does not exist.public void decodeCAT() throws TLcdCodecException, FileNotFoundException
CAT
table is decoded automatically on the first attempt to access it.
This method should no longer be called explicitly.CAT
table of this library.TLcdCodecException
- if an IO exception occurs during decoding of the CAT
table.FileNotFoundException
- if the CAT
table does not exist.public void decodeTILEREF()
TILEREF
table is decoded automatically on the first attempt to access it.
This method should no longer be called explicitly.TILEREF
table of this library.TLcdCodecException
- if an IO exception occurs during decoding of the TILEREF
table.FileNotFoundException
- if the TILEREF
table does not exist.public void decodeGRT() throws TLcdCodecException, FileNotFoundException
GRT
table is decoded automatically on the first attempt to access it.
this method should no longer be called explicitly.GRT
table.TLcdCodecException
- if an IO exception occurs during decoding of the GRT
table.FileNotFoundException
- if the GRT
table does not exist.public String toString()
getName()
or getDescription()
might be used as a good source of a textual description for this library.public boolean equals(Object o)
true
if this VPF library is equal to the given object.
Two VPF libraries are considered equal if the databases to which they belong
are equal, and their names are equal.public static void setClassTraceOn(boolean aClassTraceOn)
true
then all log messages are recorded, otherwise only
the informative, warning and error messages are recorded.aClassTraceOn
- if true then all log messages are recorded,
otherwise only the informative, warning and error messages are recorded.public void setTraceOn(boolean aTraceOn)
true
or false
as argument automatically turns
off tracing for all other class instances for which
setTraceOn
has not been called.
If the argument is false
then only the informative, warning
and error log messages are recorded.aTraceOn
- if true then all log messages are recorded for this
instance. If false, then only the informative, warning and
error log messages are recorded.public boolean isTraceOn()
true
if tracing is enabled for this class.public String getName()