[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-commits
Subject: [websites/wiki-kde-org/develop] extensions/Translate/phplot: add phplot
From: Ingo Malchow <imalchow () kde ! org>
Date: 2012-07-25 18:08:41
Message-ID: 20120725180841.B90E3A6094 () git ! kde ! org
[Download RAW message or body]
Git commit eb66135e68cd09b7da84e6e98c43487646474e04 by Ingo Malchow.
Committed on 25/07/2012 at 20:05.
Pushed by imalchow into branch 'develop'.
add phplot
A +7232 -0 extensions/Translate/phplot/phplot.php
A +752 -0 extensions/Translate/phplot/rgb.inc.php
http://commits.kde.org/websites/wiki-kde-org/eb66135e68cd09b7da84e6e98c43487646474e04
diff --git a/extensions/Translate/phplot/phplot.php b/extensions/Translate/phplot/phplot.php
new file mode 100644
index 0000000..8d46be9
--- /dev/null
+++ b/extensions/Translate/phplot/phplot.php
@@ -0,0 +1,7232 @@
+<?php
+/* $Id: phplot.php 1264 2012-04-07 00:39:48Z lbayuk $ */
+/*
+ * PHPLOT Version 5.8.0
+ *
+ * A PHP class for creating scientific and business charts
+ * Visit http://sourceforge.net/projects/phplot/
+ * for PHPlot documentation, downloads, and discussions.
+ * ---------------------------------------------------------------------
+ * Copyright (C) 1998-2012 Afan Ottenheimer
+ *
+ * This is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation;
+ * version 2.1 of the License.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ * ---------------------------------------------------------------------
+ *
+ * Co-author and maintainer (2003-2005)
+ * Miguel de Benito Delgado <nonick AT vodafone DOT es>
+ *
+ * Maintainer (2006-present)
+ * <lbayuk AT users DOT sourceforge DOT net>
+ *
+ * Requires PHP 5.3 or later.
+ */
+
+class PHPlot
+{
+ const version = '5.8.0';
+
+ /* Declare class variables which are initialized to static values. Many more class variables
+ * are used, defined as needed, but are unset by default.
+ * All these are declared as public. While it is tempting to make them private or protected, this
+ * is avoided for two reasons. First, it will break existing code, since all member variables
+ * were public in PHP4 and who knows what internal variables people used. Second, it makes
+ * testing harder and less effective. Nevertheless, your code should not modify these.
+ */
+
+ public $is_inline = FALSE; // FALSE = Sends headers, TRUE = sends just raw image data
+ public $browser_cache = FALSE; // FALSE = Sends headers for browser to not cache the image,
+ // (only if is_inline = FALSE also)
+ public $print_image = TRUE; // DrawGraph calls PrintImage. See SetPrintImage
+
+ public $safe_margin = 5; // Extra margin used in several places, in pixels
+
+ public $x_axis_position = ''; // X axis position in Y world coordinates, blank for default.
+ public $y_axis_position = ''; // Y axis position in X world coordinates, blank for default.
+
+ public $xscale_type = 'linear'; // linear, log
+ public $yscale_type = 'linear';
+
+//Fonts
+ public $use_ttf = FALSE; // Use True Type Fonts by default?
+ public $ttf_path = '.'; // Default path to look in for TT Fonts.
+ // public $default_ttfont; // Initialized in GetDefaultTTFont
+ public $line_spacing = 4; // Controls line spacing of multi-line labels
+
+ // Label angles: 0 or 90 degrees for fixed fonts, any for TTF
+ public $x_label_angle = 0; // For X tick labels
+ // public $x_data_label_angle; // For X data labels; defaults to x_label_angle - see CheckLabels()
+ public $y_label_angle = 0; // For Y tick labels
+ public $y_data_label_angle = 0; // For Y data labels
+
+//Formats
+ public $file_format = 'png';
+ public $output_file = ''; // For output to a file instead of stdout
+
+//Data
+ public $data_type = 'text-data'; // Structure of the data array
+ public $plot_type = 'linepoints'; // See $plots[] below
+
+ public $label_scale_position = 0.5; // Shifts data labels in pie charts. 1 = top, 0 = bottom
+ public $group_frac_width = 0.7; // Bars use this fraction (0 to 1) of a group's space
+ public $bar_extra_space = 0.5; // Number of extra bar's worth of space in a group
+ public $bar_width_adjust = 1; // 1 = bars of normal width, must be > 0
+
+// Titles
+ public $title_txt = '';
+
+ public $x_title_txt = '';
+ public $x_title_pos = 'none'; // plotdown, plotup, both, none
+
+ public $y_title_txt = '';
+ public $y_title_pos = 'none'; // plotleft, plotright, both, none
+
+//Labels
+ // There are two types of labels in PHPlot:
+ // Tick labels: Follow the grid, next to ticks in axis.
+ // Are drawn at grid drawing time, by DrawXTicks() and DrawYTicks()
+ // Data labels: Follow the data points, and can be placed on the axis or the plot (x/y)
+ // Are drawn at graph plotting time, by Draw*DataLabel(), called by DrawLines(), etc.
+ // DrawXDataLabel() also draws vertical lines to data points, depending on
+ // draw_x_data_label_lines.
+ // Tick and Data label positions are not initialized, because PHPlot needs to tell if they
+ // defaulted or are set by the user. See CheckLabels() for details. The variables and
+ // effective defaults are shown here in comments (but CheckLabels adjusts the defaults).
+ // public $x_tick_label_pos = 'plotdown'; // X tick label position
+ // public $y_tick_label_pos = 'plotleft'; // Y tick label position
+ // public $x_data_label_pos = 'plotdown'; // X data label position
+ // public $y_data_label_pos = 'none'; // Y data label position
+
+ public $draw_x_data_label_lines = FALSE; // Draw a line from the data point to the axis?
+
+ // Label format controls: See SetLabelType() and FormatLabel()
+ // Outer index is the type of label: x, y (tick labels); xd, yd (data labels); p (pie labels).
+ // Inner indexes are:
+ // type, precision, prefix, suffix, time_format, printf_format, custom_callback, custom_arg.
+ public $label_format = array('x' => array(), 'xd' => array(), 'y' => array(), 'yd' => array());
+ // data_units_text is retained for backward compatibility, because there was never a function
+ // to set it. Use the 'suffix' argument to Set[XY]LabelType instead.
+ public $data_units_text = ''; // Units text for 'data' labels (i.e: '�', '$', etc.)
+
+// Legend
+ public $legend = ''; // An array with legend titles
+ // Other legend_* variables are set as needed, unset for default values.
+
+//Ticks
+ public $x_tick_length = 5; // tick length in pixels for upper/lower axis
+ public $y_tick_length = 5; // tick length in pixels for left/right axis
+
+ public $x_tick_cross = 3; // ticks cross x axis this many pixels
+ public $y_tick_cross = 3; // ticks cross y axis this many pixels
+
+ public $x_tick_pos = 'plotdown'; // plotdown, plotup, both, xaxis, none
+ public $y_tick_pos = 'plotleft'; // plotright, plotleft, both, yaxis, none
+
+ public $num_x_ticks = '';
+ public $num_y_ticks = '';
+
+ public $x_tick_inc = ''; // Set num_x_ticks or x_tick_inc, not both.
+ public $y_tick_inc = ''; // Set num_y_ticks or y_tick_inc, not both.
+
+ public $skip_top_tick = FALSE;
+ public $skip_bottom_tick = FALSE;
+ public $skip_left_tick = FALSE;
+ public $skip_right_tick = FALSE;
+
+//Grid Formatting
+ // public $draw_x_grid = FALSE; // Default is False except for swapped data type
+ // public $draw_y_grid = TRUE; // Default is True except for swapped data type
+
+ public $dashed_grid = TRUE;
+ public $grid_at_foreground = FALSE; // Chooses whether to draw the grid below or above the graph
+
+//Colors and styles (all colors can be array (R,G,B) or named color)
+ public $color_array = 'small'; // 'small', 'large' or array (define your own colors)
+ // See rgb.inc.php and SetRGBArray()
+ public $default_colors = array( // The default colors for data and error bars
+ 'SkyBlue', 'green', 'orange', 'blue', 'red', 'DarkGreen', 'purple', 'peru',
+ 'cyan', 'salmon', 'SlateBlue', 'YellowGreen', 'magenta', 'aquamarine1', 'gold', 'violet');
+
+ // See SetDefaultStyles() for default colors for PHPlot elements.
+
+ public $line_widths = 1; // single value or array
+ public $line_styles = array('solid', 'solid', 'dashed'); // single value or array
+ public $dashed_style = '2-4'; // colored dots-transparent dots
+
+ public $point_sizes = array(6); // Array of sizes for points. See CheckPointParams()
+ public $point_shapes = array( // Array of point shapes. See SetPointShapes() and DrawDot()
+ 'diamond', 'dot', 'delta', 'home', 'yield', 'box', 'circle', 'up', 'down', 'cross'
+ );
+
+ public $error_bar_size = 5; // right and left size of tee
+ public $error_bar_shape = 'tee'; // 'tee' or 'line'
+ public $error_bar_line_width = 1; // single value (or array TODO)
+
+ public $image_border_type = 'none'; // 'raised', 'plain', 'none'
+
+ public $shading = 5; // 0 for no shading, > 0 is size of shadows in pixels
+
+ public $draw_plot_area_background = FALSE;
+ public $draw_broken_lines = FALSE; // Tells not to draw lines for missing Y data.
+
+//Miscellaneous
+ public $callbacks = array( // Valid callback reasons (see SetCallBack)
+ 'data_points' => NULL,
+ 'draw_setup' => NULL,
+ 'draw_image_background' => NULL,
+ 'draw_plotarea_background' => NULL,
+ 'draw_titles' => NULL,
+ 'draw_axes' => NULL,
+ 'draw_graph' => NULL,
+ 'draw_border' => NULL,
+ 'draw_legend' => NULL,
+ 'draw_all' => NULL,
+ 'data_color' => NULL,
+ 'debug_textbox' => NULL, // For testing/debugging text box alignment
+ 'debug_scale' => NULL, // For testing/debugging scale setup
+ );
+
+ // Defined plot types static array:
+ // Array key is the plot type. (Upper case letters are not allowed due to CheckOption)
+ // Value is an array with these keys:
+ // draw_method (required) : Class method to call to draw the plot.
+ // draw_arg : Optional array of arguments to pass to draw_method.
+ // draw_axes : If FALSE, do not draw X/Y axis lines, labels, ticks, grid, titles.
+ // abs_vals, sum_vals : Data array processing flags. See FindDataLimits().
+ static protected $plots = array(
+ 'area' => array(
+ 'draw_method' => 'DrawArea',
+ 'abs_vals' => TRUE,
+ ),
+ 'bars' => array(
+ 'draw_method' => 'DrawBars',
+ ),
+ 'bubbles' => array(
+ 'draw_method' => 'DrawBubbles',
+ ),
+ 'candlesticks' => array(
+ 'draw_method' => 'DrawOHLC',
+ 'draw_arg' => array(TRUE, FALSE), // Draw candlesticks, only fill if "closed down"
+ ),
+ 'candlesticks2' => array(
+ 'draw_method' => 'DrawOHLC',
+ 'draw_arg' => array(TRUE, TRUE), // Draw candlesticks, fill always
+ ),
+ 'linepoints' => array(
+ 'draw_method' => 'DrawLinePoints',
+ ),
+ 'lines' => array(
+ 'draw_method' => 'DrawLines',
+ ),
+ 'ohlc' => array(
+ 'draw_method' => 'DrawOHLC',
+ 'draw_arg' => array(FALSE), // Don't draw candlesticks
+ ),
+ 'pie' => array(
+ 'draw_method' => 'DrawPieChart',
+ 'draw_axes' => FALSE,
+ 'abs_vals' => TRUE,
+ ),
+ 'points' => array(
+ 'draw_method' => 'DrawDots',
+ ),
+ 'squared' => array(
+ 'draw_method' => 'DrawSquared',
+ ),
+ 'stackedarea' => array(
+ 'draw_method' => 'DrawArea',
+ 'draw_arg' => array(TRUE), // Tells DrawArea to draw stacked area plot
+ 'sum_vals' => TRUE,
+ 'abs_vals' => TRUE,
+ ),
+ 'stackedbars' => array(
+ 'draw_method' => 'DrawStackedBars',
+ 'sum_vals' => TRUE,
+ ),
+ 'thinbarline' => array(
+ 'draw_method' => 'DrawThinBarLines',
+ ),
+ );
+
+//////////////////////////////////////////////////////
+//BEGIN CODE
+//////////////////////////////////////////////////////
+
+ /*
+ * Constructor: Setup img resource, colors and size of the image, and font sizes.
+ * $width : Image width in pixels.
+ * $height : Image height in pixels.
+ * $output_file : Filename for output.
+ * $input_file : Path to a file to be used as background.
+ */
+ function PHPlot($width=600, $height=400, $output_file=NULL, $input_file=NULL)
+ {
+ $this->initialize('imagecreate', $width, $height, $output_file, $input_file);
+ }
+
+ /*
+ * Initialize a PHPlot object. This is used by both PHPlot and PHPlot_truecolor constructors.
+ */
+ protected function initialize($imagecreate_function, $width, $height, $output_file, $input_file)
+ {
+ $this->SetRGBArray($this->color_array);
+
+ if (!empty($output_file))
+ $this->SetOutputFile($output_file);
+
+ if (!empty($input_file)) {
+ $this->SetInputFile($input_file);
+ } else {
+ $this->image_width = $width;
+ $this->image_height = $height;
+ $this->img = call_user_func($imagecreate_function, $width, $height);
+ if (!$this->img)
+ return $this->PrintError(get_class($this) . '(): Could not create image resource.');
+ }
+ $this->SetDefaultStyles();
+ $this->SetDefaultFonts();
+ }
+
+ /*
+ * Support for serialize/unserialize: Prepare object for serialization.
+ * The image resource cannot be serialized. But rather than try to filter it out from the other
+ * properties, just let PHP serialize it (it will become an integer=0), and then fix it in __wakeup.
+ * This way the object is still usable after serialize().
+ * Note: This does not work if an input file was provided to the constructor.
+ */
+ function __sleep()
+ {
+ $this->truecolor = imageistruecolor($this->img); // Remember image type
+ $this->saved_version = PHPlot::version; // Remember version of PHPlot, for checking on unserialize
+ return array_keys(get_object_vars($this));
+ }
+
+ /*
+ * Support for serialize/unserialize: Cleanup after unserialization - recreate the image resource.
+ */
+ function __wakeup()
+ {
+ if (strcmp($this->saved_version, PHPlot::version) != 0)
+ $this->PrintError(get_class($this) . '(): Unserialize version mismatch');
+ $imagecreate_function = $this->truecolor ? 'imagecreatetruecolor' : 'imagecreate';
+ $this->img = call_user_func($imagecreate_function, $this->image_width, $this->image_height);
+ if (!$this->img)
+ $this->PrintError(get_class($this) . '(): Could not create image resource.');
+ unset($this->truecolor, $this->saved_version);
+ }
+
+ /*
+ * Reads an image file. Stores width and height, and returns the image
+ * resource. On error, calls PrintError and returns False.
+ * This is used by the constructor via SetInputFile, and by tile_img().
+ */
+ protected function GetImage($image_filename, &$width, &$height)
+ {
+ $error = '';
+ $size = getimagesize($image_filename);
+ if (!$size) {
+ $error = "Unable to query image file $image_filename";
+ } else {
+ $image_type = $size[2];
+ switch ($image_type) {
+ case IMAGETYPE_GIF:
+ $img = @ ImageCreateFromGIF ($image_filename);
+ break;
+ case IMAGETYPE_PNG:
+ $img = @ ImageCreateFromPNG ($image_filename);
+ break;
+ case IMAGETYPE_JPEG:
+ $img = @ ImageCreateFromJPEG ($image_filename);
+ break;
+ default:
+ $error = "Unknown image type ($image_type) for image file $image_filename";
+ break;
+ }
+ }
+ if (empty($error) && !$img) {
+ // getimagesize is OK, but GD won't read it. Maybe unsupported format.
+ $error = "Failed to read image file $image_filename";
+ }
+ if (!empty($error)) {
+ return $this->PrintError("GetImage(): $error");
+ }
+ $width = $size[0];
+ $height = $size[1];
+ return $img;
+ }
+
+ /*
+ * Selects an input file to be used as background for the whole graph.
+ * This resets the graph size to the image's size.
+ * Note: This is used by the constructor. It is deprecated for direct use.
+ */
+ function SetInputFile($which_input_file)
+ {
+ $im = $this->GetImage($which_input_file, $this->image_width, $this->image_height);
+ if (!$im)
+ return FALSE; // GetImage already produced an error message.
+
+ // Deallocate any resources previously allocated
+ if (isset($this->img))
+ imagedestroy($this->img);
+
+ $this->img = $im;
+
+ // Do not overwrite the input file with the background color.
+ $this->done['background'] = TRUE;
+
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+////////////// COLORS
+/////////////////////////////////////////////
+
+ /*
+ * Allocate a GD color index for a color specified by a 4 component array.
+ * When a color is requested, it is parsed and checked by SetRGBColor, and then saved as an array
+ * of (R,G,B,A) components. At graph drawing time, this function is used to allocate the color.
+ * $color : The color specification as a 4 component array: R, G, B, A. This is passed as
+ * a reference argument because it might be unset (see next argument).
+ * $default_color_index : An already-allocated GD color index to use as default, if $color is unset.
+ * Returns: A GD color index that can be used when drawing.
+ */
+ protected function GetColorIndex(&$color, $default_color_index = 0)
+ {
+ if (empty($color)) return $default_color_index;
+ list($r, $g, $b, $a) = $color;
+ return imagecolorresolvealpha($this->img, $r, $g, $b, $a);
+ }
+
+ /*
+ * Allocate an array of GD color indexes for an array of color specifications.
+ * This is used for the data_colors array, for example.
+ * $color_array : Array of color specifications, each an array of R,G,B,A components.
+ * This must use 0-based sequential integer indexes.
+ * $max_colors : Limit color allocation to no more than this.
+ * Returns an array of GD color indexes.
+ */
+ protected function GetColorIndexArray($color_array, $max_colors)
+ {
+ $n = min(count($color_array), $max_colors);
+ $result = array();
+ for ($i = 0; $i < $n; $i++)
+ $result[] = $this->GetColorIndex($color_array[$i]);
+ return $result;
+ }
+
+ /*
+ * Allocate an array of GD color indexes for darker shades of an array of color specifications.
+ * $color_array : Array of color specifications, each an array of R,G,B,A components.
+ * $max_colors : Limit color allocation to this many colors from the array.
+ * Returns an array of GD color indexes.
+ */
+ protected function GetDarkColorIndexArray($color_array, $max_colors)
+ {
+ $n = min(count($color_array), $max_colors);
+ $result = array();
+ for ($i = 0; $i < $n; $i++)
+ $result[] = $this->GetDarkColorIndex($color_array[$i]);
+ return $result;
+ }
+
+ /*
+ * Allocate a GD color index for a darker shade of a color specified by a 4 component array.
+ * See notes for GetColorIndex() above.
+ * $color : The color specification as a 4 component array: R, G, B, A.
+ * Returns: A GD color index that can be used when drawing.
+ */
+ protected function GetDarkColorIndex($color)
+ {
+ list ($r, $g, $b, $a) = $color;
+ $r = max(0, $r - 0x30);
+ $g = max(0, $g - 0x30);
+ $b = max(0, $b - 0x30);
+ return imagecolorresolvealpha($this->img, $r, $g, $b, $a);
+ }
+
+ /*
+ * Sets/reverts all colors and styles to their defaults.
+ */
+ protected function SetDefaultStyles()
+ {
+ $this->SetDefaultDashedStyle($this->dashed_style);
+ $this->SetImageBorderColor(array(194, 194, 194));
+ $this->SetPlotBgColor('white');
+ $this->SetBackgroundColor('white');
+ $this->SetTextColor('black');
+ $this->SetGridColor('black');
+ $this->SetLightGridColor('gray');
+ $this->SetTickColor('black');
+ $this->SetTitleColor('black');
+ // These functions set up the default colors when called without parameters
+ $this->SetDataColors();
+ $this->SetErrorBarColors();
+ $this->SetDataBorderColors();
+ return TRUE;
+ }
+
+ /*
+ * Set the image background color to $which_color.
+ */
+ function SetBackgroundColor($which_color)
+ {
+ return (bool)($this->bg_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the plot area background color (if enabled) to $which_color.
+ */
+ function SetPlotBgColor($which_color)
+ {
+ return (bool)($this->plot_bg_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color of the titles (main, X, and Y) to $which_color.
+ * See also SetXTitleColor and SetYTitleColor.
+ */
+ function SetTitleColor($which_color)
+ {
+ return (bool)($this->title_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color of the X title to $which_color.
+ * This overrides the color set with SetTitleColor.
+ */
+ function SetXTitleColor($which_color)
+ {
+ return (bool)($this->x_title_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color of the Y title to $which_color.
+ * This overrides the color set with SetTitleColor.
+ */
+ function SetYTitleColor($which_color)
+ {
+ return (bool)($this->y_title_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color of the axis tick marks to $which_color.
+ */
+ function SetTickColor($which_color)
+ {
+ return (bool)($this->tick_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Deprecated. Use SetTitleColor()
+ */
+ function SetLabelColor($which_color)
+ {
+ return $this->SetTitleColor($which_color);
+ }
+
+ /*
+ * Set the general text color (legend, and default for tick and data labels) to $which_color.
+ */
+ function SetTextColor($which_color)
+ {
+ return (bool)($this->text_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color for data labels, overriding the default set with SetTextColor.
+ */
+ function SetDataLabelColor($which_color)
+ {
+ return (bool)($this->datalabel_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color for data value labels, overriding defaults from SetTextColor and SetDataLabelColor.
+ * Note: These are the labels on and in bars, and above points - within the plot area.
+ */
+ function SetDataValueLabelColor($which_color)
+ {
+ return (bool)($this->dvlabel_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color for pie chart data labels. Historically, these used the GridColor.
+ */
+ function SetPieLabelColor($which_color)
+ {
+ return (bool)($this->pielabel_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color for tick labels, overriding the default set with SetTextColor.
+ */
+ function SetTickLabelColor($which_color)
+ {
+ return (bool)($this->ticklabel_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the X and Y grid colors to $which_color. Also sets the data label line color.
+ */
+ function SetLightGridColor($which_color)
+ {
+ return (bool)($this->light_grid_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color used for the X and Y axis, plot border, legend border to $which_color.
+ * Note: This has nothing to do with the grid, and we don't recall where this name came from.
+ */
+ function SetGridColor($which_color)
+ {
+ return (bool)($this->grid_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Set the color used for the image border to $which_color.
+ */
+ function SetImageBorderColor($which_color)
+ {
+ return (bool)($this->i_border = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Designate color $which_color to be transparent, if supported by the image format.
+ */
+ function SetTransparentColor($which_color)
+ {
+ return (bool)($this->transparent_color = $this->SetRGBColor($which_color));
+ }
+
+ /*
+ * Sets the array of colors to be used. It can be user defined, a small predefined one
+ * or a large one included from 'rgb.inc.php'.
+ *
+ * $which_color_array : A color array, or 'small' or 'large'.
+ * Color arrays map color names into arrays of R, G, B and optionally A values.
+ */
+ function SetRGBArray($which_color_array)
+ {
+ if (is_array($which_color_array)) { // User defined array
+ $this->rgb_array = $which_color_array;
+ } elseif ($which_color_array == 'small') { // Small predefined color array
+ $this->rgb_array = array(
+ 'white' => array(255, 255, 255),
+ 'snow' => array(255, 250, 250),
+ 'PeachPuff' => array(255, 218, 185),
+ 'ivory' => array(255, 255, 240),
+ 'lavender' => array(230, 230, 250),
+ 'black' => array( 0, 0, 0),
+ 'DimGrey' => array(105, 105, 105),
+ 'gray' => array(190, 190, 190),
+ 'grey' => array(190, 190, 190),
+ 'navy' => array( 0, 0, 128),
+ 'SlateBlue' => array(106, 90, 205),
+ 'blue' => array( 0, 0, 255),
+ 'SkyBlue' => array(135, 206, 235),
+ 'cyan' => array( 0, 255, 255),
+ 'DarkGreen' => array( 0, 100, 0),
+ 'green' => array( 0, 255, 0),
+ 'YellowGreen' => array(154, 205, 50),
+ 'yellow' => array(255, 255, 0),
+ 'orange' => array(255, 165, 0),
+ 'gold' => array(255, 215, 0),
+ 'peru' => array(205, 133, 63),
+ 'beige' => array(245, 245, 220),
+ 'wheat' => array(245, 222, 179),
+ 'tan' => array(210, 180, 140),
+ 'brown' => array(165, 42, 42),
+ 'salmon' => array(250, 128, 114),
+ 'red' => array(255, 0, 0),
+ 'pink' => array(255, 192, 203),
+ 'maroon' => array(176, 48, 96),
+ 'magenta' => array(255, 0, 255),
+ 'violet' => array(238, 130, 238),
+ 'plum' => array(221, 160, 221),
+ 'orchid' => array(218, 112, 214),
+ 'purple' => array(160, 32, 240),
+ 'azure1' => array(240, 255, 255),
+ 'aquamarine1' => array(127, 255, 212)
+ );
+ } elseif ($which_color_array == 'large') { // Large color array
+ if (!@include('rgb.inc.php')) {
+ return $this->PrintError("SetRGBArray(): Large color map could not be loaded\n"
+ . "from 'rgb.inc.php'.");
+ }
+ $this->rgb_array = $ColorArray;
+ } else { // Default to black and white only.
+ $this->rgb_array = array('white' => array(255, 255, 255), 'black' => array(0, 0, 0));
+ }
+
+ return TRUE;
+ }
+
+ /*
+ * Parse a color description and return the color component values.
+ * Arguments:
+ * $color_asked : The desired color description, in one of these forms:
+ * Component notation: array(R, G, B) or array(R, G, B, A) with each
+ * in the range described below for the return value.
+ * Examples: (255,255,0) (204,0,0,30)
+ * Hex notation: "#RRGGBB" or "#RRGGBBAA" where each pair is a 2 digit hex number.
+ * Examples: #FF00FF (magenta) #0000FF40 (Blue with alpha=64/127)
+ * Named color in the current colormap, with optional suffix ":alpha" for alpha value.
+ * Examples: blue red:60 yellow:20
+ * $alpha : optional default alpha value. This is applied to the color if it doesn't
+ * already have an alpha value. If not supplied, colors are opaque (alpha=0) by default.
+ *
+ * Returns an array describing a color as (R, G, B, Alpha).
+ * R, G, and B are integers 0-255, and Alpha is 0 (opaque) to 127 (transparent).
+ * Note: This function should be considered 'protected', and is not documented for public use.
+ */
+ function SetRGBColor($color_asked, $alpha = 0)
+ {
+ if (empty($color_asked)) {
+ $ret_val = array(0, 0, 0);
+
+ } elseif (is_array($color_asked) && (($n = count($color_asked)) == 3 || $n == 4) ) {
+ // Already an array of 3 or 4 elements:
+ $ret_val = $color_asked;
+
+ } elseif (preg_match('/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?$/i',
+ $color_asked, $ss)) {
+ // #RRGGBB or #RRGGBBAA notation:
+ $ret_val = array(hexdec($ss[1]), hexdec($ss[2]), hexdec($ss[3]));
+ if (isset($ss[4])) $ret_val[] = hexdec($ss[4]);
+
+ } elseif (isset($this->rgb_array[$color_asked])) {
+ // Color by name:
+ $ret_val = $this->rgb_array[$color_asked];
+
+ } elseif (preg_match('/(.+):([\d]+)$/', $color_asked, $ss)
+ && isset($this->rgb_array[$ss[1]])) {
+ // Color by name with ":alpha" suffix, alpha is a decimal number:
+ $ret_val = $this->rgb_array[$ss[1]];
+ $ret_val[3] = (int)$ss[2];
+
+ } else {
+ return $this->PrintError("SetRGBColor(): Color '$color_asked' is not valid.");
+ }
+
+ // Append alpha if not already provided for:
+ if (count($ret_val) == 3)
+ $ret_val[] = $alpha;
+ return $ret_val;
+ }
+
+ /*
+ * Sets the colors for the data, with optional default alpha value
+ * Cases are:
+ * SetDataColors(array(...)) : Use the supplied array as the color map.
+ * SetDataColors(colorname) : Use an array of just colorname as the color map.
+ * SetDataColors() or SetDataColors(NULL) : Load default color map if no color map is already set.
+ * SetDataColors('') or SetDataColors(False) : Load default color map (even if one is already set).
+ * $which_border is passed to SetDataBorderColors, for backward compatibility.
+ * $alpha is a default Alpha to apply to all data colors that do not have alpha.
+ * The default for this is NULL, not 0, so we can tell if it was defaulted. But the effective
+ * default value is 0 (opaque).
+ */
+ function SetDataColors($which_data = NULL, $which_border = NULL, $alpha = NULL)
+ {
+ if (is_array($which_data)) {
+ $colors = $which_data; // Use supplied array
+ } elseif (!empty($which_data)) {
+ $colors = array($which_data); // Use supplied single color
+ } elseif (empty($this->data_colors) || !is_null($which_data)) {
+ $colors = $this->default_colors; // Use default color array
+ } else {
+ // which_data is NULL or missing and a color array is already set.
+ // The existing color array is left alone, except that if $alpha is
+ // given this will replace the alpha value of each existing color.
+ // This makes SetDataColors(NULL, NULL, $alpha) work.
+ if (isset($alpha)) {
+ $n_colors = count($this->data_colors);
+ for ($i = 0; $i < $n_colors; $i++) {
+ $this->data_colors[$i][3] = $alpha; // Component 3 = alpha value
+ }
+ }
+ // No need to reparse the colors or anything else.
+ return TRUE;
+ }
+
+ if (!isset($alpha))
+ $alpha = 0; // Actual default is opaque colors.
+
+ // Check each color and convert to array (r,g,b,a) form.
+ // Use the $alpha argument as a default for the alpha value of each color.
+ $this->data_colors = array();
+ foreach ($colors as $color) {
+ $color_array = $this->SetRGBColor($color, $alpha);
+ if (!$color_array) return FALSE; // SetRGBColor already did an error message.
+ $this->data_colors[] = $color_array;
+ }
+
+ // For past compatibility:
+ return $this->SetDataBorderColors($which_border);
+ }
+
+ /*
+ * Set the colors for the bars and stacked bars outlines.
+ * Argument usage is similar to SetDataColors(), except the default is just black.
+ */
+ function SetDataBorderColors($which_br = NULL)
+ {
+ if (is_array($which_br)) {
+ $colors = $which_br; // Use supplied array
+ } elseif (!empty($which_br)) {
+ $colors = array($which_br); // Use supplied single color
+ } elseif (empty($this->data_border_colors) || !is_null($which_br)) {
+ $colors = array('black'); // Use default
+ } else {
+ return TRUE; // Do nothing: which_br is NULL or missing and a color array is already set.
+ }
+
+ // Check each color and convert to array (r,g,b,a) form.
+ $this->data_border_colors = array();
+ foreach ($colors as $color) {
+ $color_array = $this->SetRGBColor($color);
+ if (!$color_array) return FALSE; // SetRGBColor already did an error message.
+ $this->data_border_colors[] = $color_array;
+ }
+ return TRUE;
+ }
+
+ /*
+ * Sets the colors for the data error bars.
+ * Argument usage is the same as SetDataColors().
+ */
+ function SetErrorBarColors($which_err = NULL)
+ {
+ if (is_array($which_err)) {
+ $colors = $which_err; // Use supplied array
+ } elseif (!empty($which_err)) {
+ $colors = array($which_err); // Use supplied single color
+ } elseif (empty($this->error_bar_colors) || !is_null($which_err)) {
+ $colors = $this->default_colors; // Use default color array
+ } else {
+ return TRUE; // Do nothing: which_err is NULL or missing and a color array is already set.
+ }
+
+ // Check each color and convert to array (r,g,b,a) form.
+ $this->error_bar_colors = array();
+ foreach ($colors as $color) {
+ $color_array = $this->SetRGBColor($color);
+ if (!$color_array) return FALSE; // SetRGBColor already did an error message.
+ $this->error_bar_colors[] = $color_array;
+ }
+ return TRUE;
+ }
+
+ /*
+ * Sets the default dashed line style.
+ * $which_style : A string specifying the dashed line style, as alternating numbers
+ * of the length (in pixels) of lines and spaces, separated by dashes.
+ * For example: '2-3-1-2' means 2 dots of color, 3 transparent, 1 color, then 2 transparent.
+ * This builds a string which will evaluate to an array of integers. Each colored dot
+ * is '$which_ndxcol' and each transparent dot is 'IMG_COLOR_TRANSPARENT'. When SetDashedStyle()
+ * eval's this with $which_ndxcol set, the result is a GD line style array.
+ */
+ function SetDefaultDashedStyle($which_style)
+ {
+ // Explode "numcol-numtrans-numcol-numtrans..." into segment counts:
+ $asked = explode('-', $which_style);
+
+ if (count($asked) < 2) {
+ return $this->PrintError("SetDefaultDashedStyle(): Wrong parameter '$which_style'.");
+ }
+
+ // Build the string to be evaluated later by SetDashedStyle() with $which_ndxcolor set.
+ $result = '';
+ $vals = array('$which_ndxcol,', 'IMG_COLOR_TRANSPARENT,');
+ $index = 0;
+ foreach ($asked as $n) {
+ $result .= str_repeat($vals[$index], $n);
+ $index = 1 - $index;
+ }
+ $this->default_dashed_style = "array($result)";
+
+ return TRUE;
+ }
+
+ /*
+ * Sets the style before drawing a dashed line. Defaults to $this->default_dashed_style
+ * $which_ndxcol : Color index to be used.
+ */
+ protected function SetDashedStyle($which_ndxcol)
+ {
+ // See SetDefaultDashedStyle() to understand this.
+ eval ("\$style = $this->default_dashed_style;");
+ return imagesetstyle($this->img, $style);
+ }
+
+ /*
+ * Set line widths for each data set.
+ * $which_lw : Array of line widths in pixels, or a single value to use for all data sets.
+ */
+ function SetLineWidths($which_lw=NULL)
+ {
+ if (is_array($which_lw)) {
+ $this->line_widths = $which_lw; // Use provided array
+ } elseif (!is_null($which_lw)) {
+ $this->line_widths = array($which_lw); // Convert value to array
+ }
+ return TRUE;
+ }
+
+ /*
+ * Set line style ('solid' or 'dashed') for each data set.
+ * $which_ls : Array of keywords, or a single keyword to use for all data sets.
+ */
+ function SetLineStyles($which_ls=NULL)
+ {
+ if (is_array($which_ls)) {
+ $this->line_styles = $which_ls; // Use provided array
+ } elseif (!is_null($which_ls)) {
+ $this->line_styles = ($which_ls) ? array($which_ls) : array('solid');
+ }
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+////////////// TEXT and FONTS
+/////////////////////////////////////////////
+
+ /*
+ * Controls the line spacing of multi-line labels.
+ * $which_spc : Line spacing factor for text
+ * For GD text, this is the number of pixels between lines.
+ * For TTF text, it controls line spacing in proportion to the normal
+ * spacing defined by the font.
+ */
+ function SetLineSpacing($which_spc)
+ {
+ $this->line_spacing = $which_spc;
+ return TRUE;
+ }
+
+ /*
+ * Select the default font type to use.
+ * $which_ttf : True to default to TrueType, False to default to GD (fixed) fonts.
+ * This also resets all font settings to the defaults.
+ */
+ function SetUseTTF($which_ttf)
+ {
+ $this->use_ttf = $which_ttf;
+ return $this->SetDefaultFonts();
+ }
+
+ /*
+ * Sets the directory name to look into for TrueType fonts.
+ */
+ function SetTTFPath($which_path)
+ {
+ if (!is_dir($which_path) || !is_readable($which_path)) {
+ return $this->PrintError("SetTTFPath(): $which_path is not a valid path.");
+ }
+ $this->ttf_path = $which_path;
+ return TRUE;
+ }
+
+ /*
+ * Sets the default TrueType font and updates all fonts to that.
+ * The default font might be a full path, or relative to the TTFPath,
+ * so let SetFont check that it exists.
+ * Side effects: Enables use of TrueType fonts as the default font type,
+ * and resets all font settings.
+ */
+ function SetDefaultTTFont($which_font)
+ {
+ $this->default_ttfont = $which_font;
+ return $this->SetUseTTF(TRUE);
+ }
+
+ /*
+ * Return the default TrueType font name. If no default has been set,
+ * this tries some likely candidates for a font which can be loaded.
+ * If it finds one that works, that becomes the default TT font.
+ * If there is no default and it cannot find a working font, it falls
+ * back to the original PHPlot default (which will not likely work either).
+ */
+ protected function GetDefaultTTFont()
+ {
+ if (!isset($this->default_ttfont)) {
+ // No default font yet. Try some common sans-serif fonts.
+ $fonts = array('LiberationSans-Regular.ttf', // For Linux with a correct GD font search path
+ 'Verdana.ttf', 'Arial.ttf', 'Helvetica.ttf', // For Windows, maybe others
+ 'ttf-liberation/LiberationSans-Regular.ttf', // For Debian, Ubuntu, and friends
+ 'benjamingothic.ttf', // Original PHPlot default
+ );
+ foreach ($fonts as $font) {
+ // First try the font name alone, to see if GD can find and load it.
+ if (@imagettfbbox(10, 0, $font, "1") !== False)
+ break;
+ // If the font wasn't found, try it with the default TTF path in front.
+ $font_with_path = $this->ttf_path . DIRECTORY_SEPARATOR . $font;
+ if (@imagettfbbox(10, 0, $font_with_path, "1") !== False) {
+ $font = $font_with_path;
+ break;
+ }
+ }
+ // We either have a working font, or are using the last one regardless.
+ $this->default_ttfont = $font;
+ }
+ return $this->default_ttfont;
+ }
+
+ /*
+ * Sets fonts to their defaults
+ */
+ protected function SetDefaultFonts()
+ {
+ // TTF:
+ if ($this->use_ttf) {
+ return $this->SetFont('generic', '', 8)
+ && $this->SetFont('title', '', 14)
+ && $this->SetFont('legend', '', 8)
+ && $this->SetFont('x_label', '', 6)
+ && $this->SetFont('y_label', '', 6)
+ && $this->SetFont('x_title', '', 10)
+ && $this->SetFont('y_title', '', 10);
+ }
+ // Fixed GD Fonts:
+ return $this->SetFont('generic', 2)
+ && $this->SetFont('title', 5)
+ && $this->SetFont('legend', 2)
+ && $this->SetFont('x_label', 1)
+ && $this->SetFont('y_label', 1)
+ && $this->SetFont('x_title', 3)
+ && $this->SetFont('y_title', 3);
+ }
+
+ /*
+ * Select a fixed (GD) font for an element.
+ * This allows using a fixed font, even with SetUseTTF(True).
+ * $which_elem : The element whose font is to be changed.
+ * One of: title legend generic x_label y_label x_title y_title
+ * $which_font : A GD font number 1-5
+ * $which_spacing (optional) : Line spacing factor
+ */
+ function SetFontGD($which_elem, $which_font, $which_spacing = NULL)
+ {
+ if ($which_font < 1 || 5 < $which_font) {
+ return $this->PrintError(__FUNCTION__ . ': Font size must be 1, 2, 3, 4 or 5');
+ }
+ if (!$this->CheckOption($which_elem,
+ 'generic, title, legend, x_label, y_label, x_title, y_title',
+ __FUNCTION__)) {
+ return FALSE;
+ }
+
+ // Store the font parameters: name/size, char cell height and width.
+ $this->fonts[$which_elem] = array('ttf' => FALSE,
+ 'font' => $which_font,
+ 'height' => ImageFontHeight($which_font),
+ 'width' => ImageFontWidth($which_font),
+ 'line_spacing' => $which_spacing);
+ return TRUE;
+ }
+
+ /*
+ * Select a TrueType font for an element.
+ * This allows using a TrueType font, even with SetUseTTF(False).
+ * $which_elem : The element whose font is to be changed.
+ * One of: title legend generic x_label y_label x_title y_title
+ * $which_font : A TrueType font filename or pathname.
+ * $which_size : Font point size.
+ * $which_spacing (optional) : Line spacing factor
+ */
+ function SetFontTTF($which_elem, $which_font, $which_size = 12, $which_spacing = NULL)
+ {
+ if (!$this->CheckOption($which_elem,
+ 'generic, title, legend, x_label, y_label, x_title, y_title',
+ __FUNCTION__)) {
+ return FALSE;
+ }
+
+ // Empty font name means use the default font.
+ if (empty($which_font))
+ $which_font = $this->GetDefaultTTFont();
+ $path = $which_font;
+
+ // First try the font name directly, if not then try with path.
+ // Use GD imagettfbbox() to determine if this is a valid font.
+ // The return $bbox is used below, if valid.
+ if (($bbox = @imagettfbbox($which_size, 0, $path, "E")) === False) {
+ $path = $this->ttf_path . DIRECTORY_SEPARATOR . $which_font;
+ if (($bbox = @imagettfbbox($which_size, 0, $path, "E")) === False) {
+ return $this->PrintError(__FUNCTION__ . ": Can't find TrueType font $which_font");
+ }
+ }
+
+ // Calculate the font height and inherent line spacing. TrueType fonts have this information
+ // internally, but PHP/GD has no way to directly access it. So get the bounding box size of
+ // an upper-case character without descenders, and the baseline-to-baseline height.
+ // Note: In practice, $which_size = $height, maybe +/-1 . But which_size is in points,
+ // and height is in pixels, and someday GD may be able to tell the difference.
+ // The character width is saved too, but not used by the normal text drawing routines - it
+ // isn't necessarily a fixed-space font. It is used in DrawLegend.
+ $height = $bbox[1] - $bbox[5];
+ $width = $bbox[2] - $bbox[0];
+ $bbox = ImageTTFBBox($which_size, 0, $path, "E\nE");
+ $spacing = $bbox[1] - $bbox[5] - 2 * $height;
+
+ // Store the font parameters:
+ $this->fonts[$which_elem] = array('ttf' => TRUE,
+ 'font' => $path,
+ 'size' => $which_size,
+ 'height' => $height,
+ 'width' => $width,
+ 'spacing' => $spacing,
+ 'line_spacing' => $which_spacing);
+ return TRUE;
+ }
+
+ /*
+ * Select Fixed/TrueType font for an element. Which type of font is
+ * selected depends on the $use_ttf class variable (see SetUseTTF()).
+ * Before PHPlot supported mixing font types, only this function and
+ * SetUseTTF were available to select an overall font type, but now
+ * SetFontGD() and SetFontTTF() can be used for mixing font types.
+ * $which_elem : The element whose font is to be changed.
+ * One of: title legend generic x_label y_label x_title y_title
+ * $which_font : A number 1-5 for fixed fonts, or a TrueType font.
+ * $which_size : Ignored for Fixed fonts, point size for TrueType.
+ * $which_spacing (optional) : Line spacing factor
+ */
+ function SetFont($which_elem, $which_font, $which_size = 12, $line_spacing = NULL)
+ {
+ if ($this->use_ttf)
+ return $this->SetFontTTF($which_elem, $which_font, $which_size, $line_spacing);
+ return $this->SetFontGD($which_elem, $which_font, $line_spacing);
+ }
+
+ /*
+ * Return the inter-line spacing for a font.
+ * This is an internal function, used by ProcessText* and DrawLegend.
+ * $font : A font array variable.
+ * Returns: Spacing, in pixels, between text lines.
+ */
+ protected function GetLineSpacing($font)
+ {
+ // Use the per-font line spacing preference, if set, else the global value:
+ if (isset($font['line_spacing']))
+ $line_spacing = $font['line_spacing'];
+ else
+ $line_spacing = $this->line_spacing;
+
+ // For GD fonts, that is the spacing in pixels.
+ // For TTF, adjust based on the 'natural' font spacing (see SetFontTTF):
+ if ($font['ttf']) {
+ $line_spacing = (int)($line_spacing * $font['spacing'] / 6.0);
+ }
+ return $line_spacing;
+ }
+
+ /*
+ * Text drawing and sizing functions:
+ * ProcessText is meant for use only by DrawText and SizeText.
+ * ProcessText(True, ...) - Draw a block of text
+ * ProcessText(False, ...) - Just return ($width, $height) of
+ * the orthogonal bounding box containing the text.
+ * ProcessText is further split into separate functions for GD and TTF
+ * text, due to the size of the code.
+ *
+ * Horizontal and vertical alignment are relative to the drawing. That is:
+ * vertical text (90 deg) gets centered along Y position with
+ * v_align = 'center', and adjusted to the right of X position with
+ * h_align = 'right'. Another way to look at this is to say
+ * that text rotation happens first, then alignment.
+ *
+ * Original multiple lines code submitted by Remi Ricard.
+ * Original vertical code submitted by Marlin Viss.
+ *
+ * Text routines rewritten by ljb to fix alignment and position problems.
+ * Here is my explanation and notes. More information and pictures will be
+ * placed in the PHPlot Reference Manual.
+ *
+ * + Process TTF text one line at a time, not as a block. (See below)
+ * + Flipped top vs bottom vertical alignment. The usual interpretation
+ * is: bottom align means bottom of the text is at the specified Y
+ * coordinate. For some reason, PHPlot did left/right the correct way,
+ * but had top/bottom reversed. I fixed it, and left the default valign
+ * argument as bottom, but the meaning of the default value changed.
+ *
+ * For GD font text, only single-line text is handled by GD, and the
+ * basepoint is the upper left corner of each text line.
+ * For TTF text, multi-line text could be handled by GD, with the text
+ * basepoint at the lower left corner of the first line of text.
+ * (Behavior of TTF drawing routines on multi-line text is not documented.)
+ * But you cannot do left/center/right alignment on each line that way,
+ * or proper line spacing.
+ * Therefore, for either text type, we have to break up the text into
+ * lines and position each line independently.
+ *
+ * There are 9 alignment modes: Horizontal = left, center, or right, and
+ * Vertical = top, center, or bottom. Alignment is interpreted relative to
+ * the image, not as the text is read. This makes sense when you consider
+ * for example X axis labels. They need to be centered below the marks
+ * (center, top alignment) regardless of the text angle.
+ * 'Bottom' alignment really means baseline alignment.
+ *
+ * GD font text is supported (by libgd) at 0 degrees and 90 degrees only.
+ * Multi-line or single line text works with any of the 9 alignment modes.
+ *
+ * TTF text can be at any angle. The 9 alignment modes work for all angles,
+ * but the results might not be what you expect for multi-line text. See
+ * the PHPlot Reference Manual for pictures and details. In short, alignment
+ * applies to the orthogonal (aligned with X and Y axes) bounding box that
+ * contains the text, and to each line in the multi-line text box. Since
+ * alignment is relative to the image, 45 degree multi-line text aligns
+ * differently from 46 degree text.
+ *
+ * Note that PHPlot allows multi-line text for the 3 titles, and they
+ * are only drawn at 0 degrees (main and X titles) or 90 degrees (Y title).
+ * Data labels can also be multi-line, and they can be drawn at any angle.
+ * -ljb 2007-11-03
+ *
+ */
+
+ /*
+ * ProcessTextGD() - Draw or size GD fixed-font text.
+ * This is intended for use only by ProcessText().
+ * $draw_it : True to draw the text, False to just return the orthogonal width and height.
+ * $font : PHPlot font array (with 'ttf' = False) - see SetFontGD()
+ * $angle : Text angle in degrees. GD only supports 0 and 90. We treat >= 45 as 90, else 0.
+ * $x, $y : Reference point for the text (ignored if !$draw_it)
+ * $color : GD color index to use for drawing the text (ignored if !$draw_it)
+ * $text : The text to draw or size. Put a newline between lines.
+ * $h_factor : Horizontal alignment factor: 0(left), .5(center), or 1(right) (ignored if !$draw_it)
+ * $v_factor : Vertical alignment factor: 0(top), .5(center), or 1(bottom) (ignored if !$draw_it)
+ * Returns: True, if drawing text, or an array of ($width, $height) if not.
+ */
+ protected function ProcessTextGD($draw_it, $font, $angle, $x, $y, $color, $text, $h_factor, $v_factor)
+ {
+ // Extract font parameters:
+ $font_number = $font['font'];
+ $font_width = $font['width'];
+ $font_height = $font['height'];
+ $line_spacing = $this->GetLineSpacing($font);
+
+ // Break up the text into lines, trim whitespace, find longest line.
+ // Save the lines and length for drawing below.
+ $longest = 0;
+ foreach (explode("\n", $text) as $each_line) {
+ $lines[] = $line = trim($each_line);
+ $line_lens[] = $line_len = strlen($line);
+ if ($line_len > $longest) $longest = $line_len;
+ }
+ $n_lines = count($lines);
+
+ // Width, height are based on font size and longest line, line count respectively.
+ // These are relative to the text angle.
+ $total_width = $longest * $font_width;
+ $total_height = $n_lines * $font_height + ($n_lines - 1) * $line_spacing;
+
+ if (!$draw_it) {
+ if ($angle < 45) return array($total_width, $total_height);
+ return array($total_height, $total_width);
+ }
+
+ $interline_step = $font_height + $line_spacing; // Line-to-line step
+
+ if ($angle >= 45) {
+ // Vertical text (90 degrees):
+ // (Remember the alignment convention with vertical text)
+ // For 90 degree text, alignment factors change like this:
+ $temp = $v_factor;
+ $v_factor = $h_factor;
+ $h_factor = 1 - $temp;
+
+ $draw_func = 'ImageStringUp';
+
+ // Rotation matrix "R" for 90 degrees (with Y pointing down):
+ $r00 = 0; $r01 = 1;
+ $r10 = -1; $r11 = 0;
+
+ } else {
+ // Horizontal text (0 degrees):
+ $draw_func = 'ImageString';
+
+ // Rotation matrix "R" for 0 degrees:
+ $r00 = 1; $r01 = 0;
+ $r10 = 0; $r11 = 1;
+ }
+
+ // Adjust for vertical alignment (horizontal text) or horizontal alignment (vertical text):
+ $factor = (int)($total_height * $v_factor);
+ $xpos = $x - $r01 * $factor;
+ $ypos = $y - $r11 * $factor;
+
+ // Debug callback provides the bounding box:
+ if ($this->GetCallback('debug_textbox')) {
+ if ($angle >= 45) {
+ $bbox_width = $total_height;
+ $bbox_height = $total_width;
+ $px = $xpos;
+ $py = $ypos - (1 - $h_factor) * $total_width;
+ } else {
+ $bbox_width = $total_width;
+ $bbox_height = $total_height;
+ $px = $xpos - $h_factor * $total_width;
+ $py = $ypos;
+ }
+ $this->DoCallback('debug_textbox', $px, $py, $bbox_width, $bbox_height);
+ }
+
+ for ($i = 0; $i < $n_lines; $i++) {
+
+ // Adjust for alignment of this line within the text block:
+ $factor = (int)($line_lens[$i] * $font_width * $h_factor);
+ $x = $xpos - $r00 * $factor;
+ $y = $ypos - $r10 * $factor;
+
+ // Call ImageString or ImageStringUp:
+ $draw_func($this->img, $font_number, $x, $y, $lines[$i], $color);
+
+ // Step to the next line of text. This is a rotation of (x=0, y=interline_spacing)
+ $xpos += $r01 * $interline_step;
+ $ypos += $r11 * $interline_step;
+ }
+ return TRUE;
+ }
+
+ /*
+ * ProcessTextTTF() - Draw or size TTF text.
+ * This is intended for use only by ProcessText().
+ * $draw_it : True to draw the text, False to just return the orthogonal width and height.
+ * $font : PHPlot font array (with 'ttf' = True) - see SetFontTTF()
+ * $angle : Text angle in degrees.
+ * $x, $y : Reference point for the text (ignored if !$draw_it)
+ * $color : GD color index to use for drawing the text (ignored if !$draw_it)
+ * $text : The text to draw or size. Put a newline between lines.
+ * $h_factor : Horizontal alignment factor: 0(left), .5(center), or 1(right) (ignored if !$draw_it)
+ * $v_factor : Vertical alignment factor: 0(top), .5(center), or 1(bottom) (ignored if !$draw_it)
+ * Returns: True, if drawing text, or an array of ($width, $height) if not.
+ */
+ protected function ProcessTextTTF($draw_it, $font, $angle, $x, $y, $color, $text, $h_factor, $v_factor)
+ {
+ // Extract font parameters (see SetFontTTF):
+ $font_file = $font['font'];
+ $font_size = $font['size'];
+ $font_height = $font['height'];
+ $line_spacing = $this->GetLineSpacing($font);
+
+ // Break up the text into lines, trim whitespace.
+ // Calculate the total width and height of the text box at 0 degrees.
+ // Save the trimmed lines and their widths for later when drawing.
+ // To get uniform spacing, don't use the actual line heights.
+ // Total height = Font-specific line heights plus inter-line spacing.
+ // Total width = width of widest line.
+ // Last Line Descent is the offset from the bottom to the text baseline.
+ // Note: For some reason, ImageTTFBBox uses (-1,-1) as the reference point.
+ // So 1+bbox[1] is the baseline to bottom distance.
+ $total_width = 0;
+ $lastline_descent = 0;
+ foreach (explode("\n", $text) as $each_line) {
+ $lines[] = $line = trim($each_line);
+ $bbox = ImageTTFBBox($font_size, 0, $font_file, $line);
+ $line_widths[] = $width = $bbox[2] - $bbox[0];
+ if ($width > $total_width) $total_width = $width;
+ $lastline_descent = 1 + $bbox[1];
+ }
+ $n_lines = count($lines);
+ $total_height = $n_lines * $font_height + ($n_lines - 1) * $line_spacing;
+
+ // Calculate the rotation matrix for the text's angle. Remember that GD points Y down,
+ // so the sin() terms change sign.
+ $theta = deg2rad($angle);
+ $cos_t = cos($theta);
+ $sin_t = sin($theta);
+ $r00 = $cos_t; $r01 = $sin_t;
+ $r10 = -$sin_t; $r11 = $cos_t;
+
+ // Make a bounding box of the right size, with upper left corner at (0,0).
+ // By convention, the point order is: LL, LR, UR, UL.
+ // Note this is still working with the text at 0 degrees.
+ // When sizing text (SizeText), use the overall size with descenders.
+ // This tells the caller how much room to leave for the text.
+ // When drawing text (DrawText), use the size without descenders - that
+ // is, down to the baseline. This is for accurate positioning.
+ $b[0] = 0;
+ if ($draw_it) {
+ $b[1] = $total_height;
+ } else {
+ $b[1] = $total_height + $lastline_descent;
+ }
+ $b[2] = $total_width; $b[3] = $b[1];
+ $b[4] = $total_width; $b[5] = 0;
+ $b[6] = 0; $b[7] = 0;
+
+ // Rotate the bounding box, then offset to the reference point:
+ for ($i = 0; $i < 8; $i += 2) {
+ $x_b = $b[$i];
+ $y_b = $b[$i+1];
+ $c[$i] = $x + $r00 * $x_b + $r01 * $y_b;
+ $c[$i+1] = $y + $r10 * $x_b + $r11 * $y_b;
+ }
+
+ // Get an orthogonal (aligned with X and Y axes) bounding box around it, by
+ // finding the min and max X and Y:
+ $bbox_ref_x = $bbox_max_x = $c[0];
+ $bbox_ref_y = $bbox_max_y = $c[1];
+ for ($i = 2; $i < 8; $i += 2) {
+ $x_b = $c[$i];
+ if ($x_b < $bbox_ref_x) $bbox_ref_x = $x_b;
+ elseif ($bbox_max_x < $x_b) $bbox_max_x = $x_b;
+ $y_b = $c[$i+1];
+ if ($y_b < $bbox_ref_y) $bbox_ref_y = $y_b;
+ elseif ($bbox_max_y < $y_b) $bbox_max_y = $y_b;
+ }
+ $bbox_width = $bbox_max_x - $bbox_ref_x;
+ $bbox_height = $bbox_max_y - $bbox_ref_y;
+
+ if (!$draw_it) {
+ // Return the bounding box, rounded up (so it always contains the text):
+ return array((int)ceil($bbox_width), (int)ceil($bbox_height));
+ }
+
+ $interline_step = $font_height + $line_spacing; // Line-to-line step
+
+ // Calculate the offsets from the supplied reference point to the
+ // upper-left corner of the text.
+ // Start at the reference point at the upper left corner of the bounding
+ // box (bbox_ref_x, bbox_ref_y) then adjust it for the 9 point alignment.
+ // h,v_factor are 0,0 for top,left, .5,.5 for center,center, 1,1 for bottom,right.
+ // $off_x = $bbox_ref_x + $bbox_width * $h_factor - $x;
+ // $off_y = $bbox_ref_y + $bbox_height * $v_factor - $y;
+ // Then use that offset to calculate back to the supplied reference point x, y
+ // to get the text base point.
+ // $qx = $x - $off_x;
+ // $qy = $y - $off_y;
+ // Reduces to:
+ $qx = 2 * $x - $bbox_ref_x - $bbox_width * $h_factor;
+ $qy = 2 * $y - $bbox_ref_y - $bbox_height * $v_factor;
+
+ // Check for debug callback. Don't calculate bounding box unless it is wanted.
+ if ($this->GetCallback('debug_textbox')) {
+ // Calculate the orthogonal bounding box coordinates for debug testing.
+
+ // qx, qy is upper left corner relative to the text.
+ // Calculate px,py: upper left corner (absolute) of the bounding box.
+ // There are 4 equation sets for this, depending on the quadrant:
+ if ($sin_t > 0) {
+ if ($cos_t > 0) {
+ // Quadrant: 0d - 90d:
+ $px = $qx; $py = $qy - $total_width * $sin_t;
+ } else {
+ // Quadrant: 90d - 180d:
+ $px = $qx + $total_width * $cos_t; $py = $qy - $bbox_height;
+ }
+ } else {
+ if ($cos_t < 0) {
+ // Quadrant: 180d - 270d:
+ $px = $qx - $bbox_width; $py = $qy + $total_height * $cos_t;
+ } else {
+ // Quadrant: 270d - 360d:
+ $px = $qx + $total_height * $sin_t; $py = $qy;
+ }
+ }
+ $this->DoCallback('debug_textbox', $px, $py, $bbox_width, $bbox_height);
+ }
+
+ // Since alignment is applied after rotation, which parameter is used
+ // to control alignment of each line within the text box varies with
+ // the angle.
+ // Angle (degrees): Line alignment controlled by:
+ // -45 < angle <= 45 h_align
+ // 45 < angle <= 135 reversed v_align
+ // 135 < angle <= 225 reversed h_align
+ // 225 < angle <= 315 v_align
+ if ($cos_t >= $sin_t) {
+ if ($cos_t >= -$sin_t) $line_align_factor = $h_factor;
+ else $line_align_factor = $v_factor;
+ } else {
+ if ($cos_t >= -$sin_t) $line_align_factor = 1-$v_factor;
+ else $line_align_factor = 1-$h_factor;
+ }
+
+ // Now we have the start point, spacing and in-line alignment factor.
+ // We are finally ready to start drawing the text, line by line.
+ for ($i = 0; $i < $n_lines; $i++) {
+
+ // For drawing TTF text, the reference point is the left edge of the
+ // text baseline (not the lower left corner of the bounding box).
+ // The following also adjusts for horizontal (relative to
+ // the text) alignment of the current line within the box.
+ // What is happening is rotation of this vector by the text angle:
+ // (x = (total_width - line_width) * factor, y = font_height)
+
+ $width_factor = ($total_width - $line_widths[$i]) * $line_align_factor;
+ $rx = $qx + $r00 * $width_factor + $r01 * $font_height;
+ $ry = $qy + $r10 * $width_factor + $r11 * $font_height;
+
+ // Finally, draw the text:
+ ImageTTFText($this->img, $font_size, $angle, $rx, $ry, $color, $font_file, $lines[$i]);
+
+ // Step to position of next line.
+ // This is a rotation of (x=0,y=height+line_spacing) by $angle:
+ $qx += $r01 * $interline_step;
+ $qy += $r11 * $interline_step;
+ }
+ return TRUE;
+ }
+
+ /*
+ * ProcessText() - Wrapper for ProcessTextTTF() and ProcessTextGD(). See notes above.
+ * This is intended for use from within PHPlot only, and only by DrawText() and SizeText().
+ * $draw_it : True to draw the text, False to just return the orthogonal width and height.
+ * $font : PHPlot font array, or NULL or empty string to use 'generic'
+ * $angle : Text angle in degrees
+ * $x, $y : Reference point for the text (ignored if !$draw_it)
+ * $color : GD color index to use for drawing the text (ignored if !$draw_it)
+ * $text : The text to draw or size. Put a newline between lines.
+ * $halign : Horizontal alignment: left, center, or right (ignored if !$draw_it)
+ * $valign : Vertical alignment: top, center, or bottom (ignored if !$draw_it)
+ * Note: Alignment is relative to the image, not the text.
+ * Returns: True, if drawing text, or an array of ($width, $height) if not.
+ */
+ protected function ProcessText($draw_it, $font, $angle, $x, $y, $color, $text, $halign, $valign)
+ {
+ // Empty text case:
+ if ($text === '') {
+ if ($draw_it) return TRUE;
+ return array(0, 0);
+ }
+
+ // Calculate width and height offset factors using the alignment args:
+ if ($valign == 'top') $v_factor = 0;
+ elseif ($valign == 'center') $v_factor = 0.5;
+ else $v_factor = 1.0; // 'bottom'
+ if ($halign == 'left') $h_factor = 0;
+ elseif ($halign == 'center') $h_factor = 0.5;
+ else $h_factor = 1.0; // 'right'
+
+ // Apply a default font. This is mostly for external (callback) users.
+ if (empty($font)) $font = $this->fonts['generic'];
+
+ if ($font['ttf']) {
+ return $this->ProcessTextTTF($draw_it, $font, $angle, $x, $y, $color, $text,
+ $h_factor, $v_factor);
+ }
+ return $this->ProcessTextGD($draw_it, $font, $angle, $x, $y, $color, $text, $h_factor, $v_factor);
+ }
+
+ /*
+ * Draws a block of text. See comments above before ProcessText().
+ * $which_font : PHPlot font array, or NULL or empty string to use 'generic'
+ * $which_angle : Text angle in degrees
+ * $which_xpos, $which_ypos: Reference point for the text
+ * $which_color : GD color index to use for drawing the text
+ * $which_text : The text to draw, with newlines (\n) between lines.
+ * $which_halign : Horizontal (relative to the image) alignment: left, center, or right.
+ * $which_valign : Vertical (relative to the image) alignment: top, center, or bottom.
+ * Note: This function should be considered 'protected', and is not documented for public use.
+ */
+ function DrawText($which_font, $which_angle, $which_xpos, $which_ypos, $which_color, $which_text,
+ $which_halign = 'left', $which_valign = 'bottom')
+ {
+ return $this->ProcessText(TRUE,
+ $which_font, $which_angle, $which_xpos, $which_ypos,
+ $which_color, $which_text, $which_halign, $which_valign);
+ }
+
+ /*
+ * Returns the size of block of text. This is the orthogonal width and height of a bounding
+ * box aligned with the X and Y axes of the text. Only for angle=0 is this the actual
+ * width and height of the text block, but for any angle it is the amount of space needed
+ * to contain the text.
+ * $which_font : PHPlot font array, or NULL or empty string to use 'generic'
+ * $which_angle : Text angle in degrees
+ * $which_text : The text to draw, with newlines (\n) between lines.
+ * Returns a two element array with: $width, $height.
+ * This is just a wrapper for ProcessText() - see above.
+ * Note: This function should be considered 'protected', and is not documented for public use.
+ */
+ function SizeText($which_font, $which_angle, $which_text)
+ {
+ // Color, position, and alignment are not used when calculating the size.
+ return $this->ProcessText(FALSE,
+ $which_font, $which_angle, 0, 0, 1, $which_text, '', '');
+ }
+
+/////////////////////////////////////////////
+/////////// INPUT / OUTPUT CONTROL
+/////////////////////////////////////////////
+
+ /*
+ * Sets output file format to $format (jpg, png, ...)
+ */
+ function SetFileFormat($format)
+ {
+ $asked = $this->CheckOption($format, 'jpg, png, gif, wbmp', __FUNCTION__);
+ if (!$asked) return FALSE;
+ switch ($asked) {
+ case 'jpg':
+ $format_test = IMG_JPG;
+ break;
+ case 'png':
+ $format_test = IMG_PNG;
+ break;
+ case 'gif':
+ $format_test = IMG_GIF;
+ break;
+ case 'wbmp':
+ $format_test = IMG_WBMP;
+ break;
+ }
+ if (!(imagetypes() & $format_test)) {
+ return $this->PrintError("SetFileFormat(): File format '$format' not supported");
+ }
+ $this->file_format = $asked;
+ return TRUE;
+ }
+
+ /*
+ * Selects an input file to be used as graph background and scales or tiles this image
+ * to fit the sizes.
+ * $input_file : Path to the file to be used (jpeg, png and gif accepted)
+ * $mode : 'centeredtile', 'tile', or 'scale' (the image to the graph's size)
+ */
+ function SetBgImage($input_file, $mode='centeredtile')
+ {
+ $this->bgmode = $this->CheckOption($mode, 'tile, centeredtile, scale', __FUNCTION__);
+ $this->bgimg = $input_file;
+ return (boolean)$this->bgmode;
+ }
+
+ /*
+ * Selects an input file to be used as plot area background and scales or tiles this image
+ * to fit the sizes.
+ * $input_file : Path to the file to be used (jpeg, png and gif accepted)
+ * $mode : 'centeredtile', 'tile', or 'scale' (the image to the graph's size)
+ */
+ function SetPlotAreaBgImage($input_file, $mode='tile')
+ {
+ $this->plotbgmode = $this->CheckOption($mode, 'tile, centeredtile, scale', __FUNCTION__);
+ $this->plotbgimg = $input_file;
+ return (boolean)$this->plotbgmode;
+ }
+
+ /*
+ * Sets the name of the file to be used as output file.
+ */
+ function SetOutputFile($which_output_file)
+ {
+ $this->output_file = $which_output_file;
+ return TRUE;
+ }
+
+ /*
+ * Sets the output image as 'inline', that is: no Content-Type headers are sent
+ * to the browser. Needed if you want to embed the images.
+ */
+ function SetIsInline($which_ii)
+ {
+ $this->is_inline = (bool)$which_ii;
+ return TRUE;
+ }
+
+ /*
+ * Get the MIME type and GD output function name for the current file type.
+ */
+ protected function GetImageType(&$mime_type, &$output_f)
+ {
+ switch ($this->file_format) {
+ case 'png':
+ $mime_type = 'image/png';
+ $output_f = 'imagepng';
+ break;
+ case 'jpg':
+ $mime_type = 'image/jpeg';
+ $output_f = 'imagejpeg';
+ break;
+ case 'gif':
+ $mime_type = 'image/gif';
+ $output_f = 'imagegif';
+ break;
+ case 'wbmp':
+ $mime_type = 'image/wbmp';
+ $output_f = 'imagewbmp';
+ break;
+ default:
+ // Report the error on PrintImage, because that is where this code used to be.
+ return $this->PrintError('PrintImage(): Please select an image type!');
+ }
+ return TRUE;
+ }
+
+ /*
+ * Helper for PrintImage() : tell browser not to cache the page.
+ * Originally submitted by Thiemo Nagel; modified to add more options based on mjpg-streamer.
+ */
+ protected function DisableCaching()
+ {
+ header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
+ header('Last-Modified: ' . gmdate('D, d M Y H:i:s') . 'GMT');
+ header('Cache-Control: no-store, no-cache, must-revalidate, pre-check=0, post-check=0, max-age=0');
+ header('Pragma: no-cache');
+ return TRUE;
+ }
+
+ /*
+ * Output the generated image to standard output or to a file.
+ */
+ function PrintImage()
+ {
+ if (!$this->browser_cache && !$this->is_inline)
+ $this->DisableCaching();
+
+ // Get MIME type and GD output function name:
+ if (!$this->GetImageType($mime_type, $output_f)) return FALSE;
+
+ if (!$this->is_inline) {
+ Header("Content-type: $mime_type");
+ }
+ if ($this->is_inline && $this->output_file != '') {
+ $output_f($this->img, $this->output_file);
+ } else {
+ $output_f($this->img);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Return the image data, as raw data, base64 encoded, or data URL (see RFC2397).
+ */
+ function EncodeImage($encoding = 'dataurl')
+ {
+ $enc = $this->CheckOption($encoding, 'dataurl, raw, base64', __FUNCTION__);
+ if (!$enc || !$this->GetImageType($mime_type, $output_f)) return FALSE;
+ ob_start();
+ $output_f($this->img);
+ switch ($enc) {
+ case 'raw':
+ return ob_get_clean();
+ case 'base64':
+ return base64_encode(ob_get_clean());
+ default: // 'dataurl', checked above.
+ return "data:$mime_type;base64,\n" . chunk_split(base64_encode(ob_get_clean()));
+ }
+ }
+
+ /*
+ * Replace the image with a message. This is used for error handling, and is also available
+ * as a public function for special purposes.
+ * $text : Text of the message to display in the image
+ * $options : Optional associative array of control options. See defaults below.
+ * Default options are chosen for the error-handling case, which should be as fail-safe as possible.
+ */
+ function DrawMessage($text, $options = NULL)
+ {
+ // Merge options with defaults, and set as local variables:
+ extract( array_merge( array(
+ 'draw_background' => FALSE, // Draw image background per SetBgImage(), SetBackgroundColor()
+ 'draw_border' => FALSE, // Draw image border as set with SetBorder*()
+ 'force_print' => TRUE, // Ignore SetPrintImage() setting and always output
+ 'reset_font' => TRUE, // Reset fonts (to avoid possible TTF error)
+ 'text_color' => '', // If not empty, text color specification
+ 'text_wrap' => TRUE, // Wrap the message text with wordwrap()
+ 'wrap_width' => 75, // Width in characters for wordwrap()
+ ), (array)$options));
+
+ // Do colors, background, and border:
+ if ($draw_border && empty($this->ndx_i_border) || $draw_background && empty($this->ndx_bg_color))
+ $this->SetBgColorIndexes();
+ if ($draw_background) { // User-specified background
+ $this->DrawBackground(TRUE); // TRUE means force overwriting of background
+ } else { // Default to plain white background
+ $bgcolor = imagecolorresolve($this->img, 255, 255, 255);
+ ImageFilledRectangle($this->img, 0, 0, $this->image_width, $this->image_height, $bgcolor);
+ }
+ if ($draw_border) $this->DrawImageBorder(TRUE);
+ if (empty($text_color)) $rgb = array(0, 0, 0);
+ else $rgb = $this->SetRGBColor($text_color);
+ $ndx_text_color = imagecolorresolve($this->img, $rgb[0], $rgb[1], $rgb[2]);
+
+ // Error images should reset fonts, to avoid chance of a TTF error when displaying an error.
+ if ($reset_font) $this->SetUseTTF(FALSE);
+
+ // Determine the space needed for the text, and center the text box within the image:
+ if ($text_wrap) $text = wordwrap($text, $wrap_width);
+ list($text_width, $text_height) = $this->SizeText($this->fonts['generic'], 0, $text);
+ $x = max($this->safe_margin, ($this->image_width - $text_width) / 2);
+ $y = max($this->safe_margin, ($this->image_height - $text_height) / 2);
+ $this->DrawText($this->fonts['generic'], 0, $x, $y, $ndx_text_color, $text, 'left', 'top');
+ if ($force_print || $this->print_image) $this->PrintImage();
+ return TRUE;
+ }
+
+ /*
+ * Error handling for 'fatal' errors:
+ * $error_message : Text of the error message
+ * Produce an image containing the error message, output the image, and then trigger
+ * a user-level error with the message. If no error handler is set up, PHP will log
+ * the message and exit. If there is an error handler, and it returns, PrintError
+ * returns FALSE.
+ */
+ protected function PrintError($error_message)
+ {
+ // Be sure not to loop recursively, e.g. PrintError - PrintImage - PrintError.
+ if (isset($this->in_error)) return FALSE;
+ $this->in_error = TRUE;
+
+ // Output an image containing the error message:
+ if (empty($this->suppress_error_image)) {
+ // img will be empty if the error occurs very early - e.g. when allocating the image.
+ if (!empty($this->img)) {
+ $this->DrawMessage($error_message);
+ } elseif (!$this->is_inline) {
+ Header('HTTP/1.0 500 Internal Server Error');
+ }
+ }
+ trigger_error($error_message, E_USER_ERROR);
+ unset($this->in_error);
+ return FALSE; // In case error handler returns, rather than doing exit().
+ }
+
+ /*
+ * Set error behavior. On failure, PHPlot normally creates an error image.
+ */
+ function SetFailureImage($error_image)
+ {
+ $this->suppress_error_image = !$error_image;
+ return TRUE;
+ }
+
+ /*
+ * Begin a Motion-JPEG (or other type) stream
+ */
+ function StartStream()
+ {
+ $this->GetImageType($mime_type, $this->stream_output_f);
+ $this->stream_boundary = "PHPlot-Streaming-Frame"; // Arbitrary MIME boundary
+ $this->stream_frame_header = "\r\n--$this->stream_boundary\r\nContent-Type: $mime_type\r\n";
+ $this->DisableCaching(); // Send headers to disable browser-side caching
+ header("Content-type: multipart/x-mixed-replace; boundary=\"$this->stream_boundary\"");
+ return TRUE;
+ }
+
+ /*
+ * End a Motion-JPEG (or other type) stream
+ */
+ function EndStream()
+ {
+ echo "\r\n--$this->stream_boundary--\r\n";
+ flush();
+ return TRUE;
+ }
+
+ /*
+ * Output a plot as a frame in a Motion JPEG (or other type) stream, and set up for another.
+ */
+ function PrintImageFrame()
+ {
+ ob_start();
+ call_user_func($this->stream_output_f, $this->img);
+ $size = ob_get_length();
+ $frame = ob_get_clean();
+ echo $this->stream_frame_header, "Content-Length: $size\r\n\r\n", $frame, "\r\n";
+ flush();
+ // This gets the next DrawGraph() to do background and titles again.
+ unset($this->done);
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+/////////// LABELS
+/////////////////////////////////////////////
+
+ /*
+ * Sets position for X data labels.
+ * For vertical plots, these are X axis data labels, showing label strings from the data array.
+ * Accepted positions are: plotdown, plotup, both, none.
+ * For horizontal plots (bar, stackedbar only), these are X data value labels, show the data values.
+ * Accepted positions are: plotin, plotstack, none.
+ */
+ function SetXDataLabelPos($which_xdlp)
+ {
+ $which_xdlp = $this->CheckOption($which_xdlp, 'plotdown, plotup, both, none, plotin, plotstack',
+ __FUNCTION__);
+ if (!$which_xdlp) return FALSE;
+ $this->x_data_label_pos = $which_xdlp;
+
+ return TRUE;
+ }
+
+ /*
+ * Sets position for Y data labels.
+ * For vertical plots (where available), these are Y data value labels, showing the data values.
+ * Accepted positions are: plotin, plotstack, none.
+ * For horizontal plots, these are Y axis data labels, showing label strings from the data array.
+ * Accepted positions are: plotleft, plotright, both, none.
+ */
+ function SetYDataLabelPos($which_ydlp)
+ {
+ $which_ydlp = $this->CheckOption($which_ydlp, 'plotleft, plotright, both, none, plotin, plotstack',
+ __FUNCTION__);
+ if (!$which_ydlp) return FALSE;
+ $this->y_data_label_pos = $which_ydlp;
+
+ return TRUE;
+ }
+
+ /*
+ * Set position for X tick labels.
+ */
+ function SetXTickLabelPos($which_xtlp)
+ {
+ $which_xtlp = $this->CheckOption($which_xtlp, 'plotdown, plotup, both, xaxis, none',
+ __FUNCTION__);
+ if (!$which_xtlp) return FALSE;
+ $this->x_tick_label_pos = $which_xtlp;
+
+ return TRUE;
+ }
+
+ /*
+ * Set position for Y tick labels.
+ */
+ function SetYTickLabelPos($which_ytlp)
+ {
+ $which_ytlp = $this->CheckOption($which_ytlp, 'plotleft, plotright, both, yaxis, none',
+ __FUNCTION__);
+ if (!$which_ytlp) return FALSE;
+ $this->y_tick_label_pos = $which_ytlp;
+
+ return TRUE;
+ }
+
+ /*
+ * Set formatting type for tick and data labels on X or Y axis, or pie labels.
+ * This implements Set[XY]LabelType(), Set[XY]DataLabelType(), and part of SetPieLabelType().
+ * $mode : 'x', 'y', 'xd', 'yd', or 'p' - which type of label to configure.
+ * 'x' and 'y' set the type for tick labels, and the default type for data labels
+ * if they are not separately configured. 'xd' and 'yd' set the type for data labels.
+ * 'p' sets the type for pie chart labels.
+ * $args : Variable arguments, passed as an array.
+ * [0] = $type : Label format type: 'data', 'time', 'printf', 'custom', or empty.
+ * If this is missing or empty, the default formatting for $mode is restored.
+ * For type 'data':
+ * [1] = $precision (optional). Numeric precision. Can also be set by SetPrecision[XY]().
+ * [2] = $prefix (optional) - prefix string for labels.
+ * [3] = $suffix (optional) - suffix string for labels. This replaces data_units_text.
+ * For type 'time':
+ * [1] = $format for strftime (optional). Can also be set by Set[XY]TimeFormat().
+ * For type 'printf':
+ * [1] = $format (optional) for sprintf.
+ * For type 'custom':
+ * [1] = $callback (required) - Custom function or array of (instance,method) to call.
+ * [2] = $argument (optional) - Pass-through argument for the formatting function.
+ */
+ protected function SetLabelType($mode, $args)
+ {
+ if (!$this->CheckOption($mode, 'x, y, xd, yd, p', __FUNCTION__))
+ return FALSE;
+
+ $type = isset($args[0]) ? $args[0] : '';
+ $format = &$this->label_format[$mode]; // Shorthand reference to format storage variables
+ switch ($type) {
+ case 'data':
+ if (isset($args[1]))
+ $format['precision'] = $args[1];
+ elseif (!isset($format['precision']))
+ $format['precision'] = 1;
+ $format['prefix'] = isset($args[2]) ? $args[2] : '';
+ $format['suffix'] = isset($args[3]) ? $args[3] : '';
+ break;
+
+ case 'time':
+ if (isset($args[1]))
+ $format['time_format'] = $args[1];
+ elseif (!isset($format['time_format']))
+ $format['time_format'] = '%H:%M:%S';
+ break;
+
+ case 'printf':
+ if (isset($args[1]))
+ $format['printf_format'] = $args[1];
+ elseif (!isset($format['printf_format']))
+ $format['printf_format'] = '%e';
+ break;
+
+ case 'custom':
+ if (isset($args[1])) {
+ $format['custom_callback'] = $args[1];
+ $format['custom_arg'] = isset($args[2]) ? $args[2] : NULL;
+ } else {
+ $type = ''; // Error, 'custom' without a function, set to no-format mode.
+ }
+ break;
+
+ case '':
+ case 'title': // Retained for backwards compatibility?
+ break;
+
+ default:
+ $this->CheckOption($type, 'data, time, printf, custom', __FUNCTION__);
+ $type = '';
+ }
+ $format['type'] = $type;
+ return (boolean)$type;
+ }
+
+ /*
+ * Select label formating for X tick labels, and for X data labels
+ * (unless SetXDataLabelType was called).
+ * See SetLabelType() for details.
+ */
+ function SetXLabelType() // Variable arguments: $type, ...
+ {
+ $args = func_get_args();
+ return $this->SetLabelType('x', $args);
+ }
+
+ /*
+ * Select label formatting for X data labels, overriding SetXLabelType.
+ */
+ function SetXDataLabelType() // Variable arguments: $type, ...
+ {
+ $args = func_get_args();
+ return $this->SetLabelType('xd', $args);
+ }
+
+ /*
+ * Select label formating for Y tick labels, and for Y data labels
+ * (unless SetYDataLabelType was called).
+ * See SetLabelType() for details.
+ */
+ function SetYLabelType() // Variable arguments: $type, ...
+ {
+ $args = func_get_args();
+ return $this->SetLabelType('y', $args);
+ }
+
+ /*
+ * Select label formatting for Y data labels, overriding SetYLabelType.
+ */
+ function SetYDataLabelType() // Variable arguments: $type, ...
+ {
+ $args = func_get_args();
+ return $this->SetLabelType('yd', $args);
+ }
+
+ /*
+ * Select label source and formating for pie chart labels.
+ * $source - What to use for labels (string or array): percent, value, label, index, or empty string.
+ * Empty string (or NULL, False, or 0) means to restore the default.
+ * ... - Additional arguments telling how to format the label. See SetLabelType() for details.
+ */
+ function SetPieLabelType() // Variable arguments: $source, $type, ....
+ {
+ $args = func_get_args();
+ $source = array_shift($args);
+ if (empty($source)) {
+ unset($this->pie_label_source); // Restore defaults - see CheckPieLabels()
+ $args = array(''); // See below - tells SetLabelType to do no formatting or default.
+ } else {
+ $this->pie_label_source = $this->CheckOptionArray($source, 'percent, value, label, index',
+ __FUNCTION__);
+ if (empty($this->pie_label_source)) return FALSE;
+ }
+ return $this->SetLabelType('p', $args);
+ }
+
+ /*
+ * Set the date/time format code for X labels.
+ * Note: Use of SetXLabelType('time', $which_xtf) is preferred, because
+ * SetXTimeFormat does not also enable date/time formatting.
+ */
+ function SetXTimeFormat($which_xtf)
+ {
+ $this->label_format['x']['time_format'] = $which_xtf;
+ return TRUE;
+ }
+
+ /*
+ * Set the date/time format code for Y labels.
+ * Note: Use of SetYLabelType('time', $which_ytf) is preferred, because
+ * SetYTimeFormat does not also enable date/time formatting.
+ */
+ function SetYTimeFormat($which_ytf)
+ {
+ $this->label_format['y']['time_format'] = $which_ytf;
+ return TRUE;
+ }
+
+ /*
+ * Set number format parameters (decimal point and thousands separator) for
+ * 'data' mode label formatting, overriding the locale-defaults.
+ */
+ function SetNumberFormat($decimal_point, $thousands_sep)
+ {
+ $this->decimal_point = $decimal_point;
+ $this->thousands_sep = $thousands_sep;
+ return TRUE;
+ }
+
+ /*
+ * Set the text angle for X labels to $which_xla degrees.
+ */
+ function SetXLabelAngle($which_xla)
+ {
+ $this->x_label_angle = $which_xla;
+ return TRUE;
+ }
+
+ /*
+ * Set the text angle for Y labels to $which_xla degrees.
+ */
+ function SetYLabelAngle($which_yla)
+ {
+ $this->y_label_angle = $which_yla;
+ return TRUE;
+ }
+
+ /*
+ * Set the angle for X Data Labels to $which_xdla degrees.
+ * If not used, this defaults to the value set with SetXLabelAngle.
+ */
+ function SetXDataLabelAngle($which_xdla)
+ {
+ $this->x_data_label_angle = $which_xdla;
+ return TRUE;
+ }
+
+ /*
+ * Set the angle for Y Data Labels to $which_ydla degrees.
+ * If not used, this defaults to zero (unlike X data labels).
+ */
+ function SetYDataLabelAngle($which_ydla)
+ {
+ $this->y_data_label_angle = $which_ydla;
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+/////////// MISC
+/////////////////////////////////////////////
+
+ /*
+ * Checks the validity of an option.
+ * $which_opt String to check, such as the provided value of a function argument.
+ * $which_acc String of accepted choices. Must be lower-case, and separated
+ * by exactly ', ' (comma, space).
+ * $which_func Name of the calling function, for error messages.
+ * Returns the supplied option value, downcased and trimmed, if it is valid.
+ * Reports an error if the supplied option is not valid.
+ */
+ protected function CheckOption($which_opt, $which_acc, $which_func)
+ {
+ $asked = strtolower(trim($which_opt));
+
+ // Look for the supplied value in a comma/space separated list.
+ if (strpos(", $which_acc,", ", $asked,") !== FALSE)
+ return $asked;
+
+ $this->PrintError("$which_func(): '$which_opt' not in available choices: '$which_acc'.");
+ return NULL;
+ }
+
+ /*
+ * Checks the validity of an array of options.
+ * $opt Array or string to check.
+ * $acc String of accepted choices. Must be lower-case, and separated
+ * by exactly ', ' (comma, space).
+ * $func Name of the calling function, for error messages.
+ * Returns an array of option value(s), downcased and trimmed, if all entries in $opt are valid.
+ * Reports an error if any supplied option is not valid. Returns NULL if the error handler returns.
+ */
+ protected function CheckOptionArray($opt, $acc, $func)
+ {
+ $opt_array = (array)$opt;
+ $result = array();
+ foreach ($opt_array as $option) {
+ $choice = $this->CheckOption($option, $acc, $func);
+ if (is_null($choice)) return NULL; // In case CheckOption error handler returns
+ $result[] = $choice;
+ }
+ return $result;
+ }
+
+ /*
+ * Check compatibility of a plot type and data type.
+ * This is called by the plot-type-specific drawing functions.
+ * $valid_types String of supported data types. Multiple values must be
+ * separated by exactly ', ' (comma, space).
+ * Returns True if the type is valid for this plot.
+ * Reports an error if the data type is not value. If the error is handled and
+ * the handler returns, this returns False.
+ */
+ protected function CheckDataType($valid_types)
+ {
+ if (strpos(", $valid_types,", ", $this->data_type,") !== FALSE)
+ return TRUE;
+
+ $this->PrintError("Data type '$this->data_type' is not valid for '$this->plot_type' plots."
+ . " Supported data type(s): '$valid_types'");
+ return FALSE;
+ }
+
+ /*
+ * Decode the data type into variables used to determine how to process a data array.
+ * The goal is minimize which functions understand the actual data type values.
+ * This sets the datatype_* variables for use by other member functions.
+ * datatype_implied : Implicit independent variable (e.g. text-data vs data-data)
+ * datatype_swapped_xy : Swapped X/Y (horizontal plot)
+ * datatype_error_bars : Data array has error bar data
+ * datatype_pie_single : Data array is for a pie chart with one row per slice
+ * datatype_yz : Data array contains pairs of Y and Z for each X.
+ */
+ protected function DecodeDataType()
+ {
+ $dt = $this->data_type;
+
+ $this->datatype_implied = ($dt == 'text-data' || $dt == 'text-data-single'
+ || $dt == 'text-data-yx');
+ $this->datatype_swapped_xy = ($dt == 'text-data-yx' || $dt == 'data-data-yx');
+ $this->datatype_error_bars = ($dt == 'data-data-error');
+ $this->datatype_pie_single = ($dt == 'text-data-single');
+ $this->datatype_yz = ($dt == 'data-data-xyz');
+ }
+
+ /*
+ * Make sure the data array is populated, and calculate the number of columns.
+ * This is called from DrawGraph. Calculates data_columns, which is the
+ * maximum number of dependent variable values (usually Y) in the data array rows.
+ * (For pie charts, this is the number of slices.)
+ * This depends on the data_type, unlike records_per_group (which was
+ * previously used to pad style arrays, but is not accurate).
+ * Returns True if the data array is OK, else reports an error (and may return False).
+ * Note error messages refer to the caller, the public DrawGraph().
+ */
+ protected function CheckDataArray()
+ {
+ // Test for missing image, which really should never happen.
+ if (!$this->img) {
+ return $this->PrintError('DrawGraph(): No image resource allocated');
+ }
+
+ // Test for missing or empty data array:
+ if (empty($this->data) || !is_array($this->data)) {
+ return $this->PrintError("DrawGraph(): No data array");
+ }
+ if ($this->total_records == 0) {
+ return $this->PrintError('DrawGraph(): Empty data set');
+ }
+
+ // Decode the data type into functional flags.
+ $this->DecodeDataType();
+
+ // Calculate the maximum number of dependent values per independent value
+ // (e.g. Y for each X), or the number of pie slices. Also validate the rows.
+ $skip = $this->datatype_implied ? 1 : 2; // Skip factor for data label and independent variable
+ if ($this->datatype_error_bars) {
+ $this->data_columns = (int)(($this->records_per_group - $skip) / 3);
+ // Validate the data array for error plots: (label, X, then groups of Y, +err, -err):
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ if ($this->num_recs[$i] < $skip || ($this->num_recs[$i] - $skip) % 3 != 0)
+ return $this->PrintError("DrawGraph(): Invalid $this->data_type data array (row $i)");
+ }
+ } elseif ($this->datatype_pie_single) {
+ $this->data_columns = $this->num_data_rows; // Special case for this type of pie chart.
+ // Validate the data array for text-data-single pie charts. Requires 1 value per row.
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ if ($this->num_recs[$i] != 2)
+ return $this->PrintError("DrawGraph(): Invalid $this->data_type data array (row $i)");
+ }
+ } elseif ($this->datatype_yz) {
+ $this->data_columns = (int)(($this->records_per_group - $skip) / 2); // (y, z) pairs
+ // Validate the data array for plots using X, Y, Z: (label, X, then pairs of Y, Z)
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ if ($this->num_recs[$i] < $skip || ($this->num_recs[$i] - $skip) % 2 != 0)
+ return $this->PrintError("DrawGraph(): Invalid $this->data_type data array (row $i)");
+ }
+ } else {
+ $this->data_columns = $this->records_per_group - $skip;
+ // Validate the data array for non-error plots:
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ if ($this->num_recs[$i] < $skip)
+ return $this->PrintError("DrawGraph(): Invalid $this->data_type data array (row $i)");
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Control headers for browser-side image caching.
+ * $which_browser_cache : True to allow browsers to cache the image.
+ */
+ function SetBrowserCache($which_browser_cache)
+ {
+ $this->browser_cache = $which_browser_cache;
+ return TRUE;
+ }
+
+ /*
+ * Set whether DrawGraph automatically outputs the image too.
+ * $which_pi : True to have DrawGraph call PrintImage at the end.
+ */
+ function SetPrintImage($which_pi)
+ {
+ $this->print_image = $which_pi;
+ return TRUE;
+ }
+
+ /*
+ * Set border for the plot area.
+ * Accepted values are: left, right, top, bottom, sides, none, full or an array of those.
+ */
+ function SetPlotBorderType($pbt)
+ {
+ $this->plot_border_type = $this->CheckOptionArray($pbt, 'left, right, top, bottom, sides, none, full',
+ __FUNCTION__);
+ return !empty($this->plot_border_type);
+ }
+
+ /*
+ * Set border style for the image.
+ * Accepted values are: raised, plain, solid, none
+ * 'solid' is the same as 'plain' except it fixes the color (see DrawImageBorder)
+ */
+ function SetImageBorderType($sibt)
+ {
+ $this->image_border_type = $this->CheckOption($sibt, 'raised, plain, solid, none', __FUNCTION__);
+ return (boolean)$this->image_border_type;
+ }
+
+ /*
+ * Set border width for the image to $width in pixels.
+ */
+ function SetImageBorderWidth($width)
+ {
+ $this->image_border_width = $width;
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable drawing of the plot area background color.
+ */
+ function SetDrawPlotAreaBackground($dpab)
+ {
+ $this->draw_plot_area_background = (bool)$dpab;
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable drawing of the X grid lines.
+ */
+ function SetDrawXGrid($dxg)
+ {
+ $this->draw_x_grid = (bool)$dxg;
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable drawing of the Y grid lines.
+ */
+ function SetDrawYGrid($dyg)
+ {
+ $this->draw_y_grid = (bool)$dyg;
+ return TRUE;
+ }
+
+ /*
+ * Select dashed or solid grid lines.
+ * $ddg : True for dashed grid lines, false for solid grid lines.
+ */
+ function SetDrawDashedGrid($ddg)
+ {
+ $this->dashed_grid = (bool)$ddg;
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable drawing of X Data Label Lines.
+ */
+ function SetDrawXDataLabelLines($dxdl)
+ {
+ $this->draw_x_data_label_lines = (bool)$dxdl;
+ return TRUE;
+ }
+
+ /*
+ * Set the main title text for the plot.
+ */
+ function SetTitle($which_title)
+ {
+ $this->title_txt = $which_title;
+ return TRUE;
+ }
+
+ /*
+ * Set the X axis title and position.
+ */
+ function SetXTitle($which_xtitle, $which_xpos = 'plotdown')
+ {
+ if ($which_xtitle == '')
+ $which_xpos = 'none';
+
+ $this->x_title_pos = $this->CheckOption($which_xpos, 'plotdown, plotup, both, none', __FUNCTION__);
+ if (!$this->x_title_pos) return FALSE;
+ $this->x_title_txt = $which_xtitle;
+ return TRUE;
+ }
+
+ /*
+ * Set the Y axis title and position.
+ */
+ function SetYTitle($which_ytitle, $which_ypos = 'plotleft')
+ {
+ if ($which_ytitle == '')
+ $which_ypos = 'none';
+
+ $this->y_title_pos = $this->CheckOption($which_ypos, 'plotleft, plotright, both, none', __FUNCTION__);
+ if (!$this->y_title_pos) return FALSE;
+ $this->y_title_txt = $which_ytitle;
+ return TRUE;
+ }
+
+ /*
+ * Set the size of the drop shadow for bar and pie charts.
+ * $which_s : Size of the drop shadow in pixels.
+ */
+ function SetShading($which_s)
+ {
+ $this->shading = (int)$which_s;
+ return TRUE;
+ }
+
+ /*
+ * Set the plot type (bars, points, ...)
+ */
+ function SetPlotType($which_pt)
+ {
+ $avail_plot_types = implode(', ', array_keys(PHPlot::$plots)); // List of known plot types
+ $this->plot_type = $this->CheckOption($which_pt, $avail_plot_types, __FUNCTION__);
+ return (boolean)$this->plot_type;
+ }
+
+ /*
+ * Set the position of the X axis.
+ * $pos : Axis position in world coordinates (as an integer).
+ */
+ function SetXAxisPosition($pos='')
+ {
+ $this->x_axis_position = ($pos === '') ? $pos : (int)$pos;
+ return TRUE;
+ }
+
+ /*
+ * Set the position of the Y axis.
+ * $pos : Axis position in world coordinates (as an integer).
+ */
+ function SetYAxisPosition($pos='')
+ {
+ $this->y_axis_position = ($pos === '') ? $pos : (int)$pos;
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable drawing of the X axis line.
+ * $draw : True to draw the axis (default if not called), False to suppress it.
+ * This controls drawing of the axis line only, and not the ticks, labels, or grid.
+ */
+ function SetDrawXAxis($draw)
+ {
+ $this->suppress_x_axis = !$draw; // See DrawXAxis()
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable drawing of the Y axis line.
+ * $draw : True to draw the axis (default if not called), False to suppress it.
+ * This controls drawing of the axis line only, and not the ticks, labels, or grid.
+ */
+ function SetDrawYAxis($draw)
+ {
+ $this->suppress_y_axis = !$draw; // See DrawYAxis()
+ return TRUE;
+ }
+
+ /*
+ * Select linear or log scale for the X axis.
+ */
+ function SetXScaleType($which_xst)
+ {
+ $this->xscale_type = $this->CheckOption($which_xst, 'linear, log', __FUNCTION__);
+ return (boolean)$this->xscale_type;
+ }
+
+ /*
+ * Select linear or log scale for the Y axis.
+ */
+ function SetYScaleType($which_yst)
+ {
+ $this->yscale_type = $this->CheckOption($which_yst, 'linear, log', __FUNCTION__);
+ return (boolean)$this->yscale_type;
+ }
+
+ /*
+ * Set the precision for numerically formatted X labels.
+ * $which_prec : Number of digits to display.
+ * Note: This is equivalent to: SetXLabelType('data', $which_prec)
+ */
+ function SetPrecisionX($which_prec)
+ {
+ return $this->SetXLabelType('data', $which_prec);
+ }
+
+ /*
+ * Set the precision for numerically formatted Y labels.
+ * $which_prec : Number of digits to display.
+ * Note: This is equivalent to: SetYLabelType('data', $which_prec)
+ */
+ function SetPrecisionY($which_prec)
+ {
+ return $this->SetYLabelType('data', $which_prec);
+ }
+
+ /*
+ * Set the line width (in pixels) for error bars.
+ */
+ function SetErrorBarLineWidth($which_seblw)
+ {
+ $this->error_bar_line_width = $which_seblw;
+ return TRUE;
+ }
+
+ /*
+ * Set the position for pie chart percentage labels.
+ * $which_blb : Real number between 0 and 1.
+ * Smaller values move the labels in towards the center.
+ * Using 0 or FALSE results in no labels.
+ */
+ function SetLabelScalePosition($which_blp)
+ {
+ $this->label_scale_position = $which_blp;
+ return TRUE;
+ }
+
+ /*
+ * Set the size (in pixels) of the "T" in error bars.
+ */
+ function SetErrorBarSize($which_ebs)
+ {
+ $this->error_bar_size = $which_ebs;
+ return TRUE;
+ }
+
+ /*
+ * Set the shape of the in error bars.
+ * $which_ebs : Error bar shape, 'tee' or 'line'.
+ */
+ function SetErrorBarShape($which_ebs)
+ {
+ $this->error_bar_shape = $this->CheckOption($which_ebs, 'tee, line', __FUNCTION__);
+ return (boolean)$this->error_bar_shape;
+ }
+
+ /*
+ * Synchronize the point shape and point size arrays.
+ * This is called just before drawing any plot that needs 'points'.
+ */
+ protected function CheckPointParams()
+ {
+ // Make both point_shapes and point_sizes the same size, by padding the smaller.
+ $ps = count($this->point_sizes);
+ $pt = count($this->point_shapes);
+
+ if ($ps < $pt) {
+ $this->pad_array($this->point_sizes, $pt);
+ $this->point_counts = $pt;
+ } elseif ($ps > $pt) {
+ $this->pad_array($this->point_shapes, $ps);
+ $this->point_counts = $ps;
+ } else {
+ $this->point_counts = $ps;
+ }
+
+ // Note: PHPlot used to check and adjust point_sizes to be an even number here,
+ // for all 'diamond' and 'triangle' shapes. The reason for this having been
+ // lost, and the current maintainer seeing no sense it doing this for only
+ // some shapes, the code has been removed. But see what DrawDot() does.
+ }
+
+ /*
+ * Set the point shape for each data set.
+ * $which_pt : Array (or single value) of valid point shapes. See also DrawDot() for valid shapes.
+ * The point shape and point sizes arrays are synchronized before drawing a graph
+ * that uses points. See CheckPointParams()
+ */
+ function SetPointShapes($which_pt)
+ {
+ $this->point_shapes = $this->CheckOptionArray($which_pt, 'halfline, line, plus, cross, rect,'
+ . ' circle, dot, diamond, triangle, trianglemid, delta, yield, star, hourglass,'
+ . ' bowtie, target, box, home, up, down, none', __FUNCTION__);
+ return !empty($this->point_shapes);
+ }
+
+ /*
+ * Set the point size for point plots.
+ * $which_ps : Array (or single value) of point sizes in pixels.
+ * The point shape and point sizes arrays are synchronized before drawing a graph
+ * that uses points. See CheckPointParams()
+ */
+ function SetPointSizes($which_ps)
+ {
+ if (is_array($which_ps)) {
+ // Use provided array:
+ $this->point_sizes = $which_ps;
+ } elseif (!is_null($which_ps)) {
+ // Make the single value into an array:
+ $this->point_sizes = array($which_ps);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Sets whether lines should be broken at missing data.
+ * $bl : True to break the lines, false to connect around missing data.
+ * This only works with 'lines' and 'squared' plots.
+ */
+ function SetDrawBrokenLines($bl)
+ {
+ $this->draw_broken_lines = (bool)$bl;
+ return TRUE;
+ }
+
+ /*
+ * Set the data type, which defines the structure of the data array
+ * text-data: ('label', y1, y2, y3, ...)
+ * text-data-single: ('label', data), for some pie charts.
+ * data-data: ('label', x, y1, y2, y3, ...)
+ * data-data-error: ('label', x1, y1, e1+, e2-, y2, e2+, e2-, y3, e3+, e3-, ...)
+ * data-data-yx: ('label', y, x1, x2, x3, ..)
+ * text-data-yx: ('label', x1, x2, x3, ...)
+ * data-data-xyz: ('label', x, y1, z1, ...)
+ */
+ function SetDataType($which_dt)
+ {
+ //The next four lines are for past compatibility.
+ if ($which_dt == 'text-linear') $which_dt = 'text-data';
+ elseif ($which_dt == 'linear-linear') $which_dt = 'data-data';
+ elseif ($which_dt == 'linear-linear-error') $which_dt = 'data-data-error';
+ elseif ($which_dt == 'text-data-pie') $which_dt = 'text-data-single';
+
+ $this->data_type = $this->CheckOption($which_dt, 'text-data, text-data-single, '.
+ 'data-data, data-data-error, '.
+ 'data-data-yx, text-data-yx, data-data-xyz',
+ __FUNCTION__);
+ return (boolean)$this->data_type;
+ }
+
+ /*
+ * Copy the array of data values, converting rows to numerical indexes.
+ * Also validates that the array uses 0-based sequential integer indexes, and that each
+ * array value (row) is another array. Other validation is deferred to CheckDataArray().
+ */
+ function SetDataValues($which_dv)
+ {
+ $this->num_data_rows = count($which_dv);
+ $this->total_records = 0;
+ $this->data = array();
+ $this->num_recs = array();
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ if (!isset($which_dv[$i]) || !is_array($which_dv[$i])) {
+ return $this->PrintError("SetDataValues(): Invalid data array (row $i)");
+ }
+ $this->data[$i] = array_values($which_dv[$i]); // convert to numerical indices.
+
+ // Count size of each row, and total for the array.
+ $this->total_records += $this->num_recs[$i] = count($this->data[$i]);
+ }
+ // This is the size of the widest row in the data array
+ // Note records_per_group isn't used much anymore. See data_columns in CheckDataArray()
+ $this->records_per_group = empty($this->num_recs) ? 0 : max($this->num_recs);
+ return TRUE;
+ }
+
+ /*
+ * Pad styles arrays for later use by plot drawing functions:
+ * This removes the need for $max_data_colors, etc. and $color_index = $color_index % $max_data_colors
+ * in DrawBars(), DrawLines(), etc.
+ * The arrays are padded to data_columns which is the maximum number of data sets.
+ * See CheckDataArray() for the calculation.
+ */
+ protected function PadArrays()
+ {
+ $this->pad_array($this->line_widths, $this->data_columns);
+ $this->pad_array($this->line_styles, $this->data_columns);
+ $this->pad_array($this->ndx_data_colors, $this->data_columns);
+ $this->pad_array($this->ndx_data_border_colors, $this->data_columns);
+ // Other data color arrays are handled in the Need*Colors() functions.
+
+ return TRUE;
+ }
+
+ /*
+ * Pads an array with itself. This only works on 0-based sequential integer indexed arrays.
+ * $arr : The array (or scalar) to pad. This argument is modified.
+ * $size : Minimum size of the resulting array.
+ * If $arr is a scalar, it will be converted first to a single element array.
+ * If $arr has at least $size elements, it is unchanged.
+ * Otherwise, append elements of $arr to itself until it reaches $size elements.
+ */
+ protected function pad_array(&$arr, $size)
+ {
+ if (! is_array($arr)) {
+ $arr = array($arr);
+ }
+ $n = count($arr);
+ $base = 0;
+ while ($n < $size) $arr[$n++] = $arr[$base++];
+ }
+
+ /*
+ * Format a floating-point number.
+ * $number : A floating point number to format
+ * $decimals : Number of decimal places in the result
+ * Returns the formatted result.
+ * This is like PHP's number_format, but uses class variables for separators.
+ * The separators will default to locale-specific values, if available.
+ * Note: The locale is saved and reset after getting the values. This is needed due to an issue with
+ * PHP (see PHP bug 45365 and others): It uses a locale-specific decimal separator when converting
+ * numbers to strings, but fails to convert back if the separator is other than dot. This causes pie
+ * chart labels to fail with "A non well formed numeric value encountered".
+ */
+ protected function number_format($number, $decimals=0)
+ {
+ // Try to get the proper decimal and thousands separators if they are not already set.
+ if (!isset($this->decimal_point, $this->thousands_sep)) {
+ // Load locale-specific values from environment, unless disabled (for testing):
+ if (empty($this->locale_override)) {
+ $save_locale = @setlocale(LC_NUMERIC, '0');
+ @setlocale(LC_NUMERIC, '');
+ }
+ // Fetch locale settings:
+ $locale = @localeconv();
+ // Restore locale. (See note above.)
+ if (!empty($save_locale)) @setlocale(LC_NUMERIC, $save_locale);
+ if (isset($locale['decimal_point'], $locale['thousands_sep'])) {
+ $this->decimal_point = $locale['decimal_point'];
+ $this->thousands_sep = $locale['thousands_sep'];
+ } else {
+ // Locale information not available.
+ $this->decimal_point = '.';
+ $this->thousands_sep = ',';
+ }
+ }
+ return number_format($number, $decimals, $this->decimal_point, $this->thousands_sep);
+ }
+
+ /*
+ * Register a callback (hook) function
+ * $reason : A pre-defined name where a callback can be defined.
+ * $function : The name of a function to register for callback, or an instance/method
+ * pair in an array (see 'callbacks' in the PHP reference manual).
+ * $arg : Optional argument to supply to the callback function when it is triggered.
+ * (Often called "clientData")
+ * Returns True if the callback reason is valid, else False.
+ */
+ function SetCallback($reason, $function, $arg = NULL)
+ {
+ // Use array_key_exists because valid reason keys have NULL as value.
+ if (!array_key_exists($reason, $this->callbacks))
+ return FALSE;
+ $this->callbacks[$reason] = array($function, $arg);
+ return TRUE;
+ }
+
+ /*
+ * Return the name of a function registered for callback. See SetCallBack.
+ * $reason - A pre-defined name where a callback can be defined.
+ * Returns the current callback function (name or array) for the given reason,
+ * or False if there was no active callback or the reason is not valid.
+ * Note you can safely test the return value with a simple 'if', as
+ * no valid function name evaluates to false. Testing the return value, without saving
+ * it, is used within PHPlot to avoid preparing arguments to an unused callback.
+ */
+ function GetCallback($reason)
+ {
+ if (isset($this->callbacks[$reason]))
+ return $this->callbacks[$reason][0];
+ return FALSE;
+ }
+
+ /*
+ * Un-register (remove) a function registered for callback.
+ * $reason - A pre-defined name where a callback can be defined.
+ * Returns: True if it was a valid callback reason, else False.
+ * Note: Returns True whether or not there was a callback registered.
+ */
+ function RemoveCallback($reason)
+ {
+ if (!array_key_exists($reason, $this->callbacks))
+ return FALSE;
+ $this->callbacks[$reason] = NULL;
+ return TRUE;
+ }
+
+ /*
+ * Invoke a callback, if one is registered.
+ * Accepts a variable number of arguments >= 1:
+ * $reason : A string naming the callback.
+ * ... : Zero or more additional arguments to be passed to the
+ * callback function, after the passthru argument:
+ * callback_function($image, $passthru, ...)
+ * Returns: whatever value (if any) was returned by the callback.
+ */
+ protected function DoCallback() // Note: Variable arguments
+ {
+ $args = func_get_args();
+ $reason = $args[0];
+ if (!isset($this->callbacks[$reason]))
+ return;
+ list($function, $args[0]) = $this->callbacks[$reason];
+ array_unshift($args, $this->img);
+ // Now args[] looks like: img, passthru, extra args...
+ return call_user_func_array($function, $args);
+ }
+
+ /*
+ * Allocate background and border colors for the plot.
+ * This is split off from SetColorIndexes() [see below] for use by DrawMessage().
+ */
+ protected function SetBgColorIndexes()
+ {
+ $this->ndx_bg_color = $this->GetColorIndex($this->bg_color); // Background first
+ $this->ndx_plot_bg_color = $this->GetColorIndex($this->plot_bg_color);
+ if ($this->image_border_type != 'none') {
+ $this->ndx_i_border = $this->GetColorIndex($this->i_border);
+ $this->ndx_i_border_dark = $this->GetDarkColorIndex($this->i_border);
+ }
+ }
+
+ /*
+ * Allocate colors for the plot.
+ * This is called by DrawGraph to allocate the colors needed for the plot. Each selectable
+ * color has already been validated, parsed into an array (r,g,b,a), and stored into a member
+ * variable. Now the GD color indexes are assigned and stored into the ndx_*_color variables.
+ * This is deferred here to avoid allocating unneeded colors and to avoid order dependencies,
+ * especially with the transparent color.
+ *
+ * For drawing data elements, only the main data colors and border colors are allocated here.
+ * Dark colors and error bar colors are allocated by Need*Color() functions.
+ * (Data border colors default to just black, so there is no cost to always allocating.)
+ *
+ * Data color allocation works as follows. If there is a data_color callback, then allocate all
+ * defined data colors (because the callback can use them however it wants). Otherwise, only allocate
+ * the number of colors that will be used. This is the larger of the number of data sets and the
+ * number of legend lines.
+ */
+ protected function SetColorIndexes()
+ {
+ $this->SetBgColorIndexes(); // Background and border colors
+
+ // Handle defaults for X and Y title colors.
+ $this->ndx_title_color = $this->GetColorIndex($this->title_color);
+ $this->ndx_x_title_color = $this->GetColorIndex($this->x_title_color, $this->ndx_title_color);
+ $this->ndx_y_title_color = $this->GetColorIndex($this->y_title_color, $this->ndx_title_color);
+
+ // General text color, which is the default color for tick and data labels unless overridden.
+ $this->ndx_text_color = $this->GetColorIndex($this->text_color);
+ $this->ndx_ticklabel_color = $this->GetColorIndex($this->ticklabel_color, $this->ndx_text_color);
+ $this->ndx_datalabel_color = $this->GetColorIndex($this->datalabel_color, $this->ndx_text_color);
+ $this->ndx_dvlabel_color = $this->GetColorIndex($this->dvlabel_color, $this->ndx_datalabel_color);
+
+ $this->ndx_grid_color = $this->GetColorIndex($this->grid_color);
+ $this->ndx_light_grid_color = $this->GetColorIndex($this->light_grid_color);
+ $this->ndx_tick_color = $this->GetColorIndex($this->tick_color);
+ // Pie label color defaults to grid color, for historical reasons (PHPlot <= 5.6.1)
+ $this->ndx_pielabel_color = $this->GetColorIndex($this->pielabel_color, $this->ndx_grid_color);
+
+ // Maximum number of data & border colors to allocate:
+ if ($this->GetCallback('data_color')) {
+ $n_data = count($this->data_colors); // Need all of them
+ $n_border = count($this->data_border_colors);
+ } else {
+ $n_data = max($this->data_columns, empty($this->legend) ? 0 : count($this->legend));
+ $n_border = $n_data; // One border color per data color
+ }
+
+ // Allocate main data colors. For other colors used for data, see the functions which follow.
+ $this->ndx_data_colors = $this->GetColorIndexArray($this->data_colors, $n_data);
+ $this->ndx_data_border_colors = $this->GetColorIndexArray($this->data_border_colors, $n_border);
+
+ // Set up a color as transparent, if SetTransparentColor was used.
+ if (!empty($this->transparent_color)) {
+ imagecolortransparent($this->img, $this->GetColorIndex($this->transparent_color));
+ }
+ }
+
+ /*
+ * Allocate dark-shade data colors. Called if needed by graph drawing functions.
+ */
+ protected function NeedDataDarkColors()
+ {
+ // This duplicates the calculation in SetColorIndexes() for number of data colors to allocate.
+ if ($this->GetCallback('data_color')) {
+ $n_data = count($this->data_colors);
+ } else {
+ $n_data = max($this->data_columns, empty($this->legend) ? 0 : count($this->legend));
+ }
+ $this->ndx_data_dark_colors = $this->GetDarkColorIndexArray($this->data_colors, $n_data);
+ $this->pad_array($this->ndx_data_dark_colors, $this->data_columns);
+ }
+
+ /*
+ * Allocate error bar colors. Called if needed by graph drawing functions.
+ */
+ protected function NeedErrorBarColors()
+ {
+ // This is similar to the calculation in SetColorIndexes() for number of data colors to allocate.
+ if ($this->GetCallback('data_color')) {
+ $n_err = count($this->error_bar_colors);
+ } else {
+ $n_err = max($this->data_columns, empty($this->legend) ? 0 : count($this->legend));
+ }
+ $this->ndx_error_bar_colors = $this->GetColorIndexArray($this->error_bar_colors, $n_err);
+ $this->pad_array($this->ndx_error_bar_colors, $this->data_columns);
+ }
+
+ /*
+ * Select the best alignment for text, based on its vector angle from a point.
+ * $sin_t, $cost_t : sin() and cos() of the angle of the text offset from a reference point.
+ * $h_align, $v_align : Returned values, to be passed to DrawText(). E.g. 'left', 'bottom'.
+ * There are 8 possibilities, since 'center','center' is never returned.
+ * $reverse : Optional argument. If TRUE, reverse the usual returns. For text inside a circle.
+ * How it works: Picture a unit circle with 16 slices of 22.5 degrees each.
+ * Draw horizontal lines at the 22.5 degree and -22.5 degree positions on the circle.
+ * Text above the upper line will have 'bottom' vertical alignment; below the lower line will
+ * have 'top' vertical alignment, and between the lines will have 'center' vertical alignment.
+ * Horizontal alignment is similar, using +/- 22.5 degrees from vertical.
+ */
+ protected function GetTextAlignment($sin_t, $cos_t, &$h_align, &$v_align, $reverse = FALSE)
+ {
+ if ($reverse) { // Return the opposite alignment, align(T-180) vs align(T)
+ $sin_t = -$sin_t; // sin(T-180) = -sin(T)
+ $cos_t = -$cos_t; // cos(T-180) = -cos(T)
+ }
+ if ($sin_t >= 0.383) $v_align = 'bottom'; // 0.383 = sin(22.5 degrees)
+ elseif ($sin_t >= -0.383) $v_align = 'center';
+ else $v_align = 'top';
+ if ($cos_t >= 0.383) $h_align = 'left'; // 0.383 = cos(90 - 22.5 degrees)
+ elseif ($cos_t >= -0.383) $h_align = 'center';
+ else $h_align = 'right';
+ }
+
+ /*
+ * Determine if, and where, to draw Data Value Labels.
+ * $label_control : Label position control. Either x_data_label_pos or y_data_label_pos.
+ * &$dvl : Returns an array with position and alignment information for DrawDataValueLabel();
+ * The array has these keys: x_offset y_offset h_align v_align
+ * Returns True if data value labels should be drawn (based on $label_control), else False.
+ * This is used for plot types other than bars/stackedbars (which have their own way of doing it).
+ * It uses two member variables (unset by default): data_value_label_angle and data_value_label_distance
+ * to define the vector to the label. Default is 90 degrees at 5 pixels.
+ */
+ protected function CheckDataValueLabels($label_control, &$dvl)
+ {
+ if ($label_control != 'plotin')
+ return FALSE; // No data value labels
+ $angle = deg2rad(isset($this->data_value_label_angle) ? $this->data_value_label_angle : 90);
+ $radius = isset($this->data_value_label_distance) ? $this->data_value_label_distance : 5;
+ $cos = cos($angle);
+ $sin = sin($angle);
+ $dvl['x_offset'] = (int)($radius * $cos);
+ $dvl['y_offset'] = -(int)($radius * $sin); // Y is reversed in device coordinates
+
+ // Choose text alignment based on angle:
+ $this->GetTextAlignment($sin, $cos, $dvl['h_align'], $dvl['v_align']);
+ return TRUE;
+ }
+
+ /*
+ * Enable or disable automatic pie size calculations.
+ * If disabled, PHPlot uses the full plot area (like PHPlot-5.5.0 and earlier always did).
+ * Note the flag pie_full_size is unset by default, and stores the complement of $enable.
+ */
+ function SetPieAutoSize($enable)
+ {
+ $this->pie_full_size = !$enable;
+ return TRUE;
+ }
+
+//////////////////////////////////////////////////////////
+/////////// DATA ANALYSIS, SCALING AND TRANSLATION
+//////////////////////////////////////////////////////////
+
+ /*
+ * Analyzes the data array and calculates the minimum and maximum values.
+ * In this function, IV refers to the independent variable, and DV the dependent variable.
+ * For most plots, IV is X and DV is Y. For swapped X/Y plots, IV is Y and DV is X.
+ * At the end of the function, IV and DV ranges get assigned into X or Y.
+ *
+ * The data type mostly determines the data array structure, but some plot types do special
+ * things such as sum the values in a row. This information is in the plots[] array.
+ *
+ * This calculates min_x, max_x, min_y, and max_y. It also calculates two arrays
+ * data_min[] and data_max[] with per-row min and max values. These are used for
+ * data label lines. For normal (unswapped) data, these are the Y range for each X.
+ * For swapped X/Y data, they are the X range for each Y.
+ * For X/Y/Z plots, it also calculates min_z and max_z.
+ */
+ protected function FindDataLimits()
+ {
+ // Does this plot type need special processing of the data values?
+ $sum_vals = !empty(PHPlot::$plots[$this->plot_type]['sum_vals']); // Add up values in each row
+ $abs_vals = !empty(PHPlot::$plots[$this->plot_type]['abs_vals']); // Take absolute values
+
+ // These need to be initialized in case there are multiple plots and missing data points.
+ $this->data_min = array();
+ $this->data_max = array();
+
+ // Independent values are in the data array or assumed?
+ if ($this->datatype_implied) {
+ $all_iv = array(0, $this->num_data_rows - 1);
+ } else {
+ $all_iv = array();
+ }
+ // For X/Y/Z plots, make sure these are not left over from a previous plot.
+ if ($this->datatype_yz) {
+ unset($this->min_z);
+ unset($this->max_z);
+ }
+
+ // Process all rows of data:
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ $n_vals = $this->num_recs[$i];
+ $j = 1; // Skips label at [0]
+
+ if (!$this->datatype_implied) {
+ $all_iv[] = (double)$this->data[$i][$j++];
+ }
+
+ if ($sum_vals) {
+ $all_dv = array(0, 0); // One limit is 0, other calculated below
+ } else {
+ $all_dv = array();
+ }
+ while ($j < $n_vals) {
+ if (is_numeric($val = $this->data[$i][$j++])) {
+
+ if ($this->datatype_error_bars) {
+ $all_dv[] = $val + (double)$this->data[$i][$j++];
+ $all_dv[] = $val - (double)$this->data[$i][$j++];
+ } else {
+ if ($abs_vals) {
+ $val = abs($val); // Use absolute values
+ }
+ if ($sum_vals) {
+ $all_dv[1] += $val; // Sum of values
+ } else {
+ $all_dv[] = $val; // List of all values
+ }
+ if ($this->datatype_yz) {
+ $z = $this->data[$i][$j++]; // Note Z is required if Y is present.
+ if (!isset($this->min_z) || $z < $this->min_z) $this->min_z = $z;
+ if (!isset($this->max_z) || $z > $this->max_z) $this->max_z = $z;
+ }
+ }
+ } else { // Missing DV value
+ if ($this->datatype_error_bars) $j += 2;
+ elseif ($this->datatype_yz) $j++;
+ }
+ }
+ if (!empty($all_dv)) {
+ $this->data_min[$i] = min($all_dv); // Store per-row DV range
+ $this->data_max[$i] = max($all_dv);
+ }
+ }
+
+ if ($this->datatype_swapped_xy) {
+ // Assign min and max for swapped X/Y plots: IV=Y and DV=X
+ $this->min_y = min($all_iv);
+ $this->max_y = max($all_iv);
+ if (empty($this->data_min)) { // Guard against regressive case: No X at all
+ $this->min_x = 0;
+ $this->max_x = 0;
+ } else {
+ $this->min_x = min($this->data_min); // Store global X range
+ $this->max_x = max($this->data_max);
+ }
+ } else {
+ // Assign min and max for normal plots: IV=X and DV=Y
+ $this->min_x = min($all_iv);
+ $this->max_x = max($all_iv);
+ if (empty($this->data_min)) { // Guard against regressive case: No Y at all
+ $this->min_y = 0;
+ $this->max_y = 0;
+ } else {
+ $this->min_y = min($this->data_min); // Store global Y range
+ $this->max_y = max($this->data_max);
+ }
+ }
+ // For X/Y/Z plots, make sure these are set. If there are no valid data values,
+ // they will be unset, so set them here to prevent undefined property warnings.
+ if ($this->datatype_yz && !isset($this->min_z)) { // Means max_z is also unset
+ $this->max_z = $this->min_z = 0; // Actual values do not matter.
+ }
+
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'min_x' => $this->min_x, 'min_y' => $this->min_y,
+ 'max_x' => $this->max_x, 'max_y' => $this->max_y,
+ 'min_z' => isset($this->min_z) ? $this->min_z : '',
+ 'max_z' => isset($this->max_z) ? $this->max_z : ''));
+ }
+ return TRUE;
+ }
+
+ /*
+ * Calculates image margins on the fly from title positions and sizes,
+ * and tick labels positions and sizes.
+ *
+ * A picture of the locations of elements and spacing can be found in the
+ * PHPlot Reference Manual.
+ *
+ * Calculates the following (class variables unless noted):
+ *
+ * Plot area margins (see note below):
+ * y_top_margin
+ * y_bot_margin
+ * x_left_margin
+ * x_right_margin
+ *
+ * Title sizes (these are now local, not class variables, since they are not used elsewhere):
+ * title_height : Height of main title
+ * x_title_height : Height of X axis title, 0 if no X title
+ * y_title_width : Width of Y axis title, 0 if no Y title
+ *
+ * Tick/Data label offsets, relative to plot_area:
+ * x_label_top_offset, x_label_bot_offset, x_label_axis_offset
+ * y_label_left_offset, y_label_right_offset, y_label_axis_offset
+ *
+ * Title offsets, relative to plot area:
+ * x_title_top_offset, x_title_bot_offset
+ * y_title_left_offset, y_title_left_offset
+ * title_offset (for main title, relative to image edge)
+ *
+ * Note: The margins are calculated, but not stored, if margins or plot area were
+ * set by the user with SetPlotAreaPixels or SetMarginsPixels. The margin
+ * calculation is mixed in with the offset variables, so it doesn't seem worth the
+ * trouble to separate them.
+ *
+ * If the $maximize argument is true, we use the full image size, minus safe_margin
+ * and main title, for the plot. This is for pie charts which have no axes or X/Y titles.
+ */
+ protected function CalcMargins($maximize)
+ {
+ // This is the line-to-line or line-to-text spacing:
+ $gap = $this->safe_margin;
+ // Initial margin on each side takes into account a possible image border.
+ // For compatibility, if border is 1 or 2, don't increase the margins.
+ $base_margin = max($gap, $this->GetImageBorderWidth() + 3);
+ $this->title_offset = $base_margin; // For use in DrawTitle
+
+ // Minimum margin on each side. This reduces the chance that the
+ // right-most tick label (for example) will run off the image edge
+ // if there are no titles on that side.
+ $min_margin = 2 * $gap + $base_margin;
+
+ // Calculate the title sizes (main here, axis titles below):
+ list($unused, $title_height) = $this->SizeText($this->fonts['title'], 0, $this->title_txt);
+
+ // Special case for maximum area usage with no X/Y titles or labels, only main title:
+ if ($maximize) {
+ if (!isset($this->x_left_margin))
+ $this->x_left_margin = $base_margin;
+ if (!isset($this->x_right_margin))
+ $this->x_right_margin = $base_margin;
+ if (!isset($this->y_top_margin)) {
+ $this->y_top_margin = $base_margin;
+ if ($title_height > 0)
+ $this->y_top_margin += $title_height + $gap;
+ }
+ if (!isset($this->y_bot_margin))
+ $this->y_bot_margin = $base_margin;
+
+ return TRUE;
+ }
+
+ list($unused, $x_title_height) = $this->SizeText($this->fonts['x_title'], 0, $this->x_title_txt);
+ list($y_title_width, $unused) = $this->SizeText($this->fonts['y_title'], 90, $this->y_title_txt);
+
+ // Make local variables for these. (They get used a lot and I'm tired of this, this, this.)
+ $x_tick_label_pos = $this->x_tick_label_pos;
+ $x_data_label_pos = $this->x_data_label_pos;
+ $x_tick_pos = $this->x_tick_pos;
+ $x_tick_len = $this->x_tick_length;
+ $y_tick_label_pos = $this->y_tick_label_pos;
+ $y_tick_pos = $this->y_tick_pos;
+ $y_tick_len = $this->y_tick_length;
+ $y_data_label_pos = $this->y_data_label_pos;
+
+ // For X/Y tick and label position of 'xaxis' or 'yaxis', determine if the axis happens to be
+ // on an edge of a plot. If it is, we need to account for the margins there.
+ if ($this->x_axis_position <= $this->plot_min_y)
+ $x_axis_pos = 'bottom';
+ elseif ($this->x_axis_position >= $this->plot_max_y)
+ $x_axis_pos = 'top';
+ else
+ $x_axis_pos = 'none';
+ if ($this->y_axis_position <= $this->plot_min_x)
+ $y_axis_pos = 'left';
+ elseif ($this->y_axis_position >= $this->plot_max_x)
+ $y_axis_pos = 'right';
+ else
+ $y_axis_pos = 'none';
+
+ // Calculate the heights for X tick and data labels, and the max (used if they are overlaid):
+ $x_data_label_height = ($x_data_label_pos == 'none') ? 0 : $this->CalcMaxDataLabelSize('x');
+ $x_tick_label_height = ($x_tick_label_pos == 'none') ? 0 : $this->CalcMaxTickLabelSize('x');
+ $x_max_label_height = max($x_data_label_height, $x_tick_label_height);
+
+ // Calculate the space needed above and below the plot for X tick and X data labels:
+
+ // Above the plot:
+ $tick_labels_above = ($x_tick_label_pos == 'plotup' || $x_tick_label_pos == 'both'
+ || ($x_tick_label_pos == 'xaxis' && $x_axis_pos == 'top'));
+ $data_labels_above = ($x_data_label_pos == 'plotup' || $x_data_label_pos == 'both');
+ if ($tick_labels_above) {
+ if ($data_labels_above) {
+ $label_height_above = $x_max_label_height;
+ } else {
+ $label_height_above = $x_tick_label_height;
+ }
+ } elseif ($data_labels_above) {
+ $label_height_above = $x_data_label_height;
+ } else {
+ $label_height_above = 0;
+ }
+
+ // Below the plot:
+ $tick_labels_below = ($x_tick_label_pos == 'plotdown' || $x_tick_label_pos == 'both'
+ || ($x_tick_label_pos == 'xaxis' && $x_axis_pos == 'bottom'));
+ $data_labels_below = ($x_data_label_pos == 'plotdown' || $x_data_label_pos == 'both');
+ if ($tick_labels_below) {
+ if ($data_labels_below) {
+ $label_height_below = $x_max_label_height;
+ } else {
+ $label_height_below = $x_tick_label_height;
+ }
+ } elseif ($data_labels_below) {
+ $label_height_below = $x_data_label_height;
+ } else {
+ $label_height_below = 0;
+ }
+
+ // Calculate the width for Y tick and data labels, if on, and the max:
+ // Note CalcMaxDataLabelSize('y') returns 0 except for swapped X/Y plots.
+ $y_data_label_width = ($y_data_label_pos == 'none') ? 0 : $this->CalcMaxDataLabelSize('y');
+ $y_tick_label_width = ($y_tick_label_pos == 'none') ? 0 : $this->CalcMaxTickLabelSize('y');
+ $y_max_label_width = max($y_data_label_width, $y_tick_label_width);
+
+ // Calculate the space needed left and right of the plot for Y tick and Y data labels:
+ // (Y data labels here are for swapped X/Y plots such has horizontal bars)
+
+ // Left of the plot:
+ $tick_labels_left = ($y_tick_label_pos == 'plotleft' || $y_tick_label_pos == 'both'
+ || ($y_tick_label_pos == 'yaxis' && $y_axis_pos == 'left'));
+ $data_labels_left = ($y_data_label_pos == 'plotleft' || $y_data_label_pos == 'both');
+ if ($tick_labels_left) {
+ if ($data_labels_left) {
+ $label_width_left = $y_max_label_width;
+ } else {
+ $label_width_left = $y_tick_label_width;
+ }
+ } elseif ($data_labels_left) {
+ $label_width_left = $y_data_label_width;
+ } else {
+ $label_width_left = 0;
+ }
+
+ // Right of the plot:
+ $tick_labels_right = ($y_tick_label_pos == 'plotright' || $y_tick_label_pos == 'both'
+ || ($y_tick_label_pos == 'yaxis' && $y_axis_pos == 'right'));
+ $data_labels_right = ($y_data_label_pos == 'plotright' || $y_data_label_pos == 'both');
+ if ($tick_labels_right) {
+ if ($data_labels_right) {
+ $label_width_right = $y_max_label_width;
+ } else {
+ $label_width_right = $y_tick_label_width;
+ }
+ } elseif ($data_labels_right) {
+ $label_width_right = $y_data_label_width;
+ } else {
+ $label_width_right = 0;
+ }
+
+ ///////// Calculate margins:
+
+ // Calculating Top and Bottom margins:
+ // y_top_margin: Main title, Upper X title, X ticks and tick labels, and X data labels:
+ // y_bot_margin: Lower title, ticks and tick labels, and data labels:
+ $top_margin = $base_margin;
+ $bot_margin = $base_margin;
+ $this->x_title_top_offset = $gap;
+ $this->x_title_bot_offset = $gap;
+
+ // Space for main title?
+ if ($title_height > 0)
+ $top_margin += $title_height + $gap;
+
+ // Space for X Title?
+ if ($x_title_height > 0) {
+ $pos = $this->x_title_pos;
+ if ($pos == 'plotup' || $pos == 'both')
+ $top_margin += $x_title_height + $gap;
+ if ($pos == 'plotdown' || $pos == 'both')
+ $bot_margin += $x_title_height + $gap;
+ }
+
+ // Space for X Labels above the plot?
+ if ($label_height_above > 0) {
+ $top_margin += $label_height_above + $gap;
+ $this->x_title_top_offset += $label_height_above + $gap;
+ }
+
+ // Space for X Labels below the plot?
+ if ($label_height_below > 0) {
+ $bot_margin += $label_height_below + $gap;
+ $this->x_title_bot_offset += $label_height_below + $gap;
+ }
+
+ // Space for X Ticks above the plot?
+ if ($x_tick_pos == 'plotup' || $x_tick_pos == 'both'
+ || ($x_tick_pos == 'xaxis' && $x_axis_pos == 'top')) {
+ $top_margin += $x_tick_len;
+ $this->x_label_top_offset = $x_tick_len + $gap;
+ $this->x_title_top_offset += $x_tick_len;
+ } else {
+ // No X Ticks above the plot:
+ $this->x_label_top_offset = $gap;
+ }
+
+ // Space for X Ticks below the plot?
+ if ($x_tick_pos == 'plotdown' || $x_tick_pos == 'both'
+ || ($x_tick_pos == 'xaxis' && $x_axis_pos == 'bottom')) {
+ $bot_margin += $x_tick_len;
+ $this->x_label_bot_offset = $x_tick_len + $gap;
+ $this->x_title_bot_offset += $x_tick_len;
+ } else {
+ // No X Ticks below the plot:
+ $this->x_label_bot_offset = $gap;
+ }
+ // Label offsets for on-axis ticks:
+ if ($x_tick_pos == 'xaxis') {
+ $this->x_label_axis_offset = $x_tick_len + $gap;
+ } else {
+ $this->x_label_axis_offset = $gap;
+ }
+
+ // Calculating Left and Right margins:
+ // x_left_margin: Left Y title, Y ticks and tick labels:
+ // x_right_margin: Right Y title, Y ticks and tick labels:
+ $left_margin = $base_margin;
+ $right_margin = $base_margin;
+ $this->y_title_left_offset = $gap;
+ $this->y_title_right_offset = $gap;
+
+ // Space for Y Title?
+ if ($y_title_width > 0) {
+ $pos = $this->y_title_pos;
+ if ($pos == 'plotleft' || $pos == 'both')
+ $left_margin += $y_title_width + $gap;
+ if ($pos == 'plotright' || $pos == 'both')
+ $right_margin += $y_title_width + $gap;
+ }
+
+ // Space for Y Labels left of the plot?
+ if ($label_width_left > 0) {
+ $left_margin += $label_width_left + $gap;
+ $this->y_title_left_offset += $label_width_left + $gap;
+ }
+
+ // Space for Y Labels right of the plot?
+ if ($label_width_right > 0) {
+ $right_margin += $label_width_right + $gap;
+ $this->y_title_right_offset += $label_width_right + $gap;
+ }
+
+ // Space for Y Ticks left of plot?
+ if ($y_tick_pos == 'plotleft' || $y_tick_pos == 'both'
+ || ($y_tick_pos == 'yaxis' && $y_axis_pos == 'left')) {
+ $left_margin += $y_tick_len;
+ $this->y_label_left_offset = $y_tick_len + $gap;
+ $this->y_title_left_offset += $y_tick_len;
+ } else {
+ // No Y Ticks left of plot:
+ $this->y_label_left_offset = $gap;
+ }
+
+ // Space for Y Ticks right of plot?
+ if ($y_tick_pos == 'plotright' || $y_tick_pos == 'both'
+ || ($y_tick_pos == 'yaxis' && $y_axis_pos == 'right')) {
+ $right_margin += $y_tick_len;
+ $this->y_label_right_offset = $y_tick_len + $gap;
+ $this->y_title_right_offset += $y_tick_len;
+ } else {
+ // No Y Ticks right of plot:
+ $this->y_label_right_offset = $gap;
+ }
+
+ // Label offsets for on-axis ticks:
+ if ($x_tick_pos == 'yaxis') {
+ $this->y_label_axis_offset = $y_tick_len + $gap;
+ } else {
+ $this->y_label_axis_offset = $gap;
+ }
+
+ // Apply the minimum margins and store in the object.
+ // Do not set margins which were user-defined (see note at top of function).
+ if (!isset($this->y_top_margin))
+ $this->y_top_margin = max($min_margin, $top_margin);
+ if (!isset($this->y_bot_margin))
+ $this->y_bot_margin = max($min_margin, $bot_margin);
+ if (!isset($this->x_left_margin))
+ $this->x_left_margin = max($min_margin, $left_margin);
+ if (!isset($this->x_right_margin))
+ $this->x_right_margin = max($min_margin, $right_margin);
+
+ if ($this->GetCallback('debug_scale')) {
+ // (Too bad compact() doesn't work on class member variables...)
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'label_height_above' => $label_height_above,
+ 'label_height_below' => $label_height_below,
+ 'label_width_left' => $label_width_left,
+ 'label_width_right' => $label_width_right,
+ 'x_tick_len' => $x_tick_len,
+ 'y_tick_len' => $y_tick_len,
+ 'x_left_margin' => $this->x_left_margin,
+ 'x_right_margin' => $this->x_right_margin,
+ 'y_top_margin' => $this->y_top_margin,
+ 'y_bot_margin' => $this->y_bot_margin,
+ 'x_label_top_offset' => $this->x_label_top_offset,
+ 'x_label_bot_offset' => $this->x_label_bot_offset,
+ 'y_label_left_offset' => $this->y_label_left_offset,
+ 'y_label_right_offset' => $this->y_label_right_offset,
+ 'x_title_top_offset' => $this->x_title_top_offset,
+ 'x_title_bot_offset' => $this->x_title_bot_offset,
+ 'y_title_left_offset' => $this->y_title_left_offset,
+ 'y_title_right_offset' => $this->y_title_right_offset));
+ }
+
+ return TRUE;
+ }
+
+ /*
+ * Calculate the plot area (device coordinates) from the margins.
+ * (This used to be part of SetPlotAreaPixels.)
+ * The margins might come from SetMarginsPixels, SetPlotAreaPixels,
+ * or CalcMargins.
+ */
+ protected function CalcPlotAreaPixels()
+ {
+ $this->plot_area = array($this->x_left_margin, $this->y_top_margin,
+ $this->image_width - $this->x_right_margin,
+ $this->image_height - $this->y_bot_margin);
+ $this->plot_area_width = $this->plot_area[2] - $this->plot_area[0];
+ $this->plot_area_height = $this->plot_area[3] - $this->plot_area[1];
+
+ $this->DoCallback('debug_scale', __FUNCTION__, $this->plot_area);
+ return TRUE;
+ }
+
+ /*
+ * Set the margins in pixels (left, right, top, bottom)
+ * This determines the plot area, equivalent to SetPlotAreaPixels().
+ * Deferred calculations now occur in CalcPlotAreaPixels().
+ */
+ function SetMarginsPixels($which_lm = NULL, $which_rm = NULL, $which_tm = NULL, $which_bm = NULL)
+ {
+ $this->x_left_margin = $which_lm;
+ $this->x_right_margin = $which_rm;
+ $this->y_top_margin = $which_tm;
+ $this->y_bot_margin = $which_bm;
+
+ return TRUE;
+ }
+
+ /*
+ * Sets the limits for the plot area.
+ * This stores the margins, not the area. That may seem odd, but
+ * the idea is to make SetPlotAreaPixels and SetMarginsPixels two
+ * ways to accomplish the same thing, and the deferred calculations
+ * in CalcMargins and CalcPlotAreaPixels don't need to know which
+ * was used.
+ * (x1, y1) - Upper left corner of the plot area
+ * (x2, y2) - Lower right corner of the plot area
+ */
+ function SetPlotAreaPixels($x1 = NULL, $y1 = NULL, $x2 = NULL, $y2 = NULL)
+ {
+ $this->x_left_margin = $x1;
+ if (isset($x2)) $this->x_right_margin = $this->image_width - $x2;
+ else unset($this->x_right_margin);
+ $this->y_top_margin = $y1;
+ if (isset($y2)) $this->y_bot_margin = $this->image_height - $y2;
+ else unset($this->y_bot_margin);
+
+ return TRUE;
+ }
+
+ /*
+ * Calculate the World Coordinate limits of the plot area.
+ * This goes with SetPlotAreaWorld, but the calculations are
+ * deferred until the graph is being drawn.
+ * Uses and sets: plot_min_x, plot_max_x, plot_min_y, plot_max_y
+ * These can be user-supplied or NULL to auto-calculate.
+ * Pre-requisites: FindDataLimits() calculates min_x, max_x, min_y, max_y
+ * which are the limits of the data to be plotted.
+ *
+ * The general method is this:
+ * If any part of the range is user-defined (via SetPlotAreaWorld),
+ * use the user-defined value.
+ * Else, if this is an implicitly-defined independent variable,
+ * use the fixed range of 0 to (max+1).
+ * Else, if this is an explicitly-defined independent variable,
+ * use the exact data range (min to max).
+ * Else, this is the dependent variable, so define a range which
+ * includes and exceeds the data range by a bit.
+ */
+ protected function CalcPlotAreaWorld()
+ {
+ // Data array omits X or Y?
+ $implied_x = $this->datatype_implied && !$this->datatype_swapped_xy;
+ $implied_y = $this->datatype_implied && $this->datatype_swapped_xy;
+
+ if (isset($this->plot_min_x) && $this->plot_min_x !== '')
+ $xmin = $this->plot_min_x; // Use user-provided value
+ elseif ($implied_x)
+ $xmin = 0; // Implied X starts at zero
+ elseif ($this->datatype_swapped_xy)
+ // If X is the dependent variable, leave some room below.
+ $xmin = floor($this->min_x - abs($this->min_x) * 0.1);
+ else
+ $xmin = $this->min_x; // Otherwise just start at the min data X
+
+ if (isset($this->plot_max_x) && $this->plot_max_x !== '')
+ $xmax = $this->plot_max_x; // Use user-provided value
+ elseif ($implied_x)
+ $xmax = $this->max_x + 1; // Implied X ends after last value
+ elseif ($this->datatype_swapped_xy)
+ // If X is the dependent variable, leave some room above.
+ $xmax = ceil($this->max_x + abs($this->max_x) * 0.1);
+ else
+ $xmax = $this->max_x; // Otherwise just end at the max data X
+
+ if (isset($this->plot_min_y) && $this->plot_min_y !== '')
+ $ymin = $this->plot_min_y; // Use user-provided value
+ elseif ($implied_y)
+ $ymin = 0; // Implied Y starts at zero
+ elseif ($this->datatype_swapped_xy)
+ $ymin = $this->min_y; // Start at min data Y
+ else
+ // If Y is the dependent variable, leave some room below.
+ $ymin = floor($this->min_y - abs($this->min_y) * 0.1);
+
+ if (isset($this->plot_max_y) && $this->plot_max_y !== '')
+ $ymax = $this->plot_max_y; // Use user-provided value
+ elseif ($implied_y)
+ $ymax = $this->max_y + 1; // Implied Y ends after last value
+ elseif ($this->datatype_swapped_xy)
+ $ymax = $this->max_y; // End at max data Y
+ else
+ // If Y is the dependent variable, leave some room above.
+ $ymax = ceil($this->max_y + abs($this->max_y) * 0.1);
+
+ // Error checking
+
+ if ($ymin == $ymax)
+ $ymax++;
+ if ($xmin == $xmax)
+ $xmax++;
+
+ if ($this->yscale_type == 'log') {
+ if ($ymin <= 0) {
+ $ymin = 1;
+ }
+ if ($ymax <= 0) {
+ // Note: Error messages reference the user function, not this function.
+ return $this->PrintError('SetPlotAreaWorld(): Log plots need data greater than 0');
+ }
+ }
+
+ if ($ymax <= $ymin) {
+ return $this->PrintError('SetPlotAreaWorld(): Error in data - max not greater than min');
+ }
+
+ $this->plot_min_x = $xmin;
+ $this->plot_max_x = $xmax;
+ $this->plot_min_y = $ymin;
+ $this->plot_max_y = $ymax;
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'plot_min_x' => $this->plot_min_x, 'plot_min_y' => $this->plot_min_y,
+ 'plot_max_x' => $this->plot_max_x, 'plot_max_y' => $this->plot_max_y));
+ }
+ return TRUE;
+ }
+
+ /*
+ * Stores the desired World Coordinate range of the plot.
+ * The user calls this to force one or more of the range limits to
+ * specific values. Anything not set will be calculated in CalcPlotAreaWorld().
+ */
+ function SetPlotAreaWorld($xmin=NULL, $ymin=NULL, $xmax=NULL, $ymax=NULL)
+ {
+ $this->plot_min_x = $xmin;
+ $this->plot_max_x = $xmax;
+ $this->plot_min_y = $ymin;
+ $this->plot_max_y = $ymax;
+ return TRUE;
+ }
+
+ /*
+ * Calculate the width (or height) of bars for bar plots.
+ * $stacked : If true, this is a stacked bar plot (1 bar per group).
+ * $verticals : If false, this is a horizontal bar plot.
+ * This calculates:
+ * record_bar_width : Allocated width for each bar (including gaps)
+ * actual_bar_width : Actual drawn width of each bar
+ * bar_adjust_gap : Gap on each side of each bar (0 if they touch)
+ * For the case $verticals=False, horizontal bars are being drawn,
+ * but the same variable names are used. Think of "bar_width" as being
+ * the width if you are standing on the Y axis looking towards positive X.
+ */
+ protected function CalcBarWidths($stacked, $verticals)
+ {
+ // group_width is the width of a group, including padding
+ if ($verticals) {
+ $group_width = $this->plot_area_width / $this->num_data_rows;
+ } else {
+ $group_width = $this->plot_area_height / $this->num_data_rows;
+ }
+
+ // Actual number of bar spaces in the group. This includes the drawn bars, and
+ // 'bar_extra_space'-worth of extra bars.
+ if ($stacked) {
+ $num_spots = 1 + $this->bar_extra_space;
+ } else {
+ $num_spots = $this->data_columns + $this->bar_extra_space;
+ }
+
+ // record_bar_width is the width of each bar's allocated area.
+ // If bar_width_adjust=1 this is the width of the bar, otherwise
+ // the bar is centered inside record_bar_width.
+ // The equation is:
+ // group_frac_width * group_width = record_bar_width * num_spots
+ $this->record_bar_width = $this->group_frac_width * $group_width / $num_spots;
+
+ // Note that the extra space due to group_frac_width and bar_extra_space will be
+ // evenly divided on each side of the group: the drawn bars are centered in the group.
+
+ // Within each bar's allocated space, if bar_width_adjust=1 the bar fills the
+ // space, otherwise it is centered.
+ // This is the actual drawn bar width:
+ $this->actual_bar_width = $this->record_bar_width * $this->bar_width_adjust;
+ // This is the gap on each side of the bar (0 if bar_width_adjust=1):
+ $this->bar_adjust_gap = ($this->record_bar_width - $this->actual_bar_width) / 2;
+
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'record_bar_width' => $this->record_bar_width,
+ 'actual_bar_width' => $this->actual_bar_width,
+ 'bar_adjust_gap' => $this->bar_adjust_gap));
+ }
+ return TRUE;
+ }
+
+ /*
+ * Calculate X and Y Axis Positions, world coordinates.
+ * This needs the min/max x/y range set by CalcPlotAreaWorld.
+ * It adjusts or sets x_axis_position and y_axis_position per the data.
+ * Empty string means the values need to be calculated; otherwise they
+ * are supplied but need to be validated against the World area.
+ *
+ * Note: This used to be in CalcTranslation, but CalcMargins needs it too.
+ * This does not calculate the pixel values of the axes. That happens in
+ * CalcTranslation, after scaling is set up (which has to happen after
+ * margins are set up).
+ *
+ * For vertical plots, the X axis defaults to Y=0 if that is inside the plot range, else whichever
+ * of the top or bottom that has the smallest absolute value (that is, the value closest to 0).
+ * The Y axis defaults to the left edge. For horizontal plots, the axis roles and defaults are switched.
+ */
+ protected function CalcAxisPositions()
+ {
+ // Validate user-provided X axis position, or calculate a default if not provided:
+ if ($this->x_axis_position !== '') {
+ // Force user-provided X axis position to be within the plot range:
+ $this->x_axis_position = min(max($this->plot_min_y, $this->x_axis_position), $this->plot_max_y);
+ } elseif ($this->yscale_type == 'log') {
+ // Always use 1 for X axis position on log scale plots.
+ $this->x_axis_position = 1;
+ } elseif ($this->datatype_swapped_xy || $this->plot_min_y > 0) {
+ // Horizontal plot, or Vertical Plot with all Y > 0: Place X axis on the bottom.
+ $this->x_axis_position = $this->plot_min_y;
+ } elseif ($this->plot_max_y < 0) {
+ // Vertical plot with all Y < 0, so place the X axis at the top.
+ $this->x_axis_position = $this->plot_max_y;
+ } else {
+ // Vertical plot range includes Y=0, so place X axis at 0.
+ $this->x_axis_position = 0;
+ }
+
+ // Validate user-provided Y axis position, or calculate a default if not provided:
+ if ($this->y_axis_position !== '') {
+ // Force user-provided Y axis position to be within the plot range:
+ $this->y_axis_position = min(max($this->plot_min_x, $this->y_axis_position), $this->plot_max_x);
+ } elseif ($this->xscale_type == 'log') {
+ // Always use 1 for Y axis position on log scale plots.
+ $this->y_axis_position = 1;
+ } elseif (!$this->datatype_swapped_xy || $this->plot_min_x > 0) {
+ // Vertical plot, or Horizontal Plot with all X > 0: Place Y axis on left side.
+ $this->y_axis_position = $this->plot_min_x;
+ } elseif ($this->plot_max_x < 0) {
+ // Horizontal plot with all X < 0, so place the Y axis on the right side.
+ $this->y_axis_position = $this->plot_max_x;
+ } else {
+ // Horizontal plot range includes X=0: place Y axis at 0.
+ $this->y_axis_position = 0;
+ }
+
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'x_axis_position' => $this->x_axis_position,
+ 'y_axis_position' => $this->y_axis_position));
+ }
+
+ return TRUE;
+ }
+
+ /*
+ * Calculates scaling stuff...
+ */
+ protected function CalcTranslation()
+ {
+ if ($this->plot_max_x - $this->plot_min_x == 0) { // Check for div by 0
+ $this->xscale = 0;
+ } else {
+ if ($this->xscale_type == 'log') {
+ $this->xscale = $this->plot_area_width /
+ (log10($this->plot_max_x) - log10($this->plot_min_x));
+ } else {
+ $this->xscale = $this->plot_area_width / ($this->plot_max_x - $this->plot_min_x);
+ }
+ }
+
+ if ($this->plot_max_y - $this->plot_min_y == 0) { // Check for div by 0
+ $this->yscale = 0;
+ } else {
+ if ($this->yscale_type == 'log') {
+ $this->yscale = $this->plot_area_height /
+ (log10($this->plot_max_y) - log10($this->plot_min_y));
+ } else {
+ $this->yscale = $this->plot_area_height / ($this->plot_max_y - $this->plot_min_y);
+ }
+ }
+ // GD defines x = 0 at left and y = 0 at TOP so -/+ respectively
+ if ($this->xscale_type == 'log') {
+ $this->plot_origin_x = $this->plot_area[0] - ($this->xscale * log10($this->plot_min_x) );
+ } else {
+ $this->plot_origin_x = $this->plot_area[0] - ($this->xscale * $this->plot_min_x);
+ }
+ if ($this->yscale_type == 'log') {
+ $this->plot_origin_y = $this->plot_area[3] + ($this->yscale * log10($this->plot_min_y));
+ } else {
+ $this->plot_origin_y = $this->plot_area[3] + ($this->yscale * $this->plot_min_y);
+ }
+
+ // Convert axis positions to device coordinates:
+ $this->y_axis_x_pixels = $this->xtr($this->y_axis_position);
+ $this->x_axis_y_pixels = $this->ytr($this->x_axis_position);
+
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'xscale' => $this->xscale, 'yscale' => $this->yscale,
+ 'plot_origin_x' => $this->plot_origin_x, 'plot_origin_y' => $this->plot_origin_y,
+ 'y_axis_x_pixels' => $this->y_axis_x_pixels,
+ 'x_axis_y_pixels' => $this->x_axis_y_pixels));
+ }
+
+ return TRUE;
+ }
+
+ /*
+ * Translate X world coordinate into pixel coordinate
+ * See CalcTranslation() for calculation of xscale.
+ * Note: This function should be 'protected', but is left public for historical reasons.
+ * See GetDeviceXY() for a preferred public method.
+ */
+ function xtr($x_world)
+ {
+ if ($this->xscale_type == 'log') {
+ $x_pixels = $this->plot_origin_x + log10($x_world) * $this->xscale ;
+ } else {
+ $x_pixels = $this->plot_origin_x + $x_world * $this->xscale ;
+ }
+ return round($x_pixels);
+ }
+
+ /*
+ * Translate Y world coordinate into pixel coordinate.
+ * See CalcTranslation() for calculation of yscale.
+ * Note: This function should be 'protected', but is left public for historical reasons.
+ * See GetDeviceXY() for a preferred public method.
+ */
+ function ytr($y_world)
+ {
+ if ($this->yscale_type == 'log') {
+ //minus because GD defines y = 0 at top. doh!
+ $y_pixels = $this->plot_origin_y - log10($y_world) * $this->yscale ;
+ } else {
+ $y_pixels = $this->plot_origin_y - $y_world * $this->yscale ;
+ }
+ return round($y_pixels);
+ }
+
+ /* A public interface to xtr and ytr. Translates (x,y) in world coordinates
+ * to (x,y) in device coordinates and returns them as an array.
+ * Usage is: list($x_pixel, $y_pixel) = $plot->GetDeviceXY($x_world, $y_world)
+ */
+ function GetDeviceXY($x_world, $y_world)
+ {
+ if (!isset($this->xscale)) {
+ return $this->PrintError("GetDeviceXY() was called before translation factors were calculated");
+ }
+ return array($this->xtr($x_world), $this->ytr($y_world));
+ }
+
+ /*
+ * Calculate tick parameters: Start, end, and delta values. This is used
+ * by both DrawXTicks() and DrawYTicks().
+ * This currently uses the same simplistic method previously used by
+ * PHPlot (basically just range/10), but splitting this out into its
+ * own function is the first step in replacing the method.
+ * This is also used by CalcMaxTickSize() for CalcMargins().
+ *
+ * $which : 'x' or 'y' : Which tick parameters to calculate
+ *
+ * Returns an array of 3 elements: tick_start, tick_end, tick_step
+ */
+ protected function CalcTicks($which)
+ {
+ if ($which == 'x') {
+ $num_ticks = $this->num_x_ticks;
+ $tick_inc = $this->x_tick_inc;
+ $data_max = $this->plot_max_x;
+ $data_min = $this->plot_min_x;
+ $skip_lo = $this->skip_left_tick;
+ $skip_hi = $this->skip_right_tick;
+ $anchor = &$this->x_tick_anchor; // Use reference because this might not be set
+ } elseif ($which == 'y') {
+ $num_ticks = $this->num_y_ticks;
+ $tick_inc = $this->y_tick_inc;
+ $data_max = $this->plot_max_y;
+ $data_min = $this->plot_min_y;
+ $skip_lo = $this->skip_bottom_tick;
+ $skip_hi = $this->skip_top_tick;
+ $anchor = &$this->y_tick_anchor; // Use reference because this might not be set
+ } else {
+ return $this->PrintError("CalcTicks: Invalid usage ($which)");
+ }
+
+ if (!empty($tick_inc)) {
+ $tick_step = $tick_inc;
+ } elseif (!empty($num_ticks)) {
+ $tick_step = ($data_max - $data_min) / $num_ticks;
+ } else {
+ $tick_step = ($data_max - $data_min) / 10;
+ }
+
+ // NOTE: When working with floats, because of approximations when adding $tick_step,
+ // the value may not quite reach the end, or may exceed it very slightly.
+ // So apply a "fudge" factor.
+ $tick_start = (double)$data_min;
+ $tick_end = (double)$data_max + ($data_max - $data_min) / 10000.0;
+
+ // If a tick anchor was given, adjust the start of the range so the anchor falls
+ // at an exact tick mark (or would, if it was within range).
+ if (isset($anchor)) {
+ $tick_start = $anchor - $tick_step * floor(($anchor - $tick_start) / $tick_step);
+ }
+
+ // Lastly, adjust for option to skip left/bottom or right/top tick marks:
+ if ($skip_lo)
+ $tick_start += $tick_step;
+ if ($skip_hi)
+ $tick_end -= $tick_step;
+
+ return array($tick_start, $tick_end, $tick_step);
+ }
+
+ /*
+ * Calculate the size of the biggest tick label. This is used by CalcMargins().
+ * For 'x' ticks, it returns the height . For 'y' ticks, it returns the width.
+ * This means height along Y, or width along X - not relative to the text angle.
+ * That is what we need to calculate the needed margin space.
+ * (Previous versions of PHPlot estimated this, using the maximum X or Y value,
+ * or maybe the longest string. That doesn't work. -10 is longer than 9, etc.
+ * So this gets the actual size of each label, slow as that may be.)
+ */
+ protected function CalcMaxTickLabelSize($which)
+ {
+ list($tick_start, $tick_end, $tick_step) = $this->CalcTicks($which);
+
+ if ($which == 'x') {
+ $font = $this->fonts['x_label'];
+ $angle = $this->x_label_angle;
+ } elseif ($which == 'y') {
+ $font = $this->fonts['y_label'];
+ $angle = $this->y_label_angle;
+ } else {
+ return $this->PrintError("CalcMaxTickLabelSize: Invalid usage ($which)");
+ }
+
+ $max_width = 0;
+ $max_height = 0;
+
+ // Loop over ticks, same as DrawXTicks and DrawYTicks:
+ // Avoid cumulative round-off errors from $val += $delta
+ $n = 0;
+ $tick_val = $tick_start;
+ while ($tick_val <= $tick_end) {
+ $tick_label = $this->FormatLabel($which, $tick_val);
+ list($width, $height) = $this->SizeText($font, $angle, $tick_label);
+ if ($width > $max_width) $max_width = $width;
+ if ($height > $max_height) $max_height = $height;
+ $tick_val = $tick_start + ++$n * $tick_step;
+ }
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'which' => $which, 'height' => $max_height, 'width' => $max_width));
+ }
+
+ if ($which == 'x')
+ return $max_height;
+ return $max_width;
+ }
+
+ /*
+ * Calculate the size of the biggest data label. This is used by CalcMargins().
+ * For $which='x', it returns the height of labels along the top or bottom.
+ * For $which='y', it returns the width of labels along the left or right sides.
+ * There is only one set of data labels (the first position in each data record).
+ * They normally go along the top or bottom (or both). If the data type indicates
+ * X/Y swapping (which is used for horizontal bar charts), the data labels go
+ * along the sides instead. So CalcMaxDataLabelSize('x') returns 0 if the
+ * data is X/Y swapped, and CalcMaxDataLabelSize('y') returns 0 if the data is
+ * is not X/Y swapped.
+ */
+ protected function CalcMaxDataLabelSize($which = 'x')
+ {
+ if ($which == 'x') {
+ if ($this->datatype_swapped_xy)
+ return 0; // Shortcut: labels aren't on top/bottom.
+ $font = $this->fonts['x_label'];
+ $angle = $this->x_data_label_angle;
+ $format_code = 'xd';
+ } elseif ($which == 'y') {
+ if (!$this->datatype_swapped_xy)
+ return 0; // Shortcut: labels aren't on left/right.
+ $font = $this->fonts['y_label'];
+ $angle = $this->y_data_label_angle;
+ $format_code = 'yd';
+ } else {
+ return $this->PrintError("CalcMaxDataLabelSize: Invalid usage ($which)");
+ }
+ $max_width = 0;
+ $max_height = 0;
+
+ // Loop over all data labels and find the biggest:
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ $label = $this->FormatLabel($format_code, $this->data[$i][0], $i);
+ list($width, $height) = $this->SizeText($font, $angle, $label);
+ if ($width > $max_width) $max_width = $width;
+ if ($height > $max_height) $max_height = $height;
+ }
+ if ($this->GetCallback('debug_scale')) {
+ $this->DoCallback('debug_scale', __FUNCTION__, array(
+ 'height' => $max_height, 'width' => $max_width));
+ }
+
+ if ($this->datatype_swapped_xy)
+ return $max_width;
+ return $max_height;
+ }
+
+ /*
+ * Set grid control defaults.
+ * X grid defaults off, Y grid defaults on, except the reverse is true
+ * with swapped graphs such as horizontal bars.
+ */
+ protected function CalcGridSettings()
+ {
+ if (!isset($this->draw_x_grid))
+ $this->draw_x_grid = $this->datatype_swapped_xy;
+ if (!isset($this->draw_y_grid))
+ $this->draw_y_grid = !$this->datatype_swapped_xy;
+ }
+
+ /*
+ * Helper for CheckLabels() - determine if there are any non-empty labels.
+ * Returns True if all data labels are empty, else False.
+ */
+ protected function CheckLabelsAllEmpty()
+ {
+ for ($i = 0; $i < $this->num_data_rows; $i++)
+ if ($this->data[$i][0] !== '') return FALSE;
+ return TRUE;
+ }
+
+ /*
+ * Check and set label parameters. This handles deferred processing for label
+ * positioning and other label-related parameters.
+ * Copy label_format from 'x' to 'xd', and 'y' to 'yd', if not already set.
+ * Set x_data_label_angle from x_label_angle, if not already set.
+ * Apply defaults to X and Y tick and data label positions.
+ * Note: the label strings in the data array are used as X data labels in
+ * the normal case, but as Y data labels in the swapped X/Y case.
+ */
+ protected function CheckLabels()
+ {
+ // The X and Y data labels are formatted the same as X and Y tick labels,
+ // unless overridden. Check and apply defaults for FormatLabel here:
+ if (empty($this->label_format['xd']) && !empty($this->label_format['x']))
+ $this->label_format['xd'] = $this->label_format['x'];
+ if (empty($this->label_format['yd']) && !empty($this->label_format['y']))
+ $this->label_format['yd'] = $this->label_format['y'];
+
+ // The X tick label angle setting controls X data label angles too,
+ // unless overridden. Check and apply the default here:
+ if (!isset($this->x_data_label_angle))
+ $this->x_data_label_angle = $this->x_label_angle;
+ // Note: Y data label angle defaults to zero, unlike X,
+ // for compatibility with older releases.
+
+ // X Label position fixups, for x_data_label_pos and x_tick_label_pos:
+ if ($this->datatype_swapped_xy) {
+ // Just apply defaults - there is no position conflict for X labels.
+ if (!isset($this->x_tick_label_pos))
+ $this->x_tick_label_pos = 'plotdown';
+ if (!isset($this->x_data_label_pos))
+ $this->x_data_label_pos = 'none';
+ } else {
+ // Apply defaults but do not allow conflict between tick and data labels.
+ if (isset($this->x_data_label_pos)) {
+ if (!isset($this->x_tick_label_pos)) {
+ // Case: data_label_pos is set, tick_label_pos needs a default:
+ if ($this->x_data_label_pos == 'none')
+ $this->x_tick_label_pos = 'plotdown';
+ else
+ $this->x_tick_label_pos = 'none';
+ }
+ } elseif (isset($this->x_tick_label_pos)) {
+ // Case: tick_label_pos is set, data_label_pos needs a default:
+ if ($this->x_tick_label_pos == 'none')
+ $this->x_data_label_pos = 'plotdown';
+ else
+ $this->x_data_label_pos = 'none';
+ } else {
+ // Case: Neither tick_label_pos nor data_label_pos is set.
+ // We do not want them to be both on (as PHPlot used to do in this case).
+ // Turn on data labels if any were supplied, else tick labels.
+ if ($this->CheckLabelsAllEmpty()) {
+ $this->x_data_label_pos = 'none';
+ $this->x_tick_label_pos = 'plotdown';
+ } else {
+ $this->x_data_label_pos = 'plotdown';
+ $this->x_tick_label_pos = 'none';
+ }
+ }
+ }
+
+ // Y Label position fixups, for y_data_label_pos and y_tick_label_pos:
+ if (!$this->datatype_swapped_xy) {
+ // Just apply defaults - there is no position conflict.
+ if (!isset($this->y_tick_label_pos))
+ $this->y_tick_label_pos = 'plotleft';
+ if (!isset($this->y_data_label_pos))
+ $this->y_data_label_pos = 'none';
+ } else {
+ // Apply defaults but do not allow conflict between tick and data labels.
+ if (isset($this->y_data_label_pos)) {
+ if (!isset($this->y_tick_label_pos)) {
+ // Case: data_label_pos is set, tick_label_pos needs a default:
+ if ($this->y_data_label_pos == 'none')
+ $this->y_tick_label_pos = 'plotleft';
+ else
+ $this->y_tick_label_pos = 'none';
+ }
+ } elseif (isset($this->y_tick_label_pos)) {
+ // Case: tick_label_pos is set, data_label_pos needs a default:
+ if ($this->y_tick_label_pos == 'none')
+ $this->y_data_label_pos = 'plotleft';
+ else
+ $this->y_data_label_pos = 'none';
+ } else {
+ // Case: Neither tick_label_pos nor data_label_pos is set.
+ // Turn on data labels if any were supplied, else tick labels.
+ if ($this->CheckLabelsAllEmpty()) {
+ $this->y_data_label_pos = 'none';
+ $this->y_tick_label_pos = 'plotleft';
+ } else {
+ $this->y_data_label_pos = 'plotleft';
+ $this->y_tick_label_pos = 'none';
+ }
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Formats a tick, data, or pie chart label.
+ * $which_pos : 'x', 'xd', 'y', 'yd', or 'p' selects formatting controls.
+ * x, y are for tick labels; xd, yd are for data labels. p is for pie chart labels.
+ * $which_lab : String to format as a label.
+ * ... : Additional arguments to pass to a custom format function.
+ * Credits: Time formatting suggested by Marlin Viss
+ * Custom formatting suggested by zer0x333
+ * Notes:
+ * Type 'title' is obsolete and retained for compatibility.
+ * Class variable 'data_units_text' is retained as a suffix for 'data' type formatting for
+ * backward compatibility.
+ */
+ protected function FormatLabel($which_pos, $which_lab) // Variable additional arguments
+ {
+ // Assign a reference shortcut to the label format controls.
+ $format = &$this->label_format[$which_pos];
+
+ // Don't format empty strings (especially as time or numbers), or if no type was set.
+ if ($which_lab !== '' && !empty($format['type'])) {
+ switch ($format['type']) {
+ case 'title': // Note: This is obsolete
+ $which_lab = @ $this->data[$which_lab][0];
+ break;
+ case 'data':
+ $which_lab = $format['prefix']
+ . $this->number_format($which_lab, $format['precision'])
+ . $this->data_units_text // Obsolete
+ . $format['suffix'];
+ break;
+ case 'time':
+ $which_lab = strftime($format['time_format'], $which_lab);
+ break;
+ case 'printf':
+ $which_lab = sprintf($format['printf_format'], $which_lab);
+ break;
+ case 'custom':
+ // Build argument vector: (text, custom_callback_arg, other_args...)
+ $argv = func_get_args();
+ $argv[0] = $which_lab;
+ $argv[1] = $format['custom_arg'];
+ $which_lab = call_user_func_array($format['custom_callback'], $argv);
+ break;
+ }
+ }
+ return $which_lab;
+ }
+
+/////////////////////////////////////////////
+/////////////// TICKS
+/////////////////////////////////////////////
+
+ /*
+ * Set the step (interval) between X ticks.
+ * Use either this or SetNumXTicks(), not both, to control the X tick marks.
+ */
+ function SetXTickIncrement($which_ti='')
+ {
+ $this->x_tick_inc = $which_ti;
+ if (!empty($which_ti)) {
+ $this->num_x_ticks = '';
+ }
+ return TRUE;
+ }
+
+ /*
+ * Set the step (interval) between Y ticks.
+ * Use either this or SetNumYTicks(), not both, to control the Y tick marks.
+ */
+ function SetYTickIncrement($which_ti='')
+ {
+ $this->y_tick_inc = $which_ti;
+ if (!empty($which_ti)) {
+ $this->num_y_ticks = '';
+ }
+ return TRUE;
+ }
+
+ /*
+ * Set the number of X tick marks.
+ * Use either this or SetXTickIncrement(), not both, to control the X tick marks.
+ */
+ function SetNumXTicks($which_nt='')
+ {
+ $this->num_x_ticks = $which_nt;
+ if (!empty($which_nt)) {
+ $this->x_tick_inc = '';
+ }
+ return TRUE;
+ }
+
+ /*
+ * Set the number of Y tick marks.
+ * Use either this or SetYTickIncrement(), not both, to control the Y tick marks.
+ */
+ function SetNumYTicks($which_nt='')
+ {
+ $this->num_y_ticks = $which_nt;
+ if (!empty($which_nt)) {
+ $this->y_tick_inc = ''; //either use num_y_ticks or y_tick_inc, not both
+ }
+ return TRUE;
+ }
+
+ /*
+ * Set the position for the X tick marks.
+ * These can be above the plot, below, both positions, at the X axis, or suppressed.
+ */
+ function SetXTickPos($which_tp)
+ {
+ $this->x_tick_pos = $this->CheckOption($which_tp, 'plotdown, plotup, both, xaxis, none',
+ __FUNCTION__);
+ return (boolean)$this->x_tick_pos;
+ }
+
+ /*
+ * Set the position for the Y tick marks.
+ * These can be left of the plot, right, both positions, at the Y axis, or suppressed.
+ */
+ function SetYTickPos($which_tp)
+ {
+ $this->y_tick_pos = $this->CheckOption($which_tp, 'plotleft, plotright, both, yaxis, none',
+ __FUNCTION__);
+ return (boolean)$this->y_tick_pos;
+ }
+
+ /*
+ * Skip the top-most Y axis tick mark and label if $skip is true.
+ */
+ function SetSkipTopTick($skip)
+ {
+ $this->skip_top_tick = (bool)$skip;
+ return TRUE;
+ }
+
+ /*
+ * Skip the bottom-most Y axis tick mark and label if $skip is true.
+ */
+ function SetSkipBottomTick($skip)
+ {
+ $this->skip_bottom_tick = (bool)$skip;
+ return TRUE;
+ }
+
+ /*
+ * Skip the left-most X axis tick mark and label if $skip is true.
+ */
+ function SetSkipLeftTick($skip)
+ {
+ $this->skip_left_tick = (bool)$skip;
+ return TRUE;
+ }
+
+ /*
+ * Skip the right-most X axis tick mark and label if $skip is true.
+ */
+ function SetSkipRightTick($skip)
+ {
+ $this->skip_right_tick = (bool)$skip;
+ return TRUE;
+ }
+
+ /*
+ * Set the outer length of X tick marks to $which_xln pixels.
+ * This is the part of the tick mark that sticks out from the plot area.
+ */
+ function SetXTickLength($which_xln)
+ {
+ $this->x_tick_length = $which_xln;
+ return TRUE;
+ }
+
+ /*
+ * Set the outer length of Y tick marks to $which_yln pixels.
+ * This is the part of the tick mark that sticks out from the plot area.
+ */
+ function SetYTickLength($which_yln)
+ {
+ $this->y_tick_length = $which_yln;
+ return TRUE;
+ }
+
+ /*
+ * Set the crossing length of X tick marks to $which_xc pixels.
+ * This is the part of the tick mark that sticks into the plot area.
+ */
+ function SetXTickCrossing($which_xc)
+ {
+ $this->x_tick_cross = $which_xc;
+ return TRUE;
+ }
+
+ /*
+ * Set the crossing length of Y tick marks to $which_yc pixels.
+ * This is the part of the tick mark that sticks into the plot area.
+ */
+ function SetYTickCrossing($which_yc)
+ {
+ $this->y_tick_cross = $which_yc;
+ return TRUE;
+ }
+
+ /*
+ * Set an anchor point for X tick marks. There will be an X tick mark at
+ * this exact value (if the data range were extended to include it).
+ */
+ function SetXTickAnchor($xta = NULL)
+ {
+ $this->x_tick_anchor = $xta;
+ return TRUE;
+ }
+
+ /*
+ * Set an anchor point for Y tick marks. There will be a Y tick mark at
+ * this exact value (if the data range were extended to include it).
+ */
+ function SetYTickAnchor($yta = NULL)
+ {
+ $this->y_tick_anchor = $yta;
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+//////////////////// GENERIC DRAWING
+/////////////////////////////////////////////
+
+ /*
+ * Fill the image background, with a tiled image file or solid color.
+ * $overwrite : Optional flag. If True, allow overwriting the background.
+ */
+ protected function DrawBackground($overwrite=FALSE)
+ {
+ // Check if background should be drawn:
+ if (empty($this->done['background']) || $overwrite) {
+ if (isset($this->bgimg)) { // If bgimg is defined, use it
+ $this->tile_img($this->bgimg, 0, 0, $this->image_width, $this->image_height, $this->bgmode);
+ } else { // Else use solid color
+ ImageFilledRectangle($this->img, 0, 0, $this->image_width, $this->image_height,
+ $this->ndx_bg_color);
+ }
+ $this->done['background'] = TRUE;
+ }
+ return TRUE;
+ }
+
+ /*
+ * Fill the plot area background, with a tiled image file or solid color.
+ */
+ protected function DrawPlotAreaBackground()
+ {
+ if (isset($this->plotbgimg)) {
+ $this->tile_img($this->plotbgimg, $this->plot_area[0], $this->plot_area[1],
+ $this->plot_area_width, $this->plot_area_height, $this->plotbgmode);
+ } elseif ($this->draw_plot_area_background) {
+ ImageFilledRectangle($this->img, $this->plot_area[0], $this->plot_area[1],
+ $this->plot_area[2], $this->plot_area[3], $this->ndx_plot_bg_color);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Tiles an image at some given coordinates.
+ * $file : Filename of the picture to be used as tile.
+ * $xorig : X device coordinate of where the tile is to begin.
+ * $yorig : Y device coordinate of where the tile is to begin.
+ * $width : Width of the area to be tiled.
+ * $height : Height of the area to be tiled.
+ * $mode : Tiling mode. One of 'centeredtile', 'tile', 'scale'.
+ */
+ protected function tile_img($file, $xorig, $yorig, $width, $height, $mode)
+ {
+ $im = $this->GetImage($file, $tile_width, $tile_height);
+ if (!$im)
+ return FALSE; // GetImage already produced an error message.
+
+ if ($mode == 'scale') {
+ imagecopyresampled($this->img, $im, $xorig, $yorig, 0, 0, $width, $height,
+ $tile_width, $tile_height);
+ return TRUE;
+ }
+
+ if ($mode == 'centeredtile') {
+ $x0 = - floor($tile_width/2); // Make the tile look better
+ $y0 = - floor($tile_height/2);
+ } else { // Accept anything else as $mode == 'tile'
+ $x0 = 0;
+ $y0 = 0;
+ }
+
+ // Draw the tile onto a temporary image first.
+ $tmp = imagecreate($width, $height);
+ if (! $tmp)
+ return $this->PrintError('tile_img(): Could not create image resource.');
+
+ for ($x = $x0; $x < $width; $x += $tile_width)
+ for ($y = $y0; $y < $height; $y += $tile_height)
+ imagecopy($tmp, $im, $x, $y, 0, 0, $tile_width, $tile_height);
+
+ // Copy the temporary image onto the final one.
+ imagecopy($this->img, $tmp, $xorig, $yorig, 0,0, $width, $height);
+
+ // Free resources
+ imagedestroy($tmp);
+ imagedestroy($im);
+
+ return TRUE;
+ }
+
+ /*
+ * Return the image border width.
+ * This is used by CalcMargins() and DrawImageBorder().
+ */
+ protected function GetImageBorderWidth()
+ {
+ if ($this->image_border_type == 'none')
+ return 0; // No border
+ if (!empty($this->image_border_width))
+ return $this->image_border_width; // Specified border width
+ if ($this->image_border_type == 'raised')
+ return 2; // Default for raised border is 2 pixels.
+ return 1; // Default for other border types is 1 pixel.
+ }
+
+ /*
+ * Draws a border around the final image.
+ * Note: 'plain' draws a flat border using the dark shade of the border color.
+ * This probably should have been written to use the actual border color, but
+ * it is too late to fix it without changing plot appearances. Therefore a
+ * new type 'solid' was added to use the SetImageBorderColor color.
+ * $overwrite : Optional flag. If True, allow overwriting the border.
+ */
+ protected function DrawImageBorder($overwrite=FALSE)
+ {
+ // Check if border should be drawn:
+ if ($this->image_border_type == 'none' || !(empty($this->done['border']) || $overwrite))
+ return TRUE;
+ $width = $this->GetImageBorderWidth();
+ $color1 = $this->ndx_i_border;
+ $color2 = $this->ndx_i_border_dark;
+ $ex = $this->image_width - 1;
+ $ey = $this->image_height - 1;
+ switch ($this->image_border_type) {
+ case 'raised':
+ // Top and left lines use border color, right and bottom use the darker shade.
+ // Drawing order matters in the upper right and lower left corners.
+ for ($i = 0; $i < $width; $i++, $ex--, $ey--) {
+ imageline($this->img, $i, $i, $ex, $i, $color1); // Top
+ imageline($this->img, $ex, $i, $ex, $ey, $color2); // Right
+ imageline($this->img, $i, $i, $i, $ey, $color1); // Left
+ imageline($this->img, $i, $ey, $ex, $ey, $color2); // Bottom
+ }
+ break;
+ case 'plain': // See note above re colors
+ $color1 = $color2;
+ // Fall through
+ case 'solid':
+ for ($i = 0; $i < $width; $i++, $ex--, $ey--) {
+ imagerectangle($this->img, $i, $i, $ex, $ey, $color1);
+ }
+ break;
+ default:
+ return $this->PrintError(
+ "DrawImageBorder(): unknown image_border_type: '$this->image_border_type'");
+ }
+ $this->done['border'] = TRUE; // Border should only be drawn once per image.
+ return TRUE;
+ }
+
+ /*
+ * Draws the main title on the graph.
+ * The title must not be drawn more than once (in the case of multiple plots
+ * on the image), because TTF text antialiasing makes it look bad.
+ */
+ protected function DrawTitle()
+ {
+ if (!empty($this->done['title']) || $this->title_txt === '')
+ return TRUE;
+
+ // Center of the image:
+ $xpos = $this->image_width / 2;
+
+ // Place it at almost at the top
+ $ypos = $this->title_offset;
+
+ $this->DrawText($this->fonts['title'], 0, $xpos, $ypos,
+ $this->ndx_title_color, $this->title_txt, 'center', 'top');
+
+ $this->done['title'] = TRUE;
+ return TRUE;
+ }
+
+ /*
+ * Draws the X-Axis Title
+ */
+ protected function DrawXTitle()
+ {
+ if ($this->x_title_pos == 'none')
+ return TRUE;
+
+ // Center of the plot
+ $xpos = ($this->plot_area[2] + $this->plot_area[0]) / 2;
+
+ // Upper title
+ if ($this->x_title_pos == 'plotup' || $this->x_title_pos == 'both') {
+ $ypos = $this->plot_area[1] - $this->x_title_top_offset;
+ $this->DrawText($this->fonts['x_title'], 0, $xpos, $ypos, $this->ndx_x_title_color,
+ $this->x_title_txt, 'center', 'bottom');
+ }
+ // Lower title
+ if ($this->x_title_pos == 'plotdown' || $this->x_title_pos == 'both') {
+ $ypos = $this->plot_area[3] + $this->x_title_bot_offset;
+ $this->DrawText($this->fonts['x_title'], 0, $xpos, $ypos, $this->ndx_x_title_color,
+ $this->x_title_txt, 'center', 'top');
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draws the Y-Axis Title
+ */
+ protected function DrawYTitle()
+ {
+ if ($this->y_title_pos == 'none')
+ return TRUE;
+
+ // Center the title vertically to the plot area
+ $ypos = ($this->plot_area[3] + $this->plot_area[1]) / 2;
+
+ if ($this->y_title_pos == 'plotleft' || $this->y_title_pos == 'both') {
+ $xpos = $this->plot_area[0] - $this->y_title_left_offset;
+ $this->DrawText($this->fonts['y_title'], 90, $xpos, $ypos, $this->ndx_y_title_color,
+ $this->y_title_txt, 'right', 'center');
+ }
+ if ($this->y_title_pos == 'plotright' || $this->y_title_pos == 'both') {
+ $xpos = $this->plot_area[2] + $this->y_title_right_offset;
+ $this->DrawText($this->fonts['y_title'], 90, $xpos, $ypos, $this->ndx_y_title_color,
+ $this->y_title_txt, 'left', 'center');
+ }
+
+ return TRUE;
+ }
+
+ /*
+ * Draw the X axis, including ticks and labels, and X (vertical) grid lines.
+ */
+ protected function DrawXAxis()
+ {
+ // Draw ticks, labels and grid
+ $this->DrawXTicks();
+
+ //Draw X Axis at Y = x_axis_y_pixels, unless suppressed (See SetXAxisPosition)
+ if (empty($this->suppress_x_axis)) {
+ ImageLine($this->img, $this->plot_area[0]+1, $this->x_axis_y_pixels,
+ $this->plot_area[2]-1, $this->x_axis_y_pixels, $this->ndx_grid_color);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw the Y axis, including ticks and labels, and Y (horizontal) grid lines.
+ * Horizontal grid lines overwrite horizontal axis with y=0, so call this first, then DrawXAxis()
+ */
+ protected function DrawYAxis()
+ {
+ // Draw ticks, labels and grid
+ $this->DrawYTicks();
+
+ // Draw Y axis at X = y_axis_x_pixels, unless suppressed (See SetYAxisPosition)
+ if (empty($this->suppress_y_axis)) {
+ ImageLine($this->img, $this->y_axis_x_pixels, $this->plot_area[1],
+ $this->y_axis_x_pixels, $this->plot_area[3], $this->ndx_grid_color);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw one X tick mark and its tick label.
+ * $x : X value for the label. This is the unformatted value (in PHPlot>5.7.0)
+ * $x_pixels : X device coordinate for this tick mark.
+ */
+ protected function DrawXTick($x, $x_pixels)
+ {
+ // Ticks on X axis
+ if ($this->x_tick_pos == 'xaxis') {
+ ImageLine($this->img, $x_pixels, $this->x_axis_y_pixels - $this->x_tick_cross,
+ $x_pixels, $this->x_axis_y_pixels + $this->x_tick_length, $this->ndx_tick_color);
+ }
+
+ // Ticks on top of the Plot Area
+ if ($this->x_tick_pos == 'plotup' || $this->x_tick_pos == 'both') {
+ ImageLine($this->img, $x_pixels, $this->plot_area[1] - $this->x_tick_length,
+ $x_pixels, $this->plot_area[1] + $this->x_tick_cross, $this->ndx_tick_color);
+ }
+
+ // Ticks on bottom of Plot Area
+ if ($this->x_tick_pos == 'plotdown' || $this->x_tick_pos == 'both') {
+ ImageLine($this->img, $x_pixels, $this->plot_area[3] + $this->x_tick_length,
+ $x_pixels, $this->plot_area[3] - $this->x_tick_cross, $this->ndx_tick_color);
+ }
+
+ if ($this->x_tick_label_pos != 'none') {
+ $x_label = $this->FormatLabel('x', $x);
+
+ // Label on X axis
+ if ($this->x_tick_label_pos == 'xaxis') {
+ $this->DrawText($this->fonts['x_label'], $this->x_label_angle,
+ $x_pixels, $this->x_axis_y_pixels + $this->x_label_axis_offset,
+ $this->ndx_ticklabel_color, $x_label, 'center', 'top');
+ }
+
+ // Label on top of the plot area
+ if ($this->x_tick_label_pos == 'plotup' || $this->x_tick_label_pos == 'both') {
+ $this->DrawText($this->fonts['x_label'], $this->x_label_angle,
+ $x_pixels, $this->plot_area[1] - $this->x_label_top_offset,
+ $this->ndx_ticklabel_color, $x_label, 'center', 'bottom');
+ }
+
+ // Label on bottom of the plot area
+ if ($this->x_tick_label_pos == 'plotdown' || $this->x_tick_label_pos == 'both') {
+ $this->DrawText($this->fonts['x_label'], $this->x_label_angle,
+ $x_pixels, $this->plot_area[3] + $this->x_label_bot_offset,
+ $this->ndx_ticklabel_color, $x_label, 'center', 'top');
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw one Y tick mark and its tick label.
+ * $y : Y value for the label. This is the unformatted value (in PHPlot>5.7.0)
+ * $y_pixels : Y device coordinate for this tick mark.
+ */
+ protected function DrawYTick($y, $y_pixels)
+ {
+ // Ticks on Y axis
+ if ($this->y_tick_pos == 'yaxis') {
+ ImageLine($this->img, $this->y_axis_x_pixels - $this->y_tick_length, $y_pixels,
+ $this->y_axis_x_pixels + $this->y_tick_cross, $y_pixels, $this->ndx_tick_color);
+ }
+
+ // Ticks to the left of the Plot Area
+ if (($this->y_tick_pos == 'plotleft') || ($this->y_tick_pos == 'both') ) {
+ ImageLine($this->img, $this->plot_area[0] - $this->y_tick_length, $y_pixels,
+ $this->plot_area[0] + $this->y_tick_cross, $y_pixels, $this->ndx_tick_color);
+ }
+
+ // Ticks to the right of the Plot Area
+ if (($this->y_tick_pos == 'plotright') || ($this->y_tick_pos == 'both') ) {
+ ImageLine($this->img, $this->plot_area[2] + $this->y_tick_length, $y_pixels,
+ $this->plot_area[2] - $this->y_tick_cross, $y_pixels, $this->ndx_tick_color);
+ }
+
+ if ($this->y_tick_label_pos != 'none') {
+ $y_label = $this->FormatLabel('y', $y);
+
+ // Labels on Y axis
+ if ($this->y_tick_label_pos == 'yaxis') {
+ $this->DrawText($this->fonts['y_label'], $this->y_label_angle,
+ $this->y_axis_x_pixels - $this->y_label_axis_offset, $y_pixels,
+ $this->ndx_ticklabel_color, $y_label, 'right', 'center');
+ }
+
+ // Labels to the left of the plot area
+ if ($this->y_tick_label_pos == 'plotleft' || $this->y_tick_label_pos == 'both') {
+ $this->DrawText($this->fonts['y_label'], $this->y_label_angle,
+ $this->plot_area[0] - $this->y_label_left_offset, $y_pixels,
+ $this->ndx_ticklabel_color, $y_label, 'right', 'center');
+ }
+
+ // Labels to the right of the plot area
+ if ($this->y_tick_label_pos == 'plotright' || $this->y_tick_label_pos == 'both') {
+ $this->DrawText($this->fonts['y_label'], $this->y_label_angle,
+ $this->plot_area[2] + $this->y_label_right_offset, $y_pixels,
+ $this->ndx_ticklabel_color, $y_label, 'left', 'center');
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draws Grid, Ticks and Tick Labels along X-Axis
+ * Ticks and tick labels can be down of plot only, up of plot only,
+ * both on up and down of plot, or crossing a user defined X-axis
+ *
+ * Original vertical code submitted by Marlin Viss
+ */
+ protected function DrawXTicks()
+ {
+ // Sets the line style for IMG_COLOR_STYLED lines (grid)
+ if ($this->dashed_grid) {
+ $this->SetDashedStyle($this->ndx_light_grid_color);
+ $style = IMG_COLOR_STYLED;
+ } else {
+ $style = $this->ndx_light_grid_color;
+ }
+
+ // Calculate the tick start, end, and step:
+ list($x_start, $x_end, $delta_x) = $this->CalcTicks('x');
+
+ // Loop, avoiding cumulative round-off errors from $x += $delta_x
+ for ($n = 0; ($x = $x_start + $n * $delta_x) <= $x_end; $n++) {
+ $x_pixels = $this->xtr($x);
+
+ // Draw vertical grid line:
+ if ($this->draw_x_grid) {
+ ImageLine($this->img, $x_pixels, $this->plot_area[1], $x_pixels, $this->plot_area[3], $style);
+ }
+
+ // Draw tick mark and tick label:
+ $this->DrawXTick($x, $x_pixels);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw the grid, ticks, and tick labels along the Y axis.
+ * Ticks and tick labels can be left of plot only, right of plot only,
+ * both on the left and right of plot, or crossing a user defined Y-axis
+ */
+ protected function DrawYTicks()
+ {
+ // Sets the line style for IMG_COLOR_STYLED lines (grid)
+ if ($this->dashed_grid) {
+ $this->SetDashedStyle($this->ndx_light_grid_color);
+ $style = IMG_COLOR_STYLED;
+ } else {
+ $style = $this->ndx_light_grid_color;
+ }
+
+ // Calculate the tick start, end, and step:
+ list($y_start, $y_end, $delta_y) = $this->CalcTicks('y');
+
+ // Loop, avoiding cumulative round-off errors from $y += $delta_y
+ for ($n = 0; ($y = $y_start + $n * $delta_y) <= $y_end; $n++) {
+ $y_pixels = $this->ytr($y);
+
+ // Draw horizontal grid line:
+ if ($this->draw_y_grid) {
+ ImageLine($this->img, $this->plot_area[0]+1, $y_pixels, $this->plot_area[2]-1,
+ $y_pixels, $style);
+ }
+
+ // Draw tick mark and tick label:
+ $this->DrawYTick($y, $y_pixels);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a border around the plot area. See SetPlotBorderType.
+ * plot_border_type can be unset/NULL, a scaler, or an array. If unset or null, the
+ * default is used ('sides' if the plot includes axes, 'none' if not).
+ */
+ protected function DrawPlotBorder($draw_axes = TRUE)
+ {
+ // Force plot_border_type to array and apply defaults.
+ if (isset($this->plot_border_type)) {
+ $pbt = (array)$this->plot_border_type;
+ } elseif ($draw_axes) $pbt = array('sides');
+ else return TRUE; // Default to no border for plots without axes (e.g. pie charts)
+
+ $sides = 0; // Bitmap: 1=left 2=top 4=right 8=bottom
+ $map = array('left' => 1, 'plotleft' => 1, 'right' => 4, 'plotright' => 4, 'top' => 2,
+ 'bottom' => 8, 'both' => 5, 'sides' => 5, 'full' => 15, 'none' => 0);
+ foreach ($pbt as $option) $sides |= $map[$option];
+ if ($sides == 15) { // Border on all 4 sides
+ imagerectangle($this->img, $this->plot_area[0], $this->plot_area[1],
+ $this->plot_area[2], $this->plot_area[3], $this->ndx_grid_color);
+ } else {
+ if ($sides & 1) // Left
+ imageline($this->img, $this->plot_area[0], $this->plot_area[1],
+ $this->plot_area[0], $this->plot_area[3], $this->ndx_grid_color);
+ if ($sides & 2) // Top
+ imageline($this->img, $this->plot_area[0], $this->plot_area[1],
+ $this->plot_area[2], $this->plot_area[1], $this->ndx_grid_color);
+ if ($sides & 4) // Right
+ imageline($this->img, $this->plot_area[2], $this->plot_area[1],
+ $this->plot_area[2], $this->plot_area[3], $this->ndx_grid_color);
+ if ($sides & 8) // Bottom
+ imageline($this->img, $this->plot_area[0], $this->plot_area[3],
+ $this->plot_area[2], $this->plot_area[3], $this->ndx_grid_color);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw the data value label associated with a point in the plot.
+ * These are labels that show the value (dependent variable, usually Y) of the data point,
+ * and are drawn within the plot area (not to be confused with axis data labels).
+ * $x_or_y : Specify 'x' or 'y' labels. This selects font, angle, and formatting.
+ * $row, $column : Identifies the row and column of the data point (for custom label formatting).
+ * $x_world, $y_world : World coordinates of the text (see also [xy]_offset).
+ * $text : The text to draw, after formatting with FormatLabel().
+ * $dvl : Associative array with additional label position controls:
+ * h_align v_align : Selects from 9-point text alignment (default center, center)
+ * x_offset y_offset : Text position offsets, in device coordinates (default 0,0)
+ * min_width min_height : Suppress the text if it will not fit (default null,null = no check)
+ * Returns True, if the text was drawn, or False, if it will not fit.
+ */
+ protected function DrawDataValueLabel($x_or_y, $row, $column, $x_world, $y_world, $text, $dvl)
+ {
+ if ($x_or_y == 'x') {
+ $angle = $this->x_data_label_angle;
+ $font = $this->fonts['x_label'];
+ $formatted_text = $this->FormatLabel('xd', $text, $row, $column);
+ } else { // Assumed 'y'
+ $angle = $this->y_data_label_angle;
+ $font = $this->fonts['y_label'];
+ $formatted_text = $this->FormatLabel('yd', $text, $row, $column);
+ }
+ // Assign defaults and then extract control variables from $dvl:
+ $x_offset = $y_offset = 0;
+ $h_align = $v_align = 'center';
+ extract($dvl);
+
+ // Check to see if the text fits in the available space, if requested.
+ if (isset($min_width) || isset($min_height)) {
+ list($width, $height) = $this->SizeText($font, $angle, $formatted_text);
+ if ((isset($min_width) && ($min_width - $width) < 2)
+ || (isset($min_height) && ($min_height - $height) < 2))
+ return FALSE;
+ }
+
+ $this->DrawText($font, $angle, $this->xtr($x_world) + $x_offset, $this->ytr($y_world) + $y_offset,
+ $this->ndx_dvlabel_color, $formatted_text, $h_align, $v_align);
+ return TRUE;
+ }
+
+ /*
+ * Draws an X axis data label, and optional data label line. This is for vertical plots.
+ * $xlab : Label text
+ * $xpos : X position for the label, in device coordinates
+ * $row : Row index. This is 0 for the first X, 1 for the second, etc.
+ * $do_lines : True for plot types that support data label lines, False (the default) for others.
+ */
+ protected function DrawXDataLabel($xlab, $xpos, $row, $do_lines=FALSE)
+ {
+ $xlab = $this->FormatLabel('xd', $xlab, $row);
+
+ // Labels below the plot area
+ if ($this->x_data_label_pos == 'plotdown' || $this->x_data_label_pos == 'both')
+ $this->DrawText($this->fonts['x_label'], $this->x_data_label_angle,
+ $xpos, $this->plot_area[3] + $this->x_label_bot_offset,
+ $this->ndx_datalabel_color, $xlab, 'center', 'top');
+
+ // Labels above the plot area
+ if ($this->x_data_label_pos == 'plotup' || $this->x_data_label_pos == 'both')
+ $this->DrawText($this->fonts['x_label'], $this->x_data_label_angle,
+ $xpos, $this->plot_area[1] - $this->x_label_top_offset,
+ $this->ndx_datalabel_color, $xlab, 'center', 'bottom');
+
+ if ($do_lines && $this->draw_x_data_label_lines)
+ $this->DrawXDataLine($xpos, $row);
+ return TRUE;
+ }
+
+ /*
+ * Draw a Y axis data label. This is for horizontal plots.
+ * $ylab : Label text
+ * $ypos : Y position for the label, in device coordinates
+ * $row : Row index. This is 0 for the first Y, 1 for the second, etc.
+ * Note: No horizontal plot type supports data label lines. (Compare with DrawXDataLabel())
+ */
+ protected function DrawYDataLabel($ylab, $ypos, $row)
+ {
+ $ylab = $this->FormatLabel('yd', $ylab, $row);
+
+ // Labels left of the plot area
+ if ($this->y_data_label_pos == 'plotleft' || $this->y_data_label_pos == 'both')
+ $this->DrawText($this->fonts['y_label'], $this->y_data_label_angle,
+ $this->plot_area[0] - $this->y_label_left_offset, $ypos,
+ $this->ndx_datalabel_color, $ylab, 'right', 'center');
+
+ // Labels right of the plot area
+ if ($this->y_data_label_pos == 'plotright' || $this->y_data_label_pos == 'both')
+ $this->DrawText($this->fonts['y_label'], $this->y_data_label_angle,
+ $this->plot_area[2] + $this->y_label_right_offset, $ypos,
+ $this->ndx_datalabel_color, $ylab, 'left', 'center');
+ return TRUE;
+ }
+
+ /*
+ * Draws Vertical lines from data points up and down.
+ * Which lines are drawn depends on the value of x_data_label_pos,
+ * and whether this is at all done or not, on draw_x_data_label_lines
+ *
+ * $xpos : position in pixels of the line.
+ * $row : index of the data row being drawn.
+ */
+ protected function DrawXDataLine($xpos, $row)
+ {
+ // Sets the line style for IMG_COLOR_STYLED lines (grid)
+ if ($this->dashed_grid) {
+ $this->SetDashedStyle($this->ndx_light_grid_color);
+ $style = IMG_COLOR_STYLED;
+ } else {
+ $style = $this->ndx_light_grid_color;
+ }
+
+ if ($this->x_data_label_pos == 'both') {
+ // Lines from the bottom up
+ ImageLine($this->img, $xpos, $this->plot_area[3], $xpos, $this->plot_area[1], $style);
+ } elseif ($this->x_data_label_pos == 'plotdown' && isset($this->data_max[$row])) {
+ // Lines from the bottom of the plot up to the max Y value at this X:
+ $ypos = $this->ytr($this->data_max[$row]);
+ ImageLine($this->img, $xpos, $ypos, $xpos, $this->plot_area[3], $style);
+ } elseif ($this->x_data_label_pos == 'plotup' && isset($this->data_min[$row])) {
+ // Lines from the top of the plot down to the min Y value at this X:
+ $ypos = $this->ytr($this->data_min[$row]);
+ ImageLine($this->img, $xpos, $this->plot_area[1], $xpos, $ypos, $style);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Format a pie chart label.
+ * $index : Slice number, starting with 0.
+ * $pie_label_source : Label mode. See CheckPieLabels() and SetPieLabelType().
+ * $arc_angle : Delta angle for this slice, in degrees.
+ * $slice_weight : Numeric value, or relative weight, of this slice.
+ * Returns the formatted label text for slice $index.
+ */
+ protected function FormatPieLabel($index, $pie_label_source, $arc_angle, $slice_weight)
+ {
+ $values = array(); // Builds up label value, one field at a time.
+ foreach ($pie_label_source as $word) {
+ switch ($word) {
+ case 'label': // Use label from data array, but only if data type is compatible
+ $values[] = $this->datatype_pie_single ? $this->data[$index][0] : '';
+ break;
+ case 'value': // Use actual numeric value of the slice
+ $values[] = $slice_weight;
+ break;
+ case 'index': // Use slice index: 0, 1, 2...
+ $values[] = $index;
+ break;
+ default: // Use percentage: 100% x arc_angle / (360 degrees) = arc_angle / 3.6
+ $values[] = $arc_angle / 3.6;
+ }
+ }
+ // Format the label and return the result. Note: The conditional avoids a number-to-string
+ // conversion for the single-source case. This avoids a PHP issue with locale-based conversion.
+ return $this->FormatLabel('p', count($values) == 1 ? $values[0] : implode(' ', $values));
+ }
+
+ /*
+ * Draw a pie chart label.
+ * $label_txt : Pre-formatted label, from FormatPieLabel()
+ * $xc, $yc : Center of pie chart
+ * $start_angle, $arc_angle : Slice starting angle and angular width, in degrees
+ * $r : Array of ('x', 'y', 'reverse') elements, calculated in DrawPieChart.
+ * (x, y) are the parameters of the ellipse: x^2 / r[x]^2 + y^2 / r[y]^2 = 1
+ * Also: x = r[x] * cos(angle); y = r[y] * sin(angle); (then offset to center).
+ * reverse is a flag for text alignment (see GetTextAlignment()).
+ */
+ protected function DrawPieLabel($label_txt, $xc, $yc, $start_angle, $arc_angle, $r)
+ {
+ $mid_angle = deg2rad($start_angle + $arc_angle / 2);
+ $sin_mid = sin($mid_angle);
+ $cos_mid = cos($mid_angle);
+ // Calculate label reference point.
+ $label_x = $xc + $cos_mid * $r['x'];
+ $label_y = $yc - $sin_mid * $r['y'];
+ // For labels in the lower half, outside the pie, offset it to account for shading.
+ // But don't shift labels just below the horizontal, because the shading is too thin there,
+ // and the label ends up too far from the slice. Make a smooth transition between label offsets on
+ // shaded area and above. (This isn't perfect at all, but works for reasonably low shading.)
+ if ($this->label_scale_position >= 0.5 && $this->shading > 0 && $sin_mid < 0) {
+ $yoff = min($this->shading, -$sin_mid * $r['y']);
+ } else $yoff = 0;
+
+ // Calculate text alignment (h_align, v_align) based on angle:
+ $this->GetTextAlignment($sin_mid, $cos_mid, $h_align, $v_align, $r['reverse']);
+ // Draw the label:
+ $this->DrawText($this->fonts['generic'], 0, $label_x, $label_y + $yoff, $this->ndx_pielabel_color,
+ $label_txt, $h_align, $v_align);
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+/////////////// LEGEND
+/////////////////////////////////////////////
+
+ /*
+ * Set text to display in the graph's legend.
+ * $which_leg : Array of strings for the complete legend, or a single string
+ * to be appended to the legend.
+ * Or NULL (or an empty array) to cancel the legend.
+ */
+ function SetLegend($which_leg)
+ {
+ if (is_array($which_leg)) { // use array (or cancel, if empty array)
+ $this->legend = $which_leg;
+ } elseif (!is_null($which_leg)) { // append string
+ $this->legend[] = $which_leg;
+ } else {
+ $this->legend = ''; // Reinitialize to empty, meaning no legend.
+ }
+ return TRUE;
+ }
+
+ /*
+ * Specifies the position of the legend's upper/leftmost corner, in pixel (device) coordinates.
+ * Both X and Y must be provided, or both omitted (or use NULL) to restore auto-positioning.
+ */
+ function SetLegendPixels($which_x=NULL, $which_y=NULL)
+ {
+ return $this->SetLegendPosition(0, 0, 'image', 0, 0, $which_x, $which_y);
+ }
+
+ /*
+ * Specifies the position of the legend's upper/leftmost corner, in world (data space) coordinates.
+ */
+ function SetLegendWorld($which_x, $which_y)
+ {
+ return $this->SetLegendPosition(0, 0, 'world', $which_x, $which_y);
+ }
+
+ /*
+ * Specifies the position of the legend. This includes SetLegendWorld(), SetLegendPixels(), and
+ * additional choices using relative coordinates, with optional pixel offset.
+ * $x, $y : Relative coordinates of a point on the legend box. (See below)
+ * $relative_to : What to position the legend relative to: 'image', 'plot', 'world', or 'title'.
+ * $x_base, $y_base : Base point for positioning.
+ * If $relative_to is 'world', then this is a world coordinate position.
+ * Otherwise, this is a relative coordinate position on the $relative_to element.
+ * $x_offset, $y_offset : Additional legend box offset in device coordinates (pixels).
+ * The legend is positioned so that point ($x,$y) is at ($x_base, $y_base).
+ * 'Relative coordinates' means: (0,0) is the upper left corner, and (1,1) is the lower right corner
+ * of the element (legend, image, plot, or title area), regardless of its size. These are floating
+ * point values, each usually in the range [0,1], but they can be negative or greater than 1.
+ * If any of x, y, x_offset, or y_offset are NULL, default legend positioning is restored.
+ */
+ function SetLegendPosition($x, $y, $relative_to, $x_base, $y_base, $x_offset = 0, $y_offset = 0)
+ {
+ // Special case: NULL means restore the default positioning.
+ if (!isset($x, $y, $x_offset, $y_offset)) {
+ unset($this->legend_pos);
+ } else {
+ $mode = $this->CheckOption($relative_to, 'image, plot, title, world', __FUNCTION__);
+ if (empty($mode))
+ return FALSE;
+ // Save all values for use by GetLegendPosition()
+ $this->legend_pos = compact('x', 'y', 'mode', 'x_base', 'y_base', 'x_offset', 'y_offset');
+ }
+ return TRUE;
+ }
+
+ /*
+ * Set legend text alignment, color box alignment, and style options.
+ * $text_align : Alignment of the text, 'left' or 'right'.
+ * $colorbox_align : Alignment of the color boxes, 'left', 'right', 'none', or missing/empty.
+ * If missing or empty, the same alignment as $text_align is used. Color box is positioned first.
+ */
+ function SetLegendStyle($text_align, $colorbox_align = '')
+ {
+ $this->legend_text_align = $this->CheckOption($text_align, 'left, right', __FUNCTION__);
+ if (empty($colorbox_align))
+ $this->legend_colorbox_align = $this->legend_text_align;
+ else
+ $this->legend_colorbox_align = $this->CheckOption($colorbox_align, 'left, right, none',
+ __FUNCTION__);
+ return ((boolean)$this->legend_text_align && (boolean)$this->legend_colorbox_align);
+ }
+
+ /*
+ * Use color boxes or point shapes (for points and linepoints plots only) in the legend.
+ * $use_shapes : True to use point shapes, false to use color boxes.
+ */
+ function SetLegendUseShapes($use_shapes)
+ {
+ $this->legend_use_shapes = (bool)$use_shapes;
+ return TRUE;
+ }
+
+ /*
+ * Reverse the order of legend lines. This is useful with stackedbars and stackedarea
+ * plots, so the legend entries are ordered the same way as the plot sections.
+ */
+ function SetLegendReverse($reversal = False)
+ {
+ $this->legend_reverse_order = (bool)$reversal;
+ return TRUE;
+ }
+
+ /*
+ * Get legend sizing parameters.
+ * This is used internally by DrawLegend(), and also by the public GetLegendSize().
+ * It returns information based on any SetLegend*() calls already made. It does not use
+ * legend position or data scaling, so it can be called before data scaling is set up.
+ * Returns an associative array with these entries describing legend sizing:
+ * 'width', 'height' : Overall legend box size in pixels.
+ * 'char_w', 'char_h' : Width and height of 'E' in legend text font. (Used to size color boxes)
+ * 'v_margin' : Inside margin for legend
+ * 'text_align', 'colorbox_align' : Same as the class variables, with default applied.
+ * 'draw_colorbox' : True if color boxes will be drawn.
+ * 'dot_height' : Height of color boxes (even if not drawn), for line spacing.
+ * 'colorbox_width' : Width of color boxes.
+ */
+ protected function GetLegendSizeParams()
+ {
+ $font = &$this->fonts['legend']; // Shortcut to font info array
+
+ // Find maximum legend label line width.
+ $max_width = 0;
+ foreach ($this->legend as $line) {
+ list($width, $unused) = $this->SizeText($font, 0, $line);
+ if ($width > $max_width) $max_width = $width;
+ }
+
+ // Font parameters are used to size the color boxes:
+ $char_w = $font['width'];
+ $char_h = $font['height'];
+ $line_spacing = $this->GetLineSpacing($font);
+
+ // Apply defaults to text alignment and colorbox alignment variables:
+ $text_align = isset($this->legend_text_align) ? $this->legend_text_align : 'right';
+ $colorbox_align = isset($this->legend_colorbox_align) ? $this->legend_colorbox_align : 'right';
+ $draw_colorbox = ($colorbox_align != 'none');
+
+ // Sizing parameters:
+ $v_margin = $char_h / 2; // Between vertical borders and labels
+ $dot_height = $char_h + $line_spacing; // Height of the color boxes (even if not drawn)
+ $colorbox_width = $char_w; // Base color box width
+ if (isset($this->legend_colorbox_width))
+ $colorbox_width *= $this->legend_colorbox_width; // Adjustment to color box width
+
+ // Calculate overall legend box width and height.
+ // Width is e.g.: "| space colorbox space text space |" where each space adds $char_w,
+ // and colorbox (if drawn) adds $char_w * its width adjustment.
+ if ($draw_colorbox) {
+ $width = $max_width + 3 * $char_w + $colorbox_width;
+ } else {
+ $width = $max_width + 2 * $char_w;
+ }
+ $height = $dot_height * count($this->legend) + 2 * $v_margin;
+
+ return compact('width', 'height', 'char_w', 'char_h', 'v_margin',
+ 'text_align', 'colorbox_align', 'draw_colorbox', 'dot_height', 'colorbox_width');
+ }
+
+ /*
+ * Get legend box size. This can be used to adjust the plot margins, for example.
+ * Returns: Array of ($width, $height) of the legend box in pixels.
+ */
+ function GetLegendSize()
+ {
+ $params = $this->GetLegendSizeParams();
+ return array($params['width'], $params['height']);
+ }
+
+ /*
+ * Get legend location in device coordinates. This is a helper for DrawLegend, and is only
+ * called if there is a legend. See SetLegendWorld(), SetLegendPixels(), SetLegendPosition().
+ * $width, $height : Width and height of the legend box.
+ * Returns: coordinates of the upper left corner of the legend box as an array ($x, $y)
+ */
+ protected function GetLegendPosition($width, $height)
+ {
+ // Extract variables set by SetLegend*(): $mode, $x, $y, $x_base, $y_base, $x_offset, $y_offset
+ if (isset($this->legend_pos['mode']))
+ extract($this->legend_pos);
+ else
+ $mode = ''; // Default legend position mode.
+
+ switch ($mode) {
+
+ case 'plot': // SetLegendPosition with mode='plot', relative coordinates over plot area.
+ return array((int)($x_base * $this->plot_area_width - $x * $width)
+ + $this->plot_area[0] + $x_offset,
+ (int)($y_base * $this->plot_area_height - $y * $height)
+ + $this->plot_area[1] + $y_offset);
+
+ case 'world': // User-defined position in world-coordinates (SetLegendWorld), using x_base, y_base
+ return array($this->xtr($x_base) + $x_offset - (int)($x * $width),
+ $this->ytr($y_base) + $y_offset - (int)($y * $height));
+
+ case 'image': // SetLegendPosition with mode='image', relative coordinates over image area.
+ // SetLegendPixels() uses this too, with x=y=0.
+ return array((int)($x_base * $this->image_width - $x * $width) + $x_offset,
+ (int)($y_base * $this->image_height - $y * $height) + $y_offset);
+
+ case 'title': // SetLegendPosition with mode='title', relative to main title.
+ // Recalculate main title position/size, since CalcMargins does not save it. See DrawTitle()
+ list($title_width, $title_height) = $this->SizeText($this->fonts['title'], 0, $this->title_txt);
+ $title_x = (int)(($this->image_width - $title_width) / 2);
+ return array((int)($x_base * $title_width - $x * $width) + $title_x + $x_offset,
+ (int)($y_base * $title_height - $y * $height) + $this->title_offset + $y_offset);
+
+ default: // If mode is unset (or invalid), use default position.
+ return array ($this->plot_area[2] - $width - $this->safe_margin,
+ $this->plot_area[1] + $this->safe_margin);
+ }
+ }
+
+ /*
+ * Draws the graph legend
+ * This is called by DrawGraph only if $this->legend is not empty.
+ * Base code submitted by Marlin Viss
+ */
+ protected function DrawLegend()
+ {
+ $font = &$this->fonts['legend']; // Shortcut to font info array
+
+ // Calculate legend box sizing parameters:
+ // See GetLegendSizeParams() to see what variables are set by this.
+ extract($this->GetLegendSizeParams());
+
+ // Get legend box position:
+ list($box_start_x, $box_start_y) = $this->GetLegendPosition($width, $height);
+ $box_end_y = $box_start_y + $height;
+ $box_end_x = $box_start_x + $width;
+
+ // Draw outer box
+ ImageFilledRectangle($this->img, $box_start_x, $box_start_y, $box_end_x, $box_end_y,
+ $this->ndx_bg_color);
+ ImageRectangle($this->img, $box_start_x, $box_start_y, $box_end_x, $box_end_y,
+ $this->ndx_grid_color);
+
+ $color_index = 0;
+ $max_color_index = count($this->ndx_data_colors) - 1;
+
+ // Calculate color box and text horizontal positions.
+ if (!$draw_colorbox) {
+ if ($text_align == 'left')
+ $x_pos = $box_start_x + $char_w;
+ else
+ $x_pos = $box_end_x - $char_w;
+ $dot_left_x = 0; // Not used directly if color boxes/shapes are off, but referenced below.
+ } elseif ($colorbox_align == 'left') {
+ $dot_left_x = $box_start_x + $char_w;
+ $dot_right_x = $dot_left_x + $colorbox_width;
+ if ($text_align == 'left')
+ $x_pos = $dot_right_x + $char_w;
+ else
+ $x_pos = $box_end_x - $char_w;
+ } else { // $colorbox_align == 'right'
+ $dot_right_x = $box_end_x - $char_w;
+ $dot_left_x = $dot_right_x - $colorbox_width;
+ if ($text_align == 'left')
+ $x_pos = $box_start_x + $char_w;
+ else
+ $x_pos = $dot_left_x - $char_w;
+ }
+
+ // $y_pos is the bottom of each color box. $yc is the vertical center of the color box or
+ // the point shape (if drawn). The text is centered vertically on $yc.
+ // For normal order (top-down), $y_pos starts at the top. For reversed order, at the bottom.
+ if (empty($this->legend_reverse_order)) {
+ $y_pos = $box_start_y + $v_margin + $dot_height;
+ $delta_y = $dot_height;
+ } else {
+ $y_pos = $box_end_y - $v_margin;
+ $delta_y = -$dot_height;
+ }
+ $yc = (int)($y_pos - $dot_height / 2);
+ $xc = (int)($dot_left_x + $colorbox_width / 2); // Horizontal center for point shape if drawn
+ $shape_index = 0; // Shape number index, if drawing point shapes
+
+ // Option to use point shapes rather than solid boxes. Disallow this if the shapes array
+ // has not been initialized (see CheckPointParams). Only works with 'points' or 'linepoints' plots.
+ $use_shapes = !empty($this->legend_use_shapes) && !empty($this->point_counts);
+
+ foreach ($this->legend as $leg) {
+ // Draw text with requested alignment:
+ $this->DrawText($font, 0, $x_pos, $yc, $this->ndx_text_color, $leg, $text_align, 'center');
+ if ($draw_colorbox) {
+ $y1 = $y_pos - $dot_height + 1;
+ $y2 = $y_pos - 1;
+ if ($use_shapes) {
+ // Draw a point shape in the data color
+ // If plot area background is on, use that as the shape background:
+ if ($this->draw_plot_area_background) {
+ ImageFilledRectangle($this->img, $dot_left_x, $y1, $dot_right_x, $y2,
+ $this->ndx_plot_bg_color);
+ }
+ // Draw the shape. DrawShape() takes shape_index modulo number of defined shapes.
+ $this->DrawShape($xc, $yc, $shape_index++, $this->ndx_data_colors[$color_index]);
+ } else {
+ // Draw color boxes:
+ ImageFilledRectangle($this->img, $dot_left_x, $y1, $dot_right_x, $y2,
+ $this->ndx_data_colors[$color_index]);
+ // Draw a rectangle around the box
+ ImageRectangle($this->img, $dot_left_x, $y1, $dot_right_x, $y2, $this->ndx_text_color);
+ }
+ }
+ $y_pos += $delta_y;
+ $yc += $delta_y;
+ if (++$color_index > $max_color_index)
+ $color_index = 0;
+ }
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+//////////////////// PLOT DRAWING HELPERS
+/////////////////////////////////////////////
+
+ /*
+ * Get data color to use for plotting.
+ * $row, $idx : Index arguments for the current data point.
+ * &$vars : Variable storage. Caller makes an empty array, and this function uses it.
+ * &$data_color : Returned result - Color index for the data point.
+ * $extra : Extra info flag passed through to data color callback.
+ */
+ protected function GetDataColor($row, $idx, &$vars, &$data_color, $extra = 0)
+ {
+ // Initialize or extract variables:
+ if (empty($vars)) {
+ $custom_color = (bool)$this->GetCallback('data_color');
+ $num_data_colors = count($this->ndx_data_colors);
+ $vars = compact('custom_color', 'num_data_colors');
+ } else {
+ extract($vars);
+ }
+
+ // Select the colors.
+ if ($custom_color) {
+ $col_i = $this->DoCallback('data_color', $row, $idx, $extra); // Custom color index
+ $data_color = $this->ndx_data_colors[$col_i % $num_data_colors];
+ } else {
+ $data_color = $this->ndx_data_colors[$idx];
+ }
+ }
+
+ /*
+ * Get data color and error bar color to use for plotting.
+ * $row, $idx : Index arguments for the current bar.
+ * &$vars : Variable storage. Caller makes an empty array, and this function uses it.
+ * &$data_color : Returned result - Color index for the data (bar fill)
+ * &$error_color : Returned result - Color index for the error bars
+ * $extra : Extra info flag passed through to data color callback.
+ */
+ protected function GetDataErrorColors($row, $idx, &$vars, &$data_color, &$error_color, $extra = 0)
+ {
+ // Initialize or extract variables:
+ if (empty($vars)) {
+ $this->NeedErrorBarColors(); // This plot needs error bar colors.
+ $custom_color = (bool)$this->GetCallback('data_color');
+ $num_data_colors = count($this->ndx_data_colors);
+ $num_error_colors = count($this->ndx_error_bar_colors);
+ $vars = compact('custom_color', 'num_data_colors', 'num_error_colors');
+ } else {
+ extract($vars);
+ }
+
+ // Select the colors.
+ if ($custom_color) {
+ $col_i = $this->DoCallback('data_color', $row, $idx, $extra); // Custom color index
+ $data_color = $this->ndx_data_colors[$col_i % $num_data_colors];
+ $error_color = $this->ndx_error_bar_colors[$col_i % $num_error_colors];
+ } else {
+ $data_color = $this->ndx_data_colors[$idx];
+ $error_color = $this->ndx_error_bar_colors[$idx];
+ }
+ }
+
+ /*
+ * Get colors to use for a bar chart. There is a data color, and either a border color
+ * or a shading color (data dark color).
+ * $row, $idx : Index arguments for the current bar.
+ * &$vars : Variable storage. Caller makes an empty array, and this function uses it.
+ * &$data_color : Returned result - Color index for the data (bar fill).
+ * &$alt_color : Returned result - Color index for the shading or outline.
+ */
+ protected function GetBarColors($row, $idx, &$vars, &$data_color, &$alt_color)
+ {
+ // Initialize or extract variables:
+ if (empty($vars)) {
+ if ($this->shading > 0) // This plot needs dark colors if shading is on.
+ $this->NeedDataDarkColors();
+ $custom_color = (bool)$this->GetCallback('data_color');
+ $num_data_colors = count($this->ndx_data_colors);
+ $num_border_colors = count($this->ndx_data_border_colors);
+ $vars = compact('custom_color', 'num_data_colors', 'num_border_colors');
+ } else {
+ extract($vars);
+ }
+
+ // Select the colors.
+ if ($custom_color) {
+ $col_i = $this->DoCallback('data_color', $row, $idx); // Custom color index
+ $i_data = $col_i % $num_data_colors; // Index for data colors and dark colors
+ $i_border = $col_i % $num_border_colors; // Index for data borders (if used)
+ } else {
+ $i_data = $i_border = $idx;
+ }
+ $data_color = $this->ndx_data_colors[$i_data];
+ if ($this->shading > 0) {
+ $alt_color = $this->ndx_data_dark_colors[$i_data];
+ } else {
+ $alt_color = $this->ndx_data_border_colors[$i_border];
+ }
+ }
+
+ /*
+ * Draw a shape (dot, point). This is the bottom half of DrawDot, and is also
+ * used by legend drawing. Unlike DrawDot this takes device coordinates.
+ * The list of supported shapes can also be found in SetPointShapes().
+ * $x, $y : Device coordinates of the center of the shape
+ * $record : Index into point_shapes[] and point_sizes[]. This is taken modulo the array sizes.
+ * $color : Color to use for the point shape
+ */
+ protected function DrawShape($x, $y, $record, $color)
+ {
+ $index = $record % $this->point_counts;
+ $point_size = $this->point_sizes[$index];
+ $half_point = (int)($point_size / 2);
+
+ $x1 = $x - $half_point;
+ $x2 = $x + $half_point;
+ $y1 = $y - $half_point;
+ $y2 = $y + $half_point;
+
+ switch ($this->point_shapes[$index]) {
+ case 'halfline':
+ ImageLine($this->img, $x1, $y, $x, $y, $color);
+ break;
+ case 'line':
+ ImageLine($this->img, $x1, $y, $x2, $y, $color);
+ break;
+ case 'plus':
+ ImageLine($this->img, $x1, $y, $x2, $y, $color);
+ ImageLine($this->img, $x, $y1, $x, $y2, $color);
+ break;
+ case 'cross':
+ ImageLine($this->img, $x1, $y1, $x2, $y2, $color);
+ ImageLine($this->img, $x1, $y2, $x2, $y1, $color);
+ break;
+ case 'circle':
+ ImageArc($this->img, $x, $y, $point_size, $point_size, 0, 360, $color);
+ break;
+ case 'dot':
+ ImageFilledEllipse($this->img, $x, $y, $point_size, $point_size, $color);
+ break;
+ case 'diamond':
+ $arrpoints = array($x1, $y, $x, $y1, $x2, $y, $x, $y2);
+ ImageFilledPolygon($this->img, $arrpoints, 4, $color);
+ break;
+ case 'triangle':
+ $arrpoints = array($x1, $y, $x2, $y, $x, $y2);
+ ImageFilledPolygon($this->img, $arrpoints, 3, $color);
+ break;
+ case 'trianglemid':
+ $arrpoints = array($x1, $y1, $x2, $y1, $x, $y);
+ ImageFilledPolygon($this->img, $arrpoints, 3, $color);
+ break;
+ case 'yield':
+ $arrpoints = array($x1, $y1, $x2, $y1, $x, $y2);
+ ImageFilledPolygon($this->img, $arrpoints, 3, $color);
+ break;
+ case 'delta':
+ $arrpoints = array($x1, $y2, $x2, $y2, $x, $y1);
+ ImageFilledPolygon($this->img, $arrpoints, 3, $color);
+ break;
+ case 'star':
+ ImageLine($this->img, $x1, $y, $x2, $y, $color);
+ ImageLine($this->img, $x, $y1, $x, $y2, $color);
+ ImageLine($this->img, $x1, $y1, $x2, $y2, $color);
+ ImageLine($this->img, $x1, $y2, $x2, $y1, $color);
+ break;
+ case 'hourglass':
+ $arrpoints = array($x1, $y1, $x2, $y1, $x1, $y2, $x2, $y2);
+ ImageFilledPolygon($this->img, $arrpoints, 4, $color);
+ break;
+ case 'bowtie':
+ $arrpoints = array($x1, $y1, $x1, $y2, $x2, $y1, $x2, $y2);
+ ImageFilledPolygon($this->img, $arrpoints, 4, $color);
+ break;
+ case 'target':
+ ImageFilledRectangle($this->img, $x1, $y1, $x, $y, $color);
+ ImageFilledRectangle($this->img, $x, $y, $x2, $y2, $color);
+ ImageRectangle($this->img, $x1, $y1, $x2, $y2, $color);
+ break;
+ case 'box':
+ ImageRectangle($this->img, $x1, $y1, $x2, $y2, $color);
+ break;
+ case 'home': /* As in: "home plate" (baseball), also looks sort of like a house. */
+ $arrpoints = array($x1, $y2, $x2, $y2, $x2, $y, $x, $y1, $x1, $y);
+ ImageFilledPolygon($this->img, $arrpoints, 5, $color);
+ break;
+ case 'up':
+ ImagePolygon($this->img, array($x, $y1, $x2, $y2, $x1, $y2), 3, $color);
+ break;
+ case 'down':
+ ImagePolygon($this->img, array($x, $y2, $x1, $y1, $x2, $y1), 3, $color);
+ break;
+ case 'none': /* Special case, no point shape here */
+ break;
+ default: /* Also 'rect' */
+ ImageFilledRectangle($this->img, $x1, $y1, $x2, $y2, $color);
+ break;
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draws a styled dot, or shape. Uses world coordinates.
+ * $row, $column : Which data point is being drawn. $column is also used to pick point shape and size.
+ * $x_world, $y_world : Data point, in world coordinates
+ * $color : Color to use for the point shape
+ * Note: DrawShape() does all the work. Plot drawing uses this; legend drawing uses DrawShape directly.
+ */
+ protected function DrawDot($row, $column, $x_world, $y_world, $color)
+ {
+ $x = $this->xtr($x_world);
+ $y = $this->ytr($y_world);
+ $result = $this->DrawShape($x, $y, $column, $color);
+ $this->DoCallback('data_points', 'dot', $row, $column, $x, $y);
+ return $result;
+ }
+
+ /*
+ * Draw a bar (or segment of a bar), with optional shading or border.
+ * This is used by the bar and stackedbar plots, vertical and horizontal.
+ * $row, $column : Which data point is being drawn, for data_points callback.
+ * $x1, $y1 : One corner of the bar.
+ * $x2, $y2 : Other corner of the bar.
+ * $data_color : Color index to use for the bar fill.
+ * $alt_color : Color index to use for the shading (if shading is on), else for the border.
+ * Note the same color is NOT used for shading and border - just the same argument.
+ * See GetBarColors() for where these arguments come from.
+ * $shade_top : Shade the top? (Suppressed for downward stack segments except first.)
+ * $shade_side : Shade the right side? (Suppressed for leftward stack segments except first.)
+ * Only one of $shade_top or $shade_side can be FALSE. Both default to TRUE.
+ */
+ protected function DrawBar($row, $column, $x1, $y1, $x2, $y2, $data_color, $alt_color,
+ $shade_top = TRUE, $shade_side = TRUE)
+ {
+ // Sort the points so x1,y1 is upper left and x2,y2 is lower right. This
+ // is needed in order to get the shading right, and imagerectangle may require it.
+ if ($x1 > $x2) {
+ $t = $x1; $x1 = $x2; $x2 = $t;
+ }
+ if ($y1 > $y2) {
+ $t = $y1; $y1 = $y2; $y2 = $t;
+ }
+
+ // Draw the bar
+ ImageFilledRectangle($this->img, $x1, $y1, $x2, $y2, $data_color);
+
+ // Draw a shade, or a border.
+ if (($shade = $this->shading) > 0) {
+ if ($shade_top && $shade_side) {
+ $npts = 6;
+ $pts = array($x1, $y1, $x1 + $shade, $y1 - $shade, $x2 + $shade, $y1 - $shade,
+ $x2 + $shade, $y2 - $shade, $x2, $y2, $x2, $y1);
+ } else {
+ $npts = 4;
+ if ($shade_top) { // Suppress side shading
+ $pts = array($x1, $y1, $x1 + $shade, $y1 - $shade, $x2 + $shade, $y1 - $shade, $x2, $y1);
+ } else { // Suppress top shading
+ $pts = array($x2, $y2, $x2, $y1, $x2 + $shade, $y1 - $shade, $x2 + $shade, $y2 - $shade);
+ }
+ }
+ ImageFilledPolygon($this->img, $pts, $npts, $alt_color);
+ } else {
+ ImageRectangle($this->img, $x1, $y1, $x2,$y2, $alt_color);
+ }
+ $this->DoCallback('data_points', 'rect', $row, $column, $x1, $y1, $x2, $y2);
+ return TRUE;
+ }
+
+ /*
+ * Draw an Error Bar set. Used by DrawDotsError and DrawLinesError
+ */
+ protected function DrawYErrorBar($x_world, $y_world, $error_height, $error_bar_type, $color)
+ {
+ $x1 = $this->xtr($x_world);
+ $y1 = $this->ytr($y_world);
+ $y2 = $this->ytr($y_world+$error_height) ;
+
+ ImageSetThickness($this->img, $this->error_bar_line_width);
+ ImageLine($this->img, $x1, $y1 , $x1, $y2, $color);
+ if ($error_bar_type == 'tee') {
+ ImageLine($this->img, $x1-$this->error_bar_size, $y2, $x1+$this->error_bar_size, $y2, $color);
+ }
+ ImageSetThickness($this->img, 1);
+ return TRUE;
+ }
+
+ /*
+ * Apply defaults for pie chart labels, if not set with SetPieLabelType(). Default type is percent,
+ * data format with 1 digit precision and % suffix. However, if Y label data precision is set, use
+ * that instead, for compatibility with PHPlot <= 5.5.0.
+ * Returns: $pie_label_source : copy of $this->pie_label_source if set, else default.
+ */
+ protected function CheckPieLabels()
+ {
+ if (empty($this->pie_label_source)) { // SetPieLabelType() was not called, or was reset to default
+ $prec = isset($this->label_format['y']['precision']) ? $this->label_format['y']['precision'] : 1;
+ $this->SetLabelType('p', array('data', $prec, '', '%'));
+ return array('percent'); // Default to 'percent' labels (leaving this->pie_label_source unset)
+ }
+ return $this->pie_label_source; // Use label type set set with SetPieLabelType()
+ }
+
+
+/////////////////////////////////////////////
+//////////////////// PLOT DRAWING
+/////////////////////////////////////////////
+
+ /*
+ * Draws a pie chart. Data type is 'text-data', 'data-data', or 'text-data-single'.
+ *
+ * For text-data-single, the data array contains records with a label and one Y value.
+ * Each record defines a sector of the pie, as a portion of the sum of all Y values.
+ * Data labels are ignored by default, but can be selected for display with SetPieLabelType().
+ *
+ * For text-data and data-data, the data array contains records with an ignored label,
+ * an ignored X value for data-data only, and N (N>=1) Y values per record.
+ * The pie chart will be produced with N segments. The relative size of the first
+ * sector of the pie is the sum of the first Y data value in each record, etc.
+ * The data labels cannot be used, since they don't map to specific pie sectors.
+ *
+ * If there are no valid positive data points at all, just draw nothing. It may seem more correct to
+ * raise an error, but all of the other plot types handle it this way implicitly. DrawGraph() checks
+ * for an empty data array, but this handles a non-empty data array with no Y values, or all Y=0.
+ */
+ protected function DrawPieChart()
+ {
+ // Early checks and initialization:
+ if (!$this->CheckDataType('text-data, text-data-single, data-data'))
+ return FALSE;
+
+ // SetLabelScalePosition(0 or FALSE) means no labels.
+ $do_labels = !empty($this->label_scale_position);
+ if ($do_labels) {
+ // Validate and get default for pie chart label source and format:
+ $pie_label_source = $this->CheckPieLabels();
+ // Labels outside (vs inside) the pie? If so, pie size will need adjusting.
+ $labels_outside = $this->label_scale_position >= 0.5; // Only defined if ($do_labels)
+ }
+
+ $max_data_colors = count($this->ndx_data_colors); // Number of colors available
+
+ // Check shading. Diameter factor $diam_factor is (height / width)
+ if ($this->shading > 0) {
+ $diam_factor = isset($this->pie_diam_factor) ? $this->pie_diam_factor : 0.5;
+ $this->NeedDataDarkColors(); // Dark colors are needed for shading
+ } else {
+ $diam_factor = 1.0; // Unshaded pies are always round, width == height
+ }
+
+ // Pie center point is always the center of the plot area, regardless of label sizes.
+ $xpos = $this->plot_area[0] + $this->plot_area_width/2;
+ $ypos = $this->plot_area[1] + $this->plot_area_height/2;
+
+ // Reduce the data array into sumarr[], accounting for the data type:
+ $num_slices = $this->data_columns; // See CheckDataArray which calculates this for us.
+ if ($num_slices < 1) return TRUE; // Give up early if there is no data at all.
+ $sumarr = array_fill(0, $num_slices, 0); // Initialize array of per-sector sums.
+
+ if ($this->datatype_pie_single) {
+ // text-data-single: One data column per row, one pie slice per row.
+ for ($i = 0; $i < $num_slices; $i++) {
+ if (is_numeric($val = $this->data[$i][1]))
+ $sumarr[$i] = abs($val);
+ }
+ } else {
+ // text-data: Sum each column (skipping label), one pie slice per column.
+ // data-data: Sum each column (skipping X value and label), one pie slice per column.
+ $skip = ($this->datatype_implied) ? 1 : 2; // Leading values to skip in each row.
+ for ($i = 0; $i < $this->num_data_rows; $i++) {
+ for ($j = $skip; $j < $this->num_recs[$i]; $j++) {
+ if (is_numeric($val = $this->data[$i][$j]))
+ $sumarr[$j-$skip] += abs($val);
+ }
+ }
+ }
+
+ $total = array_sum($sumarr);
+ if ($total == 0) {
+ // There are either no valid data points, or all are 0.
+ // See top comment about why not to make this an error.
+ return TRUE;
+ }
+
+ // Pre-calculate the label strings, if labels are on. Also get the maximum height and width
+ // of the labels, to use in sizing the pie chart (if the labels are outside the pie).
+ // This is an overly pessimistic approach - assumes the widest label is at 0 or 180 degrees - but
+ // is much easier than calculating the exact space needed for all labels around the pie.
+ // For more detailed comments on the in-loop calculations, see the second loop below where
+ // the features are actually drawn.
+ // Note this is going around the pie, with angles specified, but we do not yet know the pie size.
+
+ $label_max_width = 0; // Widest label width, in pixels
+ $label_max_height = 0; // Tallest label height, in pixels
+ if ($do_labels) {
+ $labels = array(); // Store the formatted label strings
+ $end_angle = 0;
+ for ($j = 0; $j < $num_slices; $j++) {
+ $slice_weight = $sumarr[$j];
+ $arc_angle = 360 * $slice_weight / $total;
+ $start_angle = $end_angle;
+ $end_angle += $arc_angle;
+ $arc_start_angle = (int)(360 - $start_angle);
+ $arc_end_angle = (int)(360 - $end_angle);
+ if ($arc_start_angle > $arc_end_angle) { // Skip segments with angle < 1 degree
+ $labels[$j] = $this->FormatPieLabel($j, $pie_label_source, $arc_angle, $slice_weight);
+ if ($labels_outside) { // Labels are outside the pie chart
+ list($width, $height) = $this->SizeText($this->fonts['generic'], 0, $labels[$j]);
+ if ($width > $label_max_width) $label_max_width = $width;
+ if ($height > $label_max_height) $label_max_height = $height;
+ }
+ }
+ }
+ }
+
+ // Calculate the maximum available area for the pie, leaving room for labels (if outside the pie):
+ // This can be overridden by using SetPieAutoSize(FALSE), which sets the flag: pie_full_size=TRUE.
+ if ($do_labels && $labels_outside && empty($this->pie_full_size)) {
+ // There needs to be safe_margin between the labels and the plot area margins, and at least
+ // safe_margin between the labels and the pie edge (this is LR_marg and TB_marg below).
+ // plot_area_width = avail_width + 2 * (LR_marg + label_width + safe_margin)
+ // Where LR_marg = max(safe_margin, avail_width * label_scale_position - avail_width/2)
+ // plot_area_height = avail_height + 2 * (TB_marg + label_height + safe_margin + shading)
+ // Where TB_marg = max(safe_margin, avail_height * label_scale_position - avail_height/2)
+ // Note shading is on bottom only, but since center is fixed, it is counted on top too.
+ // Note (avail_width * label_scale_position) is the distance from the pie center to the label
+ // text base point. Subtract avail_width/2 to get the inner margin (unless it is too small).
+ // Similar for Y: avail_height * label_scale_position - avail_height/2 is the distance from
+ // the pie center up to the label text base point.
+
+ // Calculate available space for both values of LR_marg, TB_marg and take the smaller ones.
+ $avail_width = min(
+ ($this->plot_area_width / 2 - $label_max_width - $this->safe_margin) /
+ $this->label_scale_position,
+ $this->plot_area_width - 4 * $this->safe_margin - 2 * $label_max_width);
+
+ $avail_height = min(
+ ($this->plot_area_height / 2 - $label_max_height - $this->safe_margin - $this->shading) /
+ $this->label_scale_position,
+ $this->plot_area_height - 4*$this->safe_margin - 2*($label_max_height + $this->shading));
+
+ // Sanity check - don't let large labels shrink the pie too much.
+ $min_size_factor = isset($this->pie_min_size_factor) ? $this->pie_min_size_factor : 0.5;
+ $avail_width = max($avail_width, $min_size_factor * $this->plot_area_width);
+ $avail_height = max($avail_height, $min_size_factor * $this->plot_area_height);
+ } else { // No adjustment needed for labels
+ $avail_width = $this->plot_area_width - 2 * $this->safe_margin;
+ // Note shading is only on bottom, but need to subtract 2x because center does not move.
+ $avail_height = $this->plot_area_height - 2 * ($this->safe_margin + $this->shading);
+ }
+
+ // Calculate the pie width and height for the best fit, given diam_factor and available space:
+ if ($avail_height / $avail_width > $diam_factor) {
+ $pie_width = $avail_width;
+ $pie_height = $pie_width * $diam_factor;
+ } else {
+ $pie_height = $avail_height;
+ $pie_width = $pie_height / $diam_factor;
+ }
+
+ // Factors used to calculate label positions by DrawPieLabel(). See there for explanation.
+ if ($do_labels) {
+ $r['reverse'] = 0.25 < $this->label_scale_position && $this->label_scale_position < 0.5;
+ $r['x'] = $pie_width * $this->label_scale_position;
+ $r['y'] = $pie_height * $this->label_scale_position;
+ if ($labels_outside) {
+ // Don't let outside labels touch the pie edge - move them out a bit:
+ $r['x'] = max($r['x'], $pie_width / 2 + $this->safe_margin);
+ $r['y'] = max($r['y'], $pie_height / 2 + $this->safe_margin);
+ } else {
+ // Don't let inside labels touch the pie edge - move them in a bit:
+ $r['x'] = min($r['x'], $pie_width / 2 - $this->safe_margin);
+ $r['y'] = min($r['y'], $pie_height / 2 - $this->safe_margin);
+ }
+ }
+
+ // Draw the pie. For shaded pies, draw one set for each shading level ($h).
+ for ($h = $this->shading; $h >= 0; $h--) {
+ $color_index = 0;
+ $end_angle = 0;
+ for ($j = 0; $j < $num_slices; $j++) {
+ $slice_weight = $sumarr[$j];
+ $arc_angle = 360 * $slice_weight / $total;
+
+ // For shaded pies: the last one (at the top of the "stack") has a brighter color:
+ if ($h == 0)
+ $slicecol = $this->ndx_data_colors[$color_index];
+ else
+ $slicecol = $this->ndx_data_dark_colors[$color_index];
+
+ // Note that imagefilledarc() fills clockwise from start to end angles.
+ // Also note imagefilledarc() only takes angles in integer degrees. If the start and
+ // end angles match, you would get a full circle. So skip any wedge with integer angle = 0.
+ // To avoid cumulative error, keep the running total as a float, and round the angles.
+ $start_angle = $end_angle;
+ $end_angle += $arc_angle;
+ // This method of conversion to integer - truncate after reversing it - was
+ // chosen to match the implicit method of PHPlot<=5.0.4, to get the exact same slices.
+ $arc_start_angle = (int)(360 - $start_angle);
+ $arc_end_angle = (int)(360 - $end_angle);
+
+ if ($arc_start_angle > $arc_end_angle) {
+ // Draw the slice
+ ImageFilledArc($this->img, $xpos, $ypos+$h, $pie_width, $pie_height,
+ $arc_end_angle, $arc_start_angle, $slicecol, IMG_ARC_PIE);
+
+ // Processing to do only for the last (if shaded) or only (if unshaded) loop:
+ if ($h == 0) {
+ // For unshaded pie charts, draw the outline:
+ if ($this->shading == 0)
+ ImageFilledArc($this->img, $xpos, $ypos, $pie_width, $pie_height,
+ $arc_end_angle, $arc_start_angle, $this->ndx_grid_color,
+ IMG_ARC_PIE | IMG_ARC_EDGED |IMG_ARC_NOFILL);
+ // Draw the label:
+ if ($do_labels)
+ $this->DrawPieLabel($labels[$j], $xpos, $ypos, $start_angle, $arc_angle, $r);
+ // Trigger a data points callback; note it gets the 'modified' angles:
+ $this->DoCallback('data_points', 'pie', $j, 0, $xpos, $ypos, $pie_width,
+ $pie_height, $arc_start_angle, $arc_end_angle);
+ }
+ }
+ if (++$color_index >= $max_data_colors)
+ $color_index = 0;
+ } // end loop for each slice
+ } // end loop for each level of shading
+ return TRUE;
+ }
+
+ /*
+ * Draw the points and errors bars for an error plot of types points and linepoints
+ * Supports only data-data-error format, with each row of the form
+ * array("title", x, y1, error1+, error1-, y2, error2+, error2-, ...)
+ * This is called from DrawDots, with data type already checked.
+ * $paired is true for linepoints error plots, to make sure elements are
+ * only drawn once. If true, data labels are drawn by DrawLinesError, and error
+ * bars are drawn by DrawDotsError. (This choice is for backwards compatibility.)
+ */
+ protected function DrawDotsError($paired = FALSE)
+ {
+ // Adjust the point shapes and point sizes arrays:
+ $this->CheckPointParams();
+
+ $gcvars = array(); // For GetDataErrorColors, which initializes and uses this.
+ // Special flag for data color callback to indicate the 'points' part of 'linepoints':
+ $alt_flag = $paired ? 1 : 0;
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (title)
+
+ $x_now = $this->data[$row][$record++]; // Read it, advance record index
+
+ $x_now_pixels = $this->xtr($x_now); // Absolute coordinates.
+
+ // Draw X Data labels?
+ if ($this->x_data_label_pos != 'none' && !$paired)
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row, TRUE);
+
+ // Now go for Y, E+, E-
+ for ($idx = 0; $record < $this->num_recs[$row]; $idx++) {
+ if (is_numeric($y_now = $this->data[$row][$record++])) { // Allow for missing Y data
+
+ // Select the colors:
+ $this->GetDataErrorColors($row, $idx, $gcvars, $data_color, $error_color, $alt_flag);
+
+ // Draw the shape:
+ $this->DrawDot($row, $idx, $x_now, $y_now, $data_color);
+
+ // Error +
+ $val = $this->data[$row][$record++];
+ $this->DrawYErrorBar($x_now, $y_now, $val, $this->error_bar_shape, $error_color);
+ // Error -
+ $val = $this->data[$row][$record++];
+ $this->DrawYErrorBar($x_now, $y_now, -$val, $this->error_bar_shape, $error_color);
+ } else {
+ $record += 2; // Skip over error value positions for missing Y
+ }
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a points plot, or the points for a linepoints plot
+ * Data format can be text-data (label, y1, y2, ...) or data-data (label, x, y1, y2, ...)
+ * Points plot with error bars (data-data-error format) is redirected to DrawDotsError.
+ * $paired is true for linepoints plots, to make sure elements are only drawn once.
+ */
+ protected function DrawDots($paired = FALSE)
+ {
+ if (!$this->CheckDataType('text-data, data-data, data-data-error'))
+ return FALSE;
+ if ($this->datatype_error_bars)
+ return $this->DrawDotsError($paired); // Redirect for points+errorbars plot
+
+ // Adjust the point shapes and point sizes arrays:
+ $this->CheckPointParams();
+
+ $gcvars = array(); // For GetDataColor, which initializes and uses this.
+ // Special flag for data color callback to indicate the 'points' part of 'linepoints':
+ $alt_flag = $paired ? 1 : 0;
+
+ // Data Value Labels? (Skip if doing the points from a linepoints plot)
+ $do_dvls = !$paired && $this->CheckDataValueLabels($this->y_data_label_pos, $dvl);
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $rec = 1; // Skip record #0 (data label)
+
+ if ($this->datatype_implied) // Implied X values?
+ $x_now = 0.5 + $row; // Place text-data at X = 0.5, 1.5, 2.5, etc...
+ else
+ $x_now = $this->data[$row][$rec++]; // Read it, advance record index
+
+ $x_now_pixels = $this->xtr($x_now);
+
+ // Draw X Data labels?
+ if (!$paired && $this->x_data_label_pos != 'none')
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row, TRUE);
+
+ // Proceed with Y values
+ for ($idx = 0;$rec < $this->num_recs[$row]; $rec++, $idx++) {
+ if (is_numeric($y_now = $this->data[$row][$rec])) { // Allow for missing Y data
+
+ // Select the color:
+ $this->GetDataColor($row, $idx, $gcvars, $data_color, $alt_flag);
+ // Draw the marker:
+ $this->DrawDot($row, $idx, $x_now, $y_now, $data_color);
+
+ // Draw data value labels?
+ if ($do_dvls)
+ $this->DrawDataValueLabel('y', $row, $idx, $x_now, $y_now, $y_now, $dvl);
+ }
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a Thin Bar Line plot, also known as an Impulse plot.
+ * A clean, fast routine for when you just want charts like stock volume charts.
+ * Supports data-data and text-data formats for vertical plots,
+ * and data-data-yx and text-data-yx for horizontal plots.
+ * Note that although this plot type supports multiple data sets, it rarely makes
+ * sense to have more than 1, because the lines will overlay.
+ * This one function does both vertical and horizontal plots. "iv" is used for the
+ * independent variable (X for vertical plots, Y for horizontal) and "dv" is used
+ * for the dependent variable (Y for vertical plots, X for horizontal).
+ */
+ protected function DrawThinBarLines()
+ {
+ if (!$this->CheckDataType('text-data, data-data, text-data-yx, data-data-yx'))
+ return FALSE;
+
+ $gcvars = array(); // For GetDataColor, which initializes and uses this.
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $rec = 1; // Skip record #0 (data label)
+
+ if ($this->datatype_implied) // Implied independent variable values?
+ $iv_now = 0.5 + $row; // Place text-data at 0.5, 1.5, 2.5, etc...
+ else
+ $iv_now = $this->data[$row][$rec++]; // Read it, advance record index
+
+ if ($this->datatype_swapped_xy) {
+ $y_now_pixels = $this->ytr($iv_now);
+ // Draw Y Data labels?
+ if ($this->y_data_label_pos != 'none')
+ $this->DrawYDataLabel($this->data[$row][0], $y_now_pixels, $row);
+ } else {
+ $x_now_pixels = $this->xtr($iv_now);
+ // Draw X Data labels?
+ if ($this->x_data_label_pos != 'none')
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row);
+ }
+
+ // Proceed with dependent values
+ for ($idx = 0; $rec < $this->num_recs[$row]; $rec++, $idx++) {
+ if (is_numeric($dv = $this->data[$row][$rec])) { // Allow for missing data
+ ImageSetThickness($this->img, $this->line_widths[$idx]);
+
+ // Select the color:
+ $this->GetDataColor($row, $idx, $gcvars, $data_color);
+
+ if ($this->datatype_swapped_xy) {
+ // Draw a line from user defined y axis position right (or left) to xtr($dv)
+ ImageLine($this->img, $this->y_axis_x_pixels, $y_now_pixels,
+ $this->xtr($dv), $y_now_pixels, $data_color);
+ } else {
+ // Draw a line from user defined x axis position up (or down) to ytr($dv)
+ ImageLine($this->img, $x_now_pixels, $this->x_axis_y_pixels,
+ $x_now_pixels, $this->ytr($dv), $data_color);
+ }
+ }
+ }
+ }
+
+ ImageSetThickness($this->img, 1);
+ return TRUE;
+ }
+
+ /*
+ * Draw an 'area' or 'stacked area' plot.
+ * Both of these fill the area between lines, but in the stacked area graph the Y values
+ * are accumulated for each X, same as stacked bars. In the regular area graph, the areas
+ * are filled in order from the X axis up to each Y (so the Y values for each X need to be
+ * in decreasing order in this case).
+ * Data format can be text-data (label, y1, y2, ...) or data-data (label, x, y1, y2, ...)
+ * Notes:
+ * All Y values must be >= 0. (If any Y<0 the absolute value is used.)
+ * Missing data points are NOT handled. (They are counted as 0.)
+ * All rows must have the same number of Y points, or an error image will be produced.
+ */
+ protected function DrawArea($do_stacked = FALSE)
+ {
+ if (!$this->CheckDataType('text-data, data-data'))
+ return FALSE;
+
+ $n = $this->num_data_rows; // Number of X values
+ if ($n < 2) return TRUE; // Require at least 2 rows, for imagefilledpolygon().
+
+ // These arrays store the device X and Y coordinates for all lines:
+ $xd = array();
+ $yd = array();
+
+ // Make sure each row has the same number of values. Note records_per_group is max(num_recs).
+ if ($this->records_per_group != min($this->num_recs)) {
+ return $this->PrintError("DrawArea(): Data array must contain the same number"
+ . " of Y values for each X");
+ }
+
+ // Calculate the Y value for each X, and store the device
+ // coordinates into the xd and yd arrays.
+ // For stacked area plots, the Y values accumulate.
+ for ($row = 0; $row < $n; $row++) {
+ $rec = 1; // Skip record #0 (data label)
+
+ if ($this->datatype_implied) // Implied X values?
+ $x_now = 0.5 + $row; // Place text-data at X = 0.5, 1.5, 2.5, etc...
+ else
+ $x_now = $this->data[$row][$rec++]; // Read it, advance record index
+
+ $x_now_pixels = $this->xtr($x_now);
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row);
+
+ // Store the X value.
+ // There is an artificial Y value at the axis. For 'area' it goes
+ // at the end; for stackedarea it goes before the start.
+ $xd[$row] = $x_now_pixels;
+ $yd[$row] = array();
+ if ($do_stacked)
+ $yd[$row][] = $this->x_axis_y_pixels;
+
+ // Store the Y values for this X.
+ // All Y values are clipped to the x axis which should be zero but can be moved.
+ $y = 0;
+ while ($rec < $this->records_per_group) {
+ if (is_numeric($y_now = $this->data[$row][$rec++])) // Treat missing values as 0.
+ $y += abs($y_now);
+ $yd[$row][] = $this->ytr(max($this->x_axis_position, $y));
+ if (!$do_stacked) $y = 0;
+ }
+
+ if (!$do_stacked)
+ $yd[$row][] = $this->x_axis_y_pixels;
+ }
+
+ // Now draw the filled polygons.
+ // Note data_columns is the number of Y points (columns excluding label and X), and the
+ // number of entries in the yd[] arrays is data_columns+1.
+ $prev_row = 0;
+ for ($row = 1; $row <= $this->data_columns; $row++) { // 1 extra for X axis artificial row
+ $pts = array();
+ // Previous data set forms top (for area) or bottom (for stackedarea):
+ for ($j = 0; $j < $n; $j++) {
+ $pts[] = $xd[$j];
+ $pts[] = $yd[$j][$prev_row];
+ }
+ // Current data set forms bottom (for area) or top (for stackedarea):
+ for ($j = $n- 1; $j >= 0; $j--) {
+ $pts[] = $xd[$j];
+ $pts[] = $yd[$j][$row];
+ }
+ // Draw it:
+ ImageFilledPolygon($this->img, $pts, $n * 2, $this->ndx_data_colors[$prev_row]);
+
+ $prev_row = $row;
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a line plot, or the lines part of a linepoints plot
+ * Data format can be text-data (label, y1, y2, ...) or data-data (label, x, y1, y2, ...)
+ * Line plot with error bars (data-data-error format) is redirected to DrawLinesError.
+ * $paired is true for linepoints plots, to make sure elements are only drawn once.
+ */
+ protected function DrawLines($paired = FALSE)
+ {
+ if (!$this->CheckDataType('text-data, data-data, data-data-error'))
+ return FALSE;
+ if ($this->datatype_error_bars)
+ return $this->DrawLinesError($paired); // Redirect for lines+errorbar plot
+
+ // Flag array telling if the current point is valid, one element per plot line.
+ // If start_lines[i] is true, then (lastx[i], lasty[i]) is the previous point.
+ if ($this->data_columns == 0) return TRUE; // No data to plot; prevent array_fill error.
+ $start_lines = array_fill(0, $this->data_columns, FALSE);
+
+ $gcvars = array(); // For GetDataColor, which initializes and uses this.
+
+ // Data Value Labels?
+ $do_dvls = $this->CheckDataValueLabels($this->y_data_label_pos, $dvl);
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ if ($this->datatype_implied) // Implied X values?
+ $x_now = 0.5 + $row; // Place text-data at X = 0.5, 1.5, 2.5, etc...
+ else
+ $x_now = $this->data[$row][$record++]; // Read it, advance record index
+
+ $x_now_pixels = $this->xtr($x_now); // Absolute coordinates
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row, TRUE);
+
+ for ($idx = 0; $record < $this->num_recs[$row]; $record++, $idx++) {
+ if (($line_style = $this->line_styles[$idx]) == 'none')
+ continue; //Allow suppressing entire line, useful with linepoints
+ if (is_numeric($y_now = $this->data[$row][$record])) { //Allow for missing Y data
+ $y_now_pixels = $this->ytr($y_now);
+
+ if ($start_lines[$idx]) {
+ // Set line width, revert it to normal at the end
+ ImageSetThickness($this->img, $this->line_widths[$idx]);
+
+ // Select the color:
+ $this->GetDataColor($row, $idx, $gcvars, $data_color);
+
+ if ($line_style == 'dashed') {
+ $this->SetDashedStyle($data_color);
+ $data_color = IMG_COLOR_STYLED;
+ }
+ ImageLine($this->img, $x_now_pixels, $y_now_pixels,
+ $lastx[$idx], $lasty[$idx], $data_color);
+ }
+
+ // Draw data value labels?
+ if ($do_dvls)
+ $this->DrawDataValueLabel('y', $row, $idx, $x_now, $y_now, $y_now, $dvl);
+
+ $lasty[$idx] = $y_now_pixels;
+ $lastx[$idx] = $x_now_pixels;
+ $start_lines[$idx] = TRUE;
+ } elseif ($this->draw_broken_lines) { // Y data missing, leave a gap.
+ $start_lines[$idx] = FALSE;
+ }
+ } // end for
+ } // end for
+
+ ImageSetThickness($this->img, 1); // Revert to original state for lines to be drawn later.
+ return TRUE;
+ }
+
+ /*
+ * Draw lines with error bars for an error plot of types lines and linepoints
+ * Supports only data-data-error format, with each row of the form
+ * array("title", x, y1, error1+, error1-, y2, error2+, error2-, ...)
+ * This is called from DrawLines, with data type already checked.
+ * $paired is true for linepoints error plots, to make sure elements are
+ * only drawn once. If true, data labels are drawn by DrawLinesError, and error
+ * bars are drawn by DrawDotsError. (This choice is for backwards compatibility.)
+ */
+ protected function DrawLinesError($paired = FALSE)
+ {
+ if ($this->data_columns == 0) return TRUE; // No data to plot; prevent array_fill error.
+ $start_lines = array_fill(0, $this->data_columns, FALSE);
+
+ $gcvars = array(); // For GetDataErrorColors, which initializes and uses this.
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ $x_now = $this->data[$row][$record++]; // Read X value, advance record index
+
+ $x_now_pixels = $this->xtr($x_now); // Absolute coordinates.
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row, TRUE);
+
+ // Now go for Y, E+, E-
+ for ($idx = 0; $record < $this->num_recs[$row]; $idx++) {
+ if (($line_style = $this->line_styles[$idx]) == 'none')
+ continue; //Allow suppressing entire line, useful with linepoints
+ if (is_numeric($y_now = $this->data[$row][$record++])) { // Allow for missing Y data
+
+ // Select the colors:
+ $this->GetDataErrorColors($row, $idx, $gcvars, $data_color, $error_color);
+
+ // Y
+ $y_now_pixels = $this->ytr($y_now);
+
+ if ($start_lines[$idx]) {
+ ImageSetThickness($this->img, $this->line_widths[$idx]);
+
+ if ($line_style == 'dashed') {
+ $this->SetDashedStyle($data_color);
+ $data_color = IMG_COLOR_STYLED;
+ }
+ ImageLine($this->img, $x_now_pixels, $y_now_pixels,
+ $lastx[$idx], $lasty[$idx], $data_color);
+ }
+
+ if ($paired) {
+ $record += 2; // Skip error bars - done in the 'points' part of 'linepoints'.
+ } else {
+ // Error+
+ $val = $this->data[$row][$record++];
+ $this->DrawYErrorBar($x_now, $y_now, $val, $this->error_bar_shape, $error_color);
+
+ // Error-
+ $val = $this->data[$row][$record++];
+ $this->DrawYErrorBar($x_now, $y_now, -$val, $this->error_bar_shape, $error_color);
+ }
+
+ // Update indexes:
+ $start_lines[$idx] = TRUE; // Tells us if we already drew the first column of points,
+ // thus having $lastx and $lasty ready for the next column.
+ $lastx[$idx] = $x_now_pixels;
+ $lasty[$idx] = $y_now_pixels;
+
+ } else {
+ $record += 2; // Skip over error value positions for missing Y
+ if ($this->draw_broken_lines) {
+ $start_lines[$idx] = FALSE;
+ }
+ }
+ } // end for
+ } // end for
+
+ ImageSetThickness($this->img, 1); // Revert to original state for lines to be drawn later.
+ return TRUE;
+ }
+
+ /*
+ * Draw a Lines+Points plot (linepoints).
+ * This just uses DrawLines and DrawDots. They handle the error-bar case themselves.
+ */
+ protected function DrawLinePoints()
+ {
+ // This check is redundant, as DrawLines and DrawDots do it, but left here as insurance.
+ if (!$this->CheckDataType('text-data, data-data, data-data-error'))
+ return FALSE;
+ $this->DrawLines(TRUE);
+ $this->DrawDots(TRUE);
+ return TRUE;
+ }
+
+ /*
+ * Draw a Squared Line plot.
+ * Data format can be text-data (label, y1, y2, ...) or data-data (label, x, y1, y2, ...)
+ * This is based on DrawLines(), with one more line drawn for each point.
+ */
+ protected function DrawSquared()
+ {
+ if (!$this->CheckDataType('text-data, data-data'))
+ return FALSE;
+
+ if ($this->data_columns == 0) return TRUE; // No data to plot; prevent array_fill error.
+ // Flag array telling if the current point is valid, one element per plot line.
+ // If start_lines[i] is true, then (lastx[i], lasty[i]) is the previous point.
+ $start_lines = array_fill(0, $this->data_columns, FALSE);
+
+ $gcvars = array(); // For GetDataColor, which initializes and uses this.
+
+ // Data Value Labels?
+ $do_dvls = $this->CheckDataValueLabels($this->y_data_label_pos, $dvl);
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ if ($this->datatype_implied) // Implied X values?
+ $x_now = 0.5 + $row; // Place text-data at X = 0.5, 1.5, 2.5, etc...
+ else
+ $x_now = $this->data[$row][$record++]; // Read it, advance record index
+
+ $x_now_pixels = $this->xtr($x_now); // Absolute coordinates
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row);
+
+ // Draw Lines
+ for ($idx = 0; $record < $this->num_recs[$row]; $record++, $idx++) {
+ if (is_numeric($y_now = $this->data[$row][$record])) { // Allow for missing Y data
+ $y_now_pixels = $this->ytr($y_now);
+
+ if ($start_lines[$idx]) {
+ // Set line width, revert it to normal at the end
+ ImageSetThickness($this->img, $this->line_widths[$idx]);
+
+ // Select the color:
+ $this->GetDataColor($row, $idx, $gcvars, $data_color);
+
+ if ($this->line_styles[$idx] == 'dashed') {
+ $this->SetDashedStyle($data_color);
+ $data_color = IMG_COLOR_STYLED;
+ }
+ ImageLine($this->img, $lastx[$idx], $lasty[$idx],
+ $x_now_pixels, $lasty[$idx], $data_color);
+ ImageLine($this->img, $x_now_pixels, $lasty[$idx],
+ $x_now_pixels, $y_now_pixels, $data_color);
+ }
+
+ // Draw data value labels?
+ if ($do_dvls)
+ $this->DrawDataValueLabel('y', $row, $idx, $x_now, $y_now, $y_now, $dvl);
+
+ $lastx[$idx] = $x_now_pixels;
+ $lasty[$idx] = $y_now_pixels;
+ $start_lines[$idx] = TRUE;
+ } elseif ($this->draw_broken_lines) { // Y data missing, leave a gap.
+ $start_lines[$idx] = FALSE;
+ }
+ }
+ } // end while
+
+ ImageSetThickness($this->img, 1);
+ return TRUE;
+ }
+
+ /*
+ * Draw a Bar chart
+ * Supports text-data format, with each row in the form array(label, y1, y2, y3, ...)
+ * Horizontal bars (text-data-yx format) are sent to DrawHorizBars() instead.
+ */
+ protected function DrawBars()
+ {
+ if (!$this->CheckDataType('text-data, text-data-yx'))
+ return FALSE;
+ if ($this->datatype_swapped_xy)
+ return $this->DrawHorizBars();
+ $this->CalcBarWidths(FALSE, TRUE); // Calculate bar widths for unstacked, vertical
+
+ // This is the X offset from the bar group's label center point to the left side of the first bar
+ // in the group. See also CalcBarWidths above.
+ $x_first_bar = ($this->data_columns * $this->record_bar_width) / 2 - $this->bar_adjust_gap;
+
+ $gcvars = array(); // For GetBarColors, which initializes and uses this.
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ $x_now_pixels = $this->xtr(0.5 + $row); // Place text-data at X = 0.5, 1.5, 2.5, etc...
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row);
+
+ // Lower left X of first bar in the group:
+ $x1 = $x_now_pixels - $x_first_bar;
+
+ // Draw the bars in the group:
+ for ($idx = 0; $record < $this->num_recs[$row]; $record++, $idx++) {
+ if (is_numeric($y = $this->data[$row][$record])) { // Allow for missing Y data
+ $x2 = $x1 + $this->actual_bar_width;
+
+ if (($upgoing_bar = $y >= $this->x_axis_position)) {
+ $y1 = $this->ytr($y);
+ $y2 = $this->x_axis_y_pixels;
+ } else {
+ $y1 = $this->x_axis_y_pixels;
+ $y2 = $this->ytr($y);
+ }
+
+ // Select the colors:
+ $this->GetBarColors($row, $idx, $gcvars, $data_color, $alt_color);
+
+ // Draw the bar, and the shade or border:
+ $this->DrawBar($row, $idx, $x1, $y1, $x2, $y2, $data_color, $alt_color);
+
+ // Draw optional data value label above or below the bar:
+ if ($this->y_data_label_pos == 'plotin') {
+ $dvl['x_offset'] = ($idx + 0.5) * $this->record_bar_width - $x_first_bar;
+ if ($upgoing_bar) {
+ $dvl['v_align'] = 'bottom';
+ $dvl['y_offset'] = -5 - $this->shading;
+ } else {
+ $dvl['v_align'] = 'top';
+ $dvl['y_offset'] = 2;
+ }
+ $this->DrawDataValueLabel('y', $row, $idx, $row+0.5, $y, $y, $dvl);
+ }
+ }
+ // Step to next bar in group:
+ $x1 += $this->record_bar_width;
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a Horizontal Bar chart
+ * Supports only text-data-yx format, with each row in the form array(label, x1, x2, x3, ...)
+ * Note that the data values are X not Y, and the bars are drawn horizontally.
+ * This is called from DrawBars, which has already checked the data type.
+ */
+ protected function DrawHorizBars()
+ {
+ $this->CalcBarWidths(FALSE, FALSE); // Calculate bar widths for unstacked, vertical
+
+ // This is the Y offset from the bar group's label center point to the bottom of the first bar
+ // in the group. See also CalcBarWidths above.
+ $y_first_bar = ($this->data_columns * $this->record_bar_width) / 2 - $this->bar_adjust_gap;
+
+ $gcvars = array(); // For GetBarColors, which initializes and uses this.
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ $y_now_pixels = $this->ytr(0.5 + $row); // Place bars at Y=0.5, 1.5, 2.5, etc...
+
+ if ($this->y_data_label_pos != 'none') // Draw Y Data Labels?
+ $this->DrawYDataLabel($this->data[$row][0], $y_now_pixels, $row);
+
+ // Lower left Y of first bar in the group:
+ $y1 = $y_now_pixels + $y_first_bar;
+
+ // Draw the bars in the group:
+ for ($idx = 0; $record < $this->num_recs[$row]; $record++, $idx++) {
+ if (is_numeric($x = $this->data[$row][$record])) { // Allow for missing X data
+ $y2 = $y1 - $this->actual_bar_width;
+
+ if (($rightwards_bar = $x >= $this->y_axis_position)) {
+ $x1 = $this->xtr($x);
+ $x2 = $this->y_axis_x_pixels;
+ } else {
+ $x1 = $this->y_axis_x_pixels;
+ $x2 = $this->xtr($x);
+ }
+
+ // Select the colors:
+ $this->GetBarColors($row, $idx, $gcvars, $data_color, $alt_color);
+
+ // Draw the bar, and the shade or border:
+ $this->DrawBar($row, $idx, $x1, $y1, $x2, $y2, $data_color, $alt_color);
+
+ // Draw optional data value label to the right or left of the bar:
+ if ($this->x_data_label_pos == 'plotin') {
+ $dvl['y_offset'] = $y_first_bar - ($idx + 0.5) * $this->record_bar_width;
+ if ($rightwards_bar) {
+ $dvl['h_align'] = 'left';
+ $dvl['x_offset'] = 5 + $this->shading;
+ } else {
+ $dvl['h_align'] = 'right';
+ $dvl['x_offset'] = -2;
+ }
+ $this->DrawDataValueLabel('x', $row, $idx, $x, $row+0.5, $x, $dvl);
+ }
+ }
+ // Step to next bar in group:
+ $y1 -= $this->record_bar_width;
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a Stacked Bar chart
+ * Supports text-data format, with each row in the form array(label, y1, y2, y3, ...)
+ * Horizontal stacked bars (text-data-yx format) are sent to DrawHorizStackedBars() instead.
+ * Original stacked bars idea by Laurent Kruk < lolok at users.sourceforge.net >
+ */
+ protected function DrawStackedBars()
+ {
+ if (!$this->CheckDataType('text-data, text-data-yx'))
+ return FALSE;
+ if ($this->datatype_swapped_xy)
+ return $this->DrawHorizStackedBars();
+ $this->CalcBarWidths(TRUE, TRUE); // Calculate bar widths for stacked, vertical
+
+ // This is the X offset from the bar's label center point to the left side of the bar.
+ $x_first_bar = $this->record_bar_width / 2 - $this->bar_adjust_gap;
+
+ $gcvars = array(); // For GetBarColors, which initializes and uses this.
+
+ // Determine if any data labels are on:
+ $data_labels_within = ($this->y_data_label_pos == 'plotstack');
+ $data_labels_end = $data_labels_within || ($this->y_data_label_pos == 'plotin');
+ $data_label_y_offset = -5 - $this->shading; // For upward labels only.
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ $x_now_pixels = $this->xtr(0.5 + $row); // Place text-data at X = 0.5, 1.5, 2.5, etc...
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row);
+
+ // Determine bar direction based on 1st non-zero value. Note the bar direction is
+ // based on zero, not the axis value.
+ $n_recs = $this->num_recs[$row];
+ $upward = TRUE; // Initialize this for the case of all segments = 0
+ for ($i = $record; $i < $n_recs; $i++) {
+ if (is_numeric($this_y = $this->data[$row][$i]) && $this_y != 0) {
+ $upward = ($this_y > 0);
+ break;
+ }
+ }
+
+ $x1 = $x_now_pixels - $x_first_bar; // Left X of bars in this stack
+ $x2 = $x1 + $this->actual_bar_width; // Right X of bars in this stack
+ $wy1 = 0; // World coordinates Y1, current sum of values
+ $wy2 = $this->x_axis_position; // World coordinates Y2, last drawn value
+
+ // Draw bar segments and labels in this stack.
+ $first = TRUE;
+ for ($idx = 0; $record < $n_recs; $record++, $idx++) {
+
+ // Skip missing Y values. Process Y=0 values due to special case of moved axis.
+ if (is_numeric($this_y = $this->data[$row][$record])) {
+
+ $wy1 += $this_y; // Keep the running total for this bar stack
+
+ // Draw the segment only if it will increase the stack height (ignore if wrong direction):
+ if (($upward && $wy1 > $wy2) || (!$upward && $wy2 > $wy1)) {
+
+ $y1 = $this->ytr($wy1); // Convert to device coordinates. $y1 is outermost value.
+ $y2 = $this->ytr($wy2); // $y2 is innermost (closest to axis).
+
+ // Select the colors:
+ $this->GetBarColors($row, $idx, $gcvars, $data_color, $alt_color);
+
+ // Draw the bar, and the shade or border:
+ $this->DrawBar($row, $idx, $x1, $y1, $x2, $y2, $data_color, $alt_color,
+ // Only shade the top for upward bars, or the first segment of downward bars:
+ $upward || $first, TRUE);
+
+ // Draw optional data label for this bar segment just inside the end.
+ // Text value is the current Y, but position is the cumulative Y.
+ // The label is only drawn if it fits in the segment height |y2-y1|.
+ if ($data_labels_within) {
+ $dvl['min_height'] = abs($y1 - $y2);
+ if ($upward) {
+ $dvl['v_align'] = 'top';
+ $dvl['y_offset'] = 3;
+ } else {
+ $dvl['v_align'] = 'bottom';
+ $dvl['y_offset'] = -3;
+ }
+ $this->DrawDataValueLabel('y', $row, $idx, $row+0.5, $wy1, $this_y, $dvl);
+ }
+ // Mark the new end of the bar, conditional on segment height > 0.
+ $wy2 = $wy1;
+ $first = FALSE;
+ }
+ }
+ } // end for
+
+ // Draw optional data label above the bar with the total value.
+ // Value is wy1 (total value), but position is wy2 (end of the bar stack).
+ // These differ only with wrong-direction segments, or a stack completely clipped by the axis.
+ if ($data_labels_end) {
+ $dvl['min_height'] = NULL; // Might be set above, but the whole array might not exist.
+ if ($upward) {
+ $dvl['v_align'] = 'bottom';
+ $dvl['y_offset'] = $data_label_y_offset;
+ } else {
+ $dvl['v_align'] = 'top';
+ $dvl['y_offset'] = 5;
+ }
+ $this->DrawDataValueLabel('y', $row, NULL, $row+0.5, $wy2, $wy1, $dvl);
+ }
+ } // end for
+ return TRUE;
+ }
+
+ /*
+ * Draw a Horizontal Stacked Bar chart
+ * Supports only text-data-yx format, with each row in the form array(label, x1, x2, x3, ...)
+ * Note that the data values are X not Y, and the bars are drawn horizontally.
+ * This is called from DrawStackedBars, which has already checked the data type.
+ */
+ protected function DrawHorizStackedBars()
+ {
+ $this->CalcBarWidths(TRUE, FALSE); // Calculate bar widths for stacked, horizontal
+
+ // This is the Y offset from the bar's label center point to the bottom of the bar
+ $y_first_bar = $this->record_bar_width / 2 - $this->bar_adjust_gap;
+
+ $gcvars = array(); // For GetBarColors, which initializes and uses this.
+
+ // Determine if any data labels are on:
+ $data_labels_within = ($this->x_data_label_pos == 'plotstack');
+ $data_labels_end = $data_labels_within || ($this->x_data_label_pos == 'plotin');
+ $data_label_x_offset = 5 + $this->shading; // For rightward labels only
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ $y_now_pixels = $this->ytr(0.5 + $row); // Place bars at Y=0.5, 1.5, 2.5, etc...
+
+ if ($this->y_data_label_pos != 'none') // Draw Y Data labels?
+ $this->DrawYDataLabel($this->data[$row][0], $y_now_pixels, $row);
+
+ // Determine bar direction based on 1st non-zero value. Note the bar direction is
+ // based on zero, not the axis value.
+ $n_recs = $this->num_recs[$row];
+ $rightward = TRUE; // Initialize this for the case of all segments = 0
+ for ($i = $record; $i < $n_recs; $i++) {
+ if (is_numeric($this_x = $this->data[$row][$i]) && $this_x != 0) {
+ $rightward = ($this_x > 0);
+ break;
+ }
+ }
+
+ // Lower left and upper left Y of the bars in this stack:
+ $y1 = $y_now_pixels + $y_first_bar; // Lower Y of bars in this stack
+ $y2 = $y1 - $this->actual_bar_width; // Upper Y of bars in this stack
+ $wx1 = 0; // World coordinates X1, current sum of values
+ $wx2 = $this->y_axis_position; // World coordinates X2, last drawn value
+
+ // Draw bar segments and labels in this stack.
+ $first = TRUE;
+ for ($idx = 0; $record < $this->num_recs[$row]; $record++, $idx++) {
+
+ // Skip missing X values. Process X=0 values due to special case of moved axis.
+ if (is_numeric($this_x = $this->data[$row][$record])) {
+
+ $wx1 += $this_x; // Keep the running total for this bar stack
+
+ // Draw the segment only if it will increase the stack length (ignore if wrong direction):
+ if (($rightward && $wx1 > $wx2) || (!$rightward && $wx2 > $wx1)) {
+
+ $x1 = $this->xtr($wx1); // Convert to device coordinates. $x1 is outermost value.
+ $x2 = $this->xtr($wx2); // $x2 is innermost (closest to axis).
+
+ // Select the colors:
+ $this->GetBarColors($row, $idx, $gcvars, $data_color, $alt_color);
+
+ // Draw the bar, and the shade or border:
+ $this->DrawBar($row, $idx, $x1, $y1, $x2, $y2, $data_color, $alt_color,
+ // Only shade the side for rightward bars, or the first segment of leftward bars:
+ TRUE, $rightward || $first);
+ // Draw optional data label for this bar segment just inside the end.
+ // Text value is the current X, but position is the cumulative X.
+ // The label is only drawn if it fits in the segment width |x2-x1|.
+ if ($data_labels_within) {
+ $dvl['min_width'] = abs($x1 - $x2);
+ if ($rightward) {
+ $dvl['h_align'] = 'right';
+ $dvl['x_offset'] = -3;
+ } else {
+ $dvl['h_align'] = 'left';
+ $dvl['x_offset'] = 3;
+ }
+ $this->DrawDataValueLabel('x', $row, $idx, $wx1, $row+0.5, $this_x, $dvl);
+ }
+ // Mark the new end of the bar, conditional on segment width > 0.
+ $wx2 = $wx1;
+ $first = FALSE;
+ }
+ }
+ } // end for
+
+ // Draw optional data label right of the bar with the total value.
+ // Value is wx1 (total value), but position is wx2 (end of the bar stack).
+ // These differ only with wrong-direction segments, or a stack completely clipped by the axis.
+ if ($data_labels_end) {
+ $dvl['min_width'] = NULL; // Might be set above, but the whole array might not exist.
+ if ($rightward) {
+ $dvl['h_align'] = 'left';
+ $dvl['x_offset'] = $data_label_x_offset;
+ } else {
+ $dvl['h_align'] = 'right';
+ $dvl['x_offset'] = -5;
+ }
+ $this->DrawDataValueLabel('x', $row, NULL, $wx2, $row+0.5, $wx1, $dvl);
+ }
+ } // end for
+ return TRUE;
+ }
+
+ /*
+ * Draw a financial "Open/High/Low/Close" (OHLC) plot, including candlestick plots.
+ * Data format can be text-data (label, Yo, Yh, Yl, Yc) or data-data (label, X, Yo, Yh, Yl, Yc).
+ * Yo="Opening price", Yc="Closing price", Yl="Low price", Yh="High price".
+ * Each row must have exactly 4 Y values. Indicate a missing point using empty strings for each Yx.
+ * There are 3 subtypes, selected by $draw_candles and $always_fill.
+ * $draw_candles $always_fill Description:
+ * FALSE N/A A basic OHLC chart with a vertical line for price range, horizontal
+ * tick marks on left for opening price and right for closing price.
+ * TRUE FALSE A candlestick plot with filled body indicating close down, outline
+ * for closing up, and vertical wicks for low and high prices.
+ * TRUE TRUE A candlestick plot where the candle bodies are always filled.
+ * These map to 3 plot types per the $plots[] array.
+ *
+ * Data color usage: If closes down: If closes up or unchanged:
+ * Candlestick body, ohlc range line: color 0 color 1
+ * Candlestick wicks, ohlc tick marks: color 2 color 3
+ * There are three member variables that control the width (candlestick body or tick marks):
+ * ohlc_max_width, ohlc_min_width, ohlc_frac_width
+ * (There is no API to change them at this time.)
+ */
+ protected function DrawOHLC($draw_candles, $always_fill = FALSE)
+ {
+ if (!$this->CheckDataType('text-data, data-data'))
+ return FALSE;
+ if ($this->data_columns != 4) // early error check (more inside the loop)
+ return $this->PrintError("DrawOHLC(): rows must have 4 values.");
+
+ // Assign name of GD function to draw candlestick bodies for stocks that close up.
+ $draw_body_close_up = $always_fill ? 'imagefilledrectangle' : 'imagerectangle';
+
+ // These 3 variables control the calculation of the half-width of the candle body, or length of
+ // the tick marks. This is scaled based on the plot density, but within tight limits.
+ $min_width = isset($this->ohlc_min_width) ? $this->ohlc_min_width : 2;
+ $max_width = isset($this->ohlc_max_width) ? $this->ohlc_max_width : 8;
+ $width_factor = isset($this->ohlc_frac_width) ? $this->ohlc_frac_width : 0.3;
+ $dw = max($min_width, min($max_width,
+ (int)($width_factor * $this->plot_area_width / $this->num_data_rows)));
+
+ // Get line widths to use: index 0 for body/stroke, 1 for wick/tick.
+ list($body_thickness, $wick_thickness) = $this->line_widths;
+
+ $gcvars = array(); // For GetDataColor, which initializes and uses this.
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $record = 1; // Skip record #0 (data label)
+
+ if ($this->datatype_implied) // Implied X values?
+ $x_now = 0.5 + $row; // Place text-data at X = 0.5, 1.5, 2.5, etc...
+ else
+ $x_now = $this->data[$row][$record++]; // Read it, advance record index
+
+ $x_now_pixels = $this->xtr($x_now); // Convert X to device coordinates
+ $x_left = $x_now_pixels - $dw;
+ $x_right = $x_now_pixels + $dw;
+
+ if ($this->x_data_label_pos != 'none') // Draw X Data labels?
+ $this->DrawXDataLabel($this->data[$row][0], $x_now_pixels, $row);
+
+ // Each row must have 4 values, but skip rows with non-numeric entries.
+ if ($this->num_recs[$row] - $record != 4) {
+ return $this->PrintError("DrawOHLC(): row $row must have 4 values.");
+ }
+ if (!is_numeric($yo = $this->data[$row][$record++])
+ || !is_numeric($yh = $this->data[$row][$record++])
+ || !is_numeric($yl = $this->data[$row][$record++])
+ || !is_numeric($yc = $this->data[$row][$record++])) {
+ continue;
+ }
+
+ // Set device coordinates for each value and direction flag:
+ $yh_pixels = $this->ytr($yh);
+ $yl_pixels = $this->ytr($yl);
+ $yc_pixels = $this->ytr($yc);
+ $yo_pixels = $this->ytr($yo);
+ $closed_up = $yc >= $yo;
+
+ // Get data colors and line thicknesses:
+ if ($closed_up) {
+ $this->GetDataColor($row, 1, $gcvars, $body_color); // Color 1 for body, closing up
+ $this->GetDataColor($row, 3, $gcvars, $ext_color); // Color 3 for wicks/ticks
+ } else {
+ $this->GetDataColor($row, 0, $gcvars, $body_color); // Color 0 for body, closing down
+ $this->GetDataColor($row, 2, $gcvars, $ext_color); // Color 2 for wicks/ticks
+ }
+ imagesetthickness($this->img, $body_thickness);
+
+ if ($draw_candles) {
+ // Note: Unlike ImageFilledRectangle, ImageRectangle 'requires' its arguments in
+ // order with upper left corner first.
+ if ($closed_up) {
+ $yb1_pixels = $yc_pixels; // Upper body Y
+ $yb2_pixels = $yo_pixels; // Lower body Y
+ $draw_body = $draw_body_close_up;
+ // Avoid a PHP/GD bug resulting in "T"-shaped ends to zero height unfilled rectangle:
+ if ($yb1_pixels == $yb2_pixels)
+ $draw_body = 'imagefilledrectangle';
+ } else {
+ $yb1_pixels = $yo_pixels;
+ $yb2_pixels = $yc_pixels;
+ $draw_body = 'imagefilledrectangle';
+ }
+
+ // Draw candle body
+ $draw_body($this->img, $x_left, $yb1_pixels, $x_right, $yb2_pixels, $body_color);
+
+ // Draw upper and lower wicks, if they have height. (In device coords, that's dY<0)
+ imagesetthickness($this->img, $wick_thickness);
+ if ($yh_pixels < $yb1_pixels) {
+ imageline($this->img, $x_now_pixels, $yb1_pixels, $x_now_pixels, $yh_pixels, $ext_color);
+ }
+ if ($yl_pixels > $yb2_pixels) {
+ imageline($this->img, $x_now_pixels, $yb2_pixels, $x_now_pixels, $yl_pixels, $ext_color);
+ }
+ } else {
+ // Basic OHLC
+ imageline($this->img, $x_now_pixels, $yl_pixels, $x_now_pixels, $yh_pixels, $body_color);
+ imagesetthickness($this->img, $wick_thickness);
+ imageline($this->img, $x_left, $yo_pixels, $x_now_pixels, $yo_pixels, $ext_color);
+ imageline($this->img, $x_right, $yc_pixels, $x_now_pixels, $yc_pixels, $ext_color);
+ }
+ imagesetthickness($this->img, 1);
+ $this->DoCallback('data_points', 'rect', $row, 0, $x_left, $yh_pixels, $x_right, $yl_pixels);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw a bubble chart, which is a scatter plot with bubble size showing the Z value.
+ * Supported data type is data-data-xyz with rows of (label, X, Y1, Z1, ...)
+ * with multiple data sets (Y, Z pairs) supported.
+ * Bubble sizes are scaled per the min_z and max_z calculated in FindDataLimits.
+ */
+ protected function DrawBubbles()
+ {
+ if (!$this->CheckDataType('data-data-xyz'))
+ return FALSE;
+ if ($this->data_columns == 0) return TRUE; // No data to plot; prevents error on min_z/max_z.
+
+ $gcvars = array(); // For GetDataColor, which initializes and uses this.
+
+ // Bubble size limits can be set with class variables or calculated.
+ $min_bubble_size = isset($this->bubbles_min_size) ? $this->bubbles_min_size : 6;
+ if (isset($this->bubbles_max_size)) {
+ $max_bubble_size = $this->bubbles_max_size;
+ } else {
+ $max_bubble_size = min($this->plot_area_width, $this->plot_area_height) / 12;
+ }
+
+ // Calculate bubble scale parameters. Bubble_size(z) = $f_size * $z + $b_size
+ if ($this->max_z <= $this->min_z) { // Regressive case, no Z range.
+ $f_size = 0;
+ $b_size = ($max_bubble_size + $min_bubble_size) / 2; // Use average size of all bubbles
+ } else {
+ $f_size = ($max_bubble_size - $min_bubble_size) / ($this->max_z - $this->min_z);
+ $b_size = $max_bubble_size - $f_size * $this->max_z;
+ }
+
+ for ($row = 0; $row < $this->num_data_rows; $row++) {
+ $rec = 1; // Skip record #0 (data label)
+ $x = $this->xtr($this->data[$row][$rec++]); // Get X value from data array.
+
+ // Draw X Data labels?
+ if ($this->x_data_label_pos != 'none')
+ $this->DrawXDataLabel($this->data[$row][0], $x, $row, TRUE);
+
+ // Proceed with Y,Z values
+ for ($idx = 0; $rec < $this->num_recs[$row]; $rec += 2, $idx++) {
+
+ if (is_numeric($y_now = $this->data[$row][$rec])) { //Allow for missing Y data
+ $y = $this->ytr($y_now);
+ $z = (double)$this->data[$row][$rec+1]; // Z is required if Y is present.
+ $size = (int)($f_size * $z + $b_size); // Calculate bubble size
+
+ // Select the color:
+ $this->GetDataColor($row, $idx, $gcvars, $data_color);
+
+ // Draw the bubble:
+ ImageFilledEllipse($this->img, $x, $y, $size, $size, $data_color);
+ $this->DoCallback('data_points', 'circle', $row, $idx, $x, $y, $size);
+ }
+ }
+ }
+ return TRUE;
+ }
+
+ /*
+ * Draw the graph.
+ * This is the function that performs the actual drawing, after all
+ * the parameters and data are set up.
+ * It also outputs the finished image, unless told not to.
+ * Note: It is possible for this to be called multiple times.
+ */
+ function DrawGraph()
+ {
+ // Test for missing image, missing data, empty data:
+ if (!$this->CheckDataArray())
+ return FALSE; // Error message already reported.
+
+ // Set defaults then import plot type configuration:
+ $draw_axes = TRUE;
+ $draw_arg = array(); // Default is: no arguments to the drawing function
+ extract(PHPlot::$plots[$this->plot_type]);
+
+ // Allocate colors for the plot:
+ $this->SetColorIndexes();
+
+ // Calculate scaling, but only for plots with axes (excludes pie charts).
+ if ($draw_axes) {
+
+ // Get maxima and minima for scaling:
+ if (!$this->FindDataLimits())
+ return FALSE;
+
+ // Set plot area world values (plot_max_x, etc.):
+ if (!$this->CalcPlotAreaWorld())
+ return FALSE;
+
+ // Calculate X and Y axis positions in World Coordinates:
+ $this->CalcAxisPositions();
+
+ // Process label-related parameters:
+ $this->CheckLabels();
+
+ // Apply grid defaults:
+ $this->CalcGridSettings();
+ }
+
+ // Calculate the plot margins, if needed.
+ // For pie charts, set the $maximize argument to maximize space usage.
+ $this->CalcMargins(!$draw_axes);
+
+ // Calculate the actual plot area in device coordinates:
+ $this->CalcPlotAreaPixels();
+
+ // Calculate the mapping between world and device coordinates:
+ if ($draw_axes) $this->CalcTranslation();
+
+ // Pad color and style arrays to fit records per group:
+ $this->PadArrays();
+ $this->DoCallback('draw_setup');
+
+ $this->DrawBackground();
+ $this->DrawImageBorder();
+ $this->DoCallback('draw_image_background');
+
+ $this->DrawPlotAreaBackground();
+ $this->DoCallback('draw_plotarea_background', $this->plot_area);
+
+ $this->DrawTitle();
+ if ($draw_axes) { // If no axes (pie chart), no axis titles either
+ $this->DrawXTitle();
+ $this->DrawYTitle();
+ }
+ $this->DoCallback('draw_titles');
+
+ if ($draw_axes && ! $this->grid_at_foreground) { // Usually one wants grids to go back, but...
+ $this->DrawYAxis(); // Y axis must be drawn before X axis (see DrawYAxis())
+ $this->DrawXAxis();
+ $this->DoCallback('draw_axes');
+ }
+
+ // Call the plot-type drawing method:
+ call_user_func_array(array($this, $draw_method), $draw_arg);
+ $this->DoCallback('draw_graph', $this->plot_area);
+
+ if ($draw_axes && $this->grid_at_foreground) { // Usually one wants grids to go back, but...
+ $this->DrawYAxis(); // Y axis must be drawn before X axis (see DrawYAxis())
+ $this->DrawXAxis();
+ $this->DoCallback('draw_axes');
+ }
+
+ $this->DrawPlotBorder($draw_axes); // Flag controls default for plot area borders
+ $this->DoCallback('draw_border');
+
+ if ($this->legend) {
+ $this->DrawLegend();
+ $this->DoCallback('draw_legend');
+ }
+ $this->DoCallback('draw_all', $this->plot_area);
+
+ if ($this->print_image && !$this->PrintImage())
+ return FALSE;
+
+ return TRUE;
+ }
+
+/////////////////////////////////////////////
+////////////////// DEPRECATED METHODS
+/////////////////////////////////////////////
+
+ /*
+ * Note on deprecated methods - as these pre-date the PHPlot Reference
+ * Manual, and there is minimal documentation about them, I have neither
+ * removed them nor changed them. They are not tested or documented, and
+ * should not be used.
+ */
+
+ /*
+ * Deprecated, use SetYTickPos()
+ */
+ function SetDrawVertTicks($which_dvt)
+ {
+ if ($which_dvt != 1)
+ $this->SetYTickPos('none');
+ return TRUE;
+ }
+
+ /*
+ * Deprecated, use SetXTickPos()
+ */
+ function SetDrawHorizTicks($which_dht)
+ {
+ if ($which_dht != 1)
+ $this->SetXTickPos('none');
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use SetNumXTicks()
+ */
+ function SetNumHorizTicks($n)
+ {
+ return $this->SetNumXTicks($n);
+ }
+
+ /*
+ * Deprecated - use SetNumYTicks()
+ */
+ function SetNumVertTicks($n)
+ {
+ return $this->SetNumYTicks($n);
+ }
+
+ /*
+ * Deprecated - use SetXTickIncrement()
+ */
+ function SetHorizTickIncrement($inc)
+ {
+ return $this->SetXTickIncrement($inc);
+ }
+
+ /*
+ * Deprecated - use SetYTickIncrement()
+ */
+ function SetVertTickIncrement($inc)
+ {
+ return $this->SetYTickIncrement($inc);
+ }
+
+ /*
+ * Deprecated - use SetYTickPos()
+ */
+ function SetVertTickPosition($which_tp)
+ {
+ return $this->SetYTickPos($which_tp);
+ }
+
+ /*
+ * Deprecated - use SetXTickPos()
+ */
+ function SetHorizTickPosition($which_tp)
+ {
+ return $this->SetXTickPos($which_tp);
+ }
+
+ /*
+ * Deprecated - use SetFont()
+ */
+ function SetTitleFontSize($which_size)
+ {
+ return $this->SetFont('title', $which_size);
+ }
+
+ /*
+ * Deprecated - use SetFont()
+ */
+ function SetAxisFontSize($which_size)
+ {
+ $this->SetFont('x_label', $which_size);
+ $this->SetFont('y_label', $which_size);
+ }
+
+ /*
+ * Deprecated - use SetFont()
+ */
+ function SetSmallFontSize($which_size)
+ {
+ return $this->SetFont('generic', $which_size);
+ }
+
+ /*
+ * Deprecated - use SetFont()
+ */
+ function SetXLabelFontSize($which_size)
+ {
+ return $this->SetFont('x_title', $which_size);
+ }
+
+ /*
+ * Deprecated - use SetFont()
+ */
+ function SetYLabelFontSize($which_size)
+ {
+ return $this->SetFont('y_title', $which_size);
+ }
+
+ /*
+ * Deprecated - use SetXTitle()
+ */
+ function SetXLabel($which_xlab)
+ {
+ return $this->SetXTitle($which_xlab);
+ }
+
+ /*
+ * Deprecated - use SetYTitle()
+ */
+ function SetYLabel($which_ylab)
+ {
+ return $this->SetYTitle($which_ylab);
+ }
+
+ /*
+ * Deprecated - use SetXTickLength() and SetYTickLength() instead.
+ */
+ function SetTickLength($which_tl)
+ {
+ $this->SetXTickLength($which_tl);
+ $this->SetYTickLength($which_tl);
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use SetYLabelType()
+ */
+ function SetYGridLabelType($which_yglt)
+ {
+ return $this->SetYLabelType($which_yglt);
+ }
+
+ /*
+ * Deprecated - use SetXLabelType()
+ */
+ function SetXGridLabelType($which_xglt)
+ {
+ return $this->SetXLabelType($which_xglt);
+ }
+ /*
+ * Deprecated - use SetYTickLabelPos()
+ */
+ function SetYGridLabelPos($which_yglp)
+ {
+ return $this->SetYTickLabelPos($which_yglp);
+ }
+ /*
+ * Deprecated - use SetXTickLabelPos()
+ */
+ function SetXGridLabelPos($which_xglp)
+ {
+ return $this->SetXTickLabelPos($which_xglp);
+ }
+
+ /*
+ * Deprecated - use SetXtitle()
+ */
+ function SetXTitlePos($xpos)
+ {
+ $this->x_title_pos = $xpos;
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use SetYTitle()
+ */
+ function SetYTitlePos($xpos)
+ {
+ $this->y_title_pos = $xpos;
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use SetXDataLabelPos()
+ */
+ function SetDrawXDataLabels($which_dxdl)
+ {
+ if ($which_dxdl == '1' )
+ $this->SetXDataLabelPos('plotdown');
+ else
+ $this->SetXDataLabelPos('none');
+ }
+
+ /*
+ * Deprecated - use SetPlotAreaPixels()
+ */
+ function SetNewPlotAreaPixels($x1, $y1, $x2, $y2)
+ {
+ return $this->SetPlotAreaPixels($x1, $y1, $x2, $y2);
+ }
+
+ /*
+ * Deprecated - use SetLineWidths().
+ */
+ function SetLineWidth($which_lw)
+ {
+
+ $this->SetLineWidths($which_lw);
+
+ if (!$this->error_bar_line_width) {
+ $this->SetErrorBarLineWidth($which_lw);
+ }
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use SetPointShapes().
+ */
+ function SetPointShape($which_pt)
+ {
+ $this->SetPointShapes($which_pt);
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use SetPointSizes().
+ */
+ function SetPointSize($which_ps)
+ {
+ $this->SetPointSizes($which_ps);
+ return TRUE;
+ }
+
+ /*
+ * Deprecated - use PrintError(). $where_x, $where_y are ignored.
+ */
+ protected function DrawError($error_message, $where_x = NULL, $where_y = NULL)
+ {
+ return $this->PrintError($error_message);
+ }
+
+}
+
+/*
+ * The PHPlot_truecolor class extends PHPlot to use GD truecolor images.
+ */
+
+class PHPlot_truecolor extends PHPlot
+{
+ /*
+ * PHPlot Truecolor variation constructor: Create a PHPlot_truecolor object and initialize it.
+ *
+ * Parameters are the same as PHPlot:
+ * $width : Image width in pixels.
+ * $height : Image height in pixels.
+ * $output_file : Filename for output.
+ * $input_file : Path to a file to be used as background.
+ */
+ function __construct($width=600, $height=400, $output_file=NULL, $input_file=NULL)
+ {
+ $this->initialize('imagecreatetruecolor', $width, $height, $output_file, $input_file);
+ }
+}
diff --git a/extensions/Translate/phplot/rgb.inc.php b/extensions/Translate/phplot/rgb.inc.php
new file mode 100644
index 0000000..e3d8905
--- /dev/null
+++ b/extensions/Translate/phplot/rgb.inc.php
@@ -0,0 +1,752 @@
+<?php
+/* $Id: rgb.inc.php 393 2009-06-12 01:58:35Z lbayuk $ */
+/*
+ * This is a large color map which can be used by PHPlot via
+ * $plot->SetRGBArray('large')
+ * For more information on PHPlot see http://sourceforge.net/projects/phplot/
+ *
+ * rgb.inc.php comes with PHPlot but is derived from the X11 rgb.txt color
+ * database file, which contains no specific copyright notice. It may be
+ * covered by X.Org, XFree86, or MIT/X11 copyright and license, all of which
+ * allow redistribution on terms which are less strict than the LGPL which
+ * covers PHPlot.
+ */
+$ColorArray = array(
+ "snow" => array(255, 250, 250),
+ "ghost white" => array(248, 248, 255),
+ "GhostWhite" => array(248, 248, 255),
+ "white smoke" => array(245, 245, 245),
+ "WhiteSmoke" => array(245, 245, 245),
+ "gainsboro" => array(220, 220, 220),
+ "floral white" => array(255, 250, 240),
+ "FloralWhite" => array(255, 250, 240),
+ "old lace" => array(253, 245, 230),
+ "OldLace" => array(253, 245, 230),
+ "linen" => array(250, 240, 230),
+ "antique white" => array(250, 235, 215),
+ "AntiqueWhite" => array(250, 235, 215),
+ "papaya whip" => array(255, 239, 213),
+ "PapayaWhip" => array(255, 239, 213),
+ "blanched almond" => array(255, 235, 205),
+ "BlanchedAlmond" => array(255, 235, 205),
+ "bisque" => array(255, 228, 196),
+ "peach puff" => array(255, 218, 185),
+ "PeachPuff" => array(255, 218, 185),
+ "navajo white" => array(255, 222, 173),
+ "NavajoWhite" => array(255, 222, 173),
+ "moccasin" => array(255, 228, 181),
+ "cornsilk" => array(255, 248, 220),
+ "ivory" => array(255, 255, 240),
+ "lemon chiffon" => array(255, 250, 205),
+ "LemonChiffon" => array(255, 250, 205),
+ "seashell" => array(255, 245, 238),
+ "honeydew" => array(240, 255, 240),
+ "mint cream" => array(245, 255, 250),
+ "MintCream" => array(245, 255, 250),
+ "azure" => array(240, 255, 255),
+ "alice blue" => array(240, 248, 255),
+ "AliceBlue" => array(240, 248, 255),
+ "lavender" => array(230, 230, 250),
+ "lavender blush" => array(255, 240, 245),
+ "LavenderBlush" => array(255, 240, 245),
+ "misty rose" => array(255, 228, 225),
+ "MistyRose" => array(255, 228, 225),
+ "white" => array(255, 255, 255),
+ "black" => array( 0, 0, 0),
+ "dark slate gray" => array( 47, 79, 79),
+ "DarkSlateGray" => array( 47, 79, 79),
+ "dark slate grey" => array( 47, 79, 79),
+ "DarkSlateGrey" => array( 47, 79, 79),
+ "dim gray" => array(105, 105, 105),
+ "DimGray" => array(105, 105, 105),
+ "dim grey" => array(105, 105, 105),
+ "DimGrey" => array(105, 105, 105),
+ "slate gray" => array(112, 128, 144),
+ "SlateGray" => array(112, 128, 144),
+ "slate grey" => array(112, 128, 144),
+ "SlateGrey" => array(112, 128, 144),
+ "light slate gray" => array(119, 136, 153),
+ "LightSlateGray" => array(119, 136, 153),
+ "light slate grey" => array(119, 136, 153),
+ "LightSlateGrey" => array(119, 136, 153),
+ "gray" => array(190, 190, 190),
+ "grey" => array(190, 190, 190),
+ "light grey" => array(211, 211, 211),
+ "LightGrey" => array(211, 211, 211),
+ "light gray" => array(211, 211, 211),
+ "LightGray" => array(211, 211, 211),
+ "midnight blue" => array( 25, 25, 112),
+ "MidnightBlue" => array( 25, 25, 112),
+ "navy" => array( 0, 0, 128),
+ "navy blue" => array( 0, 0, 128),
+ "NavyBlue" => array( 0, 0, 128),
+ "cornflower blue" => array(100, 149, 237),
+ "CornflowerBlue" => array(100, 149, 237),
+ "dark slate blue" => array( 72, 61, 139),
+ "DarkSlateBlue" => array( 72, 61, 139),
+ "slate blue" => array(106, 90, 205),
+ "SlateBlue" => array(106, 90, 205),
+ "medium slate blue" => array(123, 104, 238),
+ "MediumSlateBlue" => array(123, 104, 238),
+ "light slate blue" => array(132, 112, 255),
+ "LightSlateBlue" => array(132, 112, 255),
+ "medium blue" => array( 0, 0, 205),
+ "MediumBlue" => array( 0, 0, 205),
+ "royal blue" => array( 65, 105, 225),
+ "RoyalBlue" => array( 65, 105, 225),
+ "blue" => array( 0, 0, 255),
+ "dodger blue" => array( 30, 144, 255),
+ "DodgerBlue" => array( 30, 144, 255),
+ "deep sky blue" => array( 0, 191, 255),
+ "DeepSkyBlue" => array( 0, 191, 255),
+ "sky blue" => array(135, 206, 235),
+ "SkyBlue" => array(135, 206, 235),
+ "light sky blue" => array(135, 206, 250),
+ "LightSkyBlue" => array(135, 206, 250),
+ "steel blue" => array( 70, 130, 180),
+ "SteelBlue" => array( 70, 130, 180),
+ "light steel blue" => array(176, 196, 222),
+ "LightSteelBlue" => array(176, 196, 222),
+ "light blue" => array(173, 216, 230),
+ "LightBlue" => array(173, 216, 230),
+ "powder blue" => array(176, 224, 230),
+ "PowderBlue" => array(176, 224, 230),
+ "pale turquoise" => array(175, 238, 238),
+ "PaleTurquoise" => array(175, 238, 238),
+ "dark turquoise" => array( 0, 206, 209),
+ "DarkTurquoise" => array( 0, 206, 209),
+ "medium turquoise" => array( 72, 209, 204),
+ "MediumTurquoise" => array( 72, 209, 204),
+ "turquoise" => array( 64, 224, 208),
+ "cyan" => array( 0, 255, 255),
+ "light cyan" => array(224, 255, 255),
+ "LightCyan" => array(224, 255, 255),
+ "cadet blue" => array( 95, 158, 160),
+ "CadetBlue" => array( 95, 158, 160),
+ "medium aquamarine" => array(102, 205, 170),
+ "MediumAquamarine" => array(102, 205, 170),
+ "aquamarine" => array(127, 255, 212),
+ "dark green" => array( 0, 100, 0),
+ "DarkGreen" => array( 0, 100, 0),
+ "dark olive green" => array( 85, 107, 47),
+ "DarkOliveGreen" => array( 85, 107, 47),
+ "dark sea green" => array(143, 188, 143),
+ "DarkSeaGreen" => array(143, 188, 143),
+ "sea green" => array( 46, 139, 87),
+ "SeaGreen" => array( 46, 139, 87),
+ "medium sea green" => array( 60, 179, 113),
+ "MediumSeaGreen" => array( 60, 179, 113),
+ "light sea green" => array( 32, 178, 170),
+ "LightSeaGreen" => array( 32, 178, 170),
+ "pale green" => array(152, 251, 152),
+ "PaleGreen" => array(152, 251, 152),
+ "spring green" => array( 0, 255, 127),
+ "SpringGreen" => array( 0, 255, 127),
+ "lawn green" => array(124, 252, 0),
+ "LawnGreen" => array(124, 252, 0),
+ "green" => array( 0, 255, 0),
+ "chartreuse" => array(127, 255, 0),
+ "medium spring green" => array( 0, 250, 154),
+ "MediumSpringGreen" => array( 0, 250, 154),
+ "green yellow" => array(173, 255, 47),
+ "GreenYellow" => array(173, 255, 47),
+ "lime green" => array( 50, 205, 50),
+ "LimeGreen" => array( 50, 205, 50),
+ "yellow green" => array(154, 205, 50),
+ "YellowGreen" => array(154, 205, 50),
+ "forest green" => array( 34, 139, 34),
+ "ForestGreen" => array( 34, 139, 34),
+ "olive drab" => array(107, 142, 35),
+ "OliveDrab" => array(107, 142, 35),
+ "dark khaki" => array(189, 183, 107),
+ "DarkKhaki" => array(189, 183, 107),
+ "khaki" => array(240, 230, 140),
+ "pale goldenrod" => array(238, 232, 170),
+ "PaleGoldenrod" => array(238, 232, 170),
+ "light goldenrod yellow" => array(250, 250, 210),
+ "LightGoldenrodYellow" => array(250, 250, 210),
+ "light yellow" => array(255, 255, 224),
+ "LightYellow" => array(255, 255, 224),
+ "yellow" => array(255, 255, 0),
+ "gold" => array(255, 215, 0),
+ "light goldenrod" => array(238, 221, 130),
+ "LightGoldenrod" => array(238, 221, 130),
+ "goldenrod" => array(218, 165, 32),
+ "dark goldenrod" => array(184, 134, 11),
+ "DarkGoldenrod" => array(184, 134, 11),
+ "rosy brown" => array(188, 143, 143),
+ "RosyBrown" => array(188, 143, 143),
+ "indian red" => array(205, 92, 92),
+ "IndianRed" => array(205, 92, 92),
+ "saddle brown" => array(139, 69, 19),
+ "SaddleBrown" => array(139, 69, 19),
+ "sienna" => array(160, 82, 45),
+ "peru" => array(205, 133, 63),
+ "burlywood" => array(222, 184, 135),
+ "beige" => array(245, 245, 220),
+ "wheat" => array(245, 222, 179),
+ "sandy brown" => array(244, 164, 96),
+ "SandyBrown" => array(244, 164, 96),
+ "tan" => array(210, 180, 140),
+ "chocolate" => array(210, 105, 30),
+ "firebrick" => array(178, 34, 34),
+ "brown" => array(165, 42, 42),
+ "dark salmon" => array(233, 150, 122),
+ "DarkSalmon" => array(233, 150, 122),
+ "salmon" => array(250, 128, 114),
+ "light salmon" => array(255, 160, 122),
+ "LightSalmon" => array(255, 160, 122),
+ "orange" => array(255, 165, 0),
+ "dark orange" => array(255, 140, 0),
+ "DarkOrange" => array(255, 140, 0),
+ "coral" => array(255, 127, 80),
+ "light coral" => array(240, 128, 128),
+ "LightCoral" => array(240, 128, 128),
+ "tomato" => array(255, 99, 71),
+ "orange red" => array(255, 69, 0),
+ "OrangeRed" => array(255, 69, 0),
+ "red" => array(255, 0, 0),
+ "hot pink" => array(255, 105, 180),
+ "HotPink" => array(255, 105, 180),
+ "deep pink" => array(255, 20, 147),
+ "DeepPink" => array(255, 20, 147),
+ "pink" => array(255, 192, 203),
+ "light pink" => array(255, 182, 193),
+ "LightPink" => array(255, 182, 193),
+ "pale violet red" => array(219, 112, 147),
+ "PaleVioletRed" => array(219, 112, 147),
+ "maroon" => array(176, 48, 96),
+ "medium violet red" => array(199, 21, 133),
+ "MediumVioletRed" => array(199, 21, 133),
+ "violet red" => array(208, 32, 144),
+ "VioletRed" => array(208, 32, 144),
+ "magenta" => array(255, 0, 255),
+ "violet" => array(238, 130, 238),
+ "plum" => array(221, 160, 221),
+ "orchid" => array(218, 112, 214),
+ "medium orchid" => array(186, 85, 211),
+ "MediumOrchid" => array(186, 85, 211),
+ "dark orchid" => array(153, 50, 204),
+ "DarkOrchid" => array(153, 50, 204),
+ "dark violet" => array(148, 0, 211),
+ "DarkViolet" => array(148, 0, 211),
+ "blue violet" => array(138, 43, 226),
+ "BlueViolet" => array(138, 43, 226),
+ "purple" => array(160, 32, 240),
+ "medium purple" => array(147, 112, 219),
+ "MediumPurple" => array(147, 112, 219),
+ "thistle" => array(216, 191, 216),
+ "snow1" => array(255, 250, 250),
+ "snow2" => array(238, 233, 233),
+ "snow3" => array(205, 201, 201),
+ "snow4" => array(139, 137, 137),
+ "seashell1" => array(255, 245, 238),
+ "seashell2" => array(238, 229, 222),
+ "seashell3" => array(205, 197, 191),
+ "seashell4" => array(139, 134, 130),
+ "AntiqueWhite1" => array(255, 239, 219),
+ "AntiqueWhite2" => array(238, 223, 204),
+ "AntiqueWhite3" => array(205, 192, 176),
+ "AntiqueWhite4" => array(139, 131, 120),
+ "bisque1" => array(255, 228, 196),
+ "bisque2" => array(238, 213, 183),
+ "bisque3" => array(205, 183, 158),
+ "bisque4" => array(139, 125, 107),
+ "PeachPuff1" => array(255, 218, 185),
+ "PeachPuff2" => array(238, 203, 173),
+ "PeachPuff3" => array(205, 175, 149),
+ "PeachPuff4" => array(139, 119, 101),
+ "NavajoWhite1" => array(255, 222, 173),
+ "NavajoWhite2" => array(238, 207, 161),
+ "NavajoWhite3" => array(205, 179, 139),
+ "NavajoWhite4" => array(139, 121, 94),
+ "LemonChiffon1" => array(255, 250, 205),
+ "LemonChiffon2" => array(238, 233, 191),
+ "LemonChiffon3" => array(205, 201, 165),
+ "LemonChiffon4" => array(139, 137, 112),
+ "cornsilk1" => array(255, 248, 220),
+ "cornsilk2" => array(238, 232, 205),
+ "cornsilk3" => array(205, 200, 177),
+ "cornsilk4" => array(139, 136, 120),
+ "ivory1" => array(255, 255, 240),
+ "ivory2" => array(238, 238, 224),
+ "ivory3" => array(205, 205, 193),
+ "ivory4" => array(139, 139, 131),
+ "honeydew1" => array(240, 255, 240),
+ "honeydew2" => array(224, 238, 224),
+ "honeydew3" => array(193, 205, 193),
+ "honeydew4" => array(131, 139, 131),
+ "LavenderBlush1" => array(255, 240, 245),
+ "LavenderBlush2" => array(238, 224, 229),
+ "LavenderBlush3" => array(205, 193, 197),
+ "LavenderBlush4" => array(139, 131, 134),
+ "MistyRose1" => array(255, 228, 225),
+ "MistyRose2" => array(238, 213, 210),
+ "MistyRose3" => array(205, 183, 181),
+ "MistyRose4" => array(139, 125, 123),
+ "azure1" => array(240, 255, 255),
+ "azure2" => array(224, 238, 238),
+ "azure3" => array(193, 205, 205),
+ "azure4" => array(131, 139, 139),
+ "SlateBlue1" => array(131, 111, 255),
+ "SlateBlue2" => array(122, 103, 238),
+ "SlateBlue3" => array(105, 89, 205),
+ "SlateBlue4" => array( 71, 60, 139),
+ "RoyalBlue1" => array( 72, 118, 255),
+ "RoyalBlue2" => array( 67, 110, 238),
+ "RoyalBlue3" => array( 58, 95, 205),
+ "RoyalBlue4" => array( 39, 64, 139),
+ "blue1" => array( 0, 0, 255),
+ "blue2" => array( 0, 0, 238),
+ "blue3" => array( 0, 0, 205),
+ "blue4" => array( 0, 0, 139),
+ "DodgerBlue1" => array( 30, 144, 255),
+ "DodgerBlue2" => array( 28, 134, 238),
+ "DodgerBlue3" => array( 24, 116, 205),
+ "DodgerBlue4" => array( 16, 78, 139),
+ "SteelBlue1" => array( 99, 184, 255),
+ "SteelBlue2" => array( 92, 172, 238),
+ "SteelBlue3" => array( 79, 148, 205),
+ "SteelBlue4" => array( 54, 100, 139),
+ "DeepSkyBlue1" => array( 0, 191, 255),
+ "DeepSkyBlue2" => array( 0, 178, 238),
+ "DeepSkyBlue3" => array( 0, 154, 205),
+ "DeepSkyBlue4" => array( 0, 104, 139),
+ "SkyBlue1" => array(135, 206, 255),
+ "SkyBlue2" => array(126, 192, 238),
+ "SkyBlue3" => array(108, 166, 205),
+ "SkyBlue4" => array( 74, 112, 139),
+ "LightSkyBlue1" => array(176, 226, 255),
+ "LightSkyBlue2" => array(164, 211, 238),
+ "LightSkyBlue3" => array(141, 182, 205),
+ "LightSkyBlue4" => array( 96, 123, 139),
+ "SlateGray1" => array(198, 226, 255),
+ "SlateGray2" => array(185, 211, 238),
+ "SlateGray3" => array(159, 182, 205),
+ "SlateGray4" => array(108, 123, 139),
+ "LightSteelBlue1" => array(202, 225, 255),
+ "LightSteelBlue2" => array(188, 210, 238),
+ "LightSteelBlue3" => array(162, 181, 205),
+ "LightSteelBlue4" => array(110, 123, 139),
+ "LightBlue1" => array(191, 239, 255),
+ "LightBlue2" => array(178, 223, 238),
+ "LightBlue3" => array(154, 192, 205),
+ "LightBlue4" => array(104, 131, 139),
+ "LightCyan1" => array(224, 255, 255),
+ "LightCyan2" => array(209, 238, 238),
+ "LightCyan3" => array(180, 205, 205),
+ "LightCyan4" => array(122, 139, 139),
+ "PaleTurquoise1" => array(187, 255, 255),
+ "PaleTurquoise2" => array(174, 238, 238),
+ "PaleTurquoise3" => array(150, 205, 205),
+ "PaleTurquoise4" => array(102, 139, 139),
+ "CadetBlue1" => array(152, 245, 255),
+ "CadetBlue2" => array(142, 229, 238),
+ "CadetBlue3" => array(122, 197, 205),
+ "CadetBlue4" => array( 83, 134, 139),
+ "turquoise1" => array( 0, 245, 255),
+ "turquoise2" => array( 0, 229, 238),
+ "turquoise3" => array( 0, 197, 205),
+ "turquoise4" => array( 0, 134, 139),
+ "cyan1" => array( 0, 255, 255),
+ "cyan2" => array( 0, 238, 238),
+ "cyan3" => array( 0, 205, 205),
+ "cyan4" => array( 0, 139, 139),
+ "DarkSlateGray1" => array(151, 255, 255),
+ "DarkSlateGray2" => array(141, 238, 238),
+ "DarkSlateGray3" => array(121, 205, 205),
+ "DarkSlateGray4" => array( 82, 139, 139),
+ "aquamarine1" => array(127, 255, 212),
+ "aquamarine2" => array(118, 238, 198),
+ "aquamarine3" => array(102, 205, 170),
+ "aquamarine4" => array( 69, 139, 116),
+ "DarkSeaGreen1" => array(193, 255, 193),
+ "DarkSeaGreen2" => array(180, 238, 180),
+ "DarkSeaGreen3" => array(155, 205, 155),
+ "DarkSeaGreen4" => array(105, 139, 105),
+ "SeaGreen1" => array( 84, 255, 159),
+ "SeaGreen2" => array( 78, 238, 148),
+ "SeaGreen3" => array( 67, 205, 128),
+ "SeaGreen4" => array( 46, 139, 87),
+ "PaleGreen1" => array(154, 255, 154),
+ "PaleGreen2" => array(144, 238, 144),
+ "PaleGreen3" => array(124, 205, 124),
+ "PaleGreen4" => array( 84, 139, 84),
+ "SpringGreen1" => array( 0, 255, 127),
+ "SpringGreen2" => array( 0, 238, 118),
+ "SpringGreen3" => array( 0, 205, 102),
+ "SpringGreen4" => array( 0, 139, 69),
+ "green1" => array( 0, 255, 0),
+ "green2" => array( 0, 238, 0),
+ "green3" => array( 0, 205, 0),
+ "green4" => array( 0, 139, 0),
+ "chartreuse1" => array(127, 255, 0),
+ "chartreuse2" => array(118, 238, 0),
+ "chartreuse3" => array(102, 205, 0),
+ "chartreuse4" => array( 69, 139, 0),
+ "OliveDrab1" => array(192, 255, 62),
+ "OliveDrab2" => array(179, 238, 58),
+ "OliveDrab3" => array(154, 205, 50),
+ "OliveDrab4" => array(105, 139, 34),
+ "DarkOliveGreen1" => array(202, 255, 112),
+ "DarkOliveGreen2" => array(188, 238, 104),
+ "DarkOliveGreen3" => array(162, 205, 90),
+ "DarkOliveGreen4" => array(110, 139, 61),
+ "khaki1" => array(255, 246, 143),
+ "khaki2" => array(238, 230, 133),
+ "khaki3" => array(205, 198, 115),
+ "khaki4" => array(139, 134, 78),
+ "LightGoldenrod1" => array(255, 236, 139),
+ "LightGoldenrod2" => array(238, 220, 130),
+ "LightGoldenrod3" => array(205, 190, 112),
+ "LightGoldenrod4" => array(139, 129, 76),
+ "LightYellow1" => array(255, 255, 224),
+ "LightYellow2" => array(238, 238, 209),
+ "LightYellow3" => array(205, 205, 180),
+ "LightYellow4" => array(139, 139, 122),
+ "yellow1" => array(255, 255, 0),
+ "yellow2" => array(238, 238, 0),
+ "yellow3" => array(205, 205, 0),
+ "yellow4" => array(139, 139, 0),
+ "gold1" => array(255, 215, 0),
+ "gold2" => array(238, 201, 0),
+ "gold3" => array(205, 173, 0),
+ "gold4" => array(139, 117, 0),
+ "goldenrod1" => array(255, 193, 37),
+ "goldenrod2" => array(238, 180, 34),
+ "goldenrod3" => array(205, 155, 29),
+ "goldenrod4" => array(139, 105, 20),
+ "DarkGoldenrod1" => array(255, 185, 15),
+ "DarkGoldenrod2" => array(238, 173, 14),
+ "DarkGoldenrod3" => array(205, 149, 12),
+ "DarkGoldenrod4" => array(139, 101, 8),
+ "RosyBrown1" => array(255, 193, 193),
+ "RosyBrown2" => array(238, 180, 180),
+ "RosyBrown3" => array(205, 155, 155),
+ "RosyBrown4" => array(139, 105, 105),
+ "IndianRed1" => array(255, 106, 106),
+ "IndianRed2" => array(238, 99, 99),
+ "IndianRed3" => array(205, 85, 85),
+ "IndianRed4" => array(139, 58, 58),
+ "sienna1" => array(255, 130, 71),
+ "sienna2" => array(238, 121, 66),
+ "sienna3" => array(205, 104, 57),
+ "sienna4" => array(139, 71, 38),
+ "burlywood1" => array(255, 211, 155),
+ "burlywood2" => array(238, 197, 145),
+ "burlywood3" => array(205, 170, 125),
+ "burlywood4" => array(139, 115, 85),
+ "wheat1" => array(255, 231, 186),
+ "wheat2" => array(238, 216, 174),
+ "wheat3" => array(205, 186, 150),
+ "wheat4" => array(139, 126, 102),
+ "tan1" => array(255, 165, 79),
+ "tan2" => array(238, 154, 73),
+ "tan3" => array(205, 133, 63),
+ "tan4" => array(139, 90, 43),
+ "chocolate1" => array(255, 127, 36),
+ "chocolate2" => array(238, 118, 33),
+ "chocolate3" => array(205, 102, 29),
+ "chocolate4" => array(139, 69, 19),
+ "firebrick1" => array(255, 48, 48),
+ "firebrick2" => array(238, 44, 44),
+ "firebrick3" => array(205, 38, 38),
+ "firebrick4" => array(139, 26, 26),
+ "brown1" => array(255, 64, 64),
+ "brown2" => array(238, 59, 59),
+ "brown3" => array(205, 51, 51),
+ "brown4" => array(139, 35, 35),
+ "salmon1" => array(255, 140, 105),
+ "salmon2" => array(238, 130, 98),
+ "salmon3" => array(205, 112, 84),
+ "salmon4" => array(139, 76, 57),
+ "LightSalmon1" => array(255, 160, 122),
+ "LightSalmon2" => array(238, 149, 114),
+ "LightSalmon3" => array(205, 129, 98),
+ "LightSalmon4" => array(139, 87, 66),
+ "orange1" => array(255, 165, 0),
+ "orange2" => array(238, 154, 0),
+ "orange3" => array(205, 133, 0),
+ "orange4" => array(139, 90, 0),
+ "DarkOrange1" => array(255, 127, 0),
+ "DarkOrange2" => array(238, 118, 0),
+ "DarkOrange3" => array(205, 102, 0),
+ "DarkOrange4" => array(139, 69, 0),
+ "coral1" => array(255, 114, 86),
+ "coral2" => array(238, 106, 80),
+ "coral3" => array(205, 91, 69),
+ "coral4" => array(139, 62, 47),
+ "tomato1" => array(255, 99, 71),
+ "tomato2" => array(238, 92, 66),
+ "tomato3" => array(205, 79, 57),
+ "tomato4" => array(139, 54, 38),
+ "OrangeRed1" => array(255, 69, 0),
+ "OrangeRed2" => array(238, 64, 0),
+ "OrangeRed3" => array(205, 55, 0),
+ "OrangeRed4" => array(139, 37, 0),
+ "red1" => array(255, 0, 0),
+ "red2" => array(238, 0, 0),
+ "red3" => array(205, 0, 0),
+ "red4" => array(139, 0, 0),
+ "DeepPink1" => array(255, 20, 147),
+ "DeepPink2" => array(238, 18, 137),
+ "DeepPink3" => array(205, 16, 118),
+ "DeepPink4" => array(139, 10, 80),
+ "HotPink1" => array(255, 110, 180),
+ "HotPink2" => array(238, 106, 167),
+ "HotPink3" => array(205, 96, 144),
+ "HotPink4" => array(139, 58, 98),
+ "pink1" => array(255, 181, 197),
+ "pink2" => array(238, 169, 184),
+ "pink3" => array(205, 145, 158),
+ "pink4" => array(139, 99, 108),
+ "LightPink1" => array(255, 174, 185),
+ "LightPink2" => array(238, 162, 173),
+ "LightPink3" => array(205, 140, 149),
+ "LightPink4" => array(139, 95, 101),
+ "PaleVioletRed1" => array(255, 130, 171),
+ "PaleVioletRed2" => array(238, 121, 159),
+ "PaleVioletRed3" => array(205, 104, 137),
+ "PaleVioletRed4" => array(139, 71, 93),
+ "maroon1" => array(255, 52, 179),
+ "maroon2" => array(238, 48, 167),
+ "maroon3" => array(205, 41, 144),
+ "maroon4" => array(139, 28, 98),
+ "VioletRed1" => array(255, 62, 150),
+ "VioletRed2" => array(238, 58, 140),
+ "VioletRed3" => array(205, 50, 120),
+ "VioletRed4" => array(139, 34, 82),
+ "magenta1" => array(255, 0, 255),
+ "magenta2" => array(238, 0, 238),
+ "magenta3" => array(205, 0, 205),
+ "magenta4" => array(139, 0, 139),
+ "orchid1" => array(255, 131, 250),
+ "orchid2" => array(238, 122, 233),
+ "orchid3" => array(205, 105, 201),
+ "orchid4" => array(139, 71, 137),
+ "plum1" => array(255, 187, 255),
+ "plum2" => array(238, 174, 238),
+ "plum3" => array(205, 150, 205),
+ "plum4" => array(139, 102, 139),
+ "MediumOrchid1" => array(224, 102, 255),
+ "MediumOrchid2" => array(209, 95, 238),
+ "MediumOrchid3" => array(180, 82, 205),
+ "MediumOrchid4" => array(122, 55, 139),
+ "DarkOrchid1" => array(191, 62, 255),
+ "DarkOrchid2" => array(178, 58, 238),
+ "DarkOrchid3" => array(154, 50, 205),
+ "DarkOrchid4" => array(104, 34, 139),
+ "purple1" => array(155, 48, 255),
+ "purple2" => array(145, 44, 238),
+ "purple3" => array(125, 38, 205),
+ "purple4" => array( 85, 26, 139),
+ "MediumPurple1" => array(171, 130, 255),
+ "MediumPurple2" => array(159, 121, 238),
+ "MediumPurple3" => array(137, 104, 205),
+ "MediumPurple4" => array( 93, 71, 139),
+ "thistle1" => array(255, 225, 255),
+ "thistle2" => array(238, 210, 238),
+ "thistle3" => array(205, 181, 205),
+ "thistle4" => array(139, 123, 139),
+ "gray0" => array( 0, 0, 0),
+ "grey0" => array( 0, 0, 0),
+ "gray1" => array( 3, 3, 3),
+ "grey1" => array( 3, 3, 3),
+ "gray2" => array( 5, 5, 5),
+ "grey2" => array( 5, 5, 5),
+ "gray3" => array( 8, 8, 8),
+ "grey3" => array( 8, 8, 8),
+ "gray4" => array( 10, 10, 10),
+ "grey4" => array( 10, 10, 10),
+ "gray5" => array( 13, 13, 13),
+ "grey5" => array( 13, 13, 13),
+ "gray6" => array( 15, 15, 15),
+ "grey6" => array( 15, 15, 15),
+ "gray7" => array( 18, 18, 18),
+ "grey7" => array( 18, 18, 18),
+ "gray8" => array( 20, 20, 20),
+ "grey8" => array( 20, 20, 20),
+ "gray9" => array( 23, 23, 23),
+ "grey9" => array( 23, 23, 23),
+ "gray10" => array( 26, 26, 26),
+ "grey10" => array( 26, 26, 26),
+ "gray11" => array( 28, 28, 28),
+ "grey11" => array( 28, 28, 28),
+ "gray12" => array( 31, 31, 31),
+ "grey12" => array( 31, 31, 31),
+ "gray13" => array( 33, 33, 33),
+ "grey13" => array( 33, 33, 33),
+ "gray14" => array( 36, 36, 36),
+ "grey14" => array( 36, 36, 36),
+ "gray15" => array( 38, 38, 38),
+ "grey15" => array( 38, 38, 38),
+ "gray16" => array( 41, 41, 41),
+ "grey16" => array( 41, 41, 41),
+ "gray17" => array( 43, 43, 43),
+ "grey17" => array( 43, 43, 43),
+ "gray18" => array( 46, 46, 46),
+ "grey18" => array( 46, 46, 46),
+ "gray19" => array( 48, 48, 48),
+ "grey19" => array( 48, 48, 48),
+ "gray20" => array( 51, 51, 51),
+ "grey20" => array( 51, 51, 51),
+ "gray21" => array( 54, 54, 54),
+ "grey21" => array( 54, 54, 54),
+ "gray22" => array( 56, 56, 56),
+ "grey22" => array( 56, 56, 56),
+ "gray23" => array( 59, 59, 59),
+ "grey23" => array( 59, 59, 59),
+ "gray24" => array( 61, 61, 61),
+ "grey24" => array( 61, 61, 61),
+ "gray25" => array( 64, 64, 64),
+ "grey25" => array( 64, 64, 64),
+ "gray26" => array( 66, 66, 66),
+ "grey26" => array( 66, 66, 66),
+ "gray27" => array( 69, 69, 69),
+ "grey27" => array( 69, 69, 69),
+ "gray28" => array( 71, 71, 71),
+ "grey28" => array( 71, 71, 71),
+ "gray29" => array( 74, 74, 74),
+ "grey29" => array( 74, 74, 74),
+ "gray30" => array( 77, 77, 77),
+ "grey30" => array( 77, 77, 77),
+ "gray31" => array( 79, 79, 79),
+ "grey31" => array( 79, 79, 79),
+ "gray32" => array( 82, 82, 82),
+ "grey32" => array( 82, 82, 82),
+ "gray33" => array( 84, 84, 84),
+ "grey33" => array( 84, 84, 84),
+ "gray34" => array( 87, 87, 87),
+ "grey34" => array( 87, 87, 87),
+ "gray35" => array( 89, 89, 89),
+ "grey35" => array( 89, 89, 89),
+ "gray36" => array( 92, 92, 92),
+ "grey36" => array( 92, 92, 92),
+ "gray37" => array( 94, 94, 94),
+ "grey37" => array( 94, 94, 94),
+ "gray38" => array( 97, 97, 97),
+ "grey38" => array( 97, 97, 97),
+ "gray39" => array( 99, 99, 99),
+ "grey39" => array( 99, 99, 99),
+ "gray40" => array(102, 102, 102),
+ "grey40" => array(102, 102, 102),
+ "gray41" => array(105, 105, 105),
+ "grey41" => array(105, 105, 105),
+ "gray42" => array(107, 107, 107),
+ "grey42" => array(107, 107, 107),
+ "gray43" => array(110, 110, 110),
+ "grey43" => array(110, 110, 110),
+ "gray44" => array(112, 112, 112),
+ "grey44" => array(112, 112, 112),
+ "gray45" => array(115, 115, 115),
+ "grey45" => array(115, 115, 115),
+ "gray46" => array(117, 117, 117),
+ "grey46" => array(117, 117, 117),
+ "gray47" => array(120, 120, 120),
+ "grey47" => array(120, 120, 120),
+ "gray48" => array(122, 122, 122),
+ "grey48" => array(122, 122, 122),
+ "gray49" => array(125, 125, 125),
+ "grey49" => array(125, 125, 125),
+ "gray50" => array(127, 127, 127),
+ "grey50" => array(127, 127, 127),
+ "gray51" => array(130, 130, 130),
+ "grey51" => array(130, 130, 130),
+ "gray52" => array(133, 133, 133),
+ "grey52" => array(133, 133, 133),
+ "gray53" => array(135, 135, 135),
+ "grey53" => array(135, 135, 135),
+ "gray54" => array(138, 138, 138),
+ "grey54" => array(138, 138, 138),
+ "gray55" => array(140, 140, 140),
+ "grey55" => array(140, 140, 140),
+ "gray56" => array(143, 143, 143),
+ "grey56" => array(143, 143, 143),
+ "gray57" => array(145, 145, 145),
+ "grey57" => array(145, 145, 145),
+ "gray58" => array(148, 148, 148),
+ "grey58" => array(148, 148, 148),
+ "gray59" => array(150, 150, 150),
+ "grey59" => array(150, 150, 150),
+ "gray60" => array(153, 153, 153),
+ "grey60" => array(153, 153, 153),
+ "gray61" => array(156, 156, 156),
+ "grey61" => array(156, 156, 156),
+ "gray62" => array(158, 158, 158),
+ "grey62" => array(158, 158, 158),
+ "gray63" => array(161, 161, 161),
+ "grey63" => array(161, 161, 161),
+ "gray64" => array(163, 163, 163),
+ "grey64" => array(163, 163, 163),
+ "gray65" => array(166, 166, 166),
+ "grey65" => array(166, 166, 166),
+ "gray66" => array(168, 168, 168),
+ "grey66" => array(168, 168, 168),
+ "gray67" => array(171, 171, 171),
+ "grey67" => array(171, 171, 171),
+ "gray68" => array(173, 173, 173),
+ "grey68" => array(173, 173, 173),
+ "gray69" => array(176, 176, 176),
+ "grey69" => array(176, 176, 176),
+ "gray70" => array(179, 179, 179),
+ "grey70" => array(179, 179, 179),
+ "gray71" => array(181, 181, 181),
+ "grey71" => array(181, 181, 181),
+ "gray72" => array(184, 184, 184),
+ "grey72" => array(184, 184, 184),
+ "gray73" => array(186, 186, 186),
+ "grey73" => array(186, 186, 186),
+ "gray74" => array(189, 189, 189),
+ "grey74" => array(189, 189, 189),
+ "gray75" => array(191, 191, 191),
+ "grey75" => array(191, 191, 191),
+ "gray76" => array(194, 194, 194),
+ "grey76" => array(194, 194, 194),
+ "gray77" => array(196, 196, 196),
+ "grey77" => array(196, 196, 196),
+ "gray78" => array(199, 199, 199),
+ "grey78" => array(199, 199, 199),
+ "gray79" => array(201, 201, 201),
+ "grey79" => array(201, 201, 201),
+ "gray80" => array(204, 204, 204),
+ "grey80" => array(204, 204, 204),
+ "gray81" => array(207, 207, 207),
+ "grey81" => array(207, 207, 207),
+ "gray82" => array(209, 209, 209),
+ "grey82" => array(209, 209, 209),
+ "gray83" => array(212, 212, 212),
+ "grey83" => array(212, 212, 212),
+ "gray84" => array(214, 214, 214),
+ "grey84" => array(214, 214, 214),
+ "gray85" => array(217, 217, 217),
+ "grey85" => array(217, 217, 217),
+ "gray86" => array(219, 219, 219),
+ "grey86" => array(219, 219, 219),
+ "gray87" => array(222, 222, 222),
+ "grey87" => array(222, 222, 222),
+ "gray88" => array(224, 224, 224),
+ "grey88" => array(224, 224, 224),
+ "gray89" => array(227, 227, 227),
+ "grey89" => array(227, 227, 227),
+ "gray90" => array(229, 229, 229),
+ "grey90" => array(229, 229, 229),
+ "gray91" => array(232, 232, 232),
+ "grey91" => array(232, 232, 232),
+ "gray92" => array(235, 235, 235),
+ "grey92" => array(235, 235, 235),
+ "gray93" => array(237, 237, 237),
+ "grey93" => array(237, 237, 237),
+ "gray94" => array(240, 240, 240),
+ "grey94" => array(240, 240, 240),
+ "gray95" => array(242, 242, 242),
+ "grey95" => array(242, 242, 242),
+ "gray96" => array(245, 245, 245),
+ "grey96" => array(245, 245, 245),
+ "gray97" => array(247, 247, 247),
+ "grey97" => array(247, 247, 247),
+ "gray98" => array(250, 250, 250),
+ "grey98" => array(250, 250, 250),
+ "gray99" => array(252, 252, 252),
+ "grey99" => array(252, 252, 252),
+ "gray100" => array(255, 255, 255)
+);
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic