com.luciad.format.sqlite.lvdb

LuciadLightspeedClass TLcdLVDBModelEncoder

java.lang.Object

com.luciad.format.sqlite.lvdb.TLcdLVDBModelEncoder

All Implemented Interfaces:

ILcdModelEncoder, ILcdStatusSource, Serializable

@LcdService(service=ILcdModelEncoder.class,
            priority=20000)
public class TLcdLVDBModelEncoder
extends Object
implements ILcdModelEncoder, ILcdStatusSource

A model encoder that converts models containing vector data.

This format is intended for use only with existing Luciad applications and should not be used otherwise. If you are looking for an SQLite-based exchange format, we advise to use OGC GeoPackage instead.

• Metadata in these models will be encoded based on the model descriptor if it's an instance of ILcdDataModelDescriptor or ILcdFeaturedDescriptor.

Since:

2013.1

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TLcdLVDBModelEncoder() Creates a new TLcdLVDBModelEncoder.

Method Summary

Modifier and Type	Method and Description
void	addStatusListener(ILcdStatusListener aStatusListener) Registers the given listener so it will receive status events from this source.
boolean	canExport(ILcdModel aModel, String aDestination) Returns whether this encoder can export the specified model to the specified destination.
boolean	canSave(ILcdModel aModel) Returns whether this model encoder can save the specified model to the location it originally came from.
void	export(ILcdModel aModel, String aDestination) Exports the specified model to the specified destination.
ILcdBounds	getAreaOfInterest() Returns the bounds of the area to encode.
ILcdGeoReference	getAreaOfInterestReference() Returns the reference the current area to encode is defined in.
String	getDisplayName() Returns a short, displayable name for the format this ILcdModelEncoder encodes to.
void	removeStatusListener(ILcdStatusListener aStatusListener) Removes the specified listener so it is no longer notified.
void	save(ILcdModel aModel) Saves the model to the location where it originally came from.
void	setAreaOfInterest(ILcdBounds aAreaOfInterest, ILcdGeoReference aAreaOfInterestReference) Sets the bounds to encode.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdLVDBModelEncoder

public TLcdLVDBModelEncoder()

Creates a new TLcdLVDBModelEncoder.

Method Detail

getDisplayName

public String getDisplayName()

Description copied from interface: ILcdModelEncoder

Returns a short, displayable name for the format this ILcdModelEncoder encodes to.

Specified by:

getDisplayName in interface ILcdModelEncoder

Returns:

the displayable name of this ILcdModelEncoder.

canSave

public boolean canSave(ILcdModel aModel)

Description copied from interface: ILcdModelEncoder

Returns whether this model encoder can save the specified model to the location it originally came from. Often this will only be a simple test, for example checking the type of the model's model descriptor.

Specified by:

canSave in interface ILcdModelEncoder

Parameters:

aModel - the model to be verified.

Returns:

true if this encoder can save the model in the location where it originally came from, false otherwise.

See Also:

ILcdModelEncoder.save(com.luciad.model.ILcdModel)

save

public void save(ILcdModel aModel)
          throws IllegalArgumentException,
                 IOException

Description copied from interface: ILcdModelEncoder

Saves the model to the location where it originally came from.

Specified by:

save in interface ILcdModelEncoder

Parameters:

aModel - the model to be saved.

Throws:

IllegalArgumentException - if the model cannot be saved by this encoder (!canSave(aModel)).

IOException - if an I/O error occurs during encoding.

canExport

public boolean canExport(ILcdModel aModel,
                         String aDestination)

Description copied from interface: ILcdModelEncoder

Returns whether this encoder can export the specified model to the specified destination. This method will typically check whether the contents of the specified model are compatible with the format this encoder is written for.

Specified by:

canExport in interface ILcdModelEncoder

Parameters:

aModel - the model to be verified.

aDestination - the location where the model should be exported to.

Returns:

true if this encoder can export the specified model to the specified location, false otherwise.

See Also:

ILcdModelEncoder.export(com.luciad.model.ILcdModel, java.lang.String)

export

public void export(ILcdModel aModel,
                   String aDestination)
            throws IllegalArgumentException,
                   IOException

Description copied from interface: ILcdModelEncoder

Exports the specified model to the specified destination.

Specified by:

export in interface ILcdModelEncoder

Parameters:

aModel - the model to be exported.

aDestination - the location where the model should be saved. Typically, this is a name for the output file, but it can also point to a file containing the required properties to create a set of data files.

Throws:

IllegalArgumentException - if the model cannot be saved by this encoder (!canExport(aModel, aDestinationName)).

IOException - if an I/O error occurs during encoding.

getAreaOfInterest

public ILcdBounds getAreaOfInterest()

Returns the bounds of the area to encode.

Returns:

the current area to encode.

See Also:

(

getAreaOfInterestReference

public ILcdGeoReference getAreaOfInterestReference()

Returns the reference the current area to encode is defined in.

Returns:

the reference of the area to encode.

See Also:

getAreaOfInterest()

setAreaOfInterest

public void setAreaOfInterest(ILcdBounds aAreaOfInterest,
                              ILcdGeoReference aAreaOfInterestReference)

Sets the bounds to encode. Only the vector data overlapping with this area will be encoded.

Parameters:

aAreaOfInterest - the new bounds to encode, or null if no bounds should be used.

aAreaOfInterestReference - the reference the bounds are defined in.

addStatusListener

public void addStatusListener(ILcdStatusListener aStatusListener)

Description copied from interface: ILcdStatusSource

Registers the given listener so it will receive status events from this source.

In case you need to register a listener which keeps a reference to an object with a shorter life-time than this status source, you can use a ALcdWeakStatusListener instance as status listener.

Specified by:

addStatusListener in interface ILcdStatusSource

Parameters:

aStatusListener - The listener to be notified when the status has changed.

removeStatusListener

public void removeStatusListener(ILcdStatusListener aStatusListener)

Description copied from interface: ILcdStatusSource

Removes the specified listener so it is no longer notified.

Specified by:

removeStatusListener in interface ILcdStatusSource

Parameters:

aStatusListener - The listener to remove.