|
Good Question! The answer is - we don't know! However SciChart does.
Starting with SciChart v2.0, the Rendering Loop has been modified to output debug information to the console window.
How to Enable SciChart Console Debugging
Note that debug information is only outputted when a Debugger is attached. You will need to set the following property if you want to see debug information in the console window of Visual Studio:
var sciChartSurface = new SciChartSurface();
sciChartSurface.DebugWhyDoesntSciChartRender = true; // Default is false. Turn debug output on here
Troubleshooting Steps
Typical reasons why SciChart doesn't render and their possible solutions include:
| Renderer Debug Message |
Solution |
| Because none of the SciChartSurface.RenderableSeries has a DataSeries assigned |
Please ensure that at least one of the RenderableSeries has a DataSeries. See the SciChartSurface.RenderableSeries and RenderableSeries.DataSeries properties |
| Because the SciChartSurface.RenderableSeries collection is null or empty |
Please ensure that you have a not null or empty SciChartSurface.RenderableSeries collection |
| Because the SciChartSurface.RenderSurface is null |
Please ensure that the SciChartSurface.XAxes and SciChartSurface.YAxes properties have been set, e.g. check for binding errors if using MVVM. |
| Because the SciChartSurface has not YAxes. |
Please ensure that SciChartSurface.YAxis is set, or SciChartSurface.YAxes has at least one axis. |
| Because the SciChartSurface has no XAxes. |
Please ensure the SciChartSurface.XAxis is set, or the SciChartSurface.XAxes has at least one axis. |
| Because the SciChartSurface Viewport Size is not valid (e.g. 0 sized) |
This shouldn't happen, but if it does, please ensure that the chart has a non-zero size. If you are really stuck, contact us |
| Because the VisibleRange on one or more X or Y Axes is null, zero, or undefined |
Please see the documentation article on AutoRange. SciChart's default mode will try to AutoRange once when the chart is first rendered. If there is no data, it won't be able to form a valid VisibleRange. Also this error can occur if you set the Axis.VisibleRange equal to null, or an undefined range. |
Exceptions during Render
SciChart also outputs exceptions that occur in the RenderLoop to the console window. Under normal operation, there shouldn't be any exceptions, but if you notice an unusual slowdown in performance, or the chart is blank or partially drawn, turn on the DebugWhySciChartDoesntRender feature and check the console output window in Visual Studio.
Further Reading
For more information, please find a set of Troubleshooting articles in the SciChart documentation:
| 
(6 vote(s))
Helpful
Not helpful