ChartDirector 5.1 (Perl Edition)

Horizontal Linear Meter




This example demonstrates a simple horizontal linear meter.

A basic linear meter can be created using the following steps:

In addition to the basic linear meter, this example demonstrates the following features:

Source Code Listing

[Standalone Version] perldemo\hlinearmeter.pl
#!/usr/bin/perl
use perlchartdir;

# The value to display on the meter
my $value = 75.35;

# Create an LinearMeter object of size 250 x 75 pixels, using silver background with
# a 2 pixel black 3D depressed border.
my $m = new LinearMeter(250, 75, perlchartdir::silverColor(), 0, -2);

# Set the scale region top-left corner at (15, 25), with size of 200 x 50 pixels. The
# scale labels are located on the top (implies horizontal meter)
$m->setMeter(15, 25, 220, 20, $perlchartdir::Top);

# Set meter scale from 0 - 100, with a tick every 10 units
$m->setScale(0, 100, 10);

# Set 0 - 50 as green (99ff99) zone, 50 - 80 as yellow (ffff66) zone, and 80 - 100 as
# red (ffcccc) zone
$m->addZone(0, 50, 0x99ff99);
$m->addZone(50, 80, 0xffff66);
$m->addZone(80, 100, 0xffcccc);

# Add a blue (0000cc) pointer at the specified value
$m->addPointer($value, 0x0000cc);

# Add a label at bottom-left (10, 68) using Arial Bold/8 pts/red (c00000)
$m->addText(10, 68, "Temperature C", "arialbd.ttf", 8, 0xc00000,
    $perlchartdir::BottomLeft);

# Add a text box to show the value formatted to 2 decimal places at bottom right. Use
# white text on black background with a 1 pixel depressed 3D border.
$m->addText(238, 70, $m->formatValue($value, "2"), "arial.ttf", 8, 0xffffff,
    $perlchartdir::BottomRight)->setBackground(0, 0, -1);

# Output the chart
$m->makeChart("hlinearmeter.png")

[CGI Version] perldemo_cgi\hlinearmeter.pl
#!/usr/bin/perl

# Include current script directory in the module path (needed on Microsoft IIS).
# This allows this script to work by copying ChartDirector to the same directory
# as the script (as an alternative to installation in Perl module directory)
use File::Basename;
use lib dirname($0) =~ /(.*)/;

use perlchartdir;

# The value to display on the meter
my $value = 75.35;

# Create an LinearMeter object of size 250 x 75 pixels, using silver background with
# a 2 pixel black 3D depressed border.
my $m = new LinearMeter(250, 75, perlchartdir::silverColor(), 0, -2);

# Set the scale region top-left corner at (15, 25), with size of 200 x 50 pixels. The
# scale labels are located on the top (implies horizontal meter)
$m->setMeter(15, 25, 220, 20, $perlchartdir::Top);

# Set meter scale from 0 - 100, with a tick every 10 units
$m->setScale(0, 100, 10);

# Set 0 - 50 as green (99ff99) zone, 50 - 80 as yellow (ffff66) zone, and 80 - 100 as
# red (ffcccc) zone
$m->addZone(0, 50, 0x99ff99);
$m->addZone(50, 80, 0xffff66);
$m->addZone(80, 100, 0xffcccc);

# Add a blue (0000cc) pointer at the specified value
$m->addPointer($value, 0x0000cc);

# Add a label at bottom-left (10, 68) using Arial Bold/8 pts/red (c00000)
$m->addText(10, 68, "Temperature C", "arialbd.ttf", 8, 0xc00000,
    $perlchartdir::BottomLeft);

# Add a text box to show the value formatted to 2 decimal places at bottom right. Use
# white text on black background with a 1 pixel depressed 3D border.
$m->addText(238, 70, $m->formatValue($value, "2"), "arial.ttf", 8, 0xffffff,
    $perlchartdir::BottomRight)->setBackground(0, 0, -1);

# Output the chart
binmode(STDOUT);
print "Content-type: image/png\n\n";
print $m->makeChart2($perlchartdir::PNG);