ChartDirector 6.0 (Ruby Edition)

White Semicircle Meters


          

This example demonstrates semicircle meters with a soft white background and a silver border.

The white background in this example is actually a radial gradient. It is fully white at the center, changing to light grey at the border. This creates a "softer" white effect. The radial gradient is created using AngularMeter.relativeRadialGradient.

The silver border effect is achieved by using AngularMeter.relativeLinearGradient to create a gradient consisting of varying levels of grey.

The soft white gradient and the silver gradient are applied to the meter background and border using AngularMeter.addScaleBackground.

Because the background and border color are similar, to make the border easier to distinguish from the background, the AngularMeter.addScaleBackground is called one more time to add a 1-pixel grey boundary between the border and the background.

Source Code Listing

[Ruby On Rails Version - Controller] app/controllers/whitesemicirclemeter_controller.rb
require("chartdirector")

class WhitesemicirclemeterController < ApplicationController

    def index()
        @title = "White Semicircle Meters"
        @ctrl_file = File.expand_path(__FILE__)
        @noOfCharts = 6
        render :template => "templates/chartview"
    end

    #
    # Render and deliver the chart
    #
    def getchart()
        # This script can draw different charts depending on the chartIndex
        chartIndex = (params["img"]).to_i

        # The value to display on the meter
        value = 72.55

        # Create an AngularMeter object of size 300 x 180 pixels with transparent background
        m = ChartDirector::AngularMeter.new(300, 180, ChartDirector::Transparent)

        # Set the default text and line colors to very dark grey (0x222222)
        m.setColor(ChartDirector::TextColor, 0x222222)
        m.setColor(ChartDirector::LineColor, 0x222222)

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

        # Gradient color for the border to make it silver-like
        ringGradient = [1, 0x999999, 0.5, 0xdddddd, 0, 0xf8f8f8, -0.5, 0xdddddd, -1, 0x999999]

        # Background gradient color from white (0xffffff) at the center to light grey (0xdddddd) at
        # the border
        bgGradient = [0, 0xffffff, 0.75, 0xeeeeee, 1, 0xdddddd]

        # Add a scale background of 148 pixels radius using the gradient background, with a 10 pixel
        # thick silver border
        m.addScaleBackground(148, m.relativeRadialGradient(bgGradient, 148), 10,
            m.relativeLinearGradient(ringGradient, 45, 148))

        # Add a 1 pixel light grey (0xbbbbbb) line at the inner edge of the thick silver border
        # (radius = 138) to enhance its contrast with the background gradient
        m.addScaleBackground(138, ChartDirector::Transparent, 1, 0xbbbbbb)

        # 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("ariali.ttf", 16)
        m.setTickLength(-16, -16, -10)
        m.setLineWidth(0, 2, 1, 1)

        # Demostrate different types of color scales and putting them at different positions
        smoothColorScale = [0, 0x3333ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100, 0xff0000]
        stepColorScale = [0, 0x00cc00, 60, 0xffdd00, 80, 0xee0000, 100]
        highLowColorScale = [0, 0x00ff00, 70, ChartDirector::Transparent, 100, 0xff0000]

        if chartIndex == 0
            # Add the smooth color scale at the default position
            m.addColorScale(smoothColorScale)
        elsif chartIndex == 1
            # Add the smooth color scale starting at radius 128 with zero width and ending at radius
            # 128 with 16 pixels inner width
            m.addColorScale(smoothColorScale, 128, 0, 128, -16)
        elsif chartIndex == 2
            # Add the smooth color scale starting at radius 70 with zero width and ending at radius
            # 60 with 20 pixels outer width
            m.addColorScale(smoothColorScale, 70, 0, 60, 20)
        elsif chartIndex == 3
            # Add the high/low color scale at the default position
            m.addColorScale(highLowColorScale)
        elsif chartIndex == 4
            # Add the step color scale at the default position
            m.addColorScale(stepColorScale)
        else
            # Add the smooth color scale at radius 60 with 15 pixels outer width
            m.addColorScale(smoothColorScale, 60, 15)
        end

        # Add a text label centered at (150, 125) with 15pt Arial Italic font
        m.addText(150, 125, "CPU", "ariali.ttf", 15, ChartDirector::TextColor,
            ChartDirector::BottomCenter)

        # Add a red (0xff0000) pointer at the specified value
        m.addPointer2(value, 0xff0000)

        # Output the chart
        send_data(m.makeChart2(ChartDirector::PNG), :type => "image/png", :disposition => "inline")

    end

end

[Ruby On Rails Version - View] app/views/templates/chartview.html.erb
<html>
<body style="margin:5px 0px 0px 5px">

<!-- Title -->
<div style="font-size:18pt; font-family:verdana; font-weight:bold">
    <%= @title %>
</div>
<hr style="border:solid 1px #000080" />

<!-- Source Code Listing Link -->
<div style="font-size:9pt; font-family:verdana; margin-bottom:1.5em">
    <%= link_to "Source Code Listing", 
        :controller => "cddemo", :action => "viewsource",
        :ctrl_file => @ctrl_file, :view_file => File.expand_path(__FILE__) %>
</div>

<!-- Create one or more IMG tags to display the demo chart(s) -->
<% 0.upto(@noOfCharts - 1) do |i| %>
    <img src="<%= url_for(:action => "getchart", :img => i) %>">
<% end %>

</body>
</html>

[Command Line Version] rubydemo/whitesemicirclemeter.rb
#!/usr/bin/env ruby
require("chartdirector")

def createChart(chartIndex)

    # The value to display on the meter
    value = 72.55

    # Create an AngularMeter object of size 300 x 180 pixels with transparent background
    m = ChartDirector::AngularMeter.new(300, 180, ChartDirector::Transparent)

    # Set the default text and line colors to very dark grey (0x222222)
    m.setColor(ChartDirector::TextColor, 0x222222)
    m.setColor(ChartDirector::LineColor, 0x222222)

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

    # Gradient color for the border to make it silver-like
    ringGradient = [1, 0x999999, 0.5, 0xdddddd, 0, 0xf8f8f8, -0.5, 0xdddddd, -1, 0x999999]

    # Background gradient color from white (0xffffff) at the center to light grey (0xdddddd) at the
    # border
    bgGradient = [0, 0xffffff, 0.75, 0xeeeeee, 1, 0xdddddd]

    # Add a scale background of 148 pixels radius using the gradient background, with a 10 pixel
    # thick silver border
    m.addScaleBackground(148, m.relativeRadialGradient(bgGradient, 148), 10,
        m.relativeLinearGradient(ringGradient, 45, 148))

    # Add a 1 pixel light grey (0xbbbbbb) line at the inner edge of the thick silver border (radius
    # = 138) to enhance its contrast with the background gradient
    m.addScaleBackground(138, ChartDirector::Transparent, 1, 0xbbbbbb)

    # 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("ariali.ttf", 16)
    m.setTickLength(-16, -16, -10)
    m.setLineWidth(0, 2, 1, 1)

    # Demostrate different types of color scales and putting them at different positions
    smoothColorScale = [0, 0x3333ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100, 0xff0000]
    stepColorScale = [0, 0x00cc00, 60, 0xffdd00, 80, 0xee0000, 100]
    highLowColorScale = [0, 0x00ff00, 70, ChartDirector::Transparent, 100, 0xff0000]

    if chartIndex == 0
        # Add the smooth color scale at the default position
        m.addColorScale(smoothColorScale)
    elsif chartIndex == 1
        # Add the smooth color scale starting at radius 128 with zero width and ending at radius 128
        # with 16 pixels inner width
        m.addColorScale(smoothColorScale, 128, 0, 128, -16)
    elsif chartIndex == 2
        # Add the smooth color scale starting at radius 70 with zero width and ending at radius 60
        # with 20 pixels outer width
        m.addColorScale(smoothColorScale, 70, 0, 60, 20)
    elsif chartIndex == 3
        # Add the high/low color scale at the default position
        m.addColorScale(highLowColorScale)
    elsif chartIndex == 4
        # Add the step color scale at the default position
        m.addColorScale(stepColorScale)
    else
        # Add the smooth color scale at radius 60 with 15 pixels outer width
        m.addColorScale(smoothColorScale, 60, 15)
    end

    # Add a text label centered at (150, 125) with 15pt Arial Italic font
    m.addText(150, 125, "CPU", "ariali.ttf", 15, ChartDirector::TextColor,
        ChartDirector::BottomCenter)

    # Add a red (0xff0000) pointer at the specified value
    m.addPointer2(value, 0xff0000)

    # Output the chart
    m.makeChart("whitesemicirclemeter%s.png" % chartIndex)
end

createChart(0)
createChart(1)
createChart(2)
createChart(3)
createChart(4)
createChart(5)