Class: Ring

// sectorStyleByCodomain  Each element is an object containing information and domain and range corresponding to the style information, the object has three properties (must):
// start: range lower limit (included);
// end: range upper limit (not included);
// style: Data visualization graphics style, this style object can be set properties: .
// sectorStyleByCodomain array like：
[
  {
    start:0,
    end:250,
    style:{
         fillColor:"#00CD00"
     }
 },
  {
    start:250,
    end:500,
    style:{
         fillColor:"#00EE00"
     }
 },
  {
    start:500,
    end:750,
    style:{
         fillColor:"#00FF7F"
     }
 },
  {
    start:750,
    end:1500,
    style:{
         fillColor:"#00FF00"
     }
 }
]

Extends

• SuperMap.Feature.Theme.Graph

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.

lonlatSuperMap.LonLat

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

Graph configuration object, which controls the visual display of the graph.

shapeFactorySuperMap.Feature.ShapeFactory

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()

Ring.js, line 73

Assembly graphics (Extended 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.

destroy()

Ring.js, line 65

Disposes the resource. The property that references resource is set to null.

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(width, height, codomain, XOffset, YOffset, dataViewBoxParameter, decimalNumber){boolean}

Graph.js, line 238

Initialize the basic parameters of the theme element (chart). 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
width	number	Width of the theme elements(chart), required.
height	number	Height of the theme elements(chart), required.
codomain	Array.<number>	Domain, an array with the length of 2, the first one is the minimum, the second one is the maximum value, required.
XOffset	number	optional Offset in X direction of the theme elements(chart), the unit is pixel.
YOffset	number	optional Offset in Y direction of the theme elements(chart), 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.Ring.settingObject

Properties:

Name	Type	Default	Description
width	number		Thematic elements (Graph) width.
height	number		Thematic elements (Graph) height.
codomain	Array.<number>		Charts allow the display of the data range, the length of two one-dimensional arrays, the first element is range lower limit, the second element is range limit.
XOffset	number		optional Thematic elements (graphs) offset value in the X direction, unit pixel.
YOffset	number		optional Thematic elements (graphs) offset value in the Y direction, unit pixel.
dataViewBoxParameter	Array.<number>	[0, 0, 0, 0]	optional dataViewBox parameters. It refers to the chartBox (chartBox constituted by chart position, width chart, chart highly) in the left , down,right,up four direction within the offset value.
decimalNumber	number		optional Data value array dataValues elements of the decimal value, the decimal processing parameters of data, range: [0, 16]. If you do not set this parameter in data value is not a digital data processing.
useBackground	boolean	false	optional Whetjer to use Background box.
backgroundStyle	SuperMap.Feature.ShapeParameters.Rectangle.style		optional Background style.
backgroundRadius	Array.<number>	[0, 0, 0, 0]	optional Rectangular corner radius of the background frame, you can use the array to specify the four corners of the fillet radius,Set: the radius of upper left, upper right, lower left and lower left corner in turn is: r1、r2、r3、r4, backgroundRadius is [r1、r2、r3、r4 ].
innerRingRadius	number	0	optional The radius of the inner ring, the range of more than 0, less than the outer radius of the outer ring (outer ring radius: data view frame length and width of the smaller value of 1/2).
sectorStyle	SuperMap.Feature.ShapeParameters.Sector.style		optional Based style of sector in a ring graph.This parameter contrity is lower than the sectorStyleByFields and sectorStyleByCodomain.
sectorStyleByFields	Array.<SuperMap.Feature.ShapeParameters.Sector.style>		optional According to the theme field themeFields(SuperMap.Layer.Graph.themeFields|L.supermap.graphThemeLayer.themeFields|ol.source.Graph.themeFields|mapboxgl.supermap.GraphThemeLayer.themeFields), the ring pattern is styled, and this parameter is pressed. The field controls the ring graph fan style, with a lower priority than sectorStyleByCodomain, higher than the sectorStyle. The elements in this array are style objects. The style in this parameter corresponds to the fields in themeFields one by one. For example: themeFields(<SuperMap.Layer.Graph.themeFields>) is ["POP_1992", "POP_1995", "POP_1999"], and sectorStyleByFields is [style1, style2, style3], then in the chart, the field POP_1992 corresponds to the ring The fan shape of the figure uses style1, the ring diagram fan corresponding to the field POP_1995 uses style2, and the ring diagram fan corresponding to the field POP_1999 uses style3.
sectorStyleByCodomain	Array.<SuperMap.Feature.ShapeParameters.Sector.style>		optional The range of values of the data values represented by the ring graph fan controls the ring graph fan style, with a higher priority than sectorStyle and sectorStyleByFields.