Instance Options

A separate chart instance is created for each targetted division and may have its own settings:

$(selector).gchart({series: [...]});

Below are the options that may be applied to each Google chart instance. Although all are optional, you probably want to provide at least the data values to be plotted via the series setting.

axes | backgroundColor | barGroupSpacing | barSpacing | barWidth | barZeroPoint | chartColor | dataLabels | encoding | extension | format | functions | gridLine | gridOffsets | gridSize | height | icons | legend | legendColor | legendDims | legendOrder | legendSize | mapArea | mapColors | mapDefaultColor | mapLatLong | mapRegions | margins | markers | maxValue | minValue | onLoad | opacity | pieOrientation | provideJSON | qrECLevel | qrMargin | ranges | secure | series | title | titleColor | titleSize | type | usePost | visibleSeries | width

NameTypeDefaultComments
widthnumber0 Set the width of the desired chart. If not set explicitly it defaults to the width of its containing division. Google imposes size restrictions on the charts, being 1000 pixels in either direction, but with an overall maximum of 300,000 pixels in area (e.g. 1000 x 300, 600 x 500). If either dimension exceeds 1000 it is reduced to this amount. If the image size is greater than the area limit the height is recalculated so that it is valid again. Map charts are restricted to 600 pixels in either direction, but with an overall maximum of 300,000 pixels.
heightnumber0 Set the height of the desired chart. If not set explicitly it defaults to the height of its containing division. See width for restrictions.
formatstring'png' Set the image format to be returned: 'png' or 'gif'.

Since 1.3.1.
usePostbooleanfalse Google charts normally uses a GET URL, which is limited to 2K in size. For larger charts, set this setting to true to use POST instead. This allows for requests up to 16K in size, but requires that the chart appear within an iframe that is embedded in your containing division.

Since 1.3.1.
securebooleanfalse Google charts normally uses an open line (HTTP). Set this setting to true to encrypt (HTTPS) the request instead.

Since 1.4.1.
marginsnumber or number[2] or number[4]null Set the minimum margins around the chart. The value may be a single number representing identical margins all around or an array containing either left/right and top/bottom margins or left, right, top, and bottom margins in pixels. Leave as null for default margins.

Since 1.2.0.
titlestring'' Set the title of the chart as a whole. Include pipe (|) characters to indicate new lines.
titleColorstring'' Set the colour of the title. Defaults to 'black'. See the section on colour for more details.
titleSizenumber0 Set the font size (points) of the chart title. Defaults to 14.
opacitynumber0 Set the opacity of the chart as a whole. The value may be specified either in the range 0.0 to 1.0, or as a percentage from 0 to 100, with the higher values indicating fully opaque. Leave as zero for fully opaque.

Since 1.3.0.
backgroundColorstring or objectnull Set the background colour to be used for the entire image. See the section on colour for more details.

If more than a single colour is required you can set this option to an object with the following attributes:

angle (string or number) either a descriptive term for the angle ('horizontal' for left to right, 'vertical' for bottom to top, 'diagonalUp' for bottom/left to top/right, or 'diagonalDown' for top/left to bottom/right) or the number of degrees from the positive x-axis (may be negative),

striped (boolean) true for a series of distinct stripes or false for a continuous gradient,

colorPoints ([][2]) an array of two-item arrays containing a colour and an offset from 0.0 (bottom/left) to 1.0 (top/right).

See the gradient and stripe functions for an easy way to create simple gradients and stripes.

backgroundColor: 'aqua'
backgroundColor: 'fe5621'
backgroundColor: $.gchart.gradient('horizontal',
	'black', 'transparent')
backgroundColor: $.gchart.stripe('horizontal',
	['white', 'silver', 'gray', 'white', 'silver'])
chartColorstring or objectnull Set the background colour for the chart itself. See backgroundColor above for more details.
legendstring'' Set the position of the legend: 'top', 'topVertical', 'bottom', 'bottomVertical', 'left', or 'right', or '' for none.

Since 1.2.0 - added 'topVertical' and 'bottomVertical'.
legendOrderstring'normal' Set the order of entries in the legend: 'normal' (in the order given), 'reverse' (in the reverse of the order given), 'automatic' (order by length), or a list of indexes (zero-based) separated by commas (,).

legendOrder: 'automatic'
legendOrder: '1,3,5,0,2,4'

Since 1.3.0.
legendDimsnumber[2]null Set the minimum size of the legend. The array contains width and height in pixels. Leave as null for default size. This setting is ignored if margins is not set.

Since 1.2.0.
Since 1.4.1 - renamed from legendSize.
legendColorstring'' Set the colour of the legend. Defaults to 'black'.

Since 1.4.1.
legendSizenumber0 Set the font size (points) of the legend. Defaults to 11.

Since 1.4.1.
typestring'pie3D' Specify the type of chart required.

line is a simple line chart with implied x-values.

lineXY is a line chart with explicit x- and y-values.

sparkline is a simple line chart with implied x-values and no axes.

barHoriz is a bar chart oriented horizontally with stacked series.

barVert is a bar chart oriented vertically with stacked series.

barHorizGrouped is a bar chart oriented horizontally with side-by-side series.

barVertGrouped is a bar chart oriented vertically with side-by-side series.

barHorizOverlapped is a bar chart oriented horizontally with overlapping series.

barVertOverlapped is a bar chart oriented vertically with overlapping series.

pie is a two-dimensional pie chart showing a single series.

pie3D is a three-dimensional pie chart showing a single series.

pieConcentric is a two-dimensional pie chart showing multiple series in concentric rings.

venn is a Venn diagram showing relationships between up to three sets, see the venn function (jquery.gchart.ext.js module) for assistance in creating these diagrams.

scatter is a chart of individual points specified as x- and y-values along with a size, see the scatter function (jquery.gchart.ext.js module) for assistance in creating these charts.

radar is a circular graph with values plotted out towards the perimeter, series are joined by straight lines.

radarCurved is a circular graph with values plotted out towards the perimeter, series are joined by curved lines.

map is a country or state map shaded based on data values, see the map function (jquery.gchart.ext.js module) for assistance in creating these charts.

mapOriginal is the old implementation of maps, see the map function (jquery.gchart.ext.js module) for assistance in creating these charts.

meter is a Google meter showing a single value, see the meter function (jquery.gchart.ext.js module) for assistance in creating these charts.

qrCode is a two-dimensional bar code that can encode text, see the qrCode function (jquery.gchart.ext.js module) for assistance in creating these bar codes.

formula is a mathematical formula, with the actual formula appearing as the single dataLabels value for the chart using the TeX notation (don't forget to escape any backslashes (\)) (requires the jquery.gchart.ext.js module).

graphviz is a Graph Visualization showing an abstract graph or network - using the DOT language or the graphviz function (jquery.gchart.graphviz.js module) to define the graph.

Since 1.2.0 - added 'pieConcentric'.
Since 1.3.0 - added 'formula'.
Since 1.3.2 - added 'graphviz'.
Since 1.3.3 - added 'barHorizOverlapped', 'barVertOverlapped', 'mapOriginal'.
Since 1.4.0 - moved 'formula', 'map', 'mapOriginal', 'meter', 'qrCode', 'scatter', and 'venn' to the jquery.gchart.ext.js module; moved 'graphviz' to the jquery.gchart.graphviz.js module.
encodingstring'' Set the type of encoding of data values to be used.

text normalises the values to 0-100 and presents them as normal text with commas (,) separating values and pipes (|) separating series (the default).

scaled doesn't normalise the values and presents them as normal text with commas (,) separating values and pipes (|) separating series.

simple normalises the values to 0-61 and presents them as one character (A-Za-z0-9) with no value separator and commas (,) separating series.

extended normalises the values to 0-4095 and presents them as two characters (A-Za-z0-9-.) with no value separator and commas (,) separating series.
seriesobject[][this.series('Hello World', [60, 40])] Provide the data values to be charted. You can create the series objects directly or you can use the series function to generate a new series object. Since an x-y line chart requires a special format for the series, you should use the seriesForXYLines function to assist in that case. Series data can also be loaded from external sources via the seriesFromCsv and seriesFromXml functions.

Each entry in the array is an object with the following attributes:

label (string, optional) the display text for this series,

data (number[]) the data values to be plotted,

color (string or string[], optional) the colour for the series - see the section on colour for more details; provide an array to specify colours for each item in the series; if fewer colours than the number of segments are given, the colours are recycled for the remaining segments,

fillColor (string, optional) the background colour between this series and the next one or a gradient or stripe definition with which to fill the current bar,

minValue (number, optional) the minimum value for this series,

maxValue (number, optional) the maximum value for this series,

lineThickness (number, optional together with lineSegments) the width (pixels) of the line for this series,

lineSegments (number[2], optional together with lineThickness) the lengths (pixels) of line segments and gaps when drawing the line for this series.

series: [$.gchart.series('2004', [91.80, 2.83, 4.06]),
	$.gchart.series('2005', [88.16, 1.61, 8.13])]
series: $.gchart.seriesForXYLines(
	[$.gchart.series([[0, 20], [30, 30], [60, 40], [70, 50],
	[90, 60], [95, 70], [100, 80]], 'red'),
	$.gchart.series([[10, 100], [30, 90], [40, 40], [45,20],
	[52, 10]], 'green'),
	$.gchart.series([5, 33, 50, 55, 7], 'blue')])

Since 1.2.0 - color may be an array.
Since 1.4.2 - fillColor may be a gradient or stripe.
visibleSeriesnumber0 Indicate how many series should be drawn directly. The remainder are still available for use with markers. A value of 0 means that all series should be drawn. The visible series must appear first in the list of series.

Since 1.2.0.
dataLabelsstring[][] Specify the labels to apply to each of the data items in the series. Whereas the series labels apply to the entire series, these labels apply to all the first, second, etc. items across all the series.
functionsobject[][] Add data functions to be applied to your chart. You can use the fn and fnVar functions to assist in creating data function definitions.

Each entry in the array is an object with the following attributes:

series (number) the target series into which the calculated values are written; often this would be a dummy series ($.gchart.series([0])),

data (object or object[]) one or more variable definitions for this function; use the fnVar function to create variable definitions,

fnText (string) the function to evaluate for each input value; it is specified using muParser function syntax.

functions: [$.gchart.fn(0, 'x', 0, 10, 0.1, 'sin(x) * 50 + 50')]
functions: [$.gchart.fn(0, $.gchart.fnVar('x', 0, 10, 0.1),
	'sin(x) * 50 + 50'),
	$.gchart.fn(1, $.gchart.fnVar('y', 0, 10, 0.1),
	'cos(y) * 50 + 50')]
functions: [$.gchart.fn(1, 'x', 0, '(x / 5) ^ 2')]

Since 1.3.3.
axesobject[][] Define any number of axis labels for your chart, including multiple sets of labels for one axis. Default labels range from 0 to 100 with 10 steps in between. You can use the axis function to assist in creating axis definitions and the GChartAxis functions to modify them.

Each entry in the array is either a string giving the axis name or a GChartAxis object with the following attributes:

_axis (string) the name of the axis to which this definition applies ('top', 'left' or 'y', 'bottom' or 'x', 'right'),

_lineColor (string, optional) the text colour for the labels; see the section on colour for more details,

_labels (string[], optional) the text labels to appear along this axis; unless positioned as described below, these labels are evenly spaced along the axis starting and ending at the edges of the chart; if omitted numeric labels corresponding to each tenth of the range are shown,

_positions (number[], optional) the positions of the labels along the axis ranging from the range start (0 by default) at the bottom/left to the range end (100 by default) at the top/right; if positions are defined but no labels are supplied, then these values become the labels as well,

_range (number[2 or 3], optional) the start and end points of the range of values depicted, which may be given as highest to lowest to invert the labels; an optional third entry specifies the interval between points in the range; if not specified a range of 0 to 100 and an interval of 1/10th the range is assumed,

_color (string, optional) the text colour for the labels; see the section on colour for more details,

_alignment (string, optional) the alignment of the labels ('left', 'center', 'right'); the default alignment changes per axis,

_size (number, optional) the size (pixels) of the text for the labels,

_drawing (string, optional) the drawing control to specify what is drawn for the axis ('line', 'ticks', 'both' (default)),

_tickColor (string, optional) the colour of the tick marks; defaults to axis colour,

_tickLength (number or number[], optional) the length of the tick marks or an array of lengths to cycle through; negative values are drawn inside the chart; the maximum positive value is 25,

_format (object, optional) formatting definition for the axis values.

axes: ['left']
axes: [$.gchart.axis('left', ['0', '50', '100']),
	$.gchart.axis('bottom', ['2005', '2006', '2007', '2008'])]
axes: [$.gchart.axis('y', 100, 200),
	$.gchart.axis('x', 1000, 0, -200)]
axes: [$.gchart.axis('right').
		ticks('red', -100).drawing('ticks'),
	$.gchart.axis('bottom').
		format($.gchart.formatFloat, '', 'K', 1, false, true)]

Since 1.2.0 - added _drawing, _tickColor, and _tickLength attributes.
Since 1.3.0 - added _format attribute.
Since 1.4.1 - added _lineColour attribute, _tickLength can be an array.
rangesobject[][] Define any number of data ranges to display on your chart. You can use the range function to assist in creating range definitions. Each entry in the array is an object with the following attributes:

vertical (boolean, optional) true to draw the range vertically across the chart or false to draw it horizontally,

color (string) the colour to be used for this range; see the section on colour for more details,

start (number) the starting value for the range between 0.0 at the bottom/left and 1.0 at the top/right,

end (number, optional) the ending value for the range between 0.0 at the bottom/left and 1.0 at the top/right; if omitted a line is drawn rather than a rectangular area.

ranges: [$.gchart.range('ccccff', 0.25, 0.75),
	$.gchart.range(true, 'ccffcc', 0.6, 0.8)]
markersobject[][] Define any number of markers to display on your chart. You can use the marker function to assist in creating marker definitions. Each entry in the array is an object with the following attributes:

shape (string) the type of shape to draw for this marker ('annotation', 'arrow', 'candlestick', 'circle', 'cross', 'diamond', 'down', 'errorbar', 'flag', 'financial', 'horizbar', 'horizontal', 'number', 'plus', 'rectangle', 'sparkfill', 'sparkline', 'sparkslice', 'square', 'text', 'vertical'),

color (string) the colour to be used for this marker; see the section on colour below for more details,

series (number, optinal) the index of the series to which this marker applies (0 (default) to n),

item (number or string or number[2 or 3], optional) the index of the point within that series to which this marker applies (0-n) or -1 or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the markers or 'everyn[start:end]' where the values are numbers to regularly space the markers within the given range of points or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them or [x, y] positions (see positioned below),

size (number, optional) the size (pixels) for this marker (default 10),

priority (string or number, optional) the rendering priority of this marker ('behind' or -1, 'normal' or 0 (the default), 'above' or +1),

text (string, optional) the text to show if this is a 'text' or 'flag' type marker or the number format for a 'number' type marker - see the numberFormat function for formatting options,

positioned (boolean, optional) true to absolutely position the marker - the item value must be an array of two values in the range 0.0 to 1.0

placement (string or string[], optional) the placement justification(s) ('left', 'center' or 'centre', 'right', 'top', 'middle', 'bottom', 'barbase', 'barcenter' or 'barcentre', 'bartop'),

offsets (number[2], optional) the pixel offsets, horizontal and vertical, from the calculated position.

markers: [$.gchart.marker('diamond', 'red', 0)]
markers: [$.gchart.marker('flag', 'red',
		0, 7, 0, 0, 'Unusual'),
	$.gchart.marker('number', 'blue', 0, 4)]

Since 1.1.0 - 'sparkfill' and 'sparkline' types.
Since 1.2.0 - 'flag', 'financial', and 'number' types, ranges on item, positioned setting.
Since 1.3.0 - 'annotation', 'errorbar', 'horizbar', 'rectangle', 'sparkslice' types, placement and offsets settings.
Since 1.3.1 - 'candlestick' as a synonym for 'financial' type.
iconsobject[][] Define any number of dynamic icons to display on your chart. Requires the jquery.gchart.icons.js module. You can use any of the icon functions to assist in creating icon definitions. Each entry in the array is an object with the following attributes:

name (string) the full name of the icon,

data (string) the encoded paramaters for this type of icon,

series (number, optional) the index of the series to which this icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the index of the point within that series to which this icon applies (0-n) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the markers or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index of this icon from -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) the absolute position of the icon centre from 0.0 (bottom/left) to 1.0 (top/right); if present this override the series and item settings,

offsets (number[2], optional) any pixel offsets from the calculated position.

icons: [$.gchart.bubbleIcon('Big sale')]
icons: [$.gchart.noteIcon('2010 Q1', 'Merger',
		'thought', '', 1, 3),
	$.gchart.weatherIcon('Big storm', '',
		'taped', 'thunder', 2, 5)]

Since 1.3.0.
Since 1.4.0 - moved to the jquery.gchart.icons.js module.
minValuenumber0 The minimum value displayed on the chart. Set to $.gchart.calculate to calculate the minimum from the actual data values.
maxValuenumber100 The maximum value displayed on the chart. Set to $.gchart.calculate to calculate the maximum from the actual data values.
gridSizenumber or number[2]null Specify the horizontal and vertical spacing (pixels) between grid lines on the chart as either a single number that applies for both or as an array of two numbers.

Since 1.3.3 - can be a single number.
gridLinenumber or number[2]null Specify the appearance of the grid lines by providing the lengths (pixels) of the line segments and the gaps between them as either a single number that applies for both or as an array of two numbers. A continuous line has a gap of zero. This setting is ignored if gridSize hasn't been specified.

Since 1.3.3 - can be a single number.
gridOffsetsnumber or number[2]null Specify the offsets of the grid lines by providing the x and y values (pixels) as either a single number that applies for both or as an array of two numbers. This setting is ignored if gridSize and gridLine haven't been specified.

Since 1.2.0.
Since 1.3.3 - can be a single number.
extensionobject{} Additional parameters may be passed to the Google chart request via this object, whose attributes are transferred across.

For example: {xyz: 4} would add &xyz=4.
barWidthnumber or stringnull Specify the width (pixels) of the bars in a bar chart. The width can also be set to $.gchart.barWidthAuto to automatically resize the bars to fill the chart, or $.gchart.barWidthRelative to resize the bars based on the spacing between bars and groups being relative to the width of a bar.

Since 1.2.0 - can use $.gchart.barWidthAuto or $.gchart.barWidthRelative.
barSpacingnumbernull Specify the spacing (pixels) between the bars within a group in a bar chart. This setting has no effect unless barWidth is also set. If barWidth is $.gchart.barWidthRelative the value should be between 0.0 and 1.0.
barGroupSpacingnumbernull Specify the spacing (pixels) between groups of bars in a bar chart. This setting has no effect unless barWidth and barSpacing are also set. If barWidth is $.gchart.barWidthRelative the value should be between 0.0 and 1.0.
barZeroPointnumbernull Specify the position of the zero line in a bar chart, ranging from 0.0 at the bottom/left to 1.0 at the top/right. The bars in the chart then extend from this line up or down to the value for each data point.
pieOrientationnumber0 Specify the starting angle for a pie chart in degrees clockwise from the positive x-axis.

Since 1.2.0.
mapLatLongbooleanfalse Set to true to interpret mapArea as latitude/longitude coordinates, rather than as pixel borders. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
mapAreanumber or number[4] or stringnull Define the area to show in a map chart. Requires the jquery.gchart.ext.js module. By default all selected areas are shown in the smallest surrounding box. You can override this by specifying a single number to use as pixels border on all sides, or as an array of four numbers for individual pixel borders (left, right, top, bottom) or latitude/longitude limits (bottom, left, top, right) in conjunction with the mapLatLong setting.

Under the old map scheme, this value is a string to indicate the desired region: ('world', 'africa', 'asia', 'europe', 'middle_east', 'south_america', 'usa').

mapArea: 20 // pixels border
mapArea: [50, 50, 20, 20] // pixels border
mapArea: [-60, -90, 20, -30], mapLatLong: true // lat/long
mapArea: 'africa' // old style

Since 1.3.3 - added pixel border and latitude/longitude options.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
mapRegionsstring[][] Specify the codes for the regions to be coloured on the map. Requires the jquery.gchart.ext.js module. Use the appropriate ISO 3166 country codes to identify the regions. States and cities within a country may be specified by appending a dash (-) and the state/city code to the country. The order in this array needs to match that in the series data array.

You can use the map function to assist in creating map options.

mapRegions: ['AU', 'AU-QLD', 'JP']
series: [$.gchart.series(40, 60, 100)]

Since 1.4.0 - moved to the jquery.gchart.ext.js module.
mapDefaultColorstring'bebebe' Specify the colour used for regions without associated data. Requires the jquery.gchart.ext.js module. See the section on colour for more details.

Since 1.4.0 - moved to the jquery.gchart.ext.js module.
mapColorsstring[]['blue', 'red'] Specify the starting and ending colours, or a gradient of colours, for coloured regions on a map. Requires the jquery.gchart.ext.js module. Colours are calculated between these end points based on the data value for each region relative to the maximum for the chart.

Since 1.3.0 - colour gradient.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
qrECLevelstringnull Specify the error correction level to use for a QR code ('low' (default), 'medium', 'quarter', 'high'). Requires the jquery.gchart.ext.js module.

Since 1.4.0 - moved to the jquery.gchart.ext.js module.
qrMarginnumbernull Specify the margin (squares) to leave around the outside of a QR code. The default is 4. Requires the jquery.gchart.ext.js module.

Since 1.4.0 - moved to the jquery.gchart.ext.js module.
onLoadfunctionnull Provide a callback function that is invoked when the chart has been loaded. There are no parameters unless provideJSON is true, while this refers to the surrounding division.

Since 1.2.3.
provideJSONbooleanfalse When true invoking the onLoad callback also passes a JSON description of the chart as a parameter. This description identifies the various regions within the chart and can be used to provide imagemap-like capabilities for it. Use the built-in findRegion function to convert from a mouse position into a chart region.

$(selector).gchart({onLoad: saveRegions, provideJSON: true}).
	mouseover(function(event) {
		var region = $.gchart.findRegion(event, regionData);
		$('#region').text(!region ? '' :
			region.type + ' ' + region.series + ' ' + region.point);
	});

var regionData = null;

function saveRegions(jsonData) {
	regionData = jsonData
}

Since 1.3.1.

Functions

axis | color | 'destroy' | findRegion | fn | fnVar | gradient | graphviz | lineXYSeries | map | marker | meter | numberFormat | 'option' (get) | 'option' (set) | qrCode | range | scatter | series | seriesForXYLines | seriesFromCsv | seriesFromXml | setDefaults | stripe | venn

SignatureReturnsComments
$.gchart.setDefaults(options)void Update the default instance options (see options tab) to use with all Google chart instances.
$(selector).gchart('option', options)jQuery object Update the options for the Google chart instance(s) attached to the given division(s).

options (object) the new settings for this chart.

$(selector).gchart('option', {title: 'My Chart'})
$(selector).gchart('option',
	{title: 'My Chart', encoding: 'simple'})

Since 1.5.0 - previously you used 'change'.
$(selector).gchart('option', name, value)jQuery object Update a single option for the Google chart instance(s) attached to the given division(s).

name (string) the name of setting to change,

value (any) the setting's new value.

$(selector).gchart('option', 'title', 'My Chart');

Since 1.3.0.
Since 1.5.0 - previously you used 'change'.
$(selector).gchart('option', name)object or any Retrieve one or all of the current settings for the first Google chart instance attached to the given division(s).

name (string, optional) the name of the setting to retrieve; omit for all settings.

var settings = $(selector).gchart('option');
var format = $(selector).gchart('option', 'format');

Since 1.5.0.
$(selector).gchart('destroy')jQuery object Remove the Google chart functionality from the given division(s).
$.gchart.series(label, data, colour, fillColour, minValue, maxValue, thickness, segments) object Generate a new series object for a chart for use with the series option.

label (string, optional) the label for this series,

data (number[]) the data values for this series,

colour (string or string[], optional) the colour for this series; provide an array to specify colours for each item in the series; if fewer colours than the number of segments are given, the colours are recycled for the remaining segments,

fillColour (string, optional) the fill colour for this series - from this line to the next,

minValue (number, optional) the minimum value for this series - both this and the next parameter should be present or both omitted,

maxValue (number, optional) the maximum value for this series,

thickness (number, optional) the thickness (pixels) of the line for this series - both this and the next parameter should be present or both omitted,

segments (number[2], optional) the line and gap lengths (pixels) of the line for this series.

$.gchart.series([10, 20, 30])
$.gchart.series('Firefox',
	[0.00, 4.06, 8.13, 9.95], 'blue')
$.gchart.series('Max', [29.1, 28.9, 28.1, 26.3, 23.5,
	21.2, 20.6, 21.7, 23.8, 25.6, 27.3, 28.6],
	'red', 'ffcccc', 0, 40, 2, [4, 2])

Since 1.2.0 - colour may be an array.
$.gchart.lineXYSeries(series) object[] Deprecated in favour of seriesForXYLines.

Since 1.1.0.
$.gchart.seriesForXYLines( series) object[] Transform a series into the format required for an x-y line chart for use with the series option.

series (object[]) the details of the points to plot as normal series, where each data value may be an array of two points specifying the x- and y-coordinate of the point. If you want to use the default even spacing for one of the series, provide just the y-values.

$(selector).gchart({type: 'lineXY',
	series: $.gchart.seriesForXYLines(
	[$.gchart.series([[0, 20], [30, 30],
	[60, 40], [70, 50], [90, 60], [95, 70],
	[100, 80]], 'red'),
	$.gchart.series([[10, 100], [30, 90],
	[40, 40], [45,20], [52, 10]], 'green'),
	$.gchart.series([5, 33, 50, 55, 7], 'blue')])})

Since 1.1.0 - previously was lineXYSeries.
$.gchart.seriesFromCsv(csv) object[] Generate a set of series objects from data in CSV (comma-separated values) format for use with the series option.

csv (string or string[]) the CSV data for all the series.

Each line represents one series and consists of any number of data values and, optionally, additional details about the series. For the latter, a header line is required to identify the columns. They should be named for the series attributes (label, color, fillColor, minValue, maxValue, lineThickness, lineSegmentLine, lineSegmentGap) or be of the form yn, where n is a sequential number, for the data values. If you want to specify x-y line values, include columns named xn before the corresponding y-values. If x-values are not required for one series, leave the fields blank on that line. If there is no header line, all entries are treated as data values.

If the data reside remotely, use Ajax to retrieve it as text and pass that to this function.

$.gchart.seriesFromCsv(
	'label,color,y1,y2,y3,y4\n' +
	'IE,ff0000,95.97, 91.80, 88.16, 86.64\n' +
	'Netscape,00ff00,3.39, 2.83, 1.61, 0.00\n' +
	'Firefox,0000ff,0.00, 4.06, 8.13, 9.95')

Since 1.1.0.
$.gchart.seriesFromXml(xml) object[] Generate a set of series objects from data in XML format for use with the series option.

xml (string or Document) the XML data for all the series with the structure shown below. All attributes except point/@y are optional. Use the point/@x attribute to specify an X-Y line point.

<data>
	<series label="" color="" fillColor=""
		minValue="" maxValue=""
		lineThickness="" lineSegments="">
		<point x="" y=""/>
		...
	</series>
	...
</data>
If the data reside remotely, use Ajax to retrieve it as XML and pass that to this function.

$.gchart.seriesFromXml(
  '<?xml version="1.0" encoding="UTF-8"?>\n' +
  '<data>\n' +
  '  <series label="IE" color="ff0000">\n' +
  '    <point y="95.97"/>\n' +
  '    <point y="91.80"/>\n' +
  '    <point y="88.16"/>\n' +
  '    <point y="86.64"/>\n' +
  '  </series>\n' +
  '  <series label="Netscape" color="00ff00">\n'+
  '    <point y="3.39"/>\n' +
  '    <point y="2.83"/>\n' +
  '    <point y="1.61"/>\n' +
  '    <point y="0.00"/>\n' +
  '  </series>\n' +
  '  <series label="Firefox" color="0000ff">\n'+
  '    <point y="0.00"/>\n' +
  '    <point y="4.06"/>\n' +
  '    <point y="8.13"/>\n' +
  '    <point y="9.95"/>\n' +
  '  </series>\n' +
  '</data>')

Since 1.1.0.
$.gchart.scatter(values, minMax, labels, colours, options) options Generate the options required for a scatter chart. Requires the jquery.gchart.ext.js module.

values (number[][2 or 3]) the details of the points to plot, each data value is an array of two or three numbers: the x- and y-coordinates and an optional point size (0-100),

minMax (number[2 or 4], optional) minimum and maximum values for the x- and (optionally) y-coordinates,

labels (string[], optional) labels for groups within the chart to appear in a legend; use markers to depict the groups,

colours (string[], optional) matching colours for the above labelled groups,

options (object, optional) any additional options for this chart.

$(selector).gchart($.gchart.scatter(
	[[10, 80], [30, 40, 50], [60, 70, 25],
	[90, 20], [20, 10], [40, 90], [20, 50, 75],
	[50, 70, 75], [90, 30], [70, 50]]))
$(selector).gchart($.gchart.scatter(
	[[10, 80], [30, 40, 50], [60, 70, 25],
	[90, 20], [20, 10], [40, 90], [20, 50, 75],
	[50, 70, 75], [90, 30], [70, 50]],
	[-50, 150, -50, 150],
	['Group 1', 'Group 2'], ['red', 'blue'])).
	gchart('change', {markers: [...]})

Since 1.3.0 - added labels and colours parameters.
Since 1.3.3 - added minMax parameter.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.venn(size1, size2, size3, overlap12, overlap13, overlap23, overlap123, options) options Generate the options required for a Venn diagram. Requires the jquery.gchart.ext.js module.

size1, size2, size3 (number) the relative sizes of the three sets,

overlap12, overlap13, overlap23 (number) the percentage overlaps between each pair of the three sets,

overlap123 (number) the percentage overlap of all three sets,

options (object, optional) any additional options for this chart.

$(selector).gchart($.gchart.venn(
	100, 80, 60, 10, 30, 30, 10))

Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.map(latLongArea, mapArea, values, defaultColour, colour, endColour, options) options Generate the options required for a map chart. Requires the jquery.gchart.ext.js module.

latLongArea (boolean, optional) true to interpret mapArea as latitude/longitude coordinates, or false (default) to use pixel borders,

mapArea (number or number[4] or string, optional) by default all selected areas are shown in the smallest surrounding box, but you can override this by specifying a single number to use as pixels border on all sides, or an array of four numbers for individual pixel borders (left, right, top, bottom) or latitude/longitude limits (bottom, left, top, right) in conjunction with the latLongArea parameter; several constants are defined to easily show the continents; under the old map scheme, this value is a string to indicate the desired region ('world', 'africa', 'asia', 'europe', 'middle_east', 'south_america', 'usa'),

values (object) the data values to plot; each country/state is identified by its two-character code (ISO 3166 country codes), followed by a dash (-) or underscore (_) and state/city code if desired, as an attribute name and the plotted value is the associated value,

defaultColour (string, optional) the colour used for regions without associated data; see the section on colour for more details,

colour (string, optional) the starting colour for a range or (string[]) a set of gradient colours used for regions with associated data,

endColour (string, optional) the ending colour for a range used for regions with associated data (omit if colour is an array),

options (object, optional) any additional options for this chart.

$(selector).gchart($.gchart.map(
	{AU: 20, AU_QLD: 60, BR: 40, US: 100, 'US-TX': 80}));
$(selector).gchart($.gchart.map(true, [-55, -85, 15, -35],
	{CO: 60, BR: 40}));
$(selector).gchart($.gchart.map(20, {FR: 100, FR_B: 80, PL: 40},
	'white', ['green', 'yellow', 'red']));
// Old style
$(selector).gchart($.gchart.map('world',
	{AU: 20, BR: 40, CO: 60, EG: 80, FR: 100, IN: 0,
	JP: 20, PL: 40, SA: 60, TR: 80, US: 100, ZA: 0}))
$(selector).gchart($.gchart.map('usa',
	{CA: 20, NV: 40, OR: 60, WA: 80},
	'white', ['green', 'yellow', 'red']))

Since 1.3.0 - colour may be an array.
Since 1.3.3 - added latLongArea parameter, allow mapArea as pixels border or latitude/longitude.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.meter(text, values, maxValue, colours, labels, styles, options) options Generate the options required for a Google meter chart. Requires the jquery.gchart.ext.js module.

text (string or string[], optional) the text to display at the end of the arrow(s),

values (number or number[] or [] of these) the position(s) of the arrow(s) grouped by series,

maxValue (number, optional) the maximum value for the meter (default 100),

colours (string[], optional) the colours to display blended across the band,

labels (string[], optional) the labels to appear beneath the band,

styles (number[] or number[][3 or 4], optional) the styling of the arrows per series as either just the width or an array of width, dash length, space length, and arrow size (0-15, optional),

options (object, optional) any additional options for this chart.

$(selector).gchart($.gchart.meter('Speed', 70))
$(selector).gchart($.gchart.meter(['1', '2', '3'],
	[10, 30, 70]))
$(selector).gchart($.gchart.meter('Speed', 70,
	[], ['slow', 'faster', 'crazy']))
$(selector).gchart($.gchart.meter('', [[10, 30], 70],
	[], [], [1, [3, 5, 5, 7]]))

Since 1.2.0 - added colours parameter.
Since 1.3.0 - text and value may be arrays, added labels and styles parameters.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.qrCode(text, encoding, ecLevel, margin) options Generate the options required for a QR code. Requires the jquery.gchart.ext.js module.

text (string) the text to encode into the bar code or (object) these parameters as attributes of an object,

encoding (string, optional) the encoding scheme to use ('UTF-8' (default), 'ISO-8859-1', 'Shift_JIS'),

ecLevel (string, optional) the error correction level ('low' (default), 'medium', 'quarter', 'high'),

margin (number, optional) the margin (squares) to leave around the outside of the bar code (default 4).

$(selector).gchart($.gchart.qrCode(
	'This is a QR Code'))
$(selector).gchart($.gchart.qrCode(
	'This one contains a longer text message',
	'ISO-8859-1', 'high', 2))

Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.graphviz(engine, options, directed, nodes, edges, attrs) options Generate the options required for a Graph Visualization. Requires the jquery.gchart.graphviz.js module.

engine (string, optional) the graphing engine to use ('dot' (default), 'neato', 'twopi', 'circo', 'fdp'),

options (object, optional) any additional options for this chart,

directed (boolean, optional) true for a directed graph or false (default) for an undirected one,

nodes (object) the list of nodes in the graph, indexed by name and with a value of an object containing attributes for that node,

edges (object) the list of edges in the graph, indexed by starting node name and with a value of an array of ending node names,

attrs (object, optional) any additional attributes for the graph.

$(selector).gchart($.gchart.graphviz(true,
	{C_0: {}, H_0: {type: 's'}, H_1: {type: 's'}, H_2: {type: 's'},
	C_1: {type: 's'}, H_3: {type: 's'}, H_4: {type: 's'}, H_5: {type: 's'}},
	{C_0: ['H_0', 'H_1', 'H_2', 'C_1'], C_1: ['H_3', 'H_4', 'H_5']},
	{node: {shape: 'box', color: 'green'}}))

Since 1.3.2.
$.gchart.fn(series, data, start, end, step, fnText) object Create a data function definition for use with the functions option.

series (number) the index of the target series into which the calculated values are written; often this would be a dummy series ($.gchart.series([0])),

data (object or object[]) one or more variable definitions (using the fnVar function) for this function or (string) the name of a single variable,

start (number, optional) the index of the series to use for input values to the function or the start of the range for generating input values; this parameter must be specified if data is a string and must be omitted otherwise,

end (number, optional) the end of the range for generating input values; this parameter must be included if data is a string and start specifies the start of the range; otherwise it must be omitted,

step (number, optional) the interval between the generated input values; this parameter must be included if data is a string and start specifies the start of the range; otherwise it must be omitted,

fnText (string) the function to evaluate for each input value; it is specified using muParser function syntax.

$.gchart.fn(0, 'x', 0, 10, 0.1, 'sin(x) * 50 + 50')
$.gchart.fn(0, $.gchart.fnVar('x', 0, 10, 0.1), 'sin(x) * 50 + 50')
$.gchart.fn(1, 'x', 0, '(x / 5) ^ 2')

Since 1.3.3.
$.gchart.fnVar(name, start, end, step) object Create a data function variable definition for use with the fn function.

name (string) the name of the variable,

start (number) the index of the series to use for input values to the function or the start of the range for generating input values,

end (number, optional) the end of the range for generating input values; this parameter must be included if start specifies the start of the range; otherwise it must be omitted,

step (number, optional) the interval between the generated input values; this parameter must be included if start specifies the start of the range; otherwise it must be omitted.

$.gchart.fnVar('x', 0)
$.gchart.fnVar('x', 0, 10, 0.1)

Since 1.3.3.
$.gchart.axis(axis, lineColour, labels, positions, rangeStart, rangeEnd, rangeInterval, colour, alignment, size, format) GChartAxis object Create an axis definition for use with the axes option.

axis (string) the name of the axis being defined ('top', 'bottom' or 'x', 'left' or 'y', 'right'),

lineColour (string, optional) the colour of the axis line; see the section on colour for more details,

labels (string[], optional) the labels shown on this axis - unless positioning details are included the labels are evenly spaced along the axis starting and ending at the edges of the chart; if omitted numeric labels corresponding to each tenth of the range are shown,

positions (number[], optional - may only be present if labels is present) the positions of the labels along the axis ranging from the range start (0 by default) at the bottom/left to the range end (100 by default) at the top/right; if positions are defined but no labels are supplied, then these values become the labels as well,

rangeStart (number, optional) the starting value for the range of the axis,

rangeEnd (number, optional - may only be present if rangeStart is present) the ending value for the range of the axis; this value may be less than the start of the range to invert the axis,

rangeInterval (number, optional - may only be present if rangeStart and rangeEnd are present) the interval between values for the range of the axis; note that it must be negative for an inverted range,

colour (string, optional) the text colour for the labels; see the section on colour for more details,

alignment (string, optional) the alignment of the labels ('left', 'center', 'right'),

size (number, optional) the size (pixels) of the text for the labels.

format (object, optional) the number format settings for the labels; see the axis object format for more details.

$.gchart.axis('bottom', ['Jan', 'Feb', 'Mar',
	'Apr', 'May', 'Jun'], 'black');
$.gchart.axis('left', 0, 40, 'red', 'right'),
$.gchart.axis('left', ['C'], [50], 'red', 'right')

Since 1.2.0 - added rangeInterval parameter.
Since 1.3.0 - added format parameter.
Since 1.4.1 - added lineColour parameter.
$.gchart.color(r, g, b, a)string Create a colour value in the format required by Google charts (six or eight hexadecimal digits). You can specify the red/green/blue and optional alpha (transparency) values (0-255) or the name of a standard colour with an optional alpha value.

You can always pass colour names directly as values to all functions.

The standard colours are: aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, orange, purple, red, silver, teal, transparent, white, yellow.

r (string) the colour name or hex digits or (number) the red component of the colour,

g (number, optional) the green component of the colour or the alpha component if r is a string,

b (number, optional) the blue component of the colour,

a (number, optional) the alpha (transparency) component of the colour.

$.gchart.color(255, 165, 0) // orange
$.gchart.color('red')
$.gchart.color('blue', 128) // translucent blue
$.gchart.gradient(angle, colours, positions) object Create a simple colour gradient for a background for use with the backgroundColor or chartColor options.

angle (string or number) the direction of the gradient as a name ('horizontal', 'vertical', 'diagonalUp', 'diagonalDown') or the number of degrees from the positive x-axis (may be negative),

colours (string[]) a list of colours to transform between or (string) the start colour for the gradient (bottom/left); see the section on colour for more details,

positions (number[], optional) a list of positions (0.0 to 1.0) matching the colours list above, or (string) the end colour for the gradient (top/right); if positions are not provided the colours are evenly spaced.

$.gchart.gradient('horizontal',
	'black', 'transparent')
$.gchart.gradient(60, 'lime', 'blue')
$.gchart.gradient(0, ['yellow', 'lime', 'blue'])
$.gchart.gradient(0, ['yellow', 'lime', 'blue'], [0.0, 0.25, 0.5])

Since 1.4.2 - positions added.
$.gchart.stripe(angle, colours, widths) object Create a simple colour striping for a background for use with the backgroundColor or chartColor options.

angle (string or number) the direction along which the stripes are drawn as a name ('horizontal', 'vertical', 'diagonalUp', 'diagonalDown') or the number of degrees from the positive x-axis (may be negative),

colours (string[]) the colours for the stripes; see the section on colour for more details,

widths (number[], optional) the widths (0.0 to 1.0) of the stripes; if not specified the widths are even; if the widths do not fill the entire area, they are repeated.

$.gchart.stripe('horizontal', ['white', 
	'silver', 'gray', 'white', 'silver'])
$.gchart.stripe(60, ['white', 'ffa500'])
$.gchart.stripe(0, ['white', 'ffa500'], [0.1, 0.2])

Since 1.4.2 - widths added.
$.gchart.marker(shape, colour, series, item, size, priority, text, positioned, placement, offsets) object Create a marker definition for use with the markers option.

shape (string) the type of shape to draw ('annotation', 'arrow', 'candlestick', 'circle', 'cross', 'diamond', 'down', 'errorbar', 'flag', 'financial', 'horizbar', 'horizontal', 'number', 'plus', 'rectangle', 'sparkfill', 'sparkline', 'sparkslice', 'square', 'text', 'vertical'),

colour (string) the colour to be used for this marker; see the section on colour for more details,

series (number) the index of the series to which this marker applies (0-n),

item (number or string or number[1 to 3], optional) the index of the point within that series to which this marker applies (0-n) or -1 or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the markers or 'everyn[start:end]' where the values are numbers to regularly space the markers within the given range of points or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them or [x, y] positions (see positioned below),

size (number, optional) the size (pixels) for this marker (default 10); both this and the following parameter may be omitted and text specified instead,

priority (string or number, optional) the rendering priority of this marker ('behind' or -1, 'normal' or 0 (default), 'above' or +1),

text (string, optional - takes precedence over priority if size is absent) the text to show if this is a 'text' or 'flag' type marker or the number format for a 'number' type marker - see the numberFormat function for formatting options,

positioned (boolean, optional) true to absolutely position the marker - the item value must be an array of two values in the range 0.0 to 1.0,

placement (string or string[], optional) the placement justification(s) ('left', 'center' or 'centre', 'right', 'top', 'middle', 'bottom', 'barbase', 'barcenter' or 'barcentre', 'bartop'),

offsets (number[2], optional) the pixel offsets, horizontal and vertical, from the calculated position.

$.gchart.marker('diamond', 'red', 0)
$.gchart.marker('circle', 'yellow', 1, 'every3')
$.gchart.marker('text', 'black', 0, 14, 12,
	'above', 'Note this')
$.gchart.marker('number', 'blue', 2, [2, 10], 15,
	'above', $.gchart.numberFormat('f', 1))

Since 1.1.0 - 'sparkfill' and 'sparkline' types.
Since 1.2.0 - 'flag', 'financial', and 'number' types, ranges on item, and positioned setting.
Since 1.3.0 - added placement and offsets parameters.
Since 1.3.1 - 'candlestick' as a synonym for 'financial' type.
$.gchart.range(vertical, colour, start, end) object Create a range definition for use with the ranges option.

vertical (boolean, optional) true if a vertical range or false if horizontal (default),

colour (string) the colour of the range; see the section on colour for more details,

start (number) the starting point for the range (0.0 to 1.0),

end (number, optional) the ending point for the range (0.0 to 1.0); if omitted a line is drawn instead of a rectangular area.

$.gchart.range('ccccff', 0.25, 0.75)
$.gchart.range(true, 'ccffcc', 0.6)
$.gchart.numberFormat(type, prefix, suffix, precision, showX, zeroes, separators) string Generate a number format string for use with a 'number' marker.

type (string) the type of format: $.gchart.formatFloat ('f'), $.gchart.formatPercent ('p'), $.gchart.formatScientific ('e'), or $.gchart.formatCurrency ('c') - with the last you also need to add the three-character currency designation, e.g. AUD or EUR,

prefix (string, optional) the text that appears before each number,

suffix (string, optional - may only be present if prefix is present) the text that appears after each number,

precision (number, optional) the number of decimal places to display,

showX (boolean, optional) is true to display the x-value for the point or false (default) to show the y-value,

zeroes (boolean or number, optional - may only be present if showX is present) is true to display trailing zeroes or false (default) to drop them, or a number of zeroes to show,

separators (boolean, optional - may only be present if showX and zeroes are present) is true to display group separators or false (default) to omit them.

$.gchart.marker('number', 'blue', 0,
	$.gchart.numberFormat($.gchart.formatFloat, 1))
$.gchart.marker('number', 'green', 1,
	$.gchart.numberFormat('cAUD', '', 'M', 2))

Since 1.2.0.
Since 1.4.1 - zeroes can be a number.
$.gchart.findRegion(event, jsonData) object Convert a mouse position into the underlying region of the chart. The returned object has attributes: type being the type of element beneath the mouse, such as 'bar', 'line', 'axis', 'legend', etc., series being the index of the series to which this element applies, and point being the index of the point to which this element applies, or -1 if none. If there is no matching region at the mouse position, null is returned.

event (MouseEvent) the mouse event for the position of interest,

jsonData (object) the JSON description of the chart; obtained through the onLoad and provideJSON options.

$(selector).gchart({onLoad: saveRegions, provideJSON: true}).
	mouseover(function(event) {
		var region = $.gchart.findRegion(event, regionData);
		$('#region').text(!region ? '' :
			region.type + ' ' + region.series + ' ' + region.point);
	});

var regionData = null;

function saveRegions(jsonData) {
	regionData = jsonData
}

Since 1.3.1.

Icon Functions

These functions allow you to create dynamic icons that may be added to your charts via the icons setting. Requires the jquery.gchart.icons.js module.

Since 1.3.0.
Since 1.4.0 - moved icons function to the jquery.gchart.icons.js module.

bubbleIcon | colorVaryIcon | colourVaryIcon | colorSizeVaryIcon | colourSizeVaryIcon | contextualAlignment | embeddedChart | icon | mapPinIcon | noteIcon | outlineIcon | sizeVaryIcon | stackingIcon | stackingColorVaryIcon | stackingColourVaryIcon | weatherIcon

SignatureReturnsComments
$.gchart.icon(name, data, series, item, zIndex, position, offsets) icon object Create an icon definition. This is the basic interface, requiring you to manually encode all parameters. Normally you would use one of the more specific icon functions, but this one would be appropriate for icons not covered by those.

name (string) the name of the icon to use,

data (string) the icon's encoded parameters, separated by commas (,),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.icon('map_spin', '1.0,30,ffcccc,10,b,Here!', 2, 3, 1.0)
$.gchart.bubbleIcon(text, image, tail, large, shadow, bgColour, colour, series, item, zIndex, position, offsets) icon object Create a bubble icon definition, containing text and an optional image.

text (string) the text content, use '|' for line breaks,

image (string, optional) the name of an inset image,

tail (string, optional) the type of tail to use: 'bottomLeft' (default), 'topLeft', 'topRight', 'bottomRight', 'edgeBottomLeft', 'edgeBottomCenter', 'edgeBottomRight', 'edgeTopLeft', 'edgeTopCenter', 'edgeTopRight', 'edgeLeftTop', 'edgeLeftCenter', 'edgeLeftBottom', 'edgeRightTop', 'edgeRightCenter', 'edgeRightBottom', or 'none',

large (boolean, optional) true if a large bubble is required,

shadow (string, optional) indicate whether a shadow is included: 'no', 'yes' (default), 'only' (shadow but no text box),

bgColour (string, optional) the icon background's colour (default 'white'),

colour (string, optional) the icon text's colour (default 'black'),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.bubbleIcon('Here it is')
$.gchart.bubbleIcon('Over here', 'home', 'bottomRight',
	false, 'no', 'lime', 'green', 2, 3, 1.0)

Since 1.3.3 - added edge* tails.
$.gchart.mapPinIcon(letter, image, style, shadow, bgColour, colour, series, item, zIndex, position, offsets) icon object Create a map pin icon definition, containing a letter or an image.

letter (string) the single letter to show,

image (string, optional) the name of an inset image; if present it overrides the letter above,

style (string, optional) the style of pin to use: '' or 'none' (plain), 'star', 'left' (slant), or 'right' (slant),

shadow (string, optional) indicate whether a shadow is included: 'no', 'yes', 'only' (shadow but no map pin),

bgColour (string, optional) the icon background's colour (default 'white'),

colour (string, optional) the icon text's colour (default 'black'),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.mapPinIcon('X')
$.gchart.mapPinIcon('', 'home', 'star', 'no',
	'lime', 'green', 2, 3, 1.0)
$.gchart.noteIcon(title, text, type, large, alignment, colour, series, item, zIndex, position, offsets) icon object Create a fun note icon definition, containing text and an optional image.

title (string) the note title (displayed in bold),

text (string, optional) the text content, use '|' for line breaks,

type (string, optional) the type of note to show: 'arrow', 'balloon', 'pinned', 'sticky' (default), 'taped', or 'thought',

large (boolean, optional) true if a large note is required,

alignment (string, optional) the text alignment within the note: 'left', 'right', or 'center'/'centre' (default),

colour (string, optional) the icon text's colour (default 'black'),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.noteIcon('', 'Here it is')
$.gchart.noteIcon('2010 Q1', 'Big sales', 'taped',
	false, '', 'blue', 2, 3, 1.0)
$.gchart.weatherIcon(title, text, type, image, series, item, zIndex, position, offsets) icon object Create a weather icon definition, containing text and an image.

title (string) the note title (displayed in bold),

text (string, optional) the text content, use '|' for line breaks,

type (string, optional) the type of note to show: 'arrow', 'balloon', 'pinned', 'sticky' (default), 'taped', or 'thought',

image (string, optional) the name of an inset weather image (default 'sunny'),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.weatherIcon('', 'Rain', '', 'rain')
$.gchart.weatherIcon('City', '22-29°C', 'taped',
	'thunder', 2, 3, 1.0)
$.gchart.outlineIcon(text, size, bold, alignment, colour, outline, series, item, zIndex, position, offsets) icon object Create a outlined text icon definition, containing text and an optional image.

text (string) the text content, use '|' for line breaks,

size (number, optional) the text size in pixels (default 10),

bold (boolean, optional) true if bold text is required (default false),

alignment (string, optional) the text alignment within the note: 'left', 'right', or 'center'/'centre' (default),

colour (string, optional) the icon text's fill colour (default 'white'),

outline (string, optional) the icon text's outline colour (default 'black'),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.outlineIcon('Here it is')
$.gchart.outlineIcon('Over here', 20, true, '',
	'yellow', 'red', 2, 3, 1.0)
$.gchart.colorVaryIcon(image, colourSeries, colourLow, colourMiddle, colourHigh, size, outline, alignment, series, item, zIndex, position, offsets) icon object Create a colour variation icon definition.

image (string) the name of the icon,

colourSeries (number) the index of the series that varies the colour of the icons,

colourLow (string, optional) the colour for the bottom of the range (default 'green'), or (string[3]) the low, middle, and high colour values,

colourMiddle (string, optional) the colour for the middle of the range (default 'yellow'),

colourHigh (string, optional) the colour for the top of the range (default 'red'),

size (number, optional) the icon size in pixels, must be one of 12, 16, or 24 (default 12),

outline (string, optional) the outline colour for the icons (default 'black'),

alignment (string, optional) the alignment of the icon - use the contextualAlignment function (default 'hb-0-0' - centred/bottom),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.colorVaryIcon('flag', 1)
$.gchart.colorVaryIcon('book', 2, ['white', 'yellow', 'red'], 24, 'blue',
	$.gchart.contextualAlignment('center'), 2, 3, 1.0)

Since 1.4.2.
$.gchart.colourVaryIcon(image, colourSeries, colourLow, colourMiddle, colourHigh, size, outline, alignment, series, item, zIndex, position, offsets) icon object A synonym for colorVaryIcon.

Since 1.4.2.
$.gchart.sizeVaryIcon(image, sizeSeries, zeroSize, sizeMultiplier, minSize, colour, outline, alignment, series, item, zIndex, position, offsets) icon object Create a size variation icon definition.

image (string) the name of the icon ('maps_pin', 'disk', 'square'),

sizeSeries (number) the index of the series that varies the size of the icons,

zeroSize (number, optional) the icon size for the minimum data value (default 4), or (number[3]) the zero, multiplier, and minimum size values,

sizeMultiplier (number, optional) the size scaling factor - multiplied against the difference between the icon's data value and the minimum series value (default 10),

minSize (number, optional) the minimum size for any icon in pixels (default 4),

colour (string, optional) the fill colour for the icons (default '#88ff88'),

outline (string, optional) the outline colour for the icons (default 'black'),

alignment (string, optional) the alignment of the icon - use the contextualAlignment function (default 'hb-0-0' - centred/bottom),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.sizeVaryIcon('disk', 1)
$.gchart.sizeVaryIcon('book', 2, [6, 12, 8], 'yellow', 'blue',
	$.gchart.contextualAlignment('center'), 2, 3, 1.0)

Since 1.4.2.
$.gchart.colorSizeVaryIcon(image, colourSeries, colourLow, colourMiddle, colourHigh, sizeSeries, zeroSize, sizeMultiplier, minSize, outline, alignment, series, item, zIndex, position, offsets) icon object Create a colour and size variation icon definition.

image (string) the name of the icon,

colourSeries (number) the index of the series that varies the colour of the icons,

colourLow (string, optional) the colour for the bottom of the range (default 'green'), or (string[3]) the low, middle, and high colour values,

colourMiddle (string, optional) the colour for the middle of the range (default 'yellow'),

colourHigh (string, optional) the colour for the top of the range (default 'red'),

sizeSeries (number) the index of the series that varies the size of the icons,

zeroSize (number, optional) the icon size for the minimum data value (default 4), or (number[3]) the zero, multiplier, and minimum size values,

sizeMultiplier (number, optional) the size scaling factor - multiplied against the difference between the icon's data value and the minimum series value (default 10),

minSize (number, optional) the minimum size for any icon in pixels (default 4),

outline (string, optional) the outline colour for the icons (default 'black'),

alignment (string, optional) the alignment of the icon - use the contextualAlignment function (default 'hb-0-0' - centred/bottom),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.colorSizeVaryIcon('flag', 1, 2)
$.gchart.colorSizeVaryIcon('book',
	2, ['white', 'yellow', 'red'], 3, [6, 12, 8], 'blue',
	$.gchart.contextualAlignment('center'), 2, 3, 1.0)

Since 1.4.2.
$.gchart.colourSizeVaryIcon(image, colourSeries, colourLow, colourMiddle, colourHigh, sizeSeries, zeroSize, sizeMultiplier, minSize, outline, alignment, series, item, zIndex, position, offsets) icon object A synonym for colorSizeVaryIcon.

Since 1.4.2.
$.gchart.stackingIcon(image, repeatSeries, scalingFactor, horizontal, size, colour, outline, spacing, alignment, series, item, zIndex, position, offsets) icon object Create a stacking icon definition.

image (string) the name of the icon,

repeatSeries (number) the index of the series that varies the stacking of the icons,

scalingFactor (number, optional) the scaling factor to derive the number of icons used (default 10),

horizontal (boolean, optional) true if the stacking should be horizontal (default false),

size (number, optional) the icon size in pixels, must be one of 12, 16, or 24 (default 12),

colour (string, optional) the fill colour for the icons (default '#88ff88'),

outline (string, optional) the outline colour for the icons (default 'black'),

spacing (number, optional) the number of pixels between icons (default 0),

alignment (string, optional) the alignment of the icons - use the contextualAlignment function (default 'hb-0-0' - centred/bottom),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.stackingIcon('flag', 1)
$.gchart.stackingIcon('book', 2, 5, 16, 'yellow', 'blue', 2,
	$.gchart.contextualAlignment('top'), 2, 3, 1.0)

Since 1.4.2.
$.gchart.stackingColorVaryIcon(image, repeatSeries, scalingFactor, horizontal, size, colourSeries, colourLow, colourMiddle, colourHigh, outline, spacing, alignment, series, item, zIndex, position, offsets) icon object Create a stacking and colour variation icon definition.

image (string) the name of the icon,

repeatSeries (number) the index of the series that varies the stacking of the icons,

scalingFactor (number, optional) the scaling factor to derive the number of icons used (default 10),

horizontal (boolean, optional) true if the stacking should be horizontal (default false),

size (number, optional) the icon size in pixels, must be one of 12, 16, or 24 (default 12),

colourSeries (number) the index of the series that varies the colour of the icons,

colourLow (string, optional) the colour for the bottom of the range (default 'green'), or (string[3]) the low, middle, and high colour values,

colourMiddle (string, optional) the colour for the middle of the range (default 'yellow'),

colourHigh (string, optional) the colour for the top of the range (default 'red'),

outline (string, optional) the outline colour for the icons (default 'black'),

spacing (number, optional) the number of pixels between icons (default 0),

alignment (string, optional) the alignment of the icons - use the contextualAlignment function (default 'hb-0-0' - centred/bottom),

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

$.gchart.stackingColorVaryIcon('flag', 1, 2)
$.gchart.stackingColorVaryIcon('book',
	2, 5, 16, ['yellow', 'orange', 'red'], 'blue', 2,
	$.gchart.contextualAlignment('top'), 2, 3, 1.0)

Since 1.4.2.
$.gchart.stackingColourVaryIcon(image, colourSeries, colourLow, colourMiddle, colourHigh, sizeSeries, zeroSize, sizeMultiplier, minSize, outline, alignment, series, item, zIndex, position, offsets) icon object A synonym for stackingColorVaryIcon.

Since 1.4.2.
$.gchart.contextualAlignment(position, hOffset, vOffset) string Create an alignment value for use with the colorVaryIcon, sizeVaryIcon, colorSizeVaryIcon, stackingIcon, or stackingColorVaryIcon functions.

position (string) the base position of the icon relative to the data point ('topLeft', 'top', 'topRight', 'left', 'center', 'centre', 'right', 'bottomLeft', 'bottom', 'bottomRight', 'tl', 'lt', 't', 'ht', 'tr', 'rt', 'l', 'lv', 'c', 'hc', 'hv', 'r', 'rv', 'bl', 'lb', 'b', 'hb', 'br', 'rb'),

hOffset (number, optional) the horizontal offset in pixels (default 0),

vOffset (number, optional) the vertical offset in pixels (default 0)

$.gchart.contextualAlignment('center')
$.gchart.contextualAlignment('topLeft', 10)
$.gchart.contextualAlignment('br', -10, -20)

Since 1.4.2.
$.gchart.embeddedChart(embeddedOptions, bubble, alignment, padding, frameColour, fillColour, series, item, zIndex, position, offsets) icon object Create an embedded chart definition.

embeddedOptions (object) the full set of options for the embedded chart,

bubble (boolean, optional) true if the chart should be embedded in a bubble (default false),

alignment (string, optional) the alignment of the embedded chart if not in a bubble ('topLeft', 'tl', 'top', 't', 'topRight', 'tr', 'left': 'l', 'center', 'centre', 'c', 'right', 'r', 'bottomLeft' (default), 'bl', 'bottom', 'b', 'bottomRight', 'br'), or the appearance and positioning of a tail for a bubble ('bottomLeft' (default), 'topLeft', 'topRight', 'bottomRight', 'edgeBottomLeft', 'edgeBottomCenter', 'edgeBottomRight', 'edgeTopLeft', 'edgeTopCenter', 'edgeTopRight', 'edgeLeftTop', 'edgeLeftCenter', 'edgeLeftBottom', 'edgeRightTop', 'edgeRightCenter', 'edgeRightBottom', or 'none'),

padding (number, optional) the padding in pixels inside the bubble (default 4) - omit if not a bubble,

frameColour (string, optional) the colour of the bubble frame (default '#00d0d0') - omit if not a bubble,

fillColour (string, optional) the colour for the bubble background (default '#80ffff') - omit if not a bubble,

series (number, optional) the index of the series to which the icon applies (0 (default) to n) or -1 for freestanding,

item (number or string or number[2 or 3], optional) the item (default 0) in the series to which it applies (include a fractional part for intermediate positioning) or 'all' for all points in that series (the default) or 'everyn' where n is a number to regularly space the icons or [start, end, every] to only apply markers to the specified range of points and optionally evenly space them,

zIndex (number, optional) the z-index: -1.0 (behind) through 0.0 (normal) to 1.0 (above),

position (number[2], optional) an absolute chart position (0.0 at bottom/left to 1.0 at top/right), which overrides a series and item,

offsets (number[2], optional) pixel offsets from the calculated position.

var embedded = {type: 'pie',
	series: [$.gchart.series([10, 20, 30])],
	dataLabels: ['Q1', 'Q2', 'Q3']}
$.gchart.embeddedChart(embedded, 1, 7)
$.gchart.embeddedChart(embedded, 'center', 1, 7)
$.gchart.embeddedChart(embedded, true, 'bottomRight',
	2, '#808000', '#ffffcc' 1, 7)

Since 1.4.3.

Constants

Various constants are available for your use.

barWidthAuto | barWidthRelative | calculate | formatCurrency | formatFloat | formatPercent | formatScientific | mapAfrica | mapAsia | mapAustralia | mapEurope | mapNorthAmerica | mapSouthAmerica

NameTypeComments
$.gchart.barWidthAutostring Assign this value to the barWidth setting to have the bars in a bar chart automatically resize to fill the chart.

Since 1.2.0.
$.gchart.barWidthRelativestring Assign this value to the barWidth setting to have the bars in a bar chart resized based on the barSpacing and barGroupSpacing settings being relative values (0.0 to 1.0).

Since 1.2.0.
$.gchart.calculatenumber Use this value for the minValue or maxValue settings to calculate from the actual data values.
$.gchart.formatCurrencystring Use this value for the type in a numberFormat call for a currency value in conjunction with the three-character currency code - automatically displays the currency sign.

Since 1.2.0.
$.gchart.formatFloatstring Use this value for the type in a numberFormat call for a floating point number.

Since 1.2.0.
$.gchart.formatPercentstring Use this value for the type in a numberFormat call for a percentage value - multiplies the value by 100 and appends '%'.

Since 1.2.0.
$.gchart.formatScientificstring Use this value for the type in a numberFormat call for a number in scientific notation (e.g. 1.234e5).

Since 1.2.0.
$.gchart.mapAfricanumber[4] Use this value for the mapArea in a map call in conjunction with a latLongArea of true to show all of Africa. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.mapAsianumber[4] Use this value for the mapArea in a map call in conjunction with a latLongArea of true to show all of Asia. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.mapAustralianumber[4] Use this value for the mapArea in a map call in conjunction with a latLongArea of true to show all of Australia. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.mapEuropenumber[4] Use this value for the mapArea in a map call in conjunction with a latLongArea of true to show all of Europe. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.mapNorthAmericanumber[4] Use this value for the mapArea in a map call in conjunction with a latLongArea of true to show all of North America. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.
$.gchart.mapSouthAmericanumber[4] Use this value for the mapArea in a map call in conjunction with a latLongArea of true to show all of South America. Requires the jquery.gchart.ext.js module.

Since 1.3.3.
Since 1.4.0 - moved to the jquery.gchart.ext.js module.

Axis Objects

Due to the large number of details that define an axis, they are now represented by a separate object (GChartAxis). Use the axis function to create GChartAxis objects and add them to the chart with the axes setting. Thereafter they may be updated via the functions listed below.

Since 1.2.0.

Functions

axis | color | drawing | format | labels | positions | range | style | ticks

SignatureReturnsComments
axis(axis)GChartAxis object or string Update the axis position for this axis or retrieve its current value (if no parameters are supplied).

axis (string) is the new position: 'top', 'bottom' or 'x', 'left' or 'y', or 'right'.

var axisName = axis.axis();
axis.axis('bottom');
color(lineColour)GChartAxis object or string Update the line colour for this axis or retrieve the current line colour (if no parameters are supplied). See the section on colour for more details.

lineColour (string) is the new line colour.

var lineColour = axis.color();
axis.color('blue');

Since 1.4.1.
labels(labels)GChartAxis object or string[] Update the labels for this axis or retrieve the current labels (if no parameters are supplied). Unless positioned, these labels are evenly spaced along the axis starting and ending at the edges of the chart.

labels (string[]) is the new labels.

var labels = axis.labels();
axis.labels(['2006', '2007', '2008']);
positions(positions)GChartAxis object or number[] Update the axis label positions for this axis or retrieve the current label positions (if no parameters are supplied). The positions of the labels along the axis are values from the range start (0 by default) at the bottom/left to the range end (100 by default) at the top/right. If positions are defined but no labels are supplied, then these values become the labels as well.

positions (number[]) is the new label positions.

var posns = axis.positions();
axis.positions([10, 50, 90]);
range(start, end, interval)GChartAxis object or object Update the range of values for this axis or retrieve the current range (if no parameters are supplied) as an object with start, end, and interval attributes.

start (number) is the starting value for the range,

end (number) is the ending value for the range, which may be less than the starting value to invert the labels,

interval (number, optional) is the interval between values in the range, and defaults to 1/10th of the range.

var range = axis.range();
axis.range(200, 400, 40);
style(colour, alignment, size)GChartAxis object or object Update the style for this axis or retrieve the current style (if no parameters are supplied) as an object with color, alignment, and size attributes.

colour (string) is the colour for the axis, and also applies to the tick marks unless tick colour is specified; see the section on colour for more details,

alignment (string, optional) is the alignment for the axis labels: 'left', 'center', or 'right',

size (number, optional) is the size of the label font in pixels.

var style = axis.style();
axis.style('red', 'right', 20);
drawing(drawing)GChartAxis object or string Update the drawing control for this axis or retrieve the current drawing control (if no parameters are supplied).

drawing (string) is the new drawing control: 'line', 'ticks', or 'both'.

var drawing = axis.drawing();
axis.drawing('ticks');
ticks(colour, length)GChartAxis object or object Update the tick mark style for this axis or retrieve the current tick mark style (if no parameters are supplied) as an object with color and length attributes.

colour (string) is the colour for the tick marks, and overrides the axis colour setting; see the section on colour for more details,

length (number or number[], optional) is the length of the tick marks or an array of lengths to cycle through; negative values draw inside the chart; the maximum positive value is 25.

var ticks = axis.ticks();
axis.ticks('blue', -10);

Since 1.4.1 - length can be an array.
format(type, prefix, suffix, precision, showX, zeroes, separators) GChartAxis object or object Update the number format for the axis labels or retrieve the current number format style (if no parameters are supplied) as an object with type, prefix, suffix, precision, showX, zeroes, and separators attributes.

type (string) the type of format: $.gchart.formatFloat ('f'), $.gchart.formatPercent ('p'), $.gchart.formatScientific ('e'), or $.gchart.formatCurrency ('c') - with the last you also need to add the three-character currency designation, e.g. AUD or EUR,

prefix (string, optional) the text that appears before each number,

suffix (string, optional - may only be present if prefix is present) the text that appears after each number,

precision (number, optional) the number of decimal places to display,

showX (boolean, optional) is true to display the x-value for the point or false (default) to show the y-value,

zeroes (boolean, optional - may only be present if showX is present) is true to display trailing zeroes or false (default) to drop them, or a number of zeroes to show,

separators (boolean, optional - may only be present if showX and zeroes are present) is true to display group separators or false (default) to omit them.

var format = axis.format();
axis.format($.gchart.formatFloat, 3);

Since 1.3.0.
Since 1.4.1 - zeroes can be a number.