ChartDirector 6.2 (.NET Edition)

Semicircle Meter with Readout


  

This example demonstrates semicircle meters configured with a large pointer cap to display the meter value.

The pointer cap is the circular object at the center of the meter. In this example, using AngularMeter.setCap2, the pointer cap is set to an exceptionally large size so that it can act as a place to display text. The text is added using BaseChart.addText, centered at the meter center.

In one of the meters, the pointer is configured to be floating, which means the base of the pointer is not fixed at the meter center. The pointer looks like a triangle somewhere between the center and the perimeter, pointing to the meter value. This pointer is added using AngularMeter.addPointer2 with TriangularPointer2 just like a standard pointer, but with additional arguments to specify the radial position of the pointer base and tip, as well as the pointer width.

Source Code Listing

[Windows Forms - C# version] NetWinCharts\CSharpWinCharts\semicirclemeterreadout.cs
using System;
using ChartDirector;

namespace CSharpChartExplorer
{
    public class semicirclemeterreadout : DemoModule
    {
        //Name of demo module
        public string getName() { return "Semicircle Meter with Readout"; }

        //Number of charts produced in this demo module
        public int getNoOfCharts() { return 2; }

        //Main code for creating charts
        public void createChart(WinChartViewer viewer, int chartIndex)
        {
            // The value to display on the meter
            double value = 66;

            // The background and border colors of the meters
            int[] bgColor = {0x88ccff, 0xffdddd};
            int[] borderColor = {0x000077, 0x880000};

            // Create an AngularMeter object of size 300 x 200 pixels with transparent background
            AngularMeter m = new AngularMeter(300, 200, Chart.Transparent);

            // Center at (150, 150), scale radius = 124 pixels, scale angle -90 to +90 degrees
            m.setMeter(150, 150, 124, -90, 90);

            // Background gradient color with brighter color at the center
            double[] bgGradient = {0, m.adjustBrightness(bgColor[chartIndex], 3), 0.75, bgColor[
                chartIndex]};

            // Add a scale background of 148 pixels radius using the background gradient, with a 13
            // pixel thick border
            m.addScaleBackground(148, m.relativeRadialGradient(bgGradient), 13, borderColor[
                chartIndex]);

            // Meter scale is 0 - 100, with major tick every 20 units, minor tick every 10 units,
            // and micro tick every 5 units
            m.setScale(0, 100, 20, 10, 5);

            // Set the scale label style to 15pt Arial Italic. Set the major/minor/micro tick
            // lengths to 16/16/10 pixels pointing inwards, and their widths to 2/1/1 pixels.
            m.setLabelStyle("Arial Italic", 16);
            m.setTickLength(-16, -16, -10);
            m.setLineWidth(0, 2, 1, 1);

            // Demostrate different types of color scales and putting them at different positions
            double[] smoothColorScale = {0, 0x3333ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100,
                0xff0000};

            if (chartIndex == 0) {
                // Add the smooth color scale at the default position
                m.addColorScale(smoothColorScale);
                // Add a red (0xff0000) triangular pointer starting from 38% and ending at 60% of
                // scale radius, with a width 6 times the default
                m.addPointer2(value, 0xff0000, -1, Chart.TriangularPointer2, 0.38, 0.6, 6);
            } else {
                // Add the smooth color scale starting at radius 124 with zero width and ending at
                // radius 124 with 16 pixels inner width
                m.addColorScale(smoothColorScale, 124, 0, 124, -16);
                // Add a red (0xff0000) pointer
                m.addPointer2(value, 0xff0000);
            }

            // Configure a large "pointer cap" to be used as the readout circle at the center. The
            // cap radius and border width is set to 33% and 4% of the meter scale radius. The cap
            // color is dark blue (0x000044). The border color is light blue (0x66bbff) with a 60%
            // brightness gradient effect.
            m.setCap2(Chart.Transparent, 0x000044, 0x66bbff, 0.6, 0, 0.33, 0.04);

            // Add value label at the center with light blue (0x66ddff) 28pt Arial Italic font
            m.addText(150, 150, m.formatValue(value, "{value|0}"), "Arial Italic", 28, 0x66ddff,
                Chart.Center).setMargin(0);

            // Output the chart
            viewer.Chart = m;
        }
    }
}

[Windows Forms - VB Version] NetWinCharts\VBNetWinCharts\semicirclemeterreadout.vb
Imports System
Imports Microsoft.VisualBasic
Imports ChartDirector

Public Class semicirclemeterreadout
    Implements DemoModule

    'Name of demo module
    Public Function getName() As String Implements DemoModule.getName
        Return "Semicircle Meter with Readout"
    End Function

    'Number of charts produced in this demo module
    Public Function getNoOfCharts() As Integer Implements DemoModule.getNoOfCharts
        Return 2
    End Function

    'Main code for creating charts
    Public Sub createChart(viewer As WinChartViewer, chartIndex As Integer) _
        Implements DemoModule.createChart

        ' The value to display on the meter
        Dim value As Double = 66

        ' The background and border colors of the meters
        Dim bgColor() As Integer = {&H88ccff, &Hffdddd}
        Dim borderColor() As Integer = {&H000077, &H880000}

        ' Create an AngularMeter object of size 300 x 200 pixels with transparent background
        Dim m As AngularMeter = New AngularMeter(300, 200, Chart.Transparent)

        ' Center at (150, 150), scale radius = 124 pixels, scale angle -90 to +90 degrees
        m.setMeter(150, 150, 124, -90, 90)

        ' Background gradient color with brighter color at the center
        Dim bgGradient() As Double = {0, m.adjustBrightness(bgColor(chartIndex), 3), 0.75, _
            bgColor(chartIndex)}

        ' Add a scale background of 148 pixels radius using the background gradient, with a 13 pixel
        ' thick border
        m.addScaleBackground(148, m.relativeRadialGradient(bgGradient), 13, borderColor(chartIndex))

        ' Meter scale is 0 - 100, with major tick every 20 units, minor tick every 10 units, and
        ' micro tick every 5 units
        m.setScale(0, 100, 20, 10, 5)

        ' Set the scale label style to 15pt Arial Italic. Set the major/minor/micro tick lengths to
        ' 16/16/10 pixels pointing inwards, and their widths to 2/1/1 pixels.
        m.setLabelStyle("Arial Italic", 16)
        m.setTickLength(-16, -16, -10)
        m.setLineWidth(0, 2, 1, 1)

        ' Demostrate different types of color scales and putting them at different positions
        Dim smoothColorScale() As Double = {0, &H3333ff, 25, &H0088ff, 50, &H00ff00, 75, &Hdddd00, _
            100, &Hff0000}

        If chartIndex = 0 Then
            ' Add the smooth color scale at the default position
            m.addColorScale(smoothColorScale)
            ' Add a red (0xff0000) triangular pointer starting from 38% and ending at 60% of scale
            ' radius, with a width 6 times the default
            m.addPointer2(value, &Hff0000, -1, Chart.TriangularPointer2, 0.38, 0.6, 6)
        Else
            ' Add the smooth color scale starting at radius 124 with zero width and ending at radius
            ' 124 with 16 pixels inner width
            m.addColorScale(smoothColorScale, 124, 0, 124, -16)
            ' Add a red (0xff0000) pointer
            m.addPointer2(value, &Hff0000)
        End If

        ' Configure a large "pointer cap" to be used as the readout circle at the center. The cap
        ' radius and border width is set to 33% and 4% of the meter scale radius. The cap color is
        ' dark blue (0x000044). The border color is light blue (0x66bbff) with a 60% brightness
        ' gradient effect.
        m.setCap2(Chart.Transparent, &H000044, &H66bbff, 0.6, 0, 0.33, 0.04)

        ' Add value label at the center with light blue (0x66ddff) 28pt Arial Italic font
        m.addText(150, 150, m.formatValue(value, "{value|0}"), "Arial Italic", 28, &H66ddff, _
            Chart.Center).setMargin(0)

        ' Output the chart
        viewer.Chart = m

    End Sub

End Class

[WPF - C#] NetWPFCharts\semicirclemeterreadout.cs
using System;
using ChartDirector;

namespace CSharpWPFDemo
{
    public class semicirclemeterreadout : DemoModule
    {
        //Name of demo module
        public string getName() { return "Semicircle Meter with Readout"; }

        //Number of charts produced in this demo module
        public int getNoOfCharts() { return 2; }

        //Main code for creating charts
        public void createChart(WPFChartViewer viewer, int chartIndex)
        {
            // The value to display on the meter
            double value = 66;

            // The background and border colors of the meters
            int[] bgColor = {0x88ccff, 0xffdddd};
            int[] borderColor = {0x000077, 0x880000};

            // Create an AngularMeter object of size 300 x 200 pixels with transparent background
            AngularMeter m = new AngularMeter(300, 200, Chart.Transparent);

            // Center at (150, 150), scale radius = 124 pixels, scale angle -90 to +90 degrees
            m.setMeter(150, 150, 124, -90, 90);

            // Background gradient color with brighter color at the center
            double[] bgGradient = {0, m.adjustBrightness(bgColor[chartIndex], 3), 0.75, bgColor[
                chartIndex]};

            // Add a scale background of 148 pixels radius using the background gradient, with a 13
            // pixel thick border
            m.addScaleBackground(148, m.relativeRadialGradient(bgGradient), 13, borderColor[
                chartIndex]);

            // Meter scale is 0 - 100, with major tick every 20 units, minor tick every 10 units,
            // and micro tick every 5 units
            m.setScale(0, 100, 20, 10, 5);

            // Set the scale label style to 15pt Arial Italic. Set the major/minor/micro tick
            // lengths to 16/16/10 pixels pointing inwards, and their widths to 2/1/1 pixels.
            m.setLabelStyle("Arial Italic", 16);
            m.setTickLength(-16, -16, -10);
            m.setLineWidth(0, 2, 1, 1);

            // Demostrate different types of color scales and putting them at different positions
            double[] smoothColorScale = {0, 0x3333ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100,
                0xff0000};

            if (chartIndex == 0) {
                // Add the smooth color scale at the default position
                m.addColorScale(smoothColorScale);
                // Add a red (0xff0000) triangular pointer starting from 38% and ending at 60% of
                // scale radius, with a width 6 times the default
                m.addPointer2(value, 0xff0000, -1, Chart.TriangularPointer2, 0.38, 0.6, 6);
            } else {
                // Add the smooth color scale starting at radius 124 with zero width and ending at
                // radius 124 with 16 pixels inner width
                m.addColorScale(smoothColorScale, 124, 0, 124, -16);
                // Add a red (0xff0000) pointer
                m.addPointer2(value, 0xff0000);
            }

            // Configure a large "pointer cap" to be used as the readout circle at the center. The
            // cap radius and border width is set to 33% and 4% of the meter scale radius. The cap
            // color is dark blue (0x000044). The border color is light blue (0x66bbff) with a 60%
            // brightness gradient effect.
            m.setCap2(Chart.Transparent, 0x000044, 0x66bbff, 0.6, 0, 0.33, 0.04);

            // Add value label at the center with light blue (0x66ddff) 28pt Arial Italic font
            m.addText(150, 150, m.formatValue(value, "{value|0}"), "Arial Italic", 28, 0x66ddff,
                Chart.Center).setMargin(0);

            // Output the chart
            viewer.Chart = m;
        }
    }
}

[ASP.NET Web Forms - C# version] NetWebCharts\CSharpASP\semicirclemeterreadout.aspx
(Click here on how to convert this code to code-behind style.)
<%@ Page Language="C#" Debug="true" %>
<%@ Import Namespace="ChartDirector" %>
<%@ Register TagPrefix="chart" Namespace="ChartDirector" Assembly="netchartdir" %>

<!DOCTYPE html>

<script runat="server">

//
// Create chart
//
protected void createChart(WebChartViewer viewer, int chartIndex)
{
    // The value to display on the meter
    double value = 66;

    // The background and border colors of the meters
    int[] bgColor = {0x88ccff, 0xffdddd};
    int[] borderColor = {0x000077, 0x880000};

    // Create an AngularMeter object of size 300 x 200 pixels with transparent background
    AngularMeter m = new AngularMeter(300, 200, Chart.Transparent);

    // Center at (150, 150), scale radius = 124 pixels, scale angle -90 to +90 degrees
    m.setMeter(150, 150, 124, -90, 90);

    // Background gradient color with brighter color at the center
    double[] bgGradient = {0, m.adjustBrightness(bgColor[chartIndex], 3), 0.75, bgColor[chartIndex]}
        ;

    // Add a scale background of 148 pixels radius using the background gradient, with a 13 pixel
    // thick border
    m.addScaleBackground(148, m.relativeRadialGradient(bgGradient), 13, borderColor[chartIndex]);

    // Meter scale is 0 - 100, with major tick every 20 units, minor tick every 10 units, and micro
    // tick every 5 units
    m.setScale(0, 100, 20, 10, 5);

    // Set the scale label style to 15pt Arial Italic. Set the major/minor/micro tick lengths to
    // 16/16/10 pixels pointing inwards, and their widths to 2/1/1 pixels.
    m.setLabelStyle("Arial Italic", 16);
    m.setTickLength(-16, -16, -10);
    m.setLineWidth(0, 2, 1, 1);

    // Demostrate different types of color scales and putting them at different positions
    double[] smoothColorScale = {0, 0x3333ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100,
        0xff0000};

    if (chartIndex == 0) {
        // Add the smooth color scale at the default position
        m.addColorScale(smoothColorScale);
        // Add a red (0xff0000) triangular pointer starting from 38% and ending at 60% of scale
        // radius, with a width 6 times the default
        m.addPointer2(value, 0xff0000, -1, Chart.TriangularPointer2, 0.38, 0.6, 6);
    } else {
        // Add the smooth color scale starting at radius 124 with zero width and ending at radius
        // 124 with 16 pixels inner width
        m.addColorScale(smoothColorScale, 124, 0, 124, -16);
        // Add a red (0xff0000) pointer
        m.addPointer2(value, 0xff0000);
    }

    // Configure a large "pointer cap" to be used as the readout circle at the center. The cap
    // radius and border width is set to 33% and 4% of the meter scale radius. The cap color is dark
    // blue (0x000044). The border color is light blue (0x66bbff) with a 60% brightness gradient
    // effect.
    m.setCap2(Chart.Transparent, 0x000044, 0x66bbff, 0.6, 0, 0.33, 0.04);

    // Add value label at the center with light blue (0x66ddff) 28pt Arial Italic font
    m.addText(150, 150, m.formatValue(value, "{value|0}"), "Arial Italic", 28, 0x66ddff,
        Chart.Center).setMargin(0);

    // Output the chart
    viewer.Image = m.makeWebImage(Chart.PNG);
}

//
// Page Load event handler
//
protected void Page_Load(object sender, EventArgs e)
{
    createChart(WebChartViewer0, 0);
    createChart(WebChartViewer1, 1);
}

</script>

<html>
<body>
    <chart:WebChartViewer id="WebChartViewer0" runat="server" />
    <chart:WebChartViewer id="WebChartViewer1" runat="server" />
</body>
</html>

[ASP.NET Web Forms - VB Version] NetWebCharts\VBNetASP\semicirclemeterreadout.aspx
(Click here on how to convert this code to code-behind style.)
<%@ Page Language="VB" Debug="true" %>
<%@ Import Namespace="ChartDirector" %>
<%@ Register TagPrefix="chart" Namespace="ChartDirector" Assembly="netchartdir" %>

<!DOCTYPE html>

<script runat="server">

'
' Create chart
'
Protected Sub createChart(viewer As WebChartViewer, chartIndex As Integer)

    ' The value to display on the meter
    Dim value As Double = 66

    ' The background and border colors of the meters
    Dim bgColor() As Integer = {&H88ccff, &Hffdddd}
    Dim borderColor() As Integer = {&H000077, &H880000}

    ' Create an AngularMeter object of size 300 x 200 pixels with transparent background
    Dim m As AngularMeter = New AngularMeter(300, 200, Chart.Transparent)

    ' Center at (150, 150), scale radius = 124 pixels, scale angle -90 to +90 degrees
    m.setMeter(150, 150, 124, -90, 90)

    ' Background gradient color with brighter color at the center
    Dim bgGradient() As Double = {0, m.adjustBrightness(bgColor(chartIndex), 3), 0.75, bgColor( _
        chartIndex)}

    ' Add a scale background of 148 pixels radius using the background gradient, with a 13 pixel
    ' thick border
    m.addScaleBackground(148, m.relativeRadialGradient(bgGradient), 13, borderColor(chartIndex))

    ' Meter scale is 0 - 100, with major tick every 20 units, minor tick every 10 units, and micro
    ' tick every 5 units
    m.setScale(0, 100, 20, 10, 5)

    ' Set the scale label style to 15pt Arial Italic. Set the major/minor/micro tick lengths to
    ' 16/16/10 pixels pointing inwards, and their widths to 2/1/1 pixels.
    m.setLabelStyle("Arial Italic", 16)
    m.setTickLength(-16, -16, -10)
    m.setLineWidth(0, 2, 1, 1)

    ' Demostrate different types of color scales and putting them at different positions
    Dim smoothColorScale() As Double = {0, &H3333ff, 25, &H0088ff, 50, &H00ff00, 75, &Hdddd00, _
        100, &Hff0000}

    If chartIndex = 0 Then
        ' Add the smooth color scale at the default position
        m.addColorScale(smoothColorScale)
        ' Add a red (0xff0000) triangular pointer starting from 38% and ending at 60% of scale
        ' radius, with a width 6 times the default
        m.addPointer2(value, &Hff0000, -1, Chart.TriangularPointer2, 0.38, 0.6, 6)
    Else
        ' Add the smooth color scale starting at radius 124 with zero width and ending at radius 124
        ' with 16 pixels inner width
        m.addColorScale(smoothColorScale, 124, 0, 124, -16)
        ' Add a red (0xff0000) pointer
        m.addPointer2(value, &Hff0000)
    End If

    ' Configure a large "pointer cap" to be used as the readout circle at the center. The cap radius
    ' and border width is set to 33% and 4% of the meter scale radius. The cap color is dark blue
    ' (0x000044). The border color is light blue (0x66bbff) with a 60% brightness gradient effect.
    m.setCap2(Chart.Transparent, &H000044, &H66bbff, 0.6, 0, 0.33, 0.04)

    ' Add value label at the center with light blue (0x66ddff) 28pt Arial Italic font
    m.addText(150, 150, m.formatValue(value, "{value|0}"), "Arial Italic", 28, &H66ddff, _
        Chart.Center).setMargin(0)

    ' Output the chart
    viewer.Image = m.makeWebImage(Chart.PNG)

End Sub

'
' Page Load event handler
'
Protected Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs)

    createChart(WebChartViewer0, 0)
    createChart(WebChartViewer1, 1)

End Sub

</script>

<html>
<body>
    <chart:WebChartViewer id="WebChartViewer0" runat="server" />
    <chart:WebChartViewer id="WebChartViewer1" runat="server" />
</body>
</html>

[ASP.NET MVC - Controller] NetMvcCharts\Controllers\SemicirclemeterreadoutController.cs
using System;
using System.Web.Mvc;
using ChartDirector;

namespace NetMvcCharts.Controllers
{
    public class SemicirclemeterreadoutController : Controller
    {
        //
        // Default Action
        //
        public ActionResult Index()
        {
            ViewBag.Title = "Semicircle Meter with Readout";

            // This example contains 2 charts.
            ViewBag.Viewer = new RazorChartViewer[2];
            for (int i = 0; i < ViewBag.Viewer.Length; ++i)
                createChart(ViewBag.Viewer[i] = new RazorChartViewer(HttpContext, "chart" + i), i);

            return View("~/Views/Shared/ChartView.cshtml");
        }

        //
        // Create chart
        //
        private void createChart(RazorChartViewer viewer, int chartIndex)
        {
            // The value to display on the meter
            double value = 66;

            // The background and border colors of the meters
            int[] bgColor = {0x88ccff, 0xffdddd};
            int[] borderColor = {0x000077, 0x880000};

            // Create an AngularMeter object of size 300 x 200 pixels with transparent background
            AngularMeter m = new AngularMeter(300, 200, Chart.Transparent);

            // Center at (150, 150), scale radius = 124 pixels, scale angle -90 to +90 degrees
            m.setMeter(150, 150, 124, -90, 90);

            // Background gradient color with brighter color at the center
            double[] bgGradient = {0, m.adjustBrightness(bgColor[chartIndex], 3), 0.75, bgColor[
                chartIndex]};

            // Add a scale background of 148 pixels radius using the background gradient, with a 13 pixel
            // thick border
            m.addScaleBackground(148, m.relativeRadialGradient(bgGradient), 13, borderColor[chartIndex]);

            // Meter scale is 0 - 100, with major tick every 20 units, minor tick every 10 units, and
            // micro tick every 5 units
            m.setScale(0, 100, 20, 10, 5);

            // Set the scale label style to 15pt Arial Italic. Set the major/minor/micro tick lengths to
            // 16/16/10 pixels pointing inwards, and their widths to 2/1/1 pixels.
            m.setLabelStyle("Arial Italic", 16);
            m.setTickLength(-16, -16, -10);
            m.setLineWidth(0, 2, 1, 1);

            // Demostrate different types of color scales and putting them at different positions
            double[] smoothColorScale = {0, 0x3333ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100,
                0xff0000};

            if (chartIndex == 0) {
                // Add the smooth color scale at the default position
                m.addColorScale(smoothColorScale);
                // Add a red (0xff0000) triangular pointer starting from 38% and ending at 60% of scale
                // radius, with a width 6 times the default
                m.addPointer2(value, 0xff0000, -1, Chart.TriangularPointer2, 0.38, 0.6, 6);
            } else {
                // Add the smooth color scale starting at radius 124 with zero width and ending at radius
                // 124 with 16 pixels inner width
                m.addColorScale(smoothColorScale, 124, 0, 124, -16);
                // Add a red (0xff0000) pointer
                m.addPointer2(value, 0xff0000);
            }

            // Configure a large "pointer cap" to be used as the readout circle at the center. The cap
            // radius and border width is set to 33% and 4% of the meter scale radius. The cap color is
            // dark blue (0x000044). The border color is light blue (0x66bbff) with a 60% brightness
            // gradient effect.
            m.setCap2(Chart.Transparent, 0x000044, 0x66bbff, 0.6, 0, 0.33, 0.04);

            // Add value label at the center with light blue (0x66ddff) 28pt Arial Italic font
            m.addText(150, 150, m.formatValue(value, "{value|0}"), "Arial Italic", 28, 0x66ddff,
                Chart.Center).setMargin(0);

            // Output the chart
            viewer.Image = m.makeWebImage(Chart.PNG);
        }
    }
}

[ASP.NET MVC - View] NetMvcCharts\Views\Shared\ChartView.cshtml
@{ Layout = null; }

<!DOCTYPE html>

<html>
<head>
    <meta name="viewport" content="width=device-width" />
    <title>@ViewBag.Title</title>
</head>
<body style="margin:5px 0px 0px 5px">
    <div style="font:bold 18pt verdana;">
        @ViewBag.Title
    </div>
    <hr style="border:solid 1px #000080" />
    <div>
        @{
            if (ViewBag.Viewer is Array)
            {
                // Display multiple charts
                for (int i = 0; i < ViewBag.Viewer.Length; ++i)
                {
                    @:@Html.Raw(ViewBag.Viewer[i].RenderHTML())
                }
            }
            else
            {
                // Display one chart only
                @:@Html.Raw(ViewBag.Viewer.RenderHTML())
            }
        }
    </div>
</body>
</html>