3D Bar Chart Applet: Chapter 5
(Trial Version)
![]() ![]() ![]() |
Chart Parameters For an applet, you can pass parameters using the following tag format: <PARAM NAME="parameter name" VALUE="parameter value>
For 3D Bar Chart, some of the parameters may have more than one fields. For example,
"Title" parameter have four fields:
So, the "|" charactor is used to separate the fields like this |
Parameters Summary
Chart Properties | Legend Properties | Labels Properties | Data Properties |
nSeries,
|
LegendPos,
|
BarLabelFormat,
|
Parameters List
1. Chart Properties
Name | nSeries |
Format | value = "4" |
Description |
Number of series for the chart. |
Example | <param name="nSeries" value="4"> |
Required | Yes |
Name | nElements |
Format | value = "5" |
Description |
Number of elements in each series for the chart. |
Example | <param name="nElements" value="5"> |
Required | Yes |
Name | LicenseKey |
Format | value = "A4-E5-23-35-F2-E5..." |
Description |
The license key for 3D chart applet. This is the license key you receive when
you purchased the single domain license. (There is no license key needed for multiple
domains license). |
Example | <param name="LicenseKey" value="A4-E5-23-35-F2-E5..."> |
Required | Yes for single domain license |
Name | Title |
Format | value = "Title Text|font|color|position" |
Description | This is the title of the chart. |
Values |
Title Text: any text |
Example | <param name="Title" value="Sales Report|Arial,plain,30|blue|50,50"> |
Required | Yes |
Name | Subtitle |
Format | value = "Subtitle Text|font|color|position" |
Description | This is the subtitle of the chart. |
Values |
Title Text: any text |
Example | <param name="Subtitle" value="(in Millions $)|Arial,plain,20|blue|50,50"> |
Required | Yes |
Name | TitleShadow |
Format | value = "true" |
Description | Have drop shadow for the titles. Apply to both title and subtitle. |
Values | true or false |
Example | <param name="TitleShadow" value="true"> |
Default Value | false |
Required | No |
Name | TitleEffect |
Format | value = "fromleft" |
Description |
There are some special effects for displaying the title. |
Values | "fadein", "fromleft", "fromright", "fadeinfromleft", "fadeinfromright" |
Example | <param name="TitleEffect" value="fadein"> |
Default Value | no special effect |
Required | No |
Name | BgColor | ||||||
Format |
value = "Color" |
||||||
Description |
This is the background Color. If there is one color specified, the background will be filled with a single color. If there are two color specified, the background will be filled with gradient colors. The Color1 on top and Color2 on bottom. |
||||||
Values | Please refer to Colors property. | ||||||
Examples |
|
||||||
Default Value | white | ||||||
Required | Yes |
Name | BgImage |
Format | value = "image.gif" |
Description |
This is the background image you want to use as the background of the chart. |
Example | <param name="BgImage" value="images/clouds.jpg"> |
Required | No |
Name | Scale |
Format | value = "100" |
Description |
This is the scale value for the chart. A scale value of 100 will make the size of the 3D Chart around 200x200 pixels. |
Example | <param name="scale" value="100"> |
Required | Yes |
Name | AutoYScale |
Format | value = "true" |
Description |
Calculates the Y scale for you by the software including YMax, YMin, and YIntervals. |
Values | true or false |
Example | <param name="YMax" value="1000"> |
Default Value | false |
Required | No |
Name | YMax |
Format | value = "1000" |
Description |
Maximum value of the Y scale. |
Example | <param name="YMax" value="1000"> |
Required | Yes if "AutoYScale" is set to false. |
Name | YMin |
Format | value = "0" |
Description |
Minimum value of the Y scale. |
Example | <param name="YMin" value="0"> |
Required | Yes if "AutoYScale" is set to false. |
Name | YIntervals |
Format | value = "100" |
Description |
The intervals between YMax and YMin. |
Example | <param name="YIntervals" value="100"> |
Required | Yes if "AutoYScale" is set to false. |
Name | ChartPos |
Format | value = "200, 250" |
Description |
This is the screen position of the chart. It is using the chart center as the anchor point. If you set the position as (200,200), that's means the center of the chart is at (200,200). |
Values | Please refer to position property for detail. |
Example | <param name="ChartPos" value="200,250"> |
Default Value | center of the applet window. |
Required | Yes |
Name | rotateX |
Format | value = "-30" |
Description |
Rotation angle of the chart along X axis. |
Values | Please refer to 3D Rotations property for detail. |
Example | <param name="rotateX" value="-30"> |
Default Value | 0 |
Required | No |
Name | rotateY |
Format | value = "-45" |
Description |
Rotation angle of the chart along Y axis. |
Values | Please refer to 3D Rotations property for detail. |
Example | <param name="rotateY" value="-45"> |
Default Value | 0 |
Required | No |
Name | ChartEffect |
Format | value = "Rotation|Movment" |
Description |
This is special effects when the chart is loading. For rotations, it is just like car show turntable display. You can see the chart in 360 degrees. For movment, the bars can comes up from the floor, down from top, or from the front. |
Values |
Rotation:
|
Example |
Rotate to left:
|
Default Value | no special effect |
Required | No |
Name | Antialiasing |
Format | value = "true" |
Description |
Antialiasing effect on the chart and make the chart graphic look smoother. |
Values | true or false |
Example | <param name="Antialiasing" value="true"> |
Default Value | false |
Required | No |
Name | WallColor |
Format |
value = "nofill" |
Description |
The color for the back walls. If "nofill" means, the backwalls will be drawed with wire frame without color. |
Values | "nofill" or any colors |
Example |
<param name="WallColor" value="nofill"> <param name="WallColor" value="blue"> |
Default Value | lightgray |
Required | No |
Name | BarFrame |
Format | value = "true" |
Description |
The frame around the bars. i.e. drawing lines around the bars. |
Values | true or false |
Example | <param name="BarFrame" value="true"> |
Default Value | false |
Required | No |
Name | ShowTitle |
Format | value = "false" |
Description |
Show the title and subtitle. |
Values | true or false |
Example | <param name="ShowTitle" value="false"> |
Default Value | true |
Required | No |
Name | ShowGrid |
Format | value = "false" |
Description |
Show grid on the back walls. |
Values | true or false |
Example | <param name="ShowGrid" value="false"> |
Default Value | true |
Required | No |
2. Legend Properties
Name | LegendPos |
Format | value = "200, 250" |
Description |
This is the screen position of the legend. The anchor point is the top-left corner of the legend box. |
Values | Please refer to position property for detail. |
Example | <param name="LegendPos" value="200,200"> |
Default Value | lower-right-hand side of the applet window. |
Required | Yes |
Name | LegendOrientation |
Format | value = "vertical" |
Description |
The orientation of the legend. It can be either vertical or horizontal. |
Values | "vertical", "horizontal" |
Example | <param name="LegendOrientation" value="horizontal"> |
Default Value | vertical |
Required | No |
Name | LegendBoxColor |
Format | value = "yellow" |
Description |
The color of the legend box. |
Values | any colors |
Example | <param name="LegendBoxColor" value="yellow"> |
Default Value | yellow |
Required | No |
Name | LegendFontColor |
Format | value = "font|color" |
Description |
The font and color for the text in the legend box. |
Values | fonts and colors |
Example | <param name="LegendFontColor" value="Arial,plain,12|black"> |
Default Value | font: Arial, plain, 12; color: black |
Required | No |
Name | ShowLegend |
Format | value = "false" |
Description |
Show legend. |
Values | true or false |
Example | <param name="ShowLegend" value="false"> |
Default Value | true |
Required | No |
3. Labels Properties
Name | BarLabelFormat |
Format | value = "detail" |
Description |
When a bar is click, a label will show the data value of the bar. The basic format only show the data value. The detail format will show the series name, category name, and data value. |
Values | "basic", "detail" |
Example | <param name="BarLabelFormat" value="basic"> |
Default Value | "basic" |
Required | No |
Name | BarLabelFont |
Format | value = "font" |
Description |
The font type for the data label of the bar. |
Values | fonts |
Example | <param name="BarLabelFont" value="Arial,plain,10"> |
Default Value | Arial, plain, 10 |
Required | No |
Name | XAxisTitle |
Format | value = "Months" |
Description |
The category title for X axis. |
Values | any text |
Example | <param name="XAxisTitle" value="Quarters"> |
Required | Yes |
Name | YAxisTitle |
Format | value = "Sales (in Millions $)" |
Description |
The category title for Y axis. |
Values | any text |
Example | <param name="YAxisTitle" value="Revenues"> |
Required | Yes |
Name | ZAxisTitle |
Format | value = "Years" |
Description |
The category title for Z axis. |
Values | any text |
Example | <param name="ZAxisTitle" value="Products"> |
Required | Yes |
Name | XLabelFontColor |
Format | value = "font|color" |
Description |
The font and color for the labels for X axis. |
Values | fonts and colors |
Example | <param name="XLabelFontColor" value="Arial,plain,12|black"> |
Default Value | font: Arial, plain, 12; color: black |
Required | No |
Name | YLabelFontColor |
Format | value = "font|color" |
Description |
The font and color for the labels for Y axis. |
Values | fonts and colors |
Example | <param name="YLabelFontColor" value="Arial,plain,12|black"> |
Default Value | font: Arial, plain, 12; color: black |
Required | No |
Name | ZLabelFontColor |
Format | value = "font|color" |
Description |
The font and color for the labels for Z axis. |
Values | fonts and colors |
Example | <param name="ZLabelFontColor" value="Arial,plain,12|black"> |
Default Value | font: Arial, plain, 12; color: black |
Required | No |
Name | YLabelFormat |
Format | value = "$#,###,###.00" |
Description |
The label format for the labels for Y axis. |
Values | Label Format |
Example | <param name="YLabelFormat" value="$#,###,###.00"> |
Default Value | ######### |
Required | Yes |
Name | XLabel1, XLabel2, ... , XLabel{n}; where n = nElements |
Format | value = "January" |
Description |
The labels for X axis. |
Values | any text |
Example |
<param name="XLabel1" value="Jan"> <param name="XLabel2" value="Feb"> <param name="XLabel3" value="Mar"> <param name="XLabel4" value="Apr"> <param name="XLabel5" value="May"> |
Required | Yes |
Name | ShowXLabels |
Format | value = "false" |
Description |
Show labels of X axis. |
Values | true or false |
Example | <param name="ShowXLabels" value="false"> |
Default Value | true |
Required | No |
Name | ShowYLabels |
Format | value = "false" |
Description |
Show labels of Y axis. |
Values | true or false |
Example | <param name="ShowYLabels" value="false"> |
Default Value | true |
Required | No |
Name | ShowZLabels |
Format | value = "false" |
Description |
Show labels of Z axis. |
Values | true or false |
Example | <param name="ShowZLabels" value="false"> |
Default Value | true |
Required | No |
4. Data Properties
Name | Series1Label, Series2Label, ... , Series{n}Label; where n = nSeries |
Format | value = "2001" |
Description |
The labels for each series. |
Values | any text |
Example |
<param name="Series1Label" value="2001"> <param name="Series2Label" value="2002"> <param name="Series3Label" value="2003"> <param name="Series4Label" value="2004"> |
Required | Yes |
Name | Series1Color, Series2Color, ... , Series{n}Color; where n = nSeries |
Format | value = "red" |
Description |
The color for each series. |
Values | any colors |
Example |
<param name="Series1Color" value="red"> <param name="Series2Color" value="green"> <param name="Series3Color" value="blue"> <param name="Series4Color" value="orange"> |
Required | Yes |
Name | Series1Data, Series2Data, ... , Series{n}Data; where n = nSeries |
Format | value = "34, 56, 25, 78" |
Description |
The list of data for each series. Each data is separate by a comma or a space. |
Values | any numbers separated by a comma or a space |
Example |
<param name="Series1Data" value="12, 45, 34, 55"> <param name="Series2Data" value="23, 33, 56, 34"> <param name="Series3Data" value="44, 56, 45, 62"> <param name="Series4Data" value="43, 34, 56, 33"> |
Required | Yes |