net.sourceforge.chart2d
Class Chart2DProperties

java.lang.Object
  |
  +--net.sourceforge.chart2d.Properties
        |
        +--net.sourceforge.chart2d.Chart2DProperties

public final class Chart2DProperties
extends net.sourceforge.chart2d.Properties

A data structure for holding the properties common to all Chart2D charts. Chart2D charts are all capable of having a legend. Pass this to any number of Chart2D objects.


Field Summary
static boolean CHART_BETWEEN_CHART_AND_LEGEND_GAP_EXISTENCE_DEFAULT
          The default is true.
static int CHART_BETWEEN_CHART_AND_LEGEND_GAP_THICKNESS_MODEL_DEFAULT
          The default is 5.
static int CHART_DATA_LABELS_PRECISION_DEFAULT
          The default is MAX_INTEGER.
static int MAX_FLOAT
          The number is -38.
static int MAX_INTEGER
          The number is 38.
 
Constructor Summary
Chart2DProperties()
          Creates a Chart2DProperties object with the documented default values.
Chart2DProperties(net.sourceforge.chart2d.Chart2DProperties chart2DProps)
          Creates a Chart2DProperties object with property values copied from another object.
 
Method Summary
 boolean getChartBetweenChartAndLegendGapExistence()
          Gets whether the gap between the chart and the legend exists.
 int getChartBetweenChartAndLegendGapThicknessModel()
          Gets the thickness of the gap between the chart and the legend for the chart's model size.
 int getChartDataLabelsPrecision()
          Gets the look of labels that are supposed to describe the value of the data.
 boolean isFontNameExists(java.lang.String name)
          Returns true if the font name exists in the graphics enviornment.
 void setChart2DProperties(net.sourceforge.chart2d.Chart2DProperties chart2DProps)
          Sets all properties to be the values of another Chart2DProperties object.
 void setChart2DPropertiesToDefaults()
          Sets all properties to their default values.
 void setChartBetweenChartAndLegendGapExistence(boolean existence)
          Sets whether the gap between the chart and the legend exists.
 void setChartBetweenChartAndLegendGapThicknessModel(int thickness)
          Sets the thickness of the gap between the chart and the legend for the chart's model size.
 void setChartDataLabelsPrecision(int precision)
          Sets the look of labels that are supposed to describe the value of the data.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

MAX_INTEGER

public static final int MAX_INTEGER
The number is 38.

See Also:
Constant Field Values

MAX_FLOAT

public static final int MAX_FLOAT
The number is -38.

See Also:
Constant Field Values

CHART_DATA_LABELS_PRECISION_DEFAULT

public static final int CHART_DATA_LABELS_PRECISION_DEFAULT
The default is MAX_INTEGER.

See Also:
Constant Field Values

CHART_BETWEEN_CHART_AND_LEGEND_GAP_EXISTENCE_DEFAULT

public static final boolean CHART_BETWEEN_CHART_AND_LEGEND_GAP_EXISTENCE_DEFAULT
The default is true.

See Also:
Constant Field Values

CHART_BETWEEN_CHART_AND_LEGEND_GAP_THICKNESS_MODEL_DEFAULT

public static final int CHART_BETWEEN_CHART_AND_LEGEND_GAP_THICKNESS_MODEL_DEFAULT
The default is 5.

See Also:
Constant Field Values
Constructor Detail

Chart2DProperties

public Chart2DProperties()
Creates a Chart2DProperties object with the documented default values.


Chart2DProperties

public Chart2DProperties(net.sourceforge.chart2d.Chart2DProperties chart2DProps)
Creates a Chart2DProperties object with property values copied from another object. The copying is a deep copy.

Parameters:
chart2DProps - The properties to copy.
Method Detail

setChart2DPropertiesToDefaults

public final void setChart2DPropertiesToDefaults()
Sets all properties to their default values.


setChart2DProperties

public final void setChart2DProperties(net.sourceforge.chart2d.Chart2DProperties chart2DProps)
Sets all properties to be the values of another Chart2DProperties object. The copying is a deep copy.

Parameters:
chart2DProps - The properties to copy.

setChartDataLabelsPrecision

public final void setChartDataLabelsPrecision(int precision)
Sets the look of labels that are supposed to describe the value of the data. For example, for pie charts this method will influence the labels that surround the chart, and for charts with axes this method will influence the labels on the numbers axis. The specific labels are first determined from the greatest and least value in the data set and other factors. This method then lets you adjust whether you want integer or floating point labels and how exact you want those labels to be. You do this using the precision parameter, and passing values between 38 and -38. Nonnegative ints indicate the labels will not contain a decimal (ie will be integer labels), and the specific nonnegative number indicates how many zeroes will be to the left of the decimal if it were there (ex. for the number 1976, a precision of 0 would return 1976, a precision of 1 would return 1980, a precision of 3 would return 2000, and a precision greater than 3 would also return 2000). If the number of desired zeroes is greater than the label, then the number of zeroes is automatically scaled back to be 1 less than the number of digits. Negative ints for precision indicate the labels will contain a decimal, and the specific negative number indicates how many digits to the right of the decimal are wanted (ex. for the number 1.935, a precision of -1 would return 1.9, a precision of -2 would return 1.94, a precision of -4 would return 1.9350). If the number of desired decimal places is larger than the number of places present in the number, then zeroes are added to form as many places as are desired up to -38. MAX_INTEGER or MAX_FLOAT will always indicate the maximum number of zeroes and the maximum number of decimal places possible by Chart2D's algorithm for adjusting these labels.

Parameters:
precision - The adjustement of the precision of numbers labels.

setChartBetweenChartAndLegendGapExistence

public final void setChartBetweenChartAndLegendGapExistence(boolean existence)
Sets whether the gap between the chart and the legend exists. If the legend doesn't exist, this gap will automatically not exist.

Parameters:
existence - If true, the gap exists.

setChartBetweenChartAndLegendGapThicknessModel

public final void setChartBetweenChartAndLegendGapThicknessModel(int thickness)
Sets the thickness of the gap between the chart and the legend for the chart's model size.

Parameters:
thickness - The model thickness of the gap.

getChartDataLabelsPrecision

public final int getChartDataLabelsPrecision()
Gets the look of labels that are supposed to describe the value of the data. For example, for pie charts this method will influence the labels that surround the chart, and for charts with axes this method will influence the labels on the numbers axis. The specific labels are first determined from the greatest and least value in the data set and other factors. This method then lets you adjust whether you want integer or floating point labels and how exact you want those labels to be. You do this using the precision parameter, and passing values between 8 and -8. Nonnegative ints indicate the labels will not contain a decimal (ie will be integer labels), and the specific nonnegative number indicates how many zeroes will be to the left of the decimal if it were there (ex. for the number 1976, a precision of 0 would return 1976, a precision of 1 would return 1980, a precision of 3 would return 2000, and a precision greater than 3 would also return 2000). If the number of desired zeroes is greater than the label, then the number of zeroes is automatically scaled back to be 1 less than the number of digits. Negative ints for precision indicate the labels will contain a decimal, and the specific negative number indicates how many digits to the right of the decimal are wanted (ex. for the number 1.935, a precision of -1 would return 1.9, a precision of -2 would return 1.94, a precision of -4 would return 1.9350). If the number of desired decimal places is larger than the number of places present in the number, then zeroes are added to form as many places as are desired up to -8. MAX_INTEGER or MAX_FLOAT will always indicate the maximum number of zeroes and the maximum number of decimal places possible by Chart2D's algorithm for adjusting these labels.

Returns:
The adjustement of the precision of numbers labels.

getChartBetweenChartAndLegendGapExistence

public final boolean getChartBetweenChartAndLegendGapExistence()
Gets whether the gap between the chart and the legend exists. If the legend doesn't exist, this gap will automatically not exist.

Returns:
If true, the gap exists.

getChartBetweenChartAndLegendGapThicknessModel

public final int getChartBetweenChartAndLegendGapThicknessModel()
Gets the thickness of the gap between the chart and the legend for the chart's model size.

Returns:
The model thickness of the gap.

isFontNameExists

public final boolean isFontNameExists(java.lang.String name)
Returns true if the font name exists in the graphics enviornment.

Parameters:
name - The name of the font to determine the existence of.
Returns:
boolean If true, then the font name exists.