Skip to main content

FAQ

FAQ 1: How to adjust the margin between the axis and the background?

Grid conponent,which can adjust the left, right, up, down margins of chart.

FAQ 2: How to play agian the fadeIn animation?

call the chart.AnimationReset() API.

FAQ 3: How to customize the color of data item in line chart and pie chart?

Theme->colorPalette, or the sub component LineStyle and ItemStyle of Serie.

FAQ 4: How to formatter the text of axis label, such as add a units text?

Adjust formatter and numericFormatter parameter of Legend, AxisLabel, Tooltop, SerieLabel.

FAQ 5: How to stack the bar of bar chart?

Set the stack parameter of Serie, the series will stack in a bar with the same stack.

FAQ 6: How to make the bar serie in the same bar but not stack?

Set the barGap of Serie to -1stack to null.

FAQ 7: How to adjust the bar width and gap of barchart?

Adjust the barWidth and barGap parameter of Serie, the last serie's barWidth and barGap are valid when multiple serie.

FAQ 8: How to adjust the color of bar?

Adjust the ItemStyle of Data in inspector.

FAQ 9: Can I adjust the anchor of chart?

Yes, you can set any one of 16 anchors but the value use default.

FAQ 10: Can display more than 1000 data?

Yes. But UGUI limits 65000 vertices to a single Graphic, so too much data may not be displayed completely. The sampling simplification curve can be turned on by setting the sampling distance sampleDist. You can also set some parameters to reduce the number of vertices in the chart to help show more data. Such as reducing the size of the chart, close or reduce the axis of the client drawing, close Symbol and Label display. A Normal line chart occupies fewer vertices than a Smooth line chart. The 1.5.0 and above versions can set large and largeThreshold parameters to enable performance mode.

FAQ 11: Can line chart drawing be dash, dot and dash-dot?

Yes. Adjust the lineType of Serie.

FAQ 12: How to limit the value range of the Y-axis?

Select the minMaxType of Axis as Custom, then set min and max to the values you want.

FAQ 13: How to customize the tick value range of value axis?

By default, it is automatically split by the splitNumber of Axis. Also, you can customize the interval to the range you want.

FAQ 14: How to display text at the top of data items?

Adjust the Label of Serie.

FAQ 15: How do I customize icons for data items?

Set the Icon of Data in Serie.

FAQ 16: How to anti-aliasing and make the chart smoother?

Open the Anti-Aliasing setting in Unity. Selected the UI Canvas Render Mode as Screen Space-Camera, selected MSAA, set 4 times or higher anti-aliasing. The sawtooth can only be reduced and unavoidable. The higher the pixel, the less obvious the sawtooth is.

FAQ 17: Why does mouse over chart Tooltip not show?

Verify Toolip is opened. Verify that the parent node of chart has turned off mouse events.

FAQ 18: How not to display the bar line of Tooltip?

Set the type of Tooltup as None. Or adjust the parameters of lineStyle.

FAQ 19: How do I customize the display of Tooltip?

See the formatter, itemFormatter, titleFormatter parameters of Tooltip.

FAQ 20: How do I get the Y-axis to display multiple decimal places?

Set the numericFormatter parameter of AxisLabel.

FAQ 21: How do I dynamically update data with code?

See example: Example01_UpdateData.cs

FAQ 22: How to display legend? Why are legends sometimes not displayed?

First, the name in Serie must have a value that is not null. Then set Legend is show, where data can be empty by default, indicating that all legends are displayed. If you only want to display part of the Serie legend, fill in data with the name of the legend you want to display. If none of the values in data are name of the series, the legend will not be displayed.

FAQ 23: How to make chart as prefab?

Before make prefab, please delete all sub gameObject under chart which auto-created by XCharts.

FAQ 24: How do I draw custom graphic in chart,such as line or dot?

Implement onCustomDraw of chart, see Example12_CustomDrawing.cs.

FAQ 25: How to achieve similar data movement effect of ELECTRO cardiogram?

See Example_Dynamic.cs.

FAQ 26: How do I use the background component? What are the conditions?

Setting show to true for the background component.

FAQ 27: Mesh can not have more than 65000 vertices?

This is the limit of UGUI on the number of vertices for a single Graphic. XCharts is draw chart on a single Graphic, so there is also this limitation. The solution can be referred to: FAQ 10: Can display more than 1000 data?

FAQ 28: Why are the parameters set in Serie reset after they run?

Check whether RemoveData() and add new Serie in the code. If you want to keep the configuration of Serie, you can only ClearData() which just clear data and then readd the data to the old serie.

FAQ 29: How to change the color of serie symbol?

The color of 'Symbol' is the color of 'ItemStyle' used.

FAQ 30: How to deal with TMP errors when importing or updating XCharts?

XCharts does not enable TMP by default, so there are no references to TMP on asmdef. This issue may occur when updating XCharts after TMP is enabled locally. It can be solved in the following two ways:

  1. Find XCharts.Runtime.asmdef and XCharts.Editor.asmdef and manually add references to TextMeshPro
  2. Remove the dUI_TextMeshPro macro for Scripting Define Symbols in PlayerSetting

Version 3.8.0 after adding Daemon XCharts - Daemon, will be XCharts - Daemon import project, When updating XCharts, the daemon automatically refreshes the asmdef based on the locally enabled TMP to ensure proper compilation.

FAQ 31: Support empty data? How to achieve the effect of line chart disconnection?

data of Serie is of type double, so it cannot represent empty data. Empty data can be achieved by turning on Serie's ignore and specifying ignoreValue. You can also set the ignore parameter for each SerieData. The ignoreLineBreak parameter can be set to disconnect or connect after ignoring data.

FAQ 32: 2.x What are the common problems when upgrading version 3.x?

  1. XCharts.Runtime.XChartsMgr is missing the class attribute ExtensionOfNativeClass! 3.x version does not need to mount XChartsMgr, directly delete the _xcharts_ node on the scene.

FAQ 33: How to display a line chart without white space on both sides and start from the 0 coordinate?

Set the boundaryGap parameter of the X-axis.

FAQ 34: How to set some Series not to display Tooltips?

Setting the itemFormatter of itemStyle in serie to '-' can ignore tooltip.

FAQ 35: Sometimes an overlapping line appears in the area line chart when using semi-transparent colors

This is a bug in the drawing of the area line chart. You can use light opaque colors instead of semi-transparent colors.