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

common/overlay/Bar3D.js, line 10

Name	Type	Description
`data`	SuperMap.Feature.Vector	用户数据。
`layer`	SuperMap.Layer.Graph	此专题要素所在图层。
`fields`	Array.<string>	data 中的参与此图表生成的字段名称。
`setting`	SuperMap.Feature.Theme.Bar3D.setting	图表配置对象。
`lonlat`	SuperMap.LonLat	可选专题要素地理位置，默认为 data 指代的地理要素 Bounds 中心。

Examples

// barFaceStyleByCodomain 用法示例如下：
// barFaceStyleByCodomain 的每个元素是个包含值域信息和与值域对应样式信息的对象，该对象（必须）有三个属性：
// start: 值域值下限（包含）;
// end: 值域值上限（不包含）;
// style: 数据可视化图形的 style，这个样式对象的可设属性：  。
// barFaceStyleByCodomain 数组形如：
[
  {
    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"
     }
 }
]

// barSideStyleByCodomain 用法示例如下：
// barSideStyleByCodomain 的每个元素是个包含值域信息和与值域对应样式信息的对象，该对象（必须）有三个属性：
// start: 值域值下限（包含）;
// end: 值域值上限（不包含）;
// style: 数据可视化图形的 style，这个样式对象的可设属性：  。
// barSideStyleByCodomain 数组形如：
[
  {
    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"
     }
 }
]

// barTopStyleByCodomain 用法示例如下：
// barTopStyleByCodomain 的每个元素是个包含值域信息和与值域对应样式信息的对象，该对象（必须）有三个属性：
// start: 值域值下限（包含）;
// end: 值域值上限（不包含）;
// style: 数据可视化图形的 style，这个样式对象的可设属性： 。
// barTopStyleByCodomain 数组形如：
[
  {
    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

图表 Bounds 随着 lonlat、XOffset、YOffset 更新，注意 chartBounds 是图表像素范围，不是地理范围。

chartBoxArray.<number>

专题要素（图表）区域，即图表框，长度为 4 的一维数组，数组的 4 个元素依次表示图表框左端 x 坐标值、下端 y坐标值、右端 x坐标值、上端 y 坐标值；[left, bottom, right, top]。

dataObject

用户数据，用于生成可视化 shape，可在子类中规定数据格式或类型，如：<SuperMap.Feature.Vector>。

dataValuesArray.<number>

图表展示的数据值，通过 fields 从数据 feature 属性中获得。

dataViewBoxArray.<number>

数据视图框，长度为 4 的一维数组，[left, bottom, right, top]。 dataViewBox 是统计专题要素最核心的内容，它负责解释数据在一个像素区域里的数据可视化含义，这种含义用可视化图形表达出来，这些表示数据的图形和一些辅助图形组合在一起构成统计专题图表。

DVBCenterPointArray.<number>

数据视图框中心点，长度为 2 的一维数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

DVBCodomainArray.<number>

数据视图框的内允许展示的数据值域，长度为 2 的一维数组，第一个元素表示值域下限，第二个元素表示值域上限。 dataViewBox 中允许的数据范围，对数据溢出值域范围情况的处理需要在 assembleShapes 中进行。

DVBHeightnumber

数据视图框高度。

DVBOrigonPointArray.<number>

数据视图框原点，数据视图框左上角点，长度为 2 的一维数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

DVBParameterArray.<number>

数据视图框参数，长度为 4 的一维数组（数组元素值 >= 0），[leftOffset, bottomOffset, rightOffset, topOffset]，chartBox 内偏距值。此属性用于指定数据视图框 dataViewBox 的范围。

DVBUnitValuestring

单位值。在 assembleShapes() 中初始化其具体意义，例如：饼图的 DVBUnitValue 可以定义为"360/数据总和"，折线图的 DVBUnitValue 可以定义为 "DVBCodomain/DVBHeight"。

DVBWidthnumber

数据视图框宽度。

fieldsArray.<string>

数据{SuperMap.Feature.Vector}属性字段。

heightnumber

专题要素（图表）高度。

idstring

专题要素唯一标识。

layerSuperMap.Layer.Theme

此专题要素所在专题图层。

locationArray

专题要素像素参考位置。通常由地理参考位置决定。长度为 2 的数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

lonlatSuperMap.LonLat

专题要素地理参考位置。子类中必须根据用户数据（或地理位置参数）对其赋值。

origonPointArray.<number>

专题要素（图表）原点，图表左上角点像素坐标，是长度为 2 的一维数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

origonPointOffsetArray.<number>

数据视图框原点相对于图表框的原点偏移量，长度为 2 的一维数组，第一个元素表示 x 偏移量，第二个元素表示 y 偏移量。

RelativeCoordinateboolean

图形是否已经计算了相对坐标。

settingObject

图表配置对象，该对象控制着图表的可视化显示。

shapeFactorySuperMap.Feature.ShapeFactory

内置的图形工厂对象，调用其 createShape 方法创建图形。

shapeParametersObject

当前图形参数对象，<SuperMap.Feature.ShapeParameters> 的子类对象。

shapesArray

构成此专题要素的可视化图形对象数组，数组顺序控制渲染。

widthnumber

专题要素（图表）宽度。

XOffsetnumber

专题要素（图表）在 X 方向上的偏移值，单位像素。

YOffsetnumber

专题要素（图表）在 Y 方向上的偏移值，单位像素。

Methods

assembleShapes() common/overlay/Bar3D.js, line 153

图形装配实现（扩展接口）。

calculateXShapeInfo(){Object} common/overlay/Bar3D.js, line 334

计算 X 轴方向上的图形信息，此信息是一个对象，包含两个属性，属性 xPositions 是一个一维数组，该数组元素表示图形在 x 轴方向上的像素坐标值，如果图形在 x 方向上有一定宽度，通常取图形在 x 方向上的中心点为图形在 x 方向上的坐标值。 width 表示图形的宽度（特别注意：点的宽度始终为 0，而不是其直径）。本函数中图形配置对象 setting 可设属性: xShapeBlank - {Array.} 水平方向上的图形空白间隔参数。长度为 3 的数组，第一元素表示第一个图形左端与数据视图框左端的空白间距，第二个元素表示图形间空白间距，第三个元素表示最后一个图形右端与数据视图框右端端的空白间距。

Returns:

Type	Description
Object	如果计算失败，返回 null；如果计算成功，返回 X 轴方向上的图形信息，此信息是一个对象，包含以下两个属性: xPositions - {Array.} 表示图形在 x 轴方向上的像素坐标值，如果图形在 x 方向上有一定宽度，通常取图形在 x 方向上的中心点为图形在 x 方向上的坐标值。 width - {number} 表示图形的宽度（特别注意：点的宽度始终为 0，而不是其直径）。

Type

Description

Object

如果计算失败，返回 null；如果计算成功，返回 X 轴方向上的图形信息，此信息是一个对象，包含以下两个属性: xPositions - {Array.} 表示图形在 x 轴方向上的像素坐标值，如果图形在 x 方向上有一定宽度，通常取图形在 x 方向上的中心点为图形在 x 方向上的坐标值。 width - {number} 表示图形的宽度（特别注意：点的宽度始终为 0，而不是其直径）。

inherited constructor(data, layer){SuperMap.Feature.Theme} common/overlay/feature/Theme.js, line 17

构造函数。

Name	Type	Description
`data`	Object	用户数据，用于生成可视化 shape，必设参数。
`layer`	SuperMap.Layer.Theme	此专题要素所在图层，必设参数。

Returns:

Type	Description
SuperMap.Feature.Theme	返回一个专题要素。

inherited destroy() common/overlay/Bar3D.js, line 145

销毁专题要素。

inherited getLocalXY(lonlat) common/overlay/Graph.js, line 469

地理坐标转为像素坐标。

Name	Type	Description
`lonlat`	SuperMap.Lonlat	带转换的地理坐标。

Returns:

屏幕像素坐标。

inherited initBaseParameter(width, height, codomain, XOffset, YOffset, dataViewBoxParameter, decimalNumber){boolean} common/overlay/Graph.js, line 241

初始化专题要素（图表）基础参数。在调用此方法前，此类的图表模型相关属性都是不可用的，此方法在 assembleShapes 函数中调用。调用此函数关系到 setting 对象的以下属性。

Name	Type	Description
`width`	number	专题要素（图表）宽度。
`height`	number	专题要素（图表）高度。
`codomain`	Array.<number>	值域，长度为 2 的一维数组，第一个元素表示值域下限，第二个元素表示值域上限。
`XOffset`	number	可选专题要素（图表）在 X 方向上的偏移值，单位像素。
`YOffset`	number	可选专题要素（图表）在 Y 方向上的偏移值，单位像素。
`dataViewBoxParameter`	Array.<number>	可选数据视图框 dataViewBox 参数，它是指图表框 chartBox。（由图表位置、图表宽度、图表高度构成的图表范围框）在左、下，右，上四个方向上的内偏距值。
`decimalNumber`	number	可选数据值数组 dataValues 元素值小数位数，数据的小数位处理参数，取值范围：[0, 16]。如果不设置此参数，在取数据值时不对数据做小数位处理。

Returns:

Type	Description
boolean	初始化参数是否成功。

inherited resetLinearGradient() common/overlay/Graph.js, line 373

resetLocation 中调用图表的相对坐标存在的时候，重新计算渐变的颜色（目前用于二维柱状图渐变色所以子类实现此方法）。

inherited resetLocation(lonlat){Array.<number>} common/overlay/Graph.js, line 342

根据地理位置 lonlat 重置专题要素（图表）位置。

Name	Type	Description
`lonlat`	SuperMap.LonLat	专题要素新的像素中心位置。

Returns:

Type	Description
Array.<number>	新专题要素像素参考位置。长度为 2 的数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

inherited shapesConvertToRelativeCoordinate() common/overlay/Graph.js, line 381

将（构成图表）图形的节点转为相对坐标表示，此函数必须且只能在 assembleShapes() 结束时调用。

Type Definitions

SuperMap.Feature.Theme.Bar3D.settingObject

Properties:

Name	Type	Default	Description
`width`	number		专题要素（图表）宽度。
`height`	number		专题要素（图表）高度。
`codomain`	Array.<number>		图表允许展示的数据值域，长度为 2 的一维数组，第一个元素表示值域下限，第二个元素表示值域上限。
`XOffset`	number		可选专题要素（图表）在 X 方向上的偏移值，单位像素。
`YOffset`	number		可选专题要素（图表）在 Y 方向上的偏移值，单位像素。
`dataViewBoxParameter`	Array.<number>		可选数据视图框 dataViewBox 参数，它是指图表框 chartBox （由图表位置、图表宽度、图表高度构成的图表范围框）在左、下，右，上四个方向上的内偏距值。当使用坐标轴时 dataViewBoxParameter 的默认值为：[45, 25, 20, 20]；不使用坐标轴时 dataViewBoxParameter 的默认值为：[5, 5, 5, 5]。
`decimalNumber`	number		可选数据值数组 dataValues 元素值小数位数，数据的小数位处理参数，取值范围：[0, 16]。如果不设置此参数，在取数据值时不对数据做小数位处理。
`useBackground`	boolean	true	可选是否使用图表背景框。
`backgroundStyle`	SuperMap.Feature.ShapeParameters.Rectangle.style		可选背景样式。
`backgroundRadius`	Array.<number>	[0, 0, 0, 0]	可选背景框矩形圆角半径，可以用数组分别指定四个角的圆角半径，设：左上、右上、右下、左下角的半径依次为 r1、r2、r3、r4 ,则 backgroundRadius 为 [r1、r2、r3、r4 ]。
`xShapeBlank`	Array.<number>		可选水平方向上的图形空白间隔参数。长度为 3 的数组，第一元素表示第一个图形左端与数据视图框左端的空白间距，第二个元素表示图形间空白间距，第三个元素表示最后一个图形右端与数据视图框右端端的空白间距。
`bar3DParameter`	number	10	可选 3D 柱状参数，3d柱形正面相对于背面向 x 轴和 y 轴负方向偏移的绝对值。
`useAxis`	boolean	true	可选是否使用坐标轴。
`axisStyle`	SuperMap.Feature.ShapeParameters.Line.style		可选坐标轴样式。
`axisUseArrow`	boolean	true	可选坐标轴是否使用箭头。
`axisYTick`	number	0	可选 y 轴刻度数量。
`axisYLabels`	Array.<string>		可选 y 轴上的标签组内容，标签顺序沿着数据视图框左面条边自上而下，等距排布。例如：["1000", "750", "500", "250", "0"]。
`axisYLabelsStyle`	SuperMap.Feature.ShapeParameters.Label.style		可选 y 轴上的标签组样式。
`axisYLabelsOffset`	Array.<number>	0	可选 y 轴上的标签组偏移量。长度为 2 的数组，数组第一项表示 y 轴标签组横向上的偏移量，向左为正，默认值：0；数组第二项表示 y 轴标签组纵向上的偏移量，向下为正。
`axisXLabels`	Array.<string>		可选 x 轴上的标签组内容，标签顺序沿着数据视图框下面条边自左向右排布，例如：["92年", "95年", "99年"]。标签排布规则：当标签数量与 xShapeInfo 中的属性 xShapeCenter 数量相同（即标签个数与数据个数相等时）, 按照 xShapeCenter 提供的位置排布标签，否则沿数据视图框下面条边等距排布标签。
`axisXLabelsStyle`	SuperMap.Feature.ShapeParameters.Label.style		x 轴上的标签组样式。
`axisXLabelsOffset`	Array.<number>		x 轴上的标签组偏移量。长度为 2 的数组，数组第一项表示 x 轴标签组横向上的偏移量，向左为正，默认值：-10；数组第二项表示 x 轴标签组纵向上的偏移量，向下为正，默认值：10。
`useXReferenceLine`	boolean		可选是否使用水平参考线，如果为 true，在 axisYTick 大于 0 时有效，水平参考线是 y 轴刻度在数据视图框里的延伸。
`xReferenceLineStyle`	SuperMap.Feature.ShapeParameters.Line.style		可选水平参考线样式。
`axis3DParameter`	number	20	可选 3D 坐标轴参数，此属性值在大于等于 15 时有效。
`barFaceStyle`	SuperMap.Feature.ShapeParameters.Polygon.style		3d 柱状图柱条正面基础 style，此参数控制柱条正面基础样式，优先级低于 barFaceStyleByFields 和 barFaceStyleByCodomain。
`barFaceStyleByFields`	Array.<SuperMap.Feature.ShapeParameters.Polygon.style>		可选按专题字段 themeFields（<SuperMap.Layer.Graph.themeFields>）为柱条正面赋 style，此参数按字段控制柱条正面样式，优先级低于 barFaceStyleByCodomain，高于 barFaceStyle。此数组中的元素是样式对象。此参数中的 style 与 themeFields 中的字段一一对应。例如： themeFields（<SuperMap.Layer.Graph.themeFields>）为 ["POP_1992", "POP_1995", "POP_1999"],barFaceStyleByFields 为[style1, style2, style3]，则在图表中，字段 POP_1992 对应的柱条正面使用 style1，字段 POP_1995 对应的柱条正面使用 style2 ，字段 POP_1999 对应的柱条正面使用 style3。
`barFaceStyleByCodomain`	Array.<Object>		可选按柱条正面代表的数据值所在值域范围控制柱条正面样式，优先级高于 barFaceStyle 和 barFaceStyleByFields。
`barSideStyle`	SuperMap.Feature.ShapeParameters.Polygon.style	barFaceStyle	可选 3d 柱状图柱条侧面基础 style，此参数控制柱条侧面基础样式，优先级低于 barSideStyleByFields 和 barSideStyleByCodomain。
`barSideStyleByFields`	Array.<SuperMap.Feature.ShapeParameters.Polygon.style>		可选按专题字段 themeFields（<SuperMap.Layer.Graph.themeFields>）为柱条侧面赋style，此数按字段控制柱条侧面样式，优先级低于 barSideStyleByCodomain，高于 barSideStyle。此数组中的元素是样式对象。此参数中的 style 与 themeFields 中的字段一一对应。例如： themeFields（<SuperMap.Layer.Graph.themeFields>）为 ["POP_1992", "POP_1995", "POP_1999"],barSideStyleByFields 为[style1, style2, style3]，则在图表中，字段 POP_1992 对应的柱条侧面使用 style1，字段 POP_1995对应的柱条侧面使用style2，字段POP_1999对应的柱条侧面使用style3。默认值：barFaceStyleByFields。
`barSideStyleByCodomain`	Array.<Object>	barFaceStyleByCodomain	可选按柱条侧面代表的数据值所在值域范围控制柱条侧面样式，优先级高于 barSideStyle 和 barSideStyleByFields。
`barFaceHoverStyle`	Object		可选 3d 柱条正面 hover 状态时的样式，barHoverAble 为 true 时有效。
`barSideHoverStyle`	Object	barFaceHoverStyle	可选 3d 柱条侧面 hover 状态时的样式，barHoverAble 为 true 时有效。
`barTopHoverStyle`	Object	barFaceHoverStyle	可选 3d 柱条顶面 hover 状态时的样式，barHoverAble 为 true 时有效。
`barHoverAble`	boolean	true	可选是否允许柱条使用 hover 状态。同时设置 barHoverAble 和 barClickAble 为 false，可以直接屏蔽柱条对专题图层事件的响应。
`barClickAble`	boolean	true	可选是否允许柱条被点击。同时设置 barHoverAble 和 barClickAble 为 false，可以直接屏蔽柱条对专题图层事件的响应。
`barTopStyle`	SuperMap.Feature.ShapeParameters.Polygon.style	barFaceStyle	可选 3d 柱状图柱条顶面基础 style，此参数控制柱条顶面基础样式，优先级低于 barTopStyleByFields 和 barTopStyleByCodomain。
`barTopStyleByFields`	Array.<SuperMap.Feature.ShapeParameters.Polygon.style>	barFaceStyleByFields	可选按专题字段 themeFields（<SuperMap.Layer.Graph.themeFields>）为柱条顶面赋 style，此参数按字段控制柱条顶面样式，优先级低于 barTopStyleByCodomain，高于 barTopStyle。此数组中的元素是样式对象。此参数中的 style 与 themeFields 中的字段一一对应。例如： themeFields（<SuperMap.Layer.Graph.themeFields>）为 ["POP_1992", "POP_1995", "POP_1999"],barTopStyleByFields 为[style1, style2, style3]，则在图表中，字段 POP_1992 对应的柱条顶面使用 style1，字段 POP_1995 对应的柱条顶面使用 style2 ，字段 POP_1999 对应的柱条顶面使用 style3。
`barTopStyleByCodomain`	Array.<Object>	barFaceStyleByCodomain	可选按柱条顶面代表的数据值所在值域范围控制柱条顶面样式，优先级高于 barTopStyle 和 barTopStyleByFields。

Class: Bar3D

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

Examples

Extends

Members

chartBoundsSuperMap.Bounds

chartBoxArray.<number>

dataObject

dataValuesArray.<number>

dataViewBoxArray.<number>

DVBCenterPointArray.<number>

DVBCodomainArray.<number>

DVBHeightnumber

DVBOrigonPointArray.<number>

DVBParameterArray.<number>

DVBUnitValuestring

DVBWidthnumber

fieldsArray.<string>

heightnumber

idstring

layerSuperMap.Layer.Theme

locationArray

lonlatSuperMap.LonLat

origonPointArray.<number>

origonPointOffsetArray.<number>

RelativeCoordinateboolean

settingObject

shapeFactorySuperMap.Feature.ShapeFactory

shapeParametersObject

shapesArray

widthnumber

XOffsetnumber

YOffsetnumber

Methods

assembleShapes()

calculateXShapeInfo(){Object}

Returns:

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

Returns:

inherited destroy()

inherited getLocalXY(lonlat)

Returns:

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

Returns:

inherited resetLinearGradient()

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

Returns:

inherited shapesConvertToRelativeCoordinate()

Type Definitions

SuperMap.Feature.Theme.Bar3D.settingObject

Properties: