KupoChart 0.1.0 Documentation: 2D Pie Charts

Required Parameters

To graph a 2D pie chart, you must pass the following required parameters:

• cht:
  Chart type. Must be set to 'p'.



• chd:
  Chart data. This is a string of comma-delimited values, preceded by 't:' indicating 'text' data type. Support for other data types will be added later.
  
  Example: t:12,37,15,9,20,7
  
  Note that unlike Google Chart, values do not need to add up to 100 in this mode. If values of 100 and 900 are provided, the 100 slice will be 10% of the pie and the 900 slice will be 90%. Google Chart would crop each value to 100 and display a pie with two 50% slices.

Optional Parameters

When graphing a pie chart, one may pass the following optional parameters:

• chs:
  Chart size, in pixels. In the form WIDTHxHEIGHT. Maximum size is 1600x1600 by default. Default size is 120x120 by default.
  Example: chs=200x200
  
  
  
  
• chco:
  Chart colours. This is a string of comma-delimited colours. These may be HTML-style hex colours (e.g. 'FFFF00'), named colour entities (e.g. 'yellow'), or a mix of both. When using hex colours, do not include the hash or pound sign (i.e. use '00FFAA' instead of '#00FFAA').
  Example: chco=220099,7733DD,violet,purple,indigo
  
  If no colours are provided, the following default colours will be assigned, in this order (read from left to right, top down):
  
  
• outputtype:
  Output type. Acceptable values are:
  
  • png: Output a PNG image. This is the default.
  • svg: Output a SVG (Scalable Vector Graphics) file. Note that SVG support presently lags somewhat behind PNG support.

  Example output: PNG vs. SVG
  PNG, 125x125 pixels	SVG, nominally 125x125 (scalable)

Examples

The following are several real examples of pie chart output using KupoChart.

• Small pie chart, five slices, user-specified colours, PNG output:
  kupochart.php?cht=p&chd=t:1,2,3,4,5&chco=220099,7733DD,violet,purple,indigo&chs=125x125
  
  



• Medium-sized pie chart, eight slices, default colours, SVG output:
  kupochart.php?cht=p&chd=t:1.3,2.8,9.2,7.3,5,4.1,5.7,6.9&outputmode=svg&chs=400x400