Class TLcdNVG20FilteredModel
- All Implemented Interfaces:
ILcd2DBoundsIndexedModel
,ILcd2DBoundsInteractable
,ILcdIntegerIndexedModel
,ILcdModel
,ILcdMultiDimensional
,ILcdMultiDimensionalModel
,ILcdBounded
,ILcdTimeBounded
,ILcdDisposable
,Serializable
,AutoCloseable
getUnfilteredModel()
- Since:
- 2015.0
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from interface com.luciad.model.ILcdModel
ILcdModel.Query
-
Field Summary
Fields inherited from interface com.luciad.model.ILcdModel
FIRE_LATER, FIRE_NOW, NO_EVENT
-
Constructor Summary
ConstructorDescriptionTLcdNVG20FilteredModel
(TLcdNVG20Model aDelegate) Creates a new model filtering the given NVG 2.0 model. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addElement
(Object aElement, int aEventMode) Adds the specified element to this model.void
addElements
(Vector aElements, int aEventMode) Adds all of the elements in the specified vector to this model.void
addModelListener
(ILcdModelListener aModelListener) Registers the specified model listener to receive notifications of model changes on this model.void
applyDimensionFilter
(TLcdDimensionFilter aFilter, int aEventMode) Applies a given dimensional filter and fires an event accordingly.int
applyOnInteract2DBounds
(ILcdBounds aBounds, boolean aStrictInteract, ILcdFunction aFunctionToApply, double aPrecisionX, double aPrecisionY) Applies the specified function to all the model elements of which the 2D bounds overlap with the specified bounds.int
applyOnInteract2DBounds
(ILcdBounds aBounds, boolean aStrictInteract, ILcdFunction aFunctionToApply, double aPrecisionX, double aPrecisionY, double aMinSizeX, double aMinSizeY, boolean aIncludePoints) Applies the specified function to all the elements of which the 2D bounds overlap with the specified bounds.boolean
canAddElement
(Object aElement) Returnstrue
if the specified element can be added to this model,false
otherwise.boolean
canRemoveElement
(Object aElement) Returnstrue
if the specified element can be removed from this model,false
otherwise.void
dispose()
Disposes of this model and allows it to release any system resources that it is holding.elementAt
(int aIndex) Returns the element of the filtered objects at the specified index.void
elementChanged
(Object aElement, int aEventMode) Notifies this model that the specified element has changed.elements()
Returns an enumeration over all elements of this model.void
elementsChanged
(Vector aElements, int aEventMode) Notifies this model that the elements in the specified vector have changed.void
Notifies all listeners that are registered on this model of all the changes that have been collected between the previous notification and now.Returns theILcdBounds
by which the geometry of thisILcdBounded
object is bounded.getDate()
Returns the current filtering value of the model.Returns the current filtering value of the model.Gets a list of dimensions, for example time or height, over which this multi-dimensional object is defined.Returns theILcdModelDescriptor
providing meta information about this model and its elements.Returns, if available, a model encoder that is capable of encoding this model, (encoder.canEncode(this)
),null
otherwise.Collects and returns metadata about the model.Returns theILcdModelReference
describing how the geometry of the elements contained in this model should be interpreted.Deprecated.Returns theILcdTimeBounds
by which this object is bounded.Returns theTLcdNVG20Model
model which has all the data regardless of the filter.int
Returns the index of the first occurrence of the specified element in the filter objects, or -1 if this model does not contain the element.void
removeAllElements
(int aEventMode) Removes all elements from this model.void
removeElement
(Object aElement, int aEventMode) Removes the specified element from this model.void
removeElements
(Vector aElements, int aEventMode) Removes all of the elements in the specified vector from this model.void
removeModelListener
(ILcdModelListener aModelListener) Unregisters the specified model listener so that it no longer receives notifications of model changes on this model.void
Sets a date value as a filter.int
size()
Returns the number of elements in this model.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.ILcd2DBoundsIndexedModel
query
Methods inherited from interface com.luciad.util.ILcdDisposable
close
-
Constructor Details
-
TLcdNVG20FilteredModel
Creates a new model filtering the given NVG 2.0 model.- Parameters:
aDelegate
- the model to filter
-
-
Method Details
-
getUnfilteredModel
Returns theTLcdNVG20Model
model which has all the data regardless of the filter.- Returns:
- the delegated
TLcdNVG20Model
.
-
size
public int size()Description copied from interface:ILcdIntegerIndexedModel
Returns the number of elements in this model.- Specified by:
size
in interfaceILcdIntegerIndexedModel
- Returns:
- the count of the filtered objects
-
elementAt
Returns the element of the filtered objects at the specified index.- Specified by:
elementAt
in interfaceILcdIntegerIndexedModel
- Parameters:
aIndex
- an index into the filtered objects.- Returns:
- the element at the specified index.
- Throws:
IndexOutOfBoundsException
- if an invalid index was given (aIndex < 0 || aIndex >= size())
.
-
indexOf
Returns the index of the first occurrence of the specified element in the filter objects, or -1 if this model does not contain the element. More formally: returns the smallesti
for whichthis.elementAt(i).equals(aElement)
.- Specified by:
indexOf
in interfaceILcdIntegerIndexedModel
- Parameters:
aElement
- the element to search for.- Returns:
- the index of the first occurrence of the specified element in filtered objects, or -1 if this model does not contain the element.
-
setDate
Sets a date value as a filter. Domain objects with TimeSpan data will be filtered according to this value. Calling this method can change this model. Please refer toILcdModel
's Changing data for threading and locking policies.- Parameters:
aCurrentValue
- new filter date valueaEventMode
- the mode for sending out the model change event. This can be one ofFIRE_NOW
,FIRE_LATER
orNO_EVENT
.
-
getDate
Returns the current filtering value of the model. This method returnsnull
when:- No filter has been set.
- The filter has been reset to
TLcdDimensionFilter.EMPTY_FILTER
. - The filter value has been set to a regular (as opposed to singular) interval using
applyDimensionFilter(TLcdDimensionFilter, int)
.
- Returns:
- The current filtering value of the model, possibly
null
.
-
getModelReference
Description copied from interface:ILcdModel
Returns theILcdModelReference
describing how the geometry of the elements contained in this model should be interpreted.- Specified by:
getModelReference
in interfaceILcdModel
- Returns:
- the
ILcdModelReference
of thisILcdModel
.
-
getModelDescriptor
Description copied from interface:ILcdModel
Returns theILcdModelDescriptor
providing meta information about this model and its elements.- Specified by:
getModelDescriptor
in interfaceILcdModel
- Returns:
- the
ILcdModelDescriptor
of thisILcdModel
. Should not benull
.
-
getModelEncoder
Description copied from interface:ILcdModel
Returns, if available, a model encoder that is capable of encoding this model, (encoder.canEncode(this)
),null
otherwise.- Specified by:
getModelEncoder
in interfaceILcdModel
- Returns:
- a model encoder that is capable of encoding this model if available,
null
otherwise.
-
getModelMetadata
Description copied from interface:ILcdModel
Collects and returns metadata about the model. Note that this method does not necessarily return the sameTLcdModelMetadata
instance every time it is called. The default implementation usesTLcdModelMetadata.Builder.fromModel(com.luciad.model.ILcdModel)
.Implementations can
recreate
orextend
the metadata. The following example adds a data category and source file mime type:public TLcdModelMetadata getModelMetadata() { String source = this.getModelDescriptor().getSourceName(); return this.getModelMetadata().asBuilder() .entryPoint(new TLcdModelMetadata.Source(source, MIME_XML)) .addDataCategory(TLcdModelMetadata.DataCategory.VECTOR) .build(); }
- Specified by:
getModelMetadata
in interfaceILcdModel
- Returns:
- Metadata about the model.
-
elements
Description copied from interface:ILcdModel
Returns an enumeration over all elements of this model. The order in which the elements are enumerated is unspecified by default. -
addElement
Description copied from interface:ILcdModel
Adds the specified element to this model.Models that support this operation may place limitations on what elements may be added to this model. For example, implementations that are based on a spatial indexing structure will require that elements implement
ILcdBounded
.When adding an element, the user should make sure that
canAddElement(aElement)
holds, and that the element's geometry is expressed in the same model reference as this model. It is generally undefined what happens if an invalid element is added.Implementations of this interface should clearly specify in their documentation any restrictions on what elements may be added. Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example,
NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException
), whenever possible.- Specified by:
addElement
in interfaceILcdModel
- Parameters:
aElement
- the element to be added to this model.aEventMode
- the mode for sending out the model change event. This can beFIRE_LATER
orNO_EVENT
.- See Also:
-
canAddElement
Description copied from interface:ILcdModel
Returnstrue
if the specified element can be added to this model,false
otherwise.Note that this method generally does not validate whether the specified element is expressed in the same model reference as this model. It is the responsibility of the user of this model to make sure this precondition is fulfilled when an element is added to this model.
- Specified by:
canAddElement
in interfaceILcdModel
- Parameters:
aElement
- the element to be verified.- Returns:
true
if the specified element can be added to this model,false
otherwise.
-
addElements
Description copied from interface:ILcdModel
Adds all of the elements in the specified vector to this model. Models that support this operation may place limitations on what elements may be added to this model. For example, implementations that are based on a spatial indexing structure will require that elements implementILcdBounded
. Implementations of this interface should clearly specify in their documentation any restrictions on what elements may be added.The behavior of this operation is undefined if the specified vector is modified while the operation is in progress.
The specified elements will be added to this model in the order they are specified in the vector. If an element cannot be added, this method will return at the first failure. Succeeding elements won't be added.
Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example,
NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException
), whenever possible.- Specified by:
addElements
in interfaceILcdModel
- Parameters:
aElements
- the vector of elements to be added to this model.aEventMode
- the mode for sending the model change events This can beFIRE_LATER
orNO_EVENT
.- See Also:
-
removeElement
Description copied from interface:ILcdModel
Removes the specified element from this model. If the specified element is not contained in this model, this method has no effect.Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example,
NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException
), whenever possible.- Specified by:
removeElement
in interfaceILcdModel
- Parameters:
aElement
- the element to be removed from this model.aEventMode
- the mode for sending out the model change event. This can beFIRE_LATER
orNO_EVENT
.- See Also:
-
canRemoveElement
Description copied from interface:ILcdModel
Returnstrue
if the specified element can be removed from this model,false
otherwise. Note that this method generally does not check whether the specified element is actually contained in this model.- Specified by:
canRemoveElement
in interfaceILcdModel
- Parameters:
aElement
- the element to be verified.- Returns:
true
if the specified element can be removed from this model,false
otherwise.
-
removeElements
Description copied from interface:ILcdModel
Removes all of the elements in the specified vector from this model. If one of the elements in the specified vector is not contained in this model, this element will be ignored.The behavior of this operation is undefined if the specified vector is modified while the operation is in progress.
The specified elements will be removed from this model in the order they are specified in the vector. If an element cannot be removed, this method will return at the first failure. Succeeding elements won't be removed.
Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example,
NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException
), whenever possible.- Specified by:
removeElements
in interfaceILcdModel
- Parameters:
aElements
- the vector of elements to be removed from this model.aEventMode
- the mode for sending out the model change event. This can beFIRE_LATER
orNO_EVENT
.- See Also:
-
removeAllElements
public void removeAllElements(int aEventMode) Description copied from interface:ILcdModel
Removes all elements from this model.If an element cannot be removed, this method will return at the first failure. Succeeding elements won't be removed.
Although it is unspecified what happens if the preconditions are not met, implementations are encouraged to throw meaningful exceptions (for example,
NullPointerException, IllegalArgumentException, ClassCastException, UnsupportedOperationException
), whenever possible.- Specified by:
removeAllElements
in interfaceILcdModel
- Parameters:
aEventMode
- the mode for sending out the model change event. This can beFIRE_LATER
orNO_EVENT
.
-
elementChanged
Description copied from interface:ILcdModel
Notifies this model that the specified element has changed.- Specified by:
elementChanged
in interfaceILcdModel
- Parameters:
aElement
- the element that has changed.aEventMode
- the mode for sending out the model change event. This can beFIRE_LATER
orNO_EVENT
.
-
elementsChanged
Description copied from interface:ILcdModel
Notifies this model that the elements in the specified vector have changed.- Specified by:
elementsChanged
in interfaceILcdModel
- Parameters:
aElements
- the vector of elements that have changed.aEventMode
- the mode for sending out the model change event. This can beFIRE_LATER
orNO_EVENT
.
-
fireCollectedModelChanges
public void fireCollectedModelChanges()Description copied from interface:ILcdModel
Notifies all listeners that are registered on this model of all the changes that have been collected between the previous notification and now.- Specified by:
fireCollectedModelChanges
in interfaceILcdModel
- See Also:
-
addModelListener
Description copied from interface:ILcdModel
Registers the specified model listener to receive notifications of model changes on this model.
Model changes are sent out when an element has been added, removed or changed. Model changes can be sent out individually, grouped or silently applied without notifications, depending on the
ILcdFireEventMode
that was specified with the change.In case you need to register a listener which keeps a reference to an object with a shorter life-time than this model, you can use a
ALcdWeakModelListener
instance as model listener.- Specified by:
addModelListener
in interfaceILcdModel
- Parameters:
aModelListener
- theILcdModelListener
to register on this model.- See Also:
-
removeModelListener
Description copied from interface:ILcdModel
Unregisters the specified model listener so that it no longer receives notifications of model changes on this model.- Specified by:
removeModelListener
in interfaceILcdModel
- Parameters:
aModelListener
- theILcdModelListener
to remove.- See Also:
-
dispose
public void dispose()Description copied from interface:ILcdModel
Disposes of this model and allows it to release any system resources that it is holding. The result of calling any other method (other thanfinalize
) on this model subsequent to a call to this method is undefined.- Specified by:
dispose
in interfaceILcdDisposable
- Specified by:
dispose
in interfaceILcdModel
-
applyOnInteract2DBounds
public int applyOnInteract2DBounds(ILcdBounds aBounds, boolean aStrictInteract, ILcdFunction aFunctionToApply, double aPrecisionX, double aPrecisionY) Description copied from interface:ILcd2DBoundsIndexedModel
Applies the specified function to all the model elements of which the 2D bounds overlap with the specified bounds. By default, the order in which the function is applied on the elements is unspecified and depends on the implementation. The return value of the specified function is used as a stop criterion: the spatial query is interrupted if the function returnsfalse
.- Specified by:
applyOnInteract2DBounds
in interfaceILcd2DBoundsIndexedModel
- Parameters:
aBounds
- the rectangle to test overlap with.aStrictInteract
- iffalse
, the spatial search may return more elements than the ones strictly overlapping; iftrue
, the search only returns the elements that are overlapping. The latter mode is more precise, but it may be slower.aFunctionToApply
- the function to apply on each element that overlaps with the given bounds. The return value of the specified function is used as a stop criterion: the spatial query is interrupted if the function returnsfalse
.aPrecisionX
- the precision required in the x dimension, expressed in model units. For example, for a cartesian grid system expressed in meters, the values should be expressed in meters as well, for a geodetic coordinate system the accuracy values should be expressed in degrees.The precision is useful in combination with multi-leveled data (multiple representations of the same object, but with varying accuracy), so that the most appropriate accuracy level can be used. 0 means best possible accuracy, but it might trigger lazy-loaded implementations to load lots of data.
aPrecisionY
- the precision required in the y dimension, expressed in model units.- Returns:
- the number of elements to which the
ILcdFunction
has been applied.
-
applyOnInteract2DBounds
public int applyOnInteract2DBounds(ILcdBounds aBounds, boolean aStrictInteract, ILcdFunction aFunctionToApply, double aPrecisionX, double aPrecisionY, double aMinSizeX, double aMinSizeY, boolean aIncludePoints) Description copied from interface:ILcd2DBoundsInteractable
Applies the specified function to all the elements of which the 2D bounds overlap with the specified bounds. The order in which the function is applied on the elements is unspecified and depends on the implementation. Only elements that have at least the specified minimal size in the x dimension or in the y dimension are considered. This can be useful for quickly eliminating elements that are too small to be visible in a view, for instance. If required, an exception can be made for point elements, which have a size of 0 by 0. They can be forced to be considered, even though they would always be rejected as being too small for any sizes larger than 0. The return value of the specified function is used as a stop criterion: the spatial query will be interrupted as soon as the function returnsfalse
for an element it was applied on.- Specified by:
applyOnInteract2DBounds
in interfaceILcd2DBoundsIndexedModel
- Specified by:
applyOnInteract2DBounds
in interfaceILcd2DBoundsInteractable
- Parameters:
aBounds
- the rectangle to test overlap with.aStrictInteract
- iffalse
, the spatial search may return more elements than the ones strictly overlapping; iftrue
, the search only returns the elements that are overlapping. The latter mode is more precise, but it may be slower.aFunctionToApply
- the function to apply on each element that overlaps with the given bounds.aPrecisionX
- the precision required in the x dimension, expressed in model units. For example, for a cartesian grid system expressed in meters, the values should be expressed in meters as well, for a geodetic coordinate system the accuracy values should be expressed in degrees.The precision is useful in combination with multi-leveled data (multiple representations of the same object, but with varying accuracy), so that the most appropriate accuracy level can be used. 0 means best possible accuracy, but it might trigger lazy-loaded implementations to load lots of data.
aPrecisionY
- the precision required in the y dimension, expressed in model units.aMinSizeX
- the minimal element size in the x dimension (as inILcdBounds.getWidth()
), expressed in model units. Elements that are smaller than this size will be skipped. This may, for example, be useful when improving the efficiency of painting elements by skipping elements that are smaller than some threshold (e.g. one pixel, converted to model units).aMinSizeY
- the minimal element size in the y dimension (as inILcdBounds.getHeight()
), expressed in model units.aIncludePoints
- iftrue
, zero-sized elements (points) are considered as well, even though they might be smaller than the minimum size.- Returns:
- the number of elements to which the
ILcdFunction
has been applied.
-
getBounds
Description copied from interface:ILcdBounded
Returns theILcdBounds
by which the geometry of thisILcdBounded
object is bounded.If the geometry does not allow retrieving valid bounds (for example a polyline with 0 points) the return value is unspecified. It is highly recommended to return an
undefined
bounds. You can create undefined bounds using the default constructors ofTLcdLonLatBounds
orTLcdXYBounds
.- Specified by:
getBounds
in interfaceILcdBounded
- Returns:
- the
ILcdBounds
by which the geometry of thisILcdBounded
object is bounded.
-
getPossibleDates
Deprecated.UsegetDimensions()
andILcdDimension.getValues()
instead.Generates and returns possible filtering values from each element's begin and end time information- Returns:
- list of filterable values, or an empty list if there are no values
-
getTimeBounds
Description copied from interface:ILcdTimeBounded
Returns theILcdTimeBounds
by which this object is bounded.- Specified by:
getTimeBounds
in interfaceILcdTimeBounded
- Returns:
- the
ILcdTimeBounds
by which this object is bounded.
-
applyDimensionFilter
Description copied from interface:ILcdMultiDimensionalModel
Applies a given dimensional filter and fires an event accordingly. The given filter may specify one interval per axis. The filter may contain more or less axes than the model supports.- If the filter contains more axes than the model supports, the model should ignore those axes.
- If the filter contains less axes than the model supports, the model should reset to its default for those axes.
Filtering behavior
In practice, filtering behavior and the default filter depend on the type of the model:- Vector models, such as NVG or ASTERIX, have multiple elements, where every element is a domain object. Each element has a validity defined by an interval, for example a temporal interval on a time axis. The filtered model will only contain the elements that match the filter. When a new filter is applied, events will be fired as elements are removed or added based on the new filter. The default filter in this case is 'no filter', which means that all elements match the filter and the model behaves as if unfiltered. In case no elements match the filter, the model will be empty.
-
Raster models, such as NetCDF, have a single or a couple of model elements, where every model
element corresponds with exactly one image. Internally, each element is possibly backed up by multiple
ALcdImage
instances, every one of which is valid within a certain interval. An implementation of this interface needs to make sure that- a model element only corresponds with exactly one of these images, based on the currently configured filter.
- the model element's image is available through
ALcdImage.fromDomainObject(java.lang.Object)
. We advise to use the 'has-an-image' paradigm to expose this image, because it allows for faster updates in a Lightspeed view. - changes in filtering are correctly applied. When a filter is changed, it must either replace the element with a new element, or when the 'has-an-image' paradigm is used, it must replace the image that is exposed by the model element. When a filter doesn't match anything, it must make sure that there is no element present in the model. Using 'has-an-image' with a null image is not a valid way to express this.
Filter matching
Matching intervals happens based onTLcdDimensionInterval.overlaps(com.luciad.multidimensional.TLcdDimensionInterval<T>, com.luciad.multidimensional.TLcdDimensionInterval<T>)
. The rationale for this is the following:- Each element has a validity defined by an interval, for example on a time axis.
- Using the filter, you're asking the model to "match everything which is valid in the filter interval(s)", which corresponds to the meaning of overlap.
Locking
This method should typically be called from within a write lock:
The most common exception to this rule is when you're creating a model initially and no-one has a reference to it yet: in that case, it's safe to not lock at all and usetry (TLcdLockUtil.Lock lock = TLcdLockUtil.writeLock(model) { ... model.applyDimensionFilter(filter, ILcdModel.FIRE_LATER); ... } finally { model.fireCollectedModelChanges(); }
ILcdModel.NO_EVENT
.No snapping
Implementations should not 'snap' to the intervals defined by the filter in case no elements match. There shall be no snapping to nearest, previous or next. Instead, the result must be 'empty' (or 'image isnull
' in case of raster models). If you need to snap a filter interval to an actual interval the model has to offer, you should useTLcdDimensionFilter.createSnappingFilter(com.luciad.multidimensional.ILcdMultiDimensionalModel, com.luciad.multidimensional.TLcdDimensionFilter.SnapMode)
to create a snapped filter.Differences with
createSnappingFilter
As its name suggests, the primary purpose of the utility methodcreateSnappingFilter
is to create a filter which 'snaps' to filter intervals so that there is always at least one match. But the method does more than just that. Here is a list of differences between using and not usingcreateSnappingFilter
:Behavior applyDimensionFilter
createSnappingFilter->applyDimensionFilter
Snapping Never, possibly resulting in no matches Snaps to intervals defined by the model if needed, such that there is always at least one match Supported snap modes None Nearest, previous, next, or none ( null
)Filter has less axes than supported by model Reset to default for those axes Keep the last current filter value for those axes, so that there are minimal model changes Empty filter Reset to default filter Keep current filter, so that there are no model changes ILcdModel
which is notILcdMultiDimensionalModel
Not supported Checks instance of ILcdMultiDimensionalModel
, leaves others alone- Specified by:
applyDimensionFilter
in interfaceILcdMultiDimensionalModel
- Parameters:
aFilter
- The dimensional filter, possibly empty but nevernull
.aEventMode
- The mode of the event that should be triggered when the value of the filter parameters changes.- See Also:
-
getDimensionFilter
Returns the current filtering value of the model. NVG20 models use Date as filtering value. This method returnsnull
when:- No filter has been set.
- The filter has been reset to
TLcdDimensionFilter.EMPTY_FILTER
. - The filter value has been set to a regular (as opposed to singular) interval using
applyDimensionFilter(TLcdDimensionFilter, int)
.
- Specified by:
getDimensionFilter
in interfaceILcdMultiDimensionalModel
- Returns:
- The current filtering value of the model, possibly
null
.
-
getDimensions
Description copied from interface:ILcdMultiDimensional
Gets a list of dimensions, for example time or height, over which this multi-dimensional object is defined. Each dimension defines an axis, its possible values, and the range of possible values. The values of the dimension axes are all the possible values this multi-dimensional object can be filtered on. An empty list means that the instance is not dimensionally filterable.- Specified by:
getDimensions
in interfaceILcdMultiDimensional
- Returns:
- a list dimensions (axes and their possible values) over which this multi-dimensional object is defined,
possibly empty but never
null
. - See Also:
-
getDimensions()
andILcdDimension.getValues()
instead.