Configuring Gauge

FusionCharts Suite XT v3.4 allows you to customize several cosmetic and functional properties for the thermometer gauge.

In this section, you will be shown how you can:

  • Customize the gauge fill

  • Customize the gauge border

  • Set the thermometer radius and height manually

  • Show/hide temperature value

  • Configure tick marks and values

  • Configure the hover effect

Customizing the Gauge Fill

A thermometer gauge with the gauge fill customized looks like this:

FusionCharts should load here..

Given below is a brief description of the attributes used to customize the gauge fill:

Attribute Name Description
gaugeFillColor It is used to specify the hex code of the color that will be used as the fill color for the thermometer gauge, e.g. #008ee4.
gaugeFillAlpha It is used to specify the transparency for the gauge fill. this attribute takes values between 0 (transparent) and 100 (opaque), e.g. 50.

The data structure needed to customize the gauge fill is given below:

...

Customizing the Gauge Borders

A thermometer gauge with the borders customized looks like this:

FusionCharts should load here..

Given below is a brief description of the attributes used to customize the thermometer gauge border :

Attribute Name Description
showGaugeBorder It is used to specify whether the gauge border will be shown or hidden. Setting this attribute to 0 will hide the gauge border, setting it to 1 (default) will show the border.
gaugeBorderColor It is used to specify the hex code of the color that will be used to render the entire border of the gauge, e.g. #111111.
gaugeBorderThickness It is used to specify the thickness, in pixels, for the gauge border, e.g. 5.
gaugeBorderAlpha It is used to specify the transparency for the gauge border. This attribute takes values 0 (transparent) and 100 (opaque), e.g. 50.

The data structure needed to customize the gauge border is given below:

...

Setting the Thermometer Radius and Height Manually

By default, the gauge automatically calculates the best thermometer radius and height based on the data you provide. You can, however, explicitly set the thermometer radius and height.

A thermometer gauge with the thermometer radius and height set manually looks like this:

FusionCharts should load here..

Given below is a brief description of the attributes used to manually set the thermometer radius and height:

Attribute Name Description
thmBulbRadius It is used to specify the thermometer bulb radius, in pixels, e.g 35.
thmHeight It is used to specify the thermometer height, in pixels, e.g 180.

The data structure needed to manually set the thermometer radius and height is given below:

...

Showing/Hiding the Temperature Value

By default, the current temperature value is shown below the thermometer gauge. However, you can choose to hide this value.

A thermometer gauge rendered with the temperature value hidden looks like this:

FusionCharts should load here..

Given below is a brief description of the attribute used to show/hide the gauge value:

Attribute Name Description
showValue It is used to specify whether the temperature value will be shown with the gauge. Setting this attribute to 0 will hide the value, setting it to 1 (default) will show it.

The data structure needed to hide the temperature value is given below:

...

Showing/Hiding Tick Marks and Tick Values

A thermometer gauge with the tick marks and tick values hidden looks like this:

FusionCharts should load here..

Given below is a brief description of the attributes used to show/hide the tick marks and values:

Attribute Name Description
showTickMarks It is used to specify whether the tick marks will be shown on the gauge scale. Setting this attribute to 0 will hide the tick marks, setting it to 1 (default) will show them.
showTickValues It is used to specify whether the tick values will be shown on the gauge scale. Setting this attribute to 0 will hide the tick values, setting it to 1 (default) will show them.

The data structure needed to hide tick marks and tick values for the thermometer gauge is given below:

...

Configuring Tick Marks and Tick Values

A thermometer gauge rendered with customized tick marks and tick values looks like this:

FusionCharts should load here..

Given below is a brief description of the attributes used to configure the tick marks and tick values:

Attribute Name Description
ticksOnRight It is used to specify whether the tick marks and values will be rendered to the left or the right. Setting this attribute to 0 renders the tick marks and values on the left, setting it to 1 (default) renders them on the right.
tickMarkDistance It is used to specify the distance, in pixels, between the tick marks and the gauge scale, e.g. 10.
tickValueDistance It is used to specify the distance, in pixels, between the tick marks and the tick values, e.g. 5.
adjustTM It is used to specify whether the number of major tick marks should be automatically adjusted to ensure better distribution of the chart scale. Setting this attribute to 0 disables automatic adjustment of tick marks, setting it to 1 (default) enables it.
majorTMNumber It is used to specify the number of major tick marks to be rendered, e.g. 12.
majorTMHeight It is used to specify the height of major tick marks, e.g., 5
minorTMNumber It is used to specify the number of minor tick marks to be rendered, e.g. 4.
minorTMHeight It is used to specify the height of minor tick marks, e.g., 7.
tickValueStep If you need to show only every n-th tick value only, this attribute is used to specify that value.

The data structure needed to configure the tick marks and tick values is given below:

...

Customizing Tick Marks

A thermometer gauge configured for the tick marks cosmetic properties looks like this:

FusionCharts should load here..

Given below is a brief description of the attributes used to customize the tick marks’ cosmetic properties:

Attribute Name Description
majorTMColor It is used to specify hex code of the color using which the major tick marks will be rendered, e.g. #666666.
majorTMAlpha It is used to specify the transparency of the major tick marks. This attribute takes values 0 (transparent) and 100 (opaque), e.g. 50.
majorTMThickness It is used to specify the thickness of the major tick marks, e.g. 5.
minorTMColor It is used to specify hex code of the color using which the minor tick marks will be rendered, e.g. #AAAAAA.
minorTMAlpha It is used to specify the transparency of the minor tick marks. This attribute takes values 0 (transparent) and 100 (opaque), e.g. 50.
minorTMThickness It is used to specify the thickness of the minor tick marks, e.g. 5.

The data structure needed to customize the cosmetic properties for tick marks is given below:

...

Configuring the Hover Effects for the Thermometer Gauge

A thermometer gauge configured to enable hover effects looks like this:

FusionCharts should load here..

Given below is a brief description of the attribute used to enable the hover effect for the thermometer gauge:

Attribute Name Description
showhovereffect It is used to specify whether the hover effect will be enabled for the LED gauge. Setting this attribute to 1 enables the hover effect, setting it to 0 (default) disables it.

The data structure needed to enable hover effects for the thermometer gauge is given below:

...

There! You have now seen how you can configure the various cosmetic and functional properties of the thermometer gauge.