Loading
Configuring Gauge
FusionCharts Suite XT 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:
Given below is a brief description of the attributes used to customize the gauge fill:
| Attribute Name | Description |
|---|---|
|
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. |
|
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:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": " Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"showhovereffect": "1",
"decimals": "1",
"gaugeFillColor": "#008ee4",
"gaugeFillAlpha": "70",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20"
},
"value": "-6"
}Customizing the Gauge Borders
A thermometer gauge with the borders customized looks like this:
Given below is a brief description of the attributes used to customize the thermometer gauge border :
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the gauge border will be shown or hidden. Setting this attribute to |
|
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. |
|
It is used to specify the thickness, in pixels, for the gauge border, e.g. 5. |
|
It is used to specify the transparency for the gauge border. This attribute takes values between 0 (transparent) and 100 (opaque), e.g. 50. |
The data structure needed to customize the gauge border is given below:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": " Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"showhovereffect": "1",
"decimals": "1",
"gaugeFillColor": "#008ee4",
"gaugeFillAlpha": "70",
"showGaugeBorder": "1",
"gaugeBorderColor": "#008ee4",
"gaugeBorderThickness": "2",
"gaugeBorderAlpha": "60",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20"
},
"value": "-6"
}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:
Given below is a brief description of the attributes used to manually set the thermometer radius and height:
| Attribute Name | Description |
|---|---|
|
It is used to specify the thermometer bulb radius, in pixels, e.g 35. |
|
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:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": "Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"decimals": "1",
"showhovereffect": "1",
"gaugeFillColor": "#008ee4",
"thmBulbRadius": "35",
"thmHeight": "200",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20"
},
"value": "-6"
}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:
Given below is a brief description of the attribute used to show/hide the gauge value:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the temperature value will be shown with the gauge. Setting this attribute to |
The data structure needed to hide the temperature value is given below:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": " Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"decimals": "1",
"showhovereffect": "1",
"gaugeFillColor": "#008ee4",
"showValue": "0",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20"
},
"value": "-6"
}Showing/Hiding Tick Marks and Tick Values
A thermometer gauge with the tick marks and tick values hidden looks like this:
Given below is a brief description of the attributes used to show/hide the tick marks and values:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the tick marks will be shown on the gauge scale. Setting this attribute to |
|
It is used to specify whether the tick values will be shown on the gauge scale. Setting this attribute to |
The data structure needed to hide tick marks and tick values for the thermometer gauge is given below:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": " Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"decimals": "1",
"showhovereffect": "1",
"gaugeFillColor": "#008ee4",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20",
"showTickMarks": "0",
"showTickValues": "0"
},
"value": "-6"
}Configuring Tick Marks and Tick Values
A thermometer gauge rendered with customized tick marks and tick values looks like this:
Given below is a brief description of the attributes used to configure the tick marks and tick values:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the tick marks and values will be rendered to the left or the right of the gauge. Setting this attribute to |
|
It is used to specify the distance, in pixels, between the tick marks and the gauge scale, e.g. 10. |
|
It is used to specify the distance, in pixels, between the tick marks and the tick values, e.g. 5. |
|
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 |
|
It is used to specify the number of major tick marks to be rendered, e.g. 12. |
|
It is used to specify the height of major tick marks, e.g., 5 |
|
It is used to specify the number of minor tick marks to be rendered, e.g. 4. |
|
It is used to specify the height of minor tick marks, e.g., 7. |
|
If you need to show only every n-th tick value, this attribute is used to specify that value. |
The data structure needed to configure the tick marks and tick values is given below:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": " Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"decimals": "1",
"showhovereffect": "1",
"gaugeFillColor": "#008ee4",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20",
"adjustTM": "1",
"ticksOnRight": "0",
"tickMarkDistance": "5",
"tickValueDistance": "2",
"majorTMNumber": "9",
"majorTMHeight": "12",
"minorTMNumber": "4",
"minorTMHeight": "7",
"tickValueStep": "2"
},
"value": "-6"
}Customizing Tick Marks
A thermometer gauge configured for the tick marks cosmetic properties looks like this:
Given below is a brief description of the attributes used to customize the tick marks’ cosmetic properties:
| Attribute Name | Description |
|---|---|
|
It is used to specify hex code of the color using which the major tick marks will be rendered, e.g. #666666. |
|
It is used to specify the transparency of the major tick marks. This attribute takes values between 0 (transparent) and 100 (opaque), e.g. 50. |
|
It is used to specify the thickness, in pixels, of the major tick marks, e.g. 5. |
|
It is used to specify hex code of the color using which the minor tick marks will be rendered, e.g. #AAAAAA. |
|
It is used to specify the transparency of the minor tick marks. This attribute takes values between 0 (transparent) and 100 (opaque), e.g. 50. |
|
It is used to specify the thickness, in pixels, of the minor tick marks, e.g. 5. |
The data structure needed to customize the cosmetic properties for tick marks is given below:
{
"chart": {
"caption": "Temperature Monitor",
"subcaption": " Central cold store",
"lowerLimit": "-10",
"upperLimit": "0",
"numberSuffix": "°C",
"decimals": "1",
"showhovereffect": "1",
"gaugeFillColor": "#008ee4",
"thmOriginX": "100",
"theme": "fint",
"chartBottomMargin": "20",
"majorTMNumber": "6",
"majorTMHeight": "12",
"minorTMNumber": "4",
"minorTMHeight": "7",
"majorTMColor": "#666666",
"majorTMAlpha": "100",
"majorTMThickness": "2",
"minorTMColor": "#666666",
"minorTMAlpha": "50",
"minorTMThickness": "2"
},
"value": "-6"
}Configuring Hover Effects for the Thermometer Gauge
A thermometer gauge configured to enable hover effects looks like this:
Given below is a brief description of the attribute used to enable the hover effect for the thermometer gauge:
| Attribute Name | Description |
|---|---|
|
It is used to specify whether the hover effect will be enabled for the thermometer gauge. Setting this attribute to |
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.