3D Bar Chart Applet: Chapter 5
(Trial Version)

Previous Page Table Of Contents Next Page

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:

       1.  Title Text
       2.  Title Font
       3.  Title Color
       4.  Title Position

So, the "|" charactor is used to separate the fields like this
<param name="Title" value = "Title Text|font|color|position">

Parameters Summary

Chart Properties Legend Properties Labels Properties Data Properties

nSeries,
nElements,
LicenseKey,
Title,
Subtitle,
TitleEffect,
TitleShadow,
BgColor,
BgImage,
Scale,
AutoYScale,
YMax,
YMin,
YIntervals,
ChartPos,
rotateX,
rotateY,
ChartEffect,
Antialiasing,
WallColor,
BarFrame,
ShowTitle,
ShowGrid

LegendPos,
LegendOrientation,
LegendBoxColor,
LegendFontColor,
ShowLegend

BarLabelFormat,
BarLabelFont,
XAxisTitle,
YAxisTitle,
ZAxisTitle,
XLabelFontColor,
YLabelFontColor,
ZLabelFontColor,
YLabelFormat,
XLabel{n},
ShowXLabels,
ShowYLabels,
ShowZLabels

Series{n}Label,
Series{n}Color,
Series{n}Data

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).
All you need to do is to copy and paste the license key as follows:
     <param name="LicenseKey" value="A4-E5-23-35-F2-E5...">

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
font:  please refer to font definitions
color:  please refer to color definitions
position:  x and y coordinates

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
font:  please refer to font definitions
color:  please refer to color definitions
position:  x and y coordinates

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.
    1. Fade In
    2. Moving in from left side
    3. Moving in from right side
    4. Fading in from left side
    5. Fading in from right side

Values "fadein", "fromleft", "fromright", "fadeinfromleft", "fadeinfromright" 
Example <param name="TitleEffect" value="fadein">
Default Value no special effect
Required No

Name BgColor
Format

value = "Color"
value = "Color1|Color2"

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

<param name="BgColor" value="#f4d261">
<param name="BgColor" value="blue|white">
<param name="BgColor" value="red|yellow">

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:
    "rotateleft" - rotate to left 
    "rotateright" - rotate to right
Movment:
    "growing" - the chart is coming up from the floor 
    "falling" - the chart is falling down from the sky
    "backing" - the chart is backing up from front 
    "fromleft" - the chart is appearing from left side wall
    "fromback" - the chart is appearing from back wall 

Example

Rotate to left:
        <param name="ChartEffect" value="rotateleft">
Coming up from the floor:
       <param name="ChartEffect" value="growing">
Or you can have both:
        <param name="ChartEffect" value="rotateleft|growing">
        <param name="ChartEffect" value="growing|rotateleft">
However, these are invalid: 
        <param name="ChartEffect" value="rotateleft|rotateright">
        <param name="ChartEffect" value="growing|falling">

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"
value = "color"

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