Pie Charts

Object Arguments

Object Arguments for Pie Charts (type="pie")

Name: title

Type: gchar *

Description: The text that appears above the pie chart.

Name: data_size

Type: gint

Description: The number of data points that will be used to construct the pie chart.

Name: data

Type: double *

Description: An array of doubles that provides the numerical data for constructing the pie chart

Name: labels

Type: gchar **

Description: An array of strings containing the labels associated with the numerical data used to construct the pie chart.

Name: colors

Type: gchar **

Description: An array of strings containing the names of the colors to be used for the slices of the pie. Color names are the usual ones for X11; if you are using XFree86, the complete list is usually found in /usr/X11R6/lib/X11/rgb.txt.

Name: colors_rgb

Type: guint32 *

Description: An array of integers containing the colors to be used for the slices of the pie, represented as RGB triples packed into bottom 24 bits of a 32-bit integer. 0xff0000 is red, 0x00ff00 is green, 0x0000ff is blue, etc.

Name: radius_size

Type: double

Description: The default radius of the pie chart, in points (72pt = 1in)

Name: radius_lock

Type: gboolean

Description: If TRUE, the user will not be allowed to interactively resize the pie chart to have a radius larger than what will fit in the allocated space.

Name: radius_maximize

Type: gboolean

Description: If TRUE, the value of the radius_size parameter will be ignored and the radius will instead always be set to the largest size that will fit in the allocated space. This parameter default to TRUE, so setting the radius_size will have no effect unless radius_maximize is explicitly set to FALSE.

Name: title_font

Type: GnomeFont *

Description: Specifies the font to use for the chart's title.

Name: legend_font

Type: GnomeFont *

Description: Specifies the font to use for the text labels in the chart's legend.

Name: slice_callback1, slice_callback2, slice_callback3

Type: void (*)(gint slice_num, gpointer user_data)

Description: This parameter specifies the function to execute when the user double-clicks on a pie slice with mouse button 1, 2 or 3. The callback is invoked with the slice number as the first parameter, and the value of the appropriate slice_callback_data item as the second.

Name: slice_callback_data1, slice_callback_data2, slice_callback_data3

Type: gpointer

Description: The value of this argument is passed as the second parameter of the double-click callback function.

Name: slice_callback_name1, slice_callback_name2, slice_callback_name3

Type: gchar *

Description: A short description of the slice callback function. (This parameter is not used for anything right now, but will be used by context-sensitive help system sometime in the future.)

Name: legend_callback1, legend_callback2, legend_callback3

Type: void (*)(gint slice_number, gpointer user_data)

Description: This parameter specifies the function to execute when the user double-clicks on a "color swatch" in the pie chart's legend with mouse button 1, 2 or 3. The callback is invoked with the corresponding slice number as the first parameter and the value of legend_callback_data as the second.

Name: legend_callback_data1, legend_callback_data2, legend_callback_data3

Type: gpointer

Description: The specified gpointer is passed as the second argument when the legend double-click callback is invoked.

Name: legend_callback_name1, legend_callback_name2, legend_callback_name3

Type: gchar *

Description: A short description of the legend double-click callback functions. (See slice_callback_name arguments for more information.)