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:

FusionCharts will 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:

JSON
XML

{ "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" }

{
    "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:

FusionCharts will 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 between 0 (transparent) and 100 (opaque), e.g. 50.

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

JSON
XML

{ "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" }

{
    "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:

FusionCharts will 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:

JSON
XML

{
    "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:

FusionCharts will 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:

JSON
XML

{
    "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:

FusionCharts will 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:

JSON
XML

{
    "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:

FusionCharts will 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 of the gauge. 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, this attribute is used to specify that value.

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

JSON
XML

{ "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" }

{
    "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:

FusionCharts will 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 between 0 (transparent) and 100 (opaque), e.g. 50.
`majorTMThickness`	It is used to specify the thickness, in pixels, 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 between 0 (transparent) and 100 (opaque), e.g. 50.
`minorTMThickness`	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:

JSON
XML

{ "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" }

{
    "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:

FusionCharts will 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 thermometer 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:

JSON
XML

{ "chart": { "caption": "Temperature Monitor", "subcaption": " Central cold store", "lowerLimit": "-10", "upperLimit": "00", "numberSuffix": "°C", "decimals": "1", "thmFillColor": "#008ee4", "thmOriginX": "100", "showhovereffect": "1", "theme": "fint" }, "value": "-6" }

{
    "chart": {
        "caption": "Temperature Monitor",
        "subcaption": " Central cold store",
        "lowerLimit": "-10",
        "upperLimit": "00",
        "numberSuffix": "°C",
        "decimals": "1",
        "thmFillColor": "#008ee4",
        "thmOriginX": "100",
        "showhovereffect": "1",
        "theme": "fint"
    },
    "value": "-6"
}

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