Class: Pie3DSeries

Pie3DSeries

new Pie3DSeries()

Pie3DSeries 클래스는 Pie3DChart 클래스 인스턴스의 series 속성에 설정됩니다.

차트에 설정된 데이터를 처리하고 3D 파이를 표현합니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

<rMateChart>
  <Options>
    <Caption text="Annual Report" />
  </Options>
  <Pie3DChart showDataTips="true">
    <series>
      <Pie3DSeries field="Profit" nameField="Month" />
    </series>
  </Pie3DChart>
</rMateChart>

Extends

Members

alwaysShowInsideLabelBoolean

labelPosition 속성값이 inside 인 경우 라벨(수치값)을 항상 표시할 지 여부를 설정합니다.

Default Value:
  • false

assignedRadiusRatioNumber

활용 가능한 공간 대비 표현되는 파이의 크기에 대한 비율을 설정합니다.

Default Value:
  • 1

calloutGapNumber

labelPosition 속성값이 callout 또는 insideWithCallout 일 때 차트와 라벨간의 여백 값을 설정합니다.

Default Value:
  • 10

calloutLabelRollOverVisibleNumber

LabelPosition이 callout인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성

Default Value:
  • 8

calloutModeString

수치 라벨이 표시될 슬라이스 공간이 충분하지 않을 경우, 표시하는 방식을 설정합니다.

labelPosition 속성값이 inside 또는 insideWithCallout 일 경우에 적용됩니다.

유효값은 다음과 같습니다.


  • area - 라벨을 표시하기 위한 슬라이스 공간이 충분하지 않을 경우 라벨을 바깥쪽에 표시합니다.

  • label - 라벨들이 서로 겹치게 될 경우 라벨을 바깥쪽에 표시합니다.

Default Value:
  • area

calloutTypeString

차트 외부에 라벨을 표시하고 해당되는 슬라이스를 선으로 연결할 때(callout) 라벨의 위치를 설정합니다.

유효값은 edge, around 입니다.

Default Value:
  • edge

depthNumber

원통의 깊이를 설정합니다.

Default Value:
  • 20

displayNameString

시리즈의 이름을 설정합니다.

설정된 값은 기본적으로 데이터 팁(툴팁)에서 보여지게 되고 범례의 항목으로 표시됩니다.

Default Value:
  • null

elevationNumber

원통의 기울기 각도를 설정합니다.

유효값은 -90 도에서 90 도까지 입니다.

Default Value:
  • 70

explodableBoolean

파이 차트 클릭 시 클릭된 슬라이스를 팝업 형태로 표시할 지 여부를 설정합니다.

Default Value:
  • true

fieldString

차트에서 사용될 데이터 중에서 슬라이스의 크기에 해당하는 데이터 필드명을 설정합니다.

Default Value:
  • null

fillObject

시리즈 아이템렌더러의 채우기 색을 설정합니다.

Default Value:
  • null

fillsArray

차트에 표시되는 데이터가 여러개 일 때, 각 데이터에 서로 다른 색상을 설정합니다.

만약 데이터 수만큼의 색상 객체(SolidColor)가 설정되지 않으면 설정된 색상이 반복 적용됩니다.

예를 들어, 시리즈의 데이터 수가 10 이고 5 개의 색상 객체(SolidColor)가 설정되었다면, 5 개의 색상 객체가 처음 5 개의 데이터에 순서대로 적용되고 나머지 5 개의 데이터에는 5 개의 색상 객체가 다시 순차적으로 적용됩니다.

유효값은 SolidColor 클래스의 인스턴스 배열입니다.

<fills>
  <SolidColor color="0xCC66FF" />
  <SolidColor color="0x9966CC" />
  <SolidColor color="0x9999CC" />
</fills>
Default Value:
  • null

formatterObject

숫자값을 원하는 숫자(통화, 날짜) 형식으로 표현하기 위한 포맷터(NumberFormatter, CurrencyFormatter, DateFormatter)를 설정합니다.

Default Value:
  • NumberFormatter

idString

식별자(Identifier)를 설정합니다.

식별자(Identifier)는 사용자에 의해 정의된 임의의 고유값입니다.

설정된 식별자(Identifier)를 통해 해당 객체에 접근이 가능합니다.

Default Value:
  • null

innerRadiusNumber

차트 중앙의 구멍(도넛 차트)의 크기를 설정합니다.

이 속성은 파이 차트의 전체 반지름 대비 중앙 원(구멍, hole) 반지름의 퍼센트 값입니다.

도넛 차트를 만들기 위해서 이 속성을 사용할 수 있습니다.

유효값은 0 과 1 사이의 값입니다.

Default Value:
  • 0

innerStackBoolean

이 속성을 true 로 설정하면 바깥쪽 파이가 원통 모양으로 표현되지 않고, 안쪽 파이와 같은 높이로 표현됩니다.

Default Value:
  • false

innerStackRatioNumber

스택형태로 데이터 시리즈들이 표현될 때 설정된 값만큼 데이터 시리즈 사이의 공간을 설정합니다.

Default Value:
  • 0

insideLabelRatioNumber

라벨의 위치를 설정합니다. 파이 차트의 중심에서 가장자리까지의 거리를 1에 대한 비율로 설정합니다.

labelPosition 속성값이 inside 인 경우만 적용됩니다.

Default Value:
  • 0.7

insideLabelRollOverVisibleNumber

LabelPosition이 inside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성

Default Value:
  • 8

insideWithCalloutCompareAreaNumber

이 속성에 설정된 값 이상의 여유 공간이 없으면 라벨에 대한 callout 을 수행합니다.

Default Value:
  • 0

interactiveBoolean

시리즈에 마우스 오버시 데이터 팁을 보여줄 지 여부를 설정합니다.

Default Value:
  • true

itemRollOverColorHexadecimal

데이터 아이템에 마우스 오버했을 때의 색상을 설정합니다.

Default Value:
  • null

itemRollOverEmphasizeBoolean

데이터 아이템에 마우스 오버했을 때의 아이템을 강조합니다.

Default Value:
  • false

itemSelectionColorHexadecimal

데이터 아이템을 선택했을 떄의 색상을 설정합니다.

Default Value:
  • null

labelBackgroundColorString

라벨 배경의 색상을 설정합니다.

Default Value:
  • transparent

labelBorderRadiusNumber

라벨 테두리의 둥근 정도를 설정합니다.

Default Value:
  • 0

labelBoxHeightOffsetNumber

라벨 배경의 추가 높이값을 설정합니다.

Default Value:
  • 0

labelBoxWidthOffsetNumber

라벨 배경의 추가 너비값을 설정합니다.

Default Value:
  • 0

labelFieldString

차트에서 사용될 데이터 중에서 라벨로 표시될 데이터 필드명을 설정합니다.

Default Value:
  • null

labelPositionString

라벨(수치값)을 표시하는 방법을 설정합니다.

유효값은 다음과 같습니다.


  • none - 라벨을 표시하지 않습니다.

  • outside - 차트의 가장자리에 라벨을 표시합니다.

  • callout - 차트 외부에 라벨을 표시하고 해당되는 슬라이스를 선으로 연결합니다.

  • inside - 차트 내부의 해당 슬라이스에 라벨을 표시합니다.

  • insideWithCallout - 기본적으로 차트 내부의 슬라이스에 라벨을 표시하고, 만약 라벨이 겹치면 해당 슬라이스의 라벨은 callout 방법으로 표시합니다.

Default Value:
  • none

labelXOffsetNumber

labelPosition 속성에 설정된 라벨의 위치에서 가로위치(X축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

labelYOffsetNumber

labelPosition 속성에 설정된 라벨의 위치에서 세로위치(Y축 값)에 대한 오프셋(Offset) 값을 설정합니다. (픽셀 단위)

Default Value:
  • 0

nameFieldString

차트에서 사용될 데이터 중에서 범례의 라벨로 표시될 데이터 필드명을 설정합니다.

Default Value:
  • null

outerRadiusNumber

차트 외곽의 크기를 설정합니다.

이 속성은 파이 차트의 전체 반지름 대비 외곽 원 반지름의 퍼센트 값입니다.

도넛 차트를 만들기 위해서 이 속성을 사용할 수 있습니다.

유효값은 0 과 1 사이의 값입니다.

Default Value:
  • 1

outsideLabelRollOverVisibleNumber

LabelPosition이 outside인 라벨을 안보이게 만든 후, 마우스 롤 오버(rollover) 시에만 보이게 하는 속성

Default Value:
  • 8

perWedgeExplodeRadiusArray

차트가 최초에 생성될 때 팝업될 슬라이스를 설정합니다.

만약 2, 7 번째 슬라이스가 팝업되기를 원한다면 다음과 같이 설정합니다. perWedgeExplodeRadius="[0, 0.1, 0, 0, 0, 0, 0.1]"

Default Value:
  • null

radialStrokeObject

파이의 슬라이스를 구분하는 선(반지름 선)을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • null

renderDirectionString

차트의 각 슬라이스들이 생성되는 방향을 설정합니다.

유효값은 clockwise, counterClockwise 입니다.

Default Value:
  • clockwise

reserveExplodeRadiusNumber

explodable 속성값이 true 인 경우, 슬라이스가 팝업되는 영역을 미리 확보해 놓을지 여부를 설정합니다.

확보해 놓은 공간을 제외한 크기로 파이 차트가 생성됩니다.

팝업 공간을 확보해 놓음으로써, 차트를 클릭하여 특정 슬라이스가 팝업되더라도 차트의 전체 크기에는 변화가 없도록 하기위한 목적입니다.

유효값은 0 또는 0.1 입니다.

Default Value:
  • 0

selectableBoolean

마우스로 데이터를 선택 가능하도록 할 지 여부를 설정합니다.

Default Value:
  • true

showDataEffectObject

차트상에 데이터가 표현되는 모습을 보여줄 애니메이션 이펙트를 설정합니다.

유효값은 SeriesInterpolate, SeriesSlide, SeriesZoom 입니다.

Default Value:
  • null

sortFieldString

사용자가 데이터의 출력 순서를 변경하고자 할 경우 출력 순서에 대한 필드명을 설정합니다.

Default Value:
  • null

startAngleNumber

첫번째 아이템을 표현하는 시작 각도를 설정합니다.

차트의 중심에서 오른쪽 가로 방향(3시 방향)이 0 이고, 기본값(default)입니다.

Default Value:
  • 0

strokeObject

파이의 테두리 선을 설정합니다.

유효값은 Stroke 클래스 인스턴스입니다.

Default Value:
  • null

styleNameString

스타일을 <Style> 노드에 설정할 경우, <Style> 노드에 정의된 이름을 설정합니다.

<Style> 노드에 스타일을 정의할 때는 반드시 스타일명 앞에 마침표가 위치해야 합니다.

레이아웃은 다음과 같은 형식으로 작성됩니다.

<Bar3DChart>
  <Bar3DSeries xField="Profit" styleName="seriesStyle">
  ...
</Bar3DChart>
<Style>
  .seriesStyle {fontFamily:"Malgun Gothic";labelPosition:inside;fontSize:11;paddingTop:4;color:0x000099;}
</Style>
Default Value:
  • null

visibleBoolean

시리즈를 차트에 출력할 지 여부를 설정합니다.

Default Value:
  • true

zeroValueEnableBoolean

라벨(수치값)이 0 인 경우, 차트에 표현할 지 여부를 설정합니다.

Default Value:
  • false

Methods

inherited fillJsFunction(seriesId, index, data, values)

사용자 정의 색상을 설정하는 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 fillJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" fillJsFunction="fillJsFunc">
...
fillJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열

inherited htmlJsFunction(seriesId, index, data, values)

차트의 데이터 아이템들 중에서 설정된 조건을 만족하는 데이터 아이템에 대해서 실핼될 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 htmlJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" htmlJsFunction="userElementFunc">
...
userElementFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열

inherited labelJsFunction(seriesId, index, data, values)

파이 차트에서 labelPosition 속성을 설정한 경우, 사용자 정의 라벨(수치값)을 설정하는 자바스크립트 함수명을 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 labelJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Pie2DSeries field="Profit" nameField="Month" labelPosition="inside" labelJsFunction="pieSeriesLabelFunc">
...
pieSeriesLabelFunc(seriesId, index, data, values) {
  ...
}
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열
0 : 값, 1 : 퍼센티지, 2 : nameField

inherited strokeJsFunction(seriesId, index, data, values)

아이템 렌더러에 의해 표현되는 아이템 테두리에 대한 사용자 정의 함수를 설정합니다.

차트 레이아웃 설정시 Series 클래스 인스턴스의 strokeJsFunction 속성값에 자바스크립트 함수명을 설정합니다.

<Column2DSeries yField="Profit" strokeJsFunction="strokeJsFunc">
...
strokeJsFunc(seriesId, index, data, values) {
  ...
}

values 값은 배열로 전달되며 차트의 종류에 따라 다음과 같습니다.
1.  바 시리즈(Bar2DSeries, Bar3DSeries) - 0 : x축 값, 1 : y축 값
2.  컬럼 시리즈(Column2DSeries, Column3DSeries) - 0 : x축 값, 1 : y축 값
3.  영역 시리즈(Area2DSeries, CandleArea2DSeries) - 0 : x축 값, 1 : y축 값
4.  버블 시리즈(Bubble2DSeries, Bubble3DSeries) - 0 : x축 값, 1 : y축 값, 2 : radius 값
5.  라인 시리즈(Line2DSeries, CandleLine2DSeries) - 0 : x축 값, 1 : y축 값
6.  파이 시리즈(Pie2DSeries, Pie3DSeries) - 0 : 값, 1 : 퍼센티지, 2 : nameField 값
7.  캔들 시리즈(Candlestick2DSeries) - 0 : x축 값, 1 : openField 값, 2 : closeField 값, 3 : highField 값, 4 : lowField 값
8.  윙 시리즈(Column2DWingSeries, Bar2DWingSeries) - 0 : x축 값, 1 : y축 값, 2 : xOpp 값, 3 : yOpp 값
9.  히스토그램 시리즈(Histogram2D, Histogram3DSeries) - 0 : x축 값, 1 : y축 값
10. 트리맵 시리즈(TreeMapSeries) - 0 : weight 값, 1 : text 값
11. 박스플롯 시리즈(BoxPlotSeries) - 0 : upper 값, 1 : median 값, 2 : lower 값, 3 : min 값, 4 : hidden 값
12. 벡터 시리즈(Vector2DSeries) - 0 : degree 값, 1 : velocity 값, 2 : meter 값
13. 워드클라우드 시리즈(WordCloudSeries) - 0 : text 값, 1 : weight 값
14. 피라미드, 퓨넬 시리즈(Pyramid2DSeries) - 0 : weight 값, 1 : nameField 값
15. 오버레이버블 시리즈(OverlayBubbleSeries) - 0 : field 값, 1 : nameField 값
16. 이미지매트릭스 시리즈(ImageMatrixSeries) - 0 : value 값
17. 윈드로즈 시리즈(WindRoseSeries) - 0 : field 값
Name Type Description
seriesId String

시리즈 식별자(Identifier)

index Number

데이터 아이템의 인덱스

data Object

데이터 아이템의 데이터 객체

values Array

데이터 아이템의 데이터 배열