ChartDirector 6.0 (Ruby Edition)

Neon Round Meters


      

This examples demonstrates various shading effects to create round meters with a neon look and feel. It also demonstrates how to create meters that can easily be resized.

In this example, the code uses a single size parameter as input, and it derives all the other sizes, such as the radius of the various parts of the chart, the font size, line widths and tick lengths. This allows the chart to be easily resized by changing only one parameter.

For the colors, apart from black and white, the code only uses a single color as input. BaseChart.adjustBrightness is used to create brighter or darker versions of that color, and AngularMeter.relativeRadialGradient is used to combine them in gradients.

Source Code Listing

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

class NeonroundmeterController < ApplicationController

    def index()
        @title = "Neon Round Meters"
        @ctrl_file = File.expand_path(__FILE__)
        @noOfCharts = 4
        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 = 50

        # The main color of the four meters in this example. The other colors and gradients are
        # derived from the main color.
        colorList = [0x007700, 0x770077, 0x0033dd, 0x880000]
        mainColor = colorList[chartIndex]

        #
        # In this example, we demonstrate how to parameterized by size, so that the chart size can
        # be changed by changing just one variable.
        #
        size = 300

        # The radius of the entire meter, which is size / 2, minus 2 pixels for margin
        outerRadius = (size / 2 - 2).to_i

        # The radius of the meter scale
        scaleRadius = (outerRadius * 92 / 100).to_i

        # The radius of the inner decorative circle
        innerRadius = (scaleRadius * 40 / 100).to_i

        # The width of the color scale
        colorScaleWidth = (scaleRadius * 10 / 100).to_i

        # Major tick length
        tickLength = (scaleRadius * 10 / 100).to_i

        # Major tick width
        tickWidth = (scaleRadius * 1 / 100 + 1).to_i

        # Label font size
        fontSize = (scaleRadius * 13 / 100).to_i

        #
        # Create an angular meter based on the above parameters
        #

        # Create an AngularMeter object of the specified size. In this demo, we use black (0x000000)
        # as the background color. You can also use transparent or other colors.
        m = ChartDirector::AngularMeter.new(size, size, 0x000000)

        # Set the default text and line colors to white (0xffffff)
        m.setColor(ChartDirector::TextColor, 0xffffff)
        m.setColor(ChartDirector::LineColor, 0xffffff)

        # Set meter center and scale radius, and set the scale angle from -180 to +90 degrees
        m.setMeter(size / 2, size / 2, scaleRadius, -180, 90)

        # Background gradient with the mainColor at the center and become darker near the border
        bgGradient = [0, mainColor, 0.5, m.adjustBrightness(mainColor, 0.75), 1, m.adjustBrightness(
            mainColor, 0.15)]

        # Fill the meter background with the background gradient
        m.addRing(0, outerRadius, m.relativeRadialGradient(bgGradient, outerRadius * 0.66))

        # Fill the inner circle with the same background gradient for decoration
        m.addRing(0, innerRadius, m.relativeRadialGradient(bgGradient, innerRadius * 0.8))

        # Gradient for the neon backlight, with the main color at the scale radius fading to
        # transparent
        neonGradient = [0.89, ChartDirector::Transparent, 1, mainColor, 1.07,
            ChartDirector::Transparent]
        m.addRing((scaleRadius * 85 / 100).to_i, outerRadius, m.relativeRadialGradient(neonGradient)
            )

        # The neon ring at the scale radius with width equal to 1/80 of the scale radius, creating
        # using a brighter version of the main color
        m.addRing(scaleRadius, (scaleRadius + scaleRadius / 80).to_i, m.adjustBrightness(mainColor,
            2))

        # Meter scale is 0 - 100, with major/minor/micro ticks every 10/5/1 units
        m.setScale(0, 100, 10, 5, 1)

        # Set the scale label style, tick length and tick width. The minor and micro tick lengths
        # are 80% and 60% of the major tick length, and their widths are around half of the major
        # tick width.
        m.setLabelStyle("ariali.ttf", fontSize)
        m.setTickLength(-tickLength, -(tickLength * 80 / 100).to_i, -(tickLength * 60 / 100).to_i)
        m.setLineWidth(0, tickWidth, ((tickWidth + 1) / 2).to_i, ((tickWidth + 1) / 2).to_i)

        # Demostrate different types of color scales and glare effects and putting them at different
        # positions.
        smoothColorScale = [0, 0x0000ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100, 0xff0000]
        stepColorScale = [0, 0x00dd00, 60, 0xddaa00, 80, 0xdd0000, 100]
        highColorScale = [70, ChartDirector::Transparent, 100, 0xff0000]

        if chartIndex == 1
            # Add the smooth color scale just outside the inner circle
            m.addColorScale(smoothColorScale, innerRadius + 1, colorScaleWidth)
            # Add glare up to the scale radius, concave and spanning 190 degrees
            m.addGlare(scaleRadius, -190)
        elsif chartIndex == 2
            # Add the high color scale at the default position
            m.addColorScale(highColorScale)
            # Add glare up to the scale radius
            m.addGlare(scaleRadius)
        else
            # Add the step color scale just outside the inner circle
            m.addColorScale(stepColorScale, innerRadius + 1, colorScaleWidth)
            # Add glare up to the scale radius, concave and spanning 190 degrees and rotated by -45
            # degrees
            m.addGlare(scaleRadius, -190, -45)
        end

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

        # Set the cap background to a brighter version of the mainColor, and using black (0x000000)
        # for the cap and grey (0x999999) for the cap border
        m.setCap2(m.adjustBrightness(mainColor, 1.1), 0x000000, 0x999999)

        # 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/neonroundmeter.rb
#!/usr/bin/env ruby
require("chartdirector")

def createChart(chartIndex)

    # The value to display on the meter
    value = 50

    # The main color of the four meters in this example. The other colors and gradients are derived
    # from the main color.
    colorList = [0x007700, 0x770077, 0x0033dd, 0x880000]
    mainColor = colorList[chartIndex]

    #
    # In this example, we demonstrate how to parameterized by size, so that the chart size can be
    # changed by changing just one variable.
    #
    size = 300

    # The radius of the entire meter, which is size / 2, minus 2 pixels for margin
    outerRadius = (size / 2 - 2).to_i

    # The radius of the meter scale
    scaleRadius = (outerRadius * 92 / 100).to_i

    # The radius of the inner decorative circle
    innerRadius = (scaleRadius * 40 / 100).to_i

    # The width of the color scale
    colorScaleWidth = (scaleRadius * 10 / 100).to_i

    # Major tick length
    tickLength = (scaleRadius * 10 / 100).to_i

    # Major tick width
    tickWidth = (scaleRadius * 1 / 100 + 1).to_i

    # Label font size
    fontSize = (scaleRadius * 13 / 100).to_i

    #
    # Create an angular meter based on the above parameters
    #

    # Create an AngularMeter object of the specified size. In this demo, we use black (0x000000) as
    # the background color. You can also use transparent or other colors.
    m = ChartDirector::AngularMeter.new(size, size, 0x000000)

    # Set the default text and line colors to white (0xffffff)
    m.setColor(ChartDirector::TextColor, 0xffffff)
    m.setColor(ChartDirector::LineColor, 0xffffff)

    # Set meter center and scale radius, and set the scale angle from -180 to +90 degrees
    m.setMeter(size / 2, size / 2, scaleRadius, -180, 90)

    # Background gradient with the mainColor at the center and become darker near the border
    bgGradient = [0, mainColor, 0.5, m.adjustBrightness(mainColor, 0.75), 1, m.adjustBrightness(
        mainColor, 0.15)]

    # Fill the meter background with the background gradient
    m.addRing(0, outerRadius, m.relativeRadialGradient(bgGradient, outerRadius * 0.66))

    # Fill the inner circle with the same background gradient for decoration
    m.addRing(0, innerRadius, m.relativeRadialGradient(bgGradient, innerRadius * 0.8))

    # Gradient for the neon backlight, with the main color at the scale radius fading to transparent
    neonGradient = [0.89, ChartDirector::Transparent, 1, mainColor, 1.07, ChartDirector::Transparent
        ]
    m.addRing((scaleRadius * 85 / 100).to_i, outerRadius, m.relativeRadialGradient(neonGradient))

    # The neon ring at the scale radius with width equal to 1/80 of the scale radius, creating using
    # a brighter version of the main color
    m.addRing(scaleRadius, (scaleRadius + scaleRadius / 80).to_i, m.adjustBrightness(mainColor, 2))

    # Meter scale is 0 - 100, with major/minor/micro ticks every 10/5/1 units
    m.setScale(0, 100, 10, 5, 1)

    # Set the scale label style, tick length and tick width. The minor and micro tick lengths are
    # 80% and 60% of the major tick length, and their widths are around half of the major tick
    # width.
    m.setLabelStyle("ariali.ttf", fontSize)
    m.setTickLength(-tickLength, -(tickLength * 80 / 100).to_i, -(tickLength * 60 / 100).to_i)
    m.setLineWidth(0, tickWidth, ((tickWidth + 1) / 2).to_i, ((tickWidth + 1) / 2).to_i)

    # Demostrate different types of color scales and glare effects and putting them at different
    # positions.
    smoothColorScale = [0, 0x0000ff, 25, 0x0088ff, 50, 0x00ff00, 75, 0xdddd00, 100, 0xff0000]
    stepColorScale = [0, 0x00dd00, 60, 0xddaa00, 80, 0xdd0000, 100]
    highColorScale = [70, ChartDirector::Transparent, 100, 0xff0000]

    if chartIndex == 1
        # Add the smooth color scale just outside the inner circle
        m.addColorScale(smoothColorScale, innerRadius + 1, colorScaleWidth)
        # Add glare up to the scale radius, concave and spanning 190 degrees
        m.addGlare(scaleRadius, -190)
    elsif chartIndex == 2
        # Add the high color scale at the default position
        m.addColorScale(highColorScale)
        # Add glare up to the scale radius
        m.addGlare(scaleRadius)
    else
        # Add the step color scale just outside the inner circle
        m.addColorScale(stepColorScale, innerRadius + 1, colorScaleWidth)
        # Add glare up to the scale radius, concave and spanning 190 degrees and rotated by -45
        # degrees
        m.addGlare(scaleRadius, -190, -45)
    end

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

    # Set the cap background to a brighter version of the mainColor, and using black (0x000000) for
    # the cap and grey (0x999999) for the cap border
    m.setCap2(m.adjustBrightness(mainColor, 1.1), 0x000000, 0x999999)

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

createChart(0)
createChart(1)
createChart(2)
createChart(3)