B
Error Messages

Cause: The timestamps in the array passed to the named method are not in ascending order. The first timestamp that is not in correct order is in element number in the array. This error can occur with the setXSeries( ), setYSeriesSparse( ), or setUserXLabel( ) method.

Action: Correct the timestamps in the array so that they are in ascending order.

Cause: The application tried to load two Y-axis series with the same name, string. This error can occur with the setYSeries( ), setHiLoCloseSeries( ), setOpenHiLoCloseSeries( ), or setCandlestickSeries( ) method.

Action: Verify the names of the series and correct the name in at least one call to the named method so that each call specifies a different series.

Cause: The application tried to load a subchart with the same name, string, as another subchart or another series.

Action: Verify the names of the subchart and the series and correct the name in at least one call so that each call specifies a different series.

Cause: The application invoked a display method such as drawBuffer( ) or paint( ) before invoking setXSeries( ).

Action: Invoke setXSeries( ) before invoking a method such as drawBuffer( ) or paint( ).

Cause: The application attempts to use the setYSeriesSparseAppend( ) method to append a sparse series to the named series, which is not a sparse series. You can use the setYSeriesSparseAppend( ) method to append data to another sparse series only.

Action: To append data to a non-sparse series, use the setYSeriesAppend( ) method.

Cause: The application attempted to change the orientation from HORIZONTAL. Once the orientation is set to HORIZONTAL, it cannot be changed. One of the ways that this error can occur is if you used the deprecated constant AxisChart.BAR_HORIZONTAL in the setSeriesGraphType( ) method, then set the orientation to vertical using the setChartOrientation(VERTICAL) method, which is the default.

Action: Correct the application, using only one type of chart orientation.

Cause: The application invoked the getImageMapCS( ) or getImageMapSS( ) method before it invoked the drawBuffer( ) method.

Action: Correct the application to invoke the drawBuffer( ) method before it invokes the getImageMapCS( ) or getImageMapSS( ) method.

Cause: The application defined an empty series, but did not define extents. For example, if the application defines a timestamp array for a named X-series with zero values and then adds data points in real time, the application must explicitly set extents.

Action: Either define a timestamp array with values or set extents using the setExtent( ) method or the setExtentMin( ) and setExtentMax( ) methods.

Cause: The end date specified in the setXSeries( ) method was earlier than the start date specified. The end date must be later than the start date.

Action: Modify either the start date or the end date so that the end date is later than the start date.

Cause: The extrusion thickness specified by the setExtrusionThickness( ) method is not within the allowable range. The extrusion thickness must be between 0.0 and .30.

Action: Correct the extrusion thickness, using a value between 0.0 and .30.

Cause: The first timestamp specified for the setYSeriesSparse( ) method is earlier than the first baseline timestamp, which was loaded by the setXSeries( ) method. The timestamps specified by the setYSeriesSparse( ) method must be within the range of the baseline timestamps.

Action: Correct the timestamps either in the array for the setYSeriesSparse( ) method or in the array of baseline timestamp so that the timestamps specified by the setYSeriesSparse( ) method are within the range of the baseline timestamps.

Cause: The first timestamp specified for the setYSeriesSparseAppend( ) method is earlier than the last existing sparse timestamp, which was loaded by the setYSeriesSparse( ) method. The timestamps specified by the setYSeriesSparse( ) method must be later than the existing sparse timestamps.

Action: Correct the timestamps either in the array for the setYSeriesSparseAppend( ) method or in the array of existing timestamps so that the timestamps specified by the setYSeriesSparseAppend( ) method are later than the existing sparse timestamps.

Cause: The application specifies an orientation type of HORIZONTAL but the graph type for the named series is not AxisChart.BAR. Horizontal orientation is supported only for bar charts.

Action: Either change the graph type to AxisChart.BAR by using the setSeriesGraphType( ) method or change the orientation to vertical using the setChartOrientation(VERTICAL) method, which is the default.

Cause: The constant for the axis identifier specified in the setChartAttributes( ) or getGridDesc( ) method is invalid. Valid values for setChartAttributes( ) are AxisChart.XAXIS, AxisChart.YAXIS, and AxisChart.XYAXIS. Valid values for getGridDesc( ) are AxisChart.XAXIS and AxisChart.YAXIS.

Action: Correct the axis identifier, using a valid identifier.

Cause: The bar style specified in the setBarStyle( ) method of the BarDesc descriptor in invalid. Valid values are STYLE_BASIC, STYLE_EFFECT3D, STYLE_DROP_SHADOW.

Action: Correct the bar style, using a valid value.

Cause: The frequency specified in the setXSeries( ) method is not valid. Valid frequencies are Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_MONTH, Calendar.HOUR, Calendar.MINUTE, and Calendar.SECOND.

Action: Correct the frequency, using a valid value.

Cause: The grid style specified as a parameter to the setGridStyle( ) method is invalid. Valid styles are GRID_LINE_SOLID, GRID_LINE_DASHED, and GRID_LINE_DASHED2.

Action: Correct the grid style parameter, using a valid style.

Cause: The justification type specified as a parameter to the setLabelJustify( ) method is invalid. Valid types are LABEL_LEFT_JUSTIFY and LABEL_RIGHT_JUSTIFY.

Action: Correct the justification type parameter, using a valid type.

Cause: The legend alignment specified as a parameter to the setLegendAlignment( ) method is invalid. Valid values for legends inside the plot area are Legend.NORTH, Legend.NORTHEAST, Legend.NORTHWEST, Legend.SOUTH, Legend.SOUTHEAST, Legend.SOUTHWEST, Legend.EAST and Legend.WEST.

Action: Correct the legend alignment parameter, using a valid value.

Cause: The legend alignment specified as a parameter to the setLegendAlignment( ) method is invalid. Valid values for legends in pie charts are Legend.DERIVED, Legend.NORTH, Legend.SOUTH, Legend.EAST, and Legend.WEST.

Action: Correct the parameter passed to the setLegendAlignment( ) method, using a valid value.

Cause: The legend alignment specified as a parameter to the setLegendAlignment( ) method is invalid. Valid values for legends outside the plot area are Legend.EAST and Legend.SOUTH.

Action: Correct the legend alignment parameter, using a valid value.

Cause: The line style specified in the setLineStyle( ) method of the LineDesc descriptor or in the setMarkerType( ) method of the MarkerDesc descriptor is invalid. Valid values for the setLineStyle( ) method are LINE_SOLID, LINE_DASHED, and LINE_DASHED2. Valid values for the setMarkerType( ) method are MARKER_NONE, MARKER_CIRCLE, MARKER_SQUARE, MARKER_DIAMOND, MARKER_PLUS, and MARKER_X.

Action: Correct the line type or marker type, using a valid value.

Cause: The marker type specified as a parameter to the setMarkerType( ) method is invalid. Valid markers are MARKER_NONE, MARKER_CIRCLE, MARKER_SQUARE, MARKER_DIAMOND, MARKER_PLUS, and MARKER_X.

Action: Correct the marker type parameter, using a valid type.

Cause: The pie style specified as a parameter to the setStyleType( ) method is invalid. Valid styles are BASIC, STYLE_EFFECT_3D, and STYLE_DROP_SHADOW. Note that, at this time, STYLE_DROP_SHADOW provides the 3-D effect.

Action: Correct the parameter to the setStyleType( ) method, using a valid parameter.

Cause: The time dimension specified as a parameter to the named method is invalid. Valid dimensions are TimeAxisDesc.SECOND, TimeAxisDesc.MINUTE, TimeAxisDesc.HOUR, TimeAxisDesc.DAY, TimeAxisDesc.MONTH, and TimeAxisDesc.YEAR. This error can occur with the getField( ), setField( ), setMinDimension( ), or setMaxDimension( ) method.

Action: Correct the time dimension parameter, using a valid dimension.

Cause: The application invoked the setSeriesAnnotations( ) method before the setXSeries( ) method. The setXSeries( ) method must be invoked first.

Action: Invoke the setXSeries( ) method before invoking the setSeriesAnnotations( ) method.

Cause: The last timestamp specified for the setYSeriesSparse( ) method is later than the last baseline timestamp. Baseline timestamps are loaded by the setXSeries( ) method. The timestamps specified by the setYSeriesSparse( ) method must be within the range of the baseline timestamps.

Action: Correct the timestamps either in the array for the setYSeriesSparse( ) method or in the array of baseline timestamps so that the timestamps specified by the setYSeriesSparse( ) method are within the range of the baseline timestamps.

Cause: The array of timestamps passed to the setSeriesAnnotations( ) method contains more timestamps than the array of timestamps passed to the setXSeries( ) method. The setSeriesAnnotations( ) method cannot contain more timestamps than the setXSeries( ) method.

Action: Modify the array of timestamps passed to the setSeriesAnnotations( ) method so that it does not include more timestamps than the setXSeries( ) method.

Cause: The length of the timestamp array is not equal to the length of the value array passed to the setYSeriesSparse( ) or setYSeriesSparseAppend( ) method.

Action: Correct the application so that the two arrays are equal in length.

Cause: The application attempted to append data using methods that are not compatible with the named existing series.

Action: To append data to a series with the LINE, AREA, or BAR graph type, use the setYSeries Append( ) method. To append data to a series with the OpenHigh-Low-Close graph type, use the setOpenHiLoCloseSeriesAppend( ) method. To append data to a series with the High-Low-Close graph type, use the setHiLoCloseSeriesAppend( ) method. To append data to a series with the Candlestick graph type, use the setCandlestickAppend( ) method.

Cause: The array of values passed to the setYSeriesAppend( ) method for the named series contains more values than the array of timestamps.

Action: Modify the arrays so that the array of values passed to the setYSeriesAppend( ) method does not contain more values than the array of timestamps.

Cause: The series index is a negative number. It must be equal to or greater than 0. This error can occur with the setSeries Highlight( ), setSeriesUnHighlight( ), or setSeriesAnnotation( ) method.

Action: Correct the index passed to the method, specifying a number equal to or greater than 0.

Cause: A timestamp in a sparse Y-axis array does not match the timestamp in the setXSeries.

Action: Correct the timestamp in the sparse Y-axis array to match the timestamps in the X-axis array.

Cause: The array of timestamps passed to the setSeriesAnnotations( ) or setXSeries( ) method contains no elements.

Action: Modify the array of timestamps passed to the setSeriesAnnotations( ) or setXSeries( ) method to include at least one timestamp.

Cause: The array of strings to be used as labels that was passed to the setXSeries( ) method contains no elements.

Action: Modify the array of strings passed to the setXSeries( ) method to include at least one string.

Cause: The parameter for the graph-type descriptor, such as AreaDesc, is null.

Action: Correct the application to pass a non-null parameter for the graph-type descriptor.

Cause: The graphics context in the buffered image is null. This error can occur for the drawBuffer( ) method.

Action: Make sure that the Graphics2D context in the buffered image is not null.

Cause: A null value was passed to the method. This error can occur with several methods, including setBarColor( ), setNegativeBarColor( ), and setPointLabelColor( ).

Action: Check your code to be sure that you are not passing a null value to this method.

Cause: A null pieSliceDesc descriptor was encountered. The array of pie slice descriptors must contain at least one descriptor. Each descriptor includes a label and a numeric value.

Action: Correct the application so that the array of pie slice descriptors contains at least one descriptor.

Cause: The array of timestamps passed to the setXSeries( ) or setYSeriesSparse( ) method contains a null value.

Action: Correct the array of timestamps passed to the setXSeries( ) or setYSeriesSparse( ) method so that it contains no null values.

Cause: The number of sparse timestamps loaded by the setYSeriesSparse( ) method cannot exceed the number of timestamps loaded by the setXSeries( ) method.

Action: Correct the number of timestamps loaded so that the timestamps loaded by the setYSeriesSparse( ) method does not exceed the number of timestamps loaded by the setXSeries( ) method.

Cause: The optional length parameter to the setYSeries( ) method is greater than the number of elements in the array of values passed to the method. It must be equal to or less than the number of elements in the array.

Action: Verify the number of elements in the array of values. Correct the length parameter so that is it equal to or less than the number of elements in the array.

Cause: The orientation parameter passed to the setChartOrientation( ) method was invalid. Valid values are HORIZONTAL and VERTICAL.

Action: Specify HORIZONTAL or VERTICAL as the parameter.

Cause: The Y-axis series contains an invalid value, a Double.NaN. A NaN is a special Not-a-Number value. A NaN value is used to represent the result of certain invalid operations such as dividing zero by zero.

Action: Correct the data loaded into the series so that it does not contain invalid values.

Cause: The arrays passed to the setHiLoCloseSeries( ) method are not the same length.

Action: Correct the high, low, and close arrays so that they are of equal length.

Cause: The arrays passed to the named method are not of the same length. This error can occur with the setOpenHiLoCloseSeries( ) or setCandlestickSeries( ) method.

Action: Correct the open, high, low, and close arrays so that they are of equal length.

Cause: The number of values, number1, in the array passed to the named Y-axis series is greater than the number of timestamps. The number of values for the Y-axis series must be equal to or less than the number of timestamps, number2. This error can occur with the setYSeries( ), setHiLoCloseSeries( ), setOpenHiLoCloseSeries( ), or setCandlestickSeries( ) method.

Action: Correct the number of values in the array passed to the named series so that it is equal to or less than the number of timestamps, number2.

Cause: The number of values, number1, in the array passed to the named Y-axis series is greater than the number of labels passed to the X-axis series. The number of values for the Y-axis series must be equal to or less than the number of X-axis labels, number2. This error can occur with the setYSeries( ), setHiLoCloseSeries( ), setOpenHiLoCloseSeries( ), or setCandlestickSeries( ) method.

Action: Correct the number of values in the array passed to the named series so that it is equal to or less than the number of X-axis labels, number2.

Cause: The series index is not within a valid range. This error can occur with the setSeries Highlight( ) or setSeriesAnnotation( ) method.

Action: Correct the application to specify a valid index.

Cause: The series name string, which was passed to the named method was not found in the application. This error can occur in several methods, including getSeriesColor( ), setSeriesColor( ), setSeriesPointLabels( ), setSeriesGraphic( ), and setSeriesWidth( ), setYSeries( ), and setYSeriesAxis2( ).

Action: Verify the name of the series and correct it in the call to the specified method.

Cause: The application called the setLabelInteriorVal( ) method, then it called the setDeriveLabelPct( ) method. These methods are incompatible. If the application invokes the setLabelInteriorVal( ) method, it can use the setDeriveLabelVal( ) method.

Action: Correct the application to call the setDeriveLabelVal( ) method.

Cause: The application called the setLabelInteriorPct( ) method, then it called the setDeriveLabelVal( ) method. These methods are incompatible. If the application invokes the setLabelInteriorPct( ) method, it can use the setDeriveLabelPct( ) method.

Action: Correct the application to call the setDeriveLabelPct( ) method.

Cause: The application called the named method before it called the setSeries( ) method. The setSeries( ) method must be called first. This error can occur with the getPieSliceDesc( ), getSliceIndex( ), getSliceEntered( ), or getSliceExited( ) method.

Action: Correct the application so that it calls the setSeries( ) method before the getPieSliceDesc( ), getSliceIndex( ), getSliceEntered( ), or getSliceExited( ) method.

Cause: The application called the setXSeries( ) method twice. It can be called only once.

Action: Remove the additional call from the application.

Cause: The application does not call the setXSeries( ) method.

Action: Modify the application to call the setXSeries( ) method.

Cause: The application called the setYAxisLabelsOff( ) method for a horizontal chart. This method can be used only with vertical charts.

Action: Either remove the call to the setYAxisLabelsOff( ) method or change the horizontal chart to a vertical one.

Cause: The application does not call the setYSeries( ) method or other Y-axis loading methods. It must call the setYSeries( ) method or other Y-axis loading methods.

Action: Modify the application to call the setHiLoCloseSeries( ), setOpenHiLoCloseSeries( ), setCandlestickSeries( ), or setYSeries( ) method.

Cause: The application attempted to shift more timestamps than the number of existing timestamps or reserved timestamps (specified by the setXSeriesReserve( ) method). Shifting timestamps removes the earliest timestamps and adds more recent timestamps.

Action: Correct the number of timestamps passed to the setXSeriesShift( ) method.

Cause: The slice index parameter passed to the getPieSliceDesc( ) method is not within the range of slice indexes for the chart.

Action: Verify the slice index and correct the parameter passed to the getPieSliceDesc( ) method.

Cause: The value of one or more of the slices is less than zero. You cannot use a negative value in a pie chart. The value of any slice must be zero or greater.

Action: Check your data to make sure that the value of all slices is zero or greater.

Cause: The subchart specified as a parameter to the named method does not exist. This error can occur for many methods, including setChartAttributes( ), setSubchartHeightFraction( ), setYAxisLabelsOff( ), setEnableImageMapCS( ), and setEnableImageMapSS( ).

Action: Make sure that the subchart has been created and that the method specified the correct subchart name.

Cause: Only one sparse timestamp can map to the same time axis interval. For example, if the setXSeries( ) method loads one date, such as 2001-03-01, for each month of the year 2001, you cannot load two sparse timestamps for any one month. In this example, you cannot load the dates 2001-03-05 and 2001-03-24.

Action: Either modify the array of dates loaded into the sparse series so that no more than one date falls into any interval loaded by the setXSeries( ) or modify the array loaded by the setXSeries( ) method so that it contains dates with smaller intervals.

Cause: In a horizontal chart, the setXSeries( ) method does not accept timestamps. It accepts only an array of strings as input.

Action: To create a chart that uses timestamps, the chart must have a vertical, not horizontal orientation. Set the chart orientation to vertical using the setChartOrientation(VERTICAL) method, which is the default.

Cause: The application attempted to load the Y-axis series before it loaded the X-axis series. The setXSeries( ) method must be invoked before the setYSeries( ) method (or other Y-axis-loading methods) or the setSeriesPointLabels( ) method.

Action: Invoke the setXSeries( ) method before loading the Y-axis series.

Cause: The timestamp array passed to the setYSeriesSparseAppend( ) method is zero in length. The array length must be greater than zero.

Action: Pass an array that has a length greater than zero to the setYSeriesSparseAppend( ) method.

Cause: The arrays of timestamps and annotations passed to the setSeriesAnnotations( ) method do not contain the same number of elements.

Action: Modify one or both arrays so that they contain the same number of elements.

Cause: The value of units specified in the setXSeries( ) method is not valid. The value must be greater than zero.

Action: Modify the value of the units parameter in the setXSeries( ) method so that it is greater than zero.

Cause: The array passed to the setYSeries( ) method is zero in length. The array length must be greater than zero.

Action: Pass an array that has a length greater than zero to the setYSeries( ) method.

Cause: The vanishing constant, which is the perspective distance specified by the setPerspectiveDistance( ) method, is not within the allowable range. The perspective distance must be greater than or equal to 1.0.

Action: Correct the perspective distance, using a value that is greater than or equal to 1.0.

Cause: The application attempted to call the setYSeries( ) method before it defined the X-axis labels. The X-axis labels must be defined and the X-axis series loaded before calling the setYSeries( ) method.

Action: Define the X-axis labels before calling the setYSeries( ) method.

Cause: The height or the width of the chart is specified as zero (0). The values must be greater than 0.

Action: Correct the height or the width of the chart.