graph chart

Advanced Pie Chart

2D / 3D Pie Chart, version 3.2
by Sirius Computer Consultants Limited

Pie Chart Configuration Options

Whichever method ( file, html code, server process etc.) you choose to supply the graph with the configuration options the various parameters all follow the same format of
[Parameter Name] , [Parameter Value].

Below you will find each option detailed with examples for supplying by file and html code.

Please Note : Parameters Names are case sensitive. ( i.e.. axis is not the same as Axis ).

Graph Switches ( Boolean flags )

Parameter Name : 3D
Description : Specifies whether the graph should be drawn in 2D or 3D.
Range of Values : true or false
File Example : 3D true
Html Code Example : <PARAM name="3D" value="true">

Parameter Name : Slabels
Description : Specifies whether the segment labels should be drawn.
Range of Values : true or false
File Example : Slabels true
Html Code Example : <PARAM name="Slabels" value="true">

Parameter Name : legend
Description : Specifies whether the legend should be automatically generated.
Range of Values : true or false
File Example : legend true
Html Code Example : <PARAM name="legend" value="true">

Graph Characteristics ( Integer Values )

Parameter Name : nPies
Description : Defines the number of Pies to be drawn. (e.g.. If you have 3 series each with 4 pieces of data then this should be set to 3).
Range of Values : Integer Value
File Example : nPies 3
Html Code Example : <PARAM name="nPies" value="3">

Parameter Name : depth3D
Description : Defines the depth of the 3D effect .
Range of Values : Integer Value
File Example : depth3D 15
Html Code Example : <PARAM name="depth3D" value="15">

Parameter Name : ndecplaces
Description : Defines the number of decimal places to use when displaying values.
Range of Values : Integer Value
File Example : ndecplaces 3
Html Code Example : <PARAM name="ndecplaces" value="3">

Parameter Name : 3Dangle
Description : If in 3D mode this defines the angle in the "z plane". This value is in degrees and can range from 0 to 90.
Range of Values : Integer Value
File Example : 3Dangle 50
Html Code Example : <PARAM name="3Dangle" value="50">

Pie Characteristics
For each series of data, it is necessary to define the characteristics of that Pie,
X position, Y position, Pie Size, Number of Segments and Segment Seperation.

For example if we have 3 series of the data,

File Example :
Pie1 50,75,150,6,0
Pie2 350,75,150,6,10
Pie3 175,250,150,6,10

Html Code Example :
<PARAM name="Pie1" value="50,75,150,6,0">
<PARAM name="Pie2" value="350,75,150,6,10">
<PARAM name="Pie3" value="175,250,150,6,10">

Pie Segment Labels
The pie segment labels are supplied by the pieMlabelN parameter, where M & N represent integer numbers starting with 1. For example if you have 3 series each four 4 pieces of data (i.e. 4 segments in each pie) then 4 labels should be supplied for each pie e.g.,

File Example :
pie1label1 North America
pie1label2 Europe
pie1label3 Asia
pie1label4 Africa

pie2label1 North America
pie2label2 Europe
pie2label3 Asia
pie2label4 Africa

pie3label1 North America
pie3label2 Europe
pie3label3 Asia
pie3label4 Africa

Html Code Example :
<PARAM name="pie1label1" value="North America">
<PARAM name="pie1label2" value="Europe">
<PARAM name="pie1label3" value="Asia">
<PARAM name="pie1label4" value="Africa">

<PARAM name="pie2label1" value="North America">
<PARAM name="pie2label2" value="Europe">
<PARAM name="pie2label3" value="Asia">
<PARAM name="pie2label4" value="Africa">

<PARAM name="pie3label1" value="North America">
<PARAM name="pie3label2" value="Europe">
<PARAM name="pie3label3" value="Asia">
<PARAM name="pie3label4" value="Africa">

Segment Data
The pie segment data is supplied by the segmentN parameter, where N represents an integer numbers starting with 1. The segmentN parameter defines both the segment color and the legend label for each series. For example if you have 3 series each four 4 pieces of data (i.e. 4 segments in each pie) then four segment parameters should be supplied e.g.,

File Example :
segment1 115,152,164|North America
segment2 99,99,156|Europe
segment3 185,53,8|Asia
segment4 239,214,115|Africa

Html Code Example :
<PARAM name="segment1" value="115,152,164|North America">
<PARAM name="segment2" value="99,99,156|Europe">
<PARAM name="segment3" value="185,53,8|Asia">
<PARAM name="segment4" value="239,214,115|Africa">

Font Information
Most of the font information is incorporated into other parameters (see Titles below) however the following two fonts are defined as follows,

Parameter Name : font14
Description : Defines the font for the Pop-Up Values.
Range of Values : Font Definition (click here for More on Defining fonts) .
File Example : font14 TimesRoman,I,10
Html Code Example : <PARAM name="font14" value="TimesRoman,I,10">

Parameter Name : font15
Description : Defines the font for the segment labels.
Range of Values : Font Definition (click here for More on Defining fonts) .
File Example : font15 TimesRoman,I,10
Html Code Example : <PARAM name="font15" value="TimesRoman,N,10">

Color Information
Most of the color information is incorporated into other parameters (see Titles below) however the following six colors are defined as follows,

Parameter Name : color16
Description : Defines the background color.
Range of Values : Color Definition (click here for More on Defining colors) .
File Example : color16 0,100,100
Html Code Example : <PARAM name="color16" value="0,100,100">

Parameter Name : color18
Description : Defines the label text color.
Range of Values : Color Definition (click here for More on Defining colors) .
File Example : color18 0,0,0
Html Code Example : <PARAM name="color18" value="0,0,0">

Automatic Legend
The following set of parameters define the characteristics of the automatic legend,

Parameter Name : legendfont
Description : Defines the font for the legend.
Range of Values : Font Definition (click here for More on Defining fonts) .
File Example : legendfont Arial,N,10
Html Code Example : <PARAM name="legendfont" value="Arial,N,10">

Parameter Name : legendposition
Description : Defines the x,y position of the top left of the legend.
Range of Values : integer number (X value), integer number (Y value) .
File Example : legendposition 200,5
Html Code Example : <PARAM name="legendposition" value="200,5">

Parameter Name : legendtitle
Description : The text for legend title.
Range of Values : text .
File Example : legendtitle Product Sales
Html Code Example : <PARAM name="legendtitle" value="Product Sales">

Parameter Name : legendBackground
Description : Legend background color
Range of Values : Color Definition (click here for More on Defining colors).
File Example : legendBackground 200,200,200
Html Code Example : <PARAM name="legendBackground" value="200,200,200">

Parameter Name : legendBorder
Description : Legend border color
Range of Values : Color Definition (click here for More on Defining colors).
File Example : legendBorder 125,125,125
Html Code Example : <PARAM name="legendBorder" value="125,125,125">

Parameter Name : legendtextColor
Description : Legend text color
Range of Values : Color Definition (click here for More on Defining colors).
File Example : legendtextColor 0,0,0
Html Code Example : <PARAM name="legendtextColor" value="0,0,0">

Graph Title

Parameter Name : title
Description : Defines the main title for the graph. This parameter is made up of four elements each separated by a | character. The four elements represent, Title Text, Title Position, Font and Text Color.
Range of Values : Text | Position | Font definition | Color definition.
File Example : title Sales by Quarter|50,20|TimesRoman,BI,18|100,100,100
Html Code Example :
<PARAM name="title
" value="Sales by Quarter|50,20|TimesRoman,BI,18|100,100,100">

Free Form Text
In addition to the title parameter, the graph allows for 10 additional lines of text to be added to the graph image. This is achieved via the "textN" parameter, where N can range from 1 to 10. As with the titles, the textN parameter is made up of four elements each separated by a | character. The four elements represent, Title Text, Title Position, Font and Text Color.
Range of Values : Text | Position | Font definition | Color definition.

File Example :
text1 Note :|80,60|TimesRoman,N,12|0,0,255
text2 New product range|80,80|TimesRoman,N,12|0,0,0
text3 launched during|80,100|TimesRoman,N,12|0,0,0
text4 quarter 2.|80,120|TimesRoman,N,12|0,0,0

Html Code Example :
<PARAM name="text1" value="Note :|80,60|TimesRoman,N,12|0,0,255">
<PARAM name="text2" value="New product range|80,80|TimesRoman,N,12|0,0,0">
<PARAM name="text3" value="launched during|80,100|TimesRoman,N,12|0,0,0">
<PARAM name="text4" value="quarter 2.|80,120|TimesRoman,N,12|0,0,0">

Free Form Images
The graph allows for the incorporation of upto 10 images/icons to be added to the graph image. This is achieved via the "imageN" parameter, where N can range from 1 to 10.

This feature is particularly useful where you wish to incorporate a company / product logo into the graph image. It can also be used to incorporate a custom designed legend into the graph image (in this case remember to turn off the automatic legend).

The imageN parameter is made up of three elements each separated by a , (comma) character. The three elements represent,
Image URL, X position, Y position.

Range of Values : URL , X position , Y position.

File Example :
image1 ./images/logo.gif,0,0
image2 ./images/legend.gif,210,0

Html Code Example :
<PARAM name="image1" value="./images/logo.gif,0,0">
<PARAM name="image2" value="./images/legend.gif,210,0">

 

Documentation

Contents

Introduction

Implementing

Data and Configuration

Graph Printing

Pie Chart & JavaScript

Applet or Servlet ?

Examples

Configuration Options and Parameters

Licensing and Purchasing Options

Further Information and Support

More Graph and Chart Functions