AGSTemporalRenderer Class Reference


Description

Instances of this class represent temporal renderers. A temporal renderer is useful in visualizing changes to features over time. It can only be used with a feature layer that is time aware. It symbolizes features based on the time information contained in the features. Time information can either be an instant of time, or a period of time. Information representing an instant of time is stored in a single attribute of the feature. Information representing a period of time is stored in two attributes representing the start time and the end time.

A temporal renderer consists of two elements - An observation renderer, and an interpolator. The observation renderer specifies the symbols to be used when features don't contain any time information, or when the map does not have a time extent. The observation renderer can be a simple, class breaks, or unique value renderer.

An interpolator "ages" the symbols specified by the observation renderer for features that have time information. Aging refers to modifying properties of a symbol such as its size or color. Two types of interpolators are supported : ramp interpolator and time class breaks ager.

Defined in:
AGSTemporalRenderer.h ( ArcGIS library)
Since:
1.8
Inheritance diagram for AGSTemporalRenderer:
AGSRenderer <AGSCoding>

List of all members.

Public Member Functions

(void) - decodeWithJSON:
(NSDictionary *) - encodeToJSON
(id) - initWithJSON:
(id) - initWithObservationRenderer:observationAger:featureLayer:
(UIImage *) - swatchForGraphic:geometryType:size:
(UIImage *) - swatchForGraphic:size:
(AGSSymbol *) - symbolForGraphic:
(AGSSymbol *) - symbolForGraphic:timeExtent:

Properties

AGSFeatureLayerfeatureLayer
AGSSymbolInterpolatorobservationAger
AGSRendererobservationRenderer

Member Function Documentation

- (void) decodeWithJSON: (NSDictionary *)  json   [optional, inherited]

Decode object from JSON representation.

Parameters:
json The JSON representation of the object to be decoded.
Since:
1.0
- (NSDictionary *) encodeToJSON   [optional, inherited]

Encode and return JSON representation for object.

Returns:
JSON representation of object.
Since:
1.0
- (id) initWithJSON: (NSDictionary *)  json   [optional, inherited]

Initialize and return object from JSON representation.

Parameters:
json The JSON representation of the object to be created.
Returns:
Object decoded from JSON representation.
Since:
1.0
- (id) initWithObservationRenderer: (AGSRenderer *)  observationRenderer
observationAger: (AGSSymbolInterpolator *)  observationAger
featureLayer: (AGSFeatureLayer *)  featureLayer 

Initializes a temporal renderer

Parameters:
observationRenderer The observation renderer specifying the default symbols
observationAger The interpolator used to age the symbols
featureLayer The feature layer this renderer works with
Returns:
A temporal renderer
- (UIImage *) swatchForGraphic: (AGSGraphic *)  graphic
geometryType: (AGSGeometryType geometryType
size: (CGSize)  size 

Returns an image that represents a swatch for a particular graphic. This method can be used when your graphic does not have a geometry but you know the geometry type.

Parameters:
graphic Graphic for which the swatch should be drawn. This is used to determine what symbol in the renderer is used.
geometryType The type of the geometry determines what kind of swatch is drawn.
size Size of the output swatch.
Returns:
UIImage of the drawn swatch.
- (UIImage *) swatchForGraphic: (AGSGraphic *)  graphic
size: (CGSize)  size 

Returns an image that represents a swatch for a particular graphic. The graphic must have a valid geometry.

Parameters:
graphic Graphic for which the swatch should be drawn. This is used to determine what symbol in the renderer is used.
size Size of the output swatch.
Returns:
UIImage of the drawn swatch.
- (AGSSymbol *) symbolForGraphic:  

Return a symbol for the graphic based on the scheme used by this renderer.

Parameters:
graphic The graphic to determine symbol.
Returns:
Symbol for graphic.
Since:
1.0
Deprecated:
Use symbolForGraphic:timeExtent: instead.
- (AGSSymbol *) symbolForGraphic: (AGSGraphic *)  graphic
timeExtent: (AGSTimeExtent *)  timeExtent 

Return a symbol for the graphic based on the scheme used by this renderer.

Parameters:
graphic The graphic to determine symbol.
timeExtent The time extent to determine the symbol at.
Returns:
Symbol for graphic.
Since:
1.8

Property Documentation

- (AGSFeatureLayer*) featureLayer [read, write, assign]

The feature layer for which this renderer is applied.

- (AGSSymbolInterpolator*) observationAger [read, write, retain]

The interpolator which is used to age the symbols.

Since:
1.8
- (AGSRenderer*) observationRenderer [read, write, retain]

The renderer to use for the observations.

Since:
1.8