ChartDirector 6.2 (.NET Edition)

Linear Zone Meter




This example demonstrates a linear meter labelled with zones.

The meter in this example is achieved by using LinearMeter.addZone to add labelled zones. The black lines separating the zones are added by using BaseMeter.addLabel with empty spaces as labels.

Source Code Listing

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

namespace CSharpChartExplorer
{
    public class linearzonemeter : DemoModule
    {
        //Name of demo module
        public string getName() { return "Linear Zone Meter"; }

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

        //Main code for creating chart.
        //Note: the argument chartIndex is unused because this demo only has 1 chart.
        public void createChart(WinChartViewer viewer, int chartIndex)
        {
            // The value to display on the meter
            double value = 85;

            // Create an LinearMeter object of size 210 x 45 pixels, using silver background with a
            // 2 pixel black 3D depressed border.
            LinearMeter m = new LinearMeter(210, 45, Chart.silverColor(), 0, -2);

            // Set the scale region top-left corner at (5, 5), with size of 200 x 20 pixels. The
            // scale labels are located on the bottom (implies horizontal meter)
            m.setMeter(5, 5, 200, 20, Chart.Bottom);

            // Set meter scale from 0 - 100
            m.setScale(0, 100);

            // Add a title at the bottom of the meter with a 1 pixel raised 3D border
            m.addTitle2(Chart.Bottom, "Battery Level", "Arial Bold", 8).setBackground(
                Chart.Transparent, -1, 1);

            // Set 3 zones of different colors to represent Good/Weak/Bad data ranges
            m.addZone(50, 100, 0x99ff99, "Good");
            m.addZone(20, 50, 0xffff66, "Weak");
            m.addZone(0, 20, 0xffcccc, "Bad");

            // Add empty labels (just need the ticks) at 0/20/50/80 as separators for zones
            m.addLabel(0, " ");
            m.addLabel(20, " ");
            m.addLabel(50, " ");
            m.addLabel(100, " ");

            // Add a semi-transparent blue (800000ff) pointer at the specified value, using
            // triangular pointer shape
            m.addPointer(value, unchecked((int)0x800000ff)).setShape(Chart.TriangularPointer);

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

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

Public Class linearzonemeter
    Implements DemoModule

    'Name of demo module
    Public Function getName() As String Implements DemoModule.getName
        Return "Linear Zone Meter"
    End Function

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

    'Main code for creating chart.
    'Note: the argument chartIndex is unused because this demo only has 1 chart.
    Public Sub createChart(viewer As WinChartViewer, chartIndex As Integer) _
        Implements DemoModule.createChart

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

        ' Create an LinearMeter object of size 210 x 45 pixels, using silver background with a 2
        ' pixel black 3D depressed border.
        Dim m As LinearMeter = New LinearMeter(210, 45, Chart.silverColor(), 0, -2)

        ' Set the scale region top-left corner at (5, 5), with size of 200 x 20 pixels. The scale
        ' labels are located on the bottom (implies horizontal meter)
        m.setMeter(5, 5, 200, 20, Chart.Bottom)

        ' Set meter scale from 0 - 100
        m.setScale(0, 100)

        ' Add a title at the bottom of the meter with a 1 pixel raised 3D border
        m.addTitle2(Chart.Bottom, "Battery Level", "Arial Bold", 8).setBackground( _
            Chart.Transparent, -1, 1)

        ' Set 3 zones of different colors to represent Good/Weak/Bad data ranges
        m.addZone(50, 100, &H99ff99, "Good")
        m.addZone(20, 50, &Hffff66, "Weak")
        m.addZone(0, 20, &Hffcccc, "Bad")

        ' Add empty labels (just need the ticks) at 0/20/50/80 as separators for zones
        m.addLabel(0, " ")
        m.addLabel(20, " ")
        m.addLabel(50, " ")
        m.addLabel(100, " ")

        ' Add a semi-transparent blue (800000ff) pointer at the specified value, using triangular
        ' pointer shape
        m.addPointer(value, &H800000ff).setShape(Chart.TriangularPointer)

        ' Output the chart
        viewer.Chart = m

    End Sub

End Class

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

namespace CSharpWPFDemo
{
    public class linearzonemeter : DemoModule
    {
        //Name of demo module
        public string getName() { return "Linear Zone Meter"; }

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

        //Main code for creating chart.
        //Note: the argument chartIndex is unused because this demo only has 1 chart.
        public void createChart(WPFChartViewer viewer, int chartIndex)
        {
            // The value to display on the meter
            double value = 85;

            // Create an LinearMeter object of size 210 x 45 pixels, using silver background with a
            // 2 pixel black 3D depressed border.
            LinearMeter m = new LinearMeter(210, 45, Chart.silverColor(), 0, -2);

            // Set the scale region top-left corner at (5, 5), with size of 200 x 20 pixels. The
            // scale labels are located on the bottom (implies horizontal meter)
            m.setMeter(5, 5, 200, 20, Chart.Bottom);

            // Set meter scale from 0 - 100
            m.setScale(0, 100);

            // Add a title at the bottom of the meter with a 1 pixel raised 3D border
            m.addTitle2(Chart.Bottom, "Battery Level", "Arial Bold", 8).setBackground(
                Chart.Transparent, -1, 1);

            // Set 3 zones of different colors to represent Good/Weak/Bad data ranges
            m.addZone(50, 100, 0x99ff99, "Good");
            m.addZone(20, 50, 0xffff66, "Weak");
            m.addZone(0, 20, 0xffcccc, "Bad");

            // Add empty labels (just need the ticks) at 0/20/50/80 as separators for zones
            m.addLabel(0, " ");
            m.addLabel(20, " ");
            m.addLabel(50, " ");
            m.addLabel(100, " ");

            // Add a semi-transparent blue (800000ff) pointer at the specified value, using
            // triangular pointer shape
            m.addPointer(value, unchecked((int)0x800000ff)).setShape(Chart.TriangularPointer);

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

[ASP.NET Web Forms - C# version] NetWebCharts\CSharpASP\linearzonemeter.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">

//
// Page Load event handler
//
protected void Page_Load(object sender, EventArgs e)
{
    // The value to display on the meter
    double value = 85;

    // Create an LinearMeter object of size 210 x 45 pixels, using silver background with a 2 pixel
    // black 3D depressed border.
    LinearMeter m = new LinearMeter(210, 45, Chart.silverColor(), 0, -2);

    // Set the scale region top-left corner at (5, 5), with size of 200 x 20 pixels. The scale
    // labels are located on the bottom (implies horizontal meter)
    m.setMeter(5, 5, 200, 20, Chart.Bottom);

    // Set meter scale from 0 - 100
    m.setScale(0, 100);

    // Add a title at the bottom of the meter with a 1 pixel raised 3D border
    m.addTitle2(Chart.Bottom, "Battery Level", "Arial Bold", 8).setBackground(Chart.Transparent, -1,
        1);

    // Set 3 zones of different colors to represent Good/Weak/Bad data ranges
    m.addZone(50, 100, 0x99ff99, "Good");
    m.addZone(20, 50, 0xffff66, "Weak");
    m.addZone(0, 20, 0xffcccc, "Bad");

    // Add empty labels (just need the ticks) at 0/20/50/80 as separators for zones
    m.addLabel(0, " ");
    m.addLabel(20, " ");
    m.addLabel(50, " ");
    m.addLabel(100, " ");

    // Add a semi-transparent blue (800000ff) pointer at the specified value, using triangular
    // pointer shape
    m.addPointer(value, unchecked((int)0x800000ff)).setShape(Chart.TriangularPointer);

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

</script>

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

[ASP.NET Web Forms - VB Version] NetWebCharts\VBNetASP\linearzonemeter.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">

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

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

    ' Create an LinearMeter object of size 210 x 45 pixels, using silver background with a 2 pixel
    ' black 3D depressed border.
    Dim m As LinearMeter = New LinearMeter(210, 45, Chart.silverColor(), 0, -2)

    ' Set the scale region top-left corner at (5, 5), with size of 200 x 20 pixels. The scale labels
    ' are located on the bottom (implies horizontal meter)
    m.setMeter(5, 5, 200, 20, Chart.Bottom)

    ' Set meter scale from 0 - 100
    m.setScale(0, 100)

    ' Add a title at the bottom of the meter with a 1 pixel raised 3D border
    m.addTitle2(Chart.Bottom, "Battery Level", "Arial Bold", 8).setBackground(Chart.Transparent, _
        -1, 1)

    ' Set 3 zones of different colors to represent Good/Weak/Bad data ranges
    m.addZone(50, 100, &H99ff99, "Good")
    m.addZone(20, 50, &Hffff66, "Weak")
    m.addZone(0, 20, &Hffcccc, "Bad")

    ' Add empty labels (just need the ticks) at 0/20/50/80 as separators for zones
    m.addLabel(0, " ")
    m.addLabel(20, " ")
    m.addLabel(50, " ")
    m.addLabel(100, " ")

    ' Add a semi-transparent blue (800000ff) pointer at the specified value, using triangular
    ' pointer shape
    m.addPointer(value, &H800000ff).setShape(Chart.TriangularPointer)

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

End Sub

</script>

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

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

namespace NetMvcCharts.Controllers
{
    public class LinearzonemeterController : Controller
    {
        //
        // Default Action
        //
        public ActionResult Index()
        {
            ViewBag.Title = "Linear Zone Meter";
            createChart(ViewBag.Viewer = new RazorChartViewer(HttpContext, "chart1"));
            return View("~/Views/Shared/ChartView.cshtml");
        }

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

            // Create an LinearMeter object of size 210 x 45 pixels, using silver background with a 2
            // pixel black 3D depressed border.
            LinearMeter m = new LinearMeter(210, 45, Chart.silverColor(), 0, -2);

            // Set the scale region top-left corner at (5, 5), with size of 200 x 20 pixels. The scale
            // labels are located on the bottom (implies horizontal meter)
            m.setMeter(5, 5, 200, 20, Chart.Bottom);

            // Set meter scale from 0 - 100
            m.setScale(0, 100);

            // Add a title at the bottom of the meter with a 1 pixel raised 3D border
            m.addTitle2(Chart.Bottom, "Battery Level", "Arial Bold", 8).setBackground(Chart.Transparent,
                -1, 1);

            // Set 3 zones of different colors to represent Good/Weak/Bad data ranges
            m.addZone(50, 100, 0x99ff99, "Good");
            m.addZone(20, 50, 0xffff66, "Weak");
            m.addZone(0, 20, 0xffcccc, "Bad");

            // Add empty labels (just need the ticks) at 0/20/50/80 as separators for zones
            m.addLabel(0, " ");
            m.addLabel(20, " ");
            m.addLabel(50, " ");
            m.addLabel(100, " ");

            // Add a semi-transparent blue (800000ff) pointer at the specified value, using triangular
            // pointer shape
            m.addPointer(value, unchecked((int)0x800000ff)).setShape(Chart.TriangularPointer);

            // 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>