Class: Circle

SuperMap.Feature.Theme.Circle

Circle.

new SuperMap.Feature.Theme.Circle(data, layer, fields, setting, lonlat)

Circle.js, line 7
Name Type Description
data SuperMap.Feature.Vector

User data, required.

layer SuperMap.Layer.RankSymbol

Layer where this thematic feature is located. Required.

fields Array.<string>

Fields participated in the graphic generation in data. Required.

setting SuperMap.Feature.Theme.Circle.setting

Graphic configuration object. Required.

lonlat SuperMap.LonLat optional

The geographic position of thematic feature. Default is center of bounds for geographic feature represented by data.

Extends

Members

chartBoundsSuperMap.Bounds

The bounds of the chart will be updated with lonlat, XOffset and YOffset, note: chartBounds is pixel range, not geographical range.

chartBoxArray.<number>

The thematic feature (chart) area, that is, the chart box, a one-dimensional array of length 4, the four elements of the array sequentially represent the x coordinate value at the left end of the chart frame,
the lower y coordinate value, the right end x coordinate value, and the upper y coordinate value; [left , bottom, right, top].

dataObject

{ReadOnly} User data, used to generate visible shape, and can define data format and type in the sub class. e.g.: <SuperMap.Feature.Vector> 。

dataValuesArray.<number>

Data values for representation, got by fields from the property of feature.

dataViewBoxArray.<number>

Data view frame parameters, an array with the length of 4(array element value >= 0), [left, bottom, right, top]. DataViewBox is the core content of the graph theme element. It is responsible for the interpretation of data visualization in a pixel region for the data, and the meaning is expressed by visual graphic. The graphics which represent the data and some auxiliary graphics are combined together to form a statistical thematic charts.

DVBCenterPointArray.<number>

Center of the data view frame, an array with the length of 2, the first one means x, the second one means y.

DVBCodomainArray.<number>

Data domain to show in the data view frame, an array with the length of 2, the first one means the minimum, the second one means the maximum. The processing for the data out of the range should be in assembleShapes.

DVBHeightnumber

Height of the data view frame.

DVBOrigonPointArray.<number>

Origin point of the data view frame, that is the upper left corner point, an array with the length of 2, the first one means x, the second one means y.

DVBParameterArray.<number>

Data view frame parameters, an array with the length of 4(array element value >= 0), [leftOffset, bottomOffset, rightOffset, topOffset], the inner offset value of chartBox. The property is used to specify the range of dataViewBox.

DVBUnitValuestring

Unit value. Initialized in assembleShapes(), e.g.:DVBUnitValue of the pie chart is ”360/data count value”, DVBUnitValue of the line chart is “DVBCodomain/DVBHeight”.

DVBWidthnumber

Width of the data view frame.

fieldsArray.<string>

The data {SuperMap.Feature.Vector} attribute fields.

heightnumber

Height of the theme elements(chart), required.

idstring

Unique identification of thematic elements

layerSuperMap.Layer.Theme

{ReadOnly} Thematic layer where thematic features are.

locationArray

Thematic feature pixel reference position. In general, it is determined by geographic reference. It is an array, the first element is x coordinate, and the second element is y coordinate.

Thematic feature geographic reference position. In sub class, it is assigned by user data (or geographic position parameter).

origonPointArray.<number>

Origin point of the theme elements(chart), that is the upper left corner point, an array with the length of 2, the first one means x, the second one means y.

origonPointOffsetArray.<number>

The origin offset of the data view box relative to the chart box is 2 dimensional array, the first element represents the X offset, and the second element represents the Y offset.

RelativeCoordinateboolean

Whether the figure has been calculated for the relative coordinates.

settingObject

Symbol configuration object, which controls the visual display of the graph. It contains five properties:

The embedded shape factory object, call its createShape method to create shapes.

shapeParametersObject

The current shape parameter object, the subclass object of <SuperMap.Feature.ShapeParameters>.

shapesArray

{ReadOnly} The visible shape array by thematic features. The order of the array controls the render.

widthnumber

Width of the theme elements(chart), required.

XOffsetnumber

Offset in X direction of the theme elements(chart), the unit is pixel.

YOffsetnumber

Offset in Y direction of the theme elements(chart), the unit is pixel.

Methods

assembleShapes()

Circle.js, line 33

Grahpic configuration (extend interface).

inherited constructor(data, layer){SuperMap.Feature.Theme}

Theme.js, line 14

The Constructor.

Name Type Description
data Object

User data which is used to generate visible shape. Required.

layer SuperMap.Layer.Theme

The layer the theme element is in, required.

Returns:
Type Description
SuperMap.Feature.Theme Return a thematic feature.

inherited destroy()

RankSymbol.js, line 46

Destroys thematic features.

inherited destroy()

RankSymbol.js, line 46

Destroys thematic features.

inherited getLocalXY(lonlat)

Graph.js, line 465

The geographic coordinates are converted to pixel coordinates.

Name Type Description
lonlat SuperMap.Lonlat

The geographical coordinates to be converted.

Returns:
Screen pixel coordinates.

inherited initBaseParameter(codomain, XOffset, YOffset, dataViewBoxParameter, decimalNumber){boolean}

RankSymbol.js, line 56

Initialize the basic parameters of the theme element (graph). Before calling this method, the graph model related properties are not available, this method is called in the assembleShapes function. The related properties of the setting object are:

Name Type Description
codomain Array.<number>

Domain, an array with the length of 2, the first one is the minimum, the second one is the maximum value.

XOffset number optional

Offset in X direction of the theme elements(graph), the unit is pixel.

YOffset number optional

Offset in Y direction of the theme elements(graph), the unit is pixel.

dataViewBoxParameter Array.<number> optional

The data view frame dataViewBox parameters, means four inner offset values in left, down, right, up direction of chartBox( constituted by chart position, chart width, chart height).

decimalNumber number optional

The decimal value of the data value array dataValues, decimal processing parameters, the range is: [0, 16]. If you do not set this parameter, the decimal will not be processed.

Returns:
Type Description
boolean Whether the initialization is successful.

inherited resetLinearGradient()

Graph.js, line 367

When the relative coordinates of the chart are called in the resetLocation, the color of the gradient is recalculated.(The subclass implements this method at present for the gradient color of a two-dimensional histogram)

inherited resetLocation(lonlat){Array.<number>}

Graph.js, line 336

The location of the thematic element (Chart) is reset according to the geographic location lonlat.

Name Type Description
lonlat SuperMap.LonLat

The new pixel center position of the feature element.

Returns:
Type Description
Array.<number>
  • New feature element pixel reference position. The length of an array is 2, the first element to represent the X coordinates, the second elements to represent the Y coordinates.

inherited shapesConvertToRelativeCoordinate()

Graph.js, line 375

The node that will (constitute a graph) is converted to relative coordinates, which must be called at the end of the assembleShapes ().

Type Definitions

SuperMap.Feature.Theme.Circle.settingObject

Properties:
Name Type Default Description
codomain Array.<number>

Data range can be represented by the graph. The length of the array is 2, with the 1st element indicating the lower limit and the 2nd element the uppper limit. Required.

maxR number optional

Maximum radius of circle.

minR number optional

Minimum radius of circle.

fillColor string optional

Fill color of circle, such as fillColor: "#FFB980".

circleStyle Object optional

The base style style of the circle, with priority lower than circleStyleByFields and circleStyleByCodomain.

decimalNumber number optional

The decimal number of ataValues array, with the range being [0, 16]. If not set, decimal number will not be handled while getting data values.

circleHoverStyle Object optional

The style of hover status for the circle. Valid when circleHoverAble is true.

circleHoverAble boolean true optional

Whether to allow the usage of hover status for circle. Default value is yes. Meanwhile, circleHoverAble and circleClickAble are set to false to disable response of grahics to thematic layer events.

circleClickAble boolean true optional

Whetehr to allow circle to be selected. The default value is yes. Meanwhile, circleHoverAble and circleClickAble are set to false to disable response of grahics to thematic layer events.