Class: Pie

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

Pie.js, line 70

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

Pie.js, line 62

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.Pie.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, required parameters.
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. When using the coordinate axis,the default value of dataViewBoxParameter is:[45, 15, 15, 15]；When it is not used, the default value of dataViewBoxParameter is:[5, 5, 5, 5].
decimalNumber	Array.<number>		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 Whether to use Background box.
backgroundStyle	SuperMap.Feature.ShapeParameters.Rectangle.style		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.
sectorStyle	SuperMap.Feature.ShapeParameters.Sector.style		Based style of sector in a pie graph.This parameter controls the column base style, the priority is lower than the sectorStyleByFields and sectorStyleByCodomain.
sectorStyleByFields	Array.<SuperMap.Feature.ShapeParameters.Sector.style>		Set style for sector according to themeFields（SuperMap.Layer.Graph::themeFields）,this parameter field control the bar style,The priority is lower than sectorStyleByCodomain,and higher than sectorStyle. The element in this array is a style object, which can be set to a property: <SuperMap.Feature.ShapeParameters.Sector::style>. The style in this parameter corresponds to the field in the themeFields.such as: themeFields（SuperMap.Layer.Graph::themeFields）is ["POP_1992", "POP_1995", "POP_1999"], sectorStyleByFields is [style1, style2, style3]， in the graph, sector corresponding to the field of POP_1992 using the style1, a POP_1995 field corresponding to the sector using the style2 , sector field corresponds to POP_1999 using style3.
sectorStyleByCodomain	Array.<Object>		Value range of the pie control the style, a higher priority than sectorStyle and sectorStyleByFields.
sectorHoverStyle	Object		optional Sector hover state style, effective when sectorHoverAble is true.
sectorHoverAble	Object		optional Whether to allowe the bar to use the hover state. At the same time, set the sectorHoverAble and sectorClickAble false, can be directly on the shielding sector thematic layer event response.
sectorClickAble	Object		optional Whether to allowe the bar is clicked. At the same time, sectorHoverAble and sectorClickAble are set to false, which can directly screen the response of the sector strip to the event layer.