What is the meaning of each configuration items when selecting the full amount of 3D ring diagram - DataV

This topic describes the meaning of each configuration items when you select a full 3D loop.

Chart style

A 3D circle chart is a type of pie chart, which can clearly and intelligently display the proportion of each category in the circle. 3D ring charts support label display at multiple locations inside and outside the chart, support indicator card display style display, and support custom multi-series data configuration.

Style Panel

Search Configuration: Click the Search configuration items icon in the upper-right corner of the Style panel. In the Search Configuration panel, enter the name of the configuration items that you want to search for and locate the configuration items. Fuzzy match is supported. For more information, see Search configuration items.
- Size: the width and height of the widget. Unit: pixels.
- Positioning: the x-axis and y-axis of the component. Unit: pixels. X-coordinate indicates the pixel distance between the upper-left corner of the widget and the left border of the canvas. Y-coordinate indicates the pixel distance between the upper-left corner of the widget and the upper border of the canvas.
- Rotate: The widget is rotated around the center of the widget. Unit: degrees.
  - Directly enter the degrees in the Rotation Angle spin box or click the plus sign (+) or minus sign (-) to increase or decrease the value in the Rotation Angle spin box.
  - Click the icon to flip the widget style.
  - Click the icon to flip the widget style.
- Opacity: Valid values: 0 to 1. If this parameter is set to 0, the widget is hidden. If this parameter is set to 1, the widget is completely displayed. Default value: 1.

Graphics

Projection Mode: the projection mode of the 3D loop. You can select Perspective Projection or Orthogonal Projection.
Visual Distance: the distance between the 3D visuals of the ring. It is used to adjust the overall size of the ring. Unit: px.
Rotation Angle: the angle between horizontal rotation and vertical rotation. Click the icon to control the display of the rotation angle.
Note
When the rotation angle is turned on, it has an effect on rotation in mouse interactions.
Inner /Outer Diameter Ratio: Drag the slider to set the inner /outer diameter ratio of the loop graph.
Height Mapping: specifies the height mapping of the 3D ring graph. When the height mapping switch is turned on, the height of each part of the ring graph is mapped based on the value in the data. When the height mapping switch is turned off, the height of each part of the ring graph is equal.
Height Scale: the height scale of the 3D loop.
Color: Set the color of the 3D circle. For more information, see Color mapper.
Decimal Merge: Limits the number of slices to be displayed and merges the remaining slices into a total slice. You can also set the name of the merged category. Click the icon to turn decimal consolidation on or off.

Ring Chart Labeling: the labeling style of the ring chart. Click the 开关图标 icon to control the configuration items of the ring chart label.

Metric	description
Type	The data type and display type of the annotation. Valid values: Percentage and Default. Valid values: Common and Spider. Note If the number of data entries exceeds three, we recommend that you change the value of the Display Type parameter to Normal.
Labeling Field	The label field of the ring diagram. Validation values: name + value, name, and value.
Delimiter	Set the delimiter of the ring icon column. Enter br to break a line. This parameter is available only when you set the Name + Value parameter for the column field of the ring chart.
Decimal Places	The decimal place of the label field. Unit: digits.
Row Height	The row height value of the label field. Unit: px. This parameter is available only when you set the Name + Value parameter for the column field of the ring chart.
Spacing	Set the distance between the label field and the ring chart. The unit is px.
Text Style	The text style of the column field, including the font style, text weight, font size, and color.

Animation: the animation style of the 3D loop.
- Auto Rotate: If you turn on the switch, the ring diagram automatically rotates. If you turn off the switch, the ring diagram does not rotate.
  Note
  You can set the Auto Rotate type to Normal.
- Rotation Direction: specifies the rotation direction of the 3D loop. Valid values: Counterclockwise and Clockwise. This parameter is available only when Auto Rotate is turned on.
- Rotation Speed: specifies the rotation speed of the 3D loop. This parameter is available only when the Auto Rotation switch is turned on.

Interaction

Mouse Interaction: You can use the mouse to perform multiple operations, such as rotate, zoom, and zoom in or zoom in. The rotate and zoom operations are supported only when the annotation type is standard.

dialog box: On the preview or publish page, the style of the dialog box that appears when you move the pointer over or click the ring chart. Click the 开关图标 icon to control the display and concealment of the dialog box configuration items.

Metric	description
Trigger	The method by which the dialog box is triggered. You can select Hover or Click.
Display Position	The position style of the dialog box display. Valid values: Up, Down, Left, and Right.
Title Spacing	The spacing between titles in the dialog box. Unit: px.
Title Text	The style of the title text in the dialog box, including the font style, weight, font size, and color.
Content Text	The style of the content text in the dialog box, including the font style, text weight, font size, and color.
Pop-up background	dialog box pop-up background style. Background Margin: dialog box the horizontal and vertical margins of the pop-up background. Background Color: The background color of the dialog box. Border Style: the style of the dialog box border, including the width and color of the border lines.

Legend: the legend style of the ring chart.

Metric	description
Legend Switch	If you turn on the switch, you can configure the legend style. If you turn off the switch, you cannot configure the legend style.
Direction	The orientation of the legend. Valid values: Horizontal and Vertical.
Horizontal Alignment	The horizontal alignment of the legend. Valid values: Left, Center, and Right.
Vertical Alignment	The vertical alignment of the legend. Valid values: Top, Center, and Bottom.
Text Style	The font style, text weight, font size, and color of the legend text.
Category Legend	The style of the sub-type legend. Legend Marker: the size and shape of the legend marker. Legend Spacing: the horizontal and vertical distance between the legends of different categories.
Allow Page Turning	Turn on the switch to turn the legend page feature. You can configure the page number style and arrow style when the number of legends is too large. If you turn off the switch, all the legend content is displayed on one page and cannot be turned. Page Style: the style of the page number, including the font, weight, font size, and color of the page number. Arrow Style: the size, default color, and disabled color of the arrows in the page-turning style.

Effects: displays the shading effect of 3D graphics.

Metric	description
Light and Shadows	Optional. You can select Show Color Only or Shading.
Lighting effect	This parameter is displayed when you set Shading Effect to Shading Effect. Main light source: Set the light intensity, light color, horizontal and vertical rotation, projection and shadow quality of the main light source. Ambient Light: Sets the light intensity and light color of the main light source.
Late Effect	Sets the post effect for 3D graphics. Highlights: Sets the intensity of the glow for highlights in Post Effects. Depth of field: Sets the size of the depth of field in the post effect and the blur radius.

Condition: the description of the condition style.
Conditional Style: Click the or icon to add or remove a conditional style. Click the or icon to configure the arrangement style of multiple conditional styles. Click the icon to copy the current conditional style configuration and add a conditional style with the same configuration. For more information about how to configure a conditional style, see Use conditional trees.
Fan Color: If you turn on the switch, you cannot configure the fan color of the condition. If you turn off the switch, you cannot configure the fan color of the condition.

Data Sources panel

Column	Description
`name`	The category of each ring block.
`value`	The value of each ring block determines the percentage of each 3D ring block to the entire 3D ring diagram.

Configure data items	Description
Data sources	You can use the code editor or visual editor to view the data fields contained in the widget. You can also modify the data type to flexibly configure the component data.
Data Mapping	If you need to customize chart field configurations, you can set different field mapping content in the Data Mapping module and field mapping these content to the corresponding fields of the widget. This allows you to match data without modifying the fields in the data source. You can also click the icon to configure the field style.
Configure a filter	Turn on Filter, select an existing data filter or create a data filter, and configure a data filter script to filter data. For more information, see Manage data filters.
Data Response Result	The Data Response Result section displays widget data in real time. If the data source of the widget changes, this section displays the latest data. If the system response is delayed, you can click the icon on the right to view the data response result. You can also click the icon on the right to obtain the latest data of the widget. You can also click View Example to view an example of the response result of the current component.
Forbid Loading	If you select the check box, you will not see the loaded content during component initialization when you update the component and preview the data kanban. If you select the check box, the opposite is true. By default, the status is deselected.
Controlled Mode	If you select the check box, the component does not request data in the initialized state, and only requests data by using global variables or the method configured in Blueprint Editor. If you clear the check box, you can use automatic update to request data. By default, the status is deselected.
Auto Data Request	Select the check box to manually enter the time frequency of polling to set dynamic polling. If you clear the page, the page is not automatically updated. You need to manually refresh the page or use Blueprint Editor and global variable events to trigger a request to update data.

Advanced Panel

Metric	description
When you click the ring chart	Turn on the switch to enable the widget interaction feature. When the ring block of the 3D ring chart is clicked, a data request is triggered, and temporary variables are thrown to dynamically load the data of different sectors. By default, the `name` and `value` values in the data are thrown. For more information, see Component interaction configuration.
When the legend is clicked	Turn on the switch to enable the widget interaction feature. When you click the legend of a 3D ring chart, a data request is triggered, a temporary variable is thrown, and data of different legends is dynamically loaded. By default, the `name` and `checked` values in the data are thrown. For more information, see Component interaction configuration.

Blueprint Interaction

Click the icon in the upper-left corner to go to the Blueprint page.
On the Layer Nodes tab, add the widget to the main canvas.

View blueprint configuration parameters.

Event

Event	Description
When the 3D loop interface request is completed	The event is triggered with the processed JSON data after a data interface request is responded and processed by a filter. For more information about specific data examples, see the Data Response Result section of the Data Source tab in the right-side configuration panel of the canvas editor.
When you click the ring chart	The event that is raised when the ring block of the 3D ring graph is clicked, and the data item corresponding to the sector is also raised.
When the legend is clicked	The event that is raised when the legend of a 3D ring chart is clicked, and the corresponding data item of the legend is also raised.

Action

Action	Description
Import 3D loop	After data of a widget is processed in accordance with its drawing format, the widget is imported for redrawing. You do not need to request server data again. For more information about specific data examples, see the Data Response Result section of the Data Source tab in the right-side configuration panel of the canvas editor.
Request a 3D loop	This action is performed to request the server data again. The data sent by an upstream data processing node or layer node is used as a parameter. For example, if the API data source is `https://api.test` and the data transferred to the request 3D loop interface is `{ id: '1'}`, the final request interface is `https://api.test?id=1`.
Move	Move a widget to a specified location. For more information, see the data example. `{ // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. "positionType": "to", // The location, which is indicated by the x and y coordinates. "attr": { "x": 0, "y": 0 }, // The animation type. "animation": { "enable": false, // The animation delay. Unit: milliseconds. "animationDuration": 1000, // The animation curve, which can be set to linear\|easeInOutQuad\|easeInOutExpo. "animationEasing": "linear" } }`
Switch Display /Display	Specifies whether to show or hide a widget. No parameters are required.
Display	Display the widget. For more information, see Data example. `{ "animationType": "",// The animation method. Valid value: fade. If you do not specify this parameter, no animation is generated. "animationDuration": 1000,// The animation delay. Unit: ms. "animationEasing": ""// animation curve }`
Hide	Hide the component. For more information, see Data example. `{ "animationType": "",// The animation method. Valid value: fade. If you do not specify this parameter, no animation is generated. "animationDuration": 1000,// The animation delay. Unit: ms. "animationEasing": ""// animation curve }`
Update component configurations	Style configurations of widgets are dynamically updated. In the Style panel, click Copy Configuration to Clipboard to obtain the configuration data of the widget. After that, change the style field for the data processing node in Blueprint Editor.