Методы и переменные класса CAsBarDiagram

InitData($legend_x, $legend_y) - выполняет очистку внутреннего массива накопленных значений для вывода. Необходима, если нужно многократно выводить диаграммы, пользуясь при этом одним и тем же экземпляром класса CAsBarDiagram. Размерности массива становится равными длинам переданных массивов "легенд" $legend_x, $legend_y

GatherData($sqltext, $legend_x, $legend_y [, $position_y]) - заполняет внутренний массив данными из переданного SQL-запроса. При наличии необходимых таблиц можно получить все данные в одном агрегирующем запросе. Для этого первое поле полученного курсора должно соответствовать значениям в legend_x, второе - $legend_y, а третье - быть искомым числовым значением, заносимым в массив.
Пример агрегирующего запроса (MySQL)

    SELECT MONTH(sale_date) AS mnt, product, SUM(sales_val) FROM sales
       WHERE YEAR(sale_date)=2005 GROUP BY mnt,product
  

     $graph->ShowPercents[План 2004'] = 'Выполнение плана 2004';
     $graph->ShowPercents[План 2005'] = 'Выполнение плана 2005';
     // Будут выведены две строки с процентными показателями!
     $graph->DiagramBar($legend_x, $legend_y, 0, $data_title);
  

$drawempty_x, $drawempty_y - переменные задают режим отрисовки "пустых" колонок (с нулевыми значениями) и строк (в цифровой части) соответственно. По умолчанию равны 1, т.е. отображаются все колонки, даже с одними нулевыми значениями, и все строки. Переменные нужно установить до вызова DiagramBar(). Для установки режима "скрывать пустые колонки,строки" можно воспользоваться методами HideEmptyXY($Hide=1),HideEmptyX($Hide=1),HideEmptyY($Hide=1)

     $grarh->drawempty_y = 0;
     $graph->HideEmptyY(); // оба оператора имеют одинаковый эффект
 

Следующие три переменные класса служат для превращения заголовков "легенды" в HTML-ссылки.

• legendx_url - здесь задается основная строка URL, с макросом "{ID}", который для каждого залоговка заменяется на соответствующее значение.

       $grarh = new CAsBarDiagram;
       $graph->legendx_url = 'detailedinfo.php?info_id={ID}';
     

  После задания этой переменной все наименования столбцов в выведенной диаграмме будут <A HREF>-ссылками
• legendx_onClick - строка для события onClick=... в ссылке. Используется, если вместо перехода по ссылке нужно выполнить javascript-функцию. Например, для открытия popup-окна (при "клике" по тексту заголовка) можно задать строку вида:

       $graph->legendx_onClick = "window.open('details.php?id={ID}', '_blank','height=300,width=400');";
     

• legendx_id - значения для подстановки вместо "{ID}" в адресах и значениях onClick. Если переменная не содержит массива, будут использованы сами строки заголовков столбцов.
  В случае подготовленных двумерных массивов легенд нужда в legendx_id отпадает.

require_once('as-diagrams.php'); // включить в тело своего скрипта !
//...
$data_title = 'Test bar diagram'; // title for the diagram

// sample data array
$data = array();

$data[] = array(900, 1300,1600);
$data[] = array(1200,1800,2500);
$data[] = array(1400,2000,2800);
$data[] = array(1900,2900,3900);
$data[] = array(2500,3500,4500);

$legend_x = array('Yanuary','February','March','April','May');
$legend_y = array('pens','pensils','staplers');

$graph = new CAsBarDiagram;
$graph->bwidth = 10; // set one bar width, pixels
$graph->bt_total = 'Summary'; // 'totals' column title, if other than 'Totals'
// $graph->showtotals = 0;  // uncomment it if You don't need 'totals' column
$graph->precision = 0;  // decimal precision
// call drawing function
$graph->DiagramBar($legend_x, $legend_y, $data, $data_title);

• Отображаемые данные могут иметь отрицательные значения, в этом случае график будет иметь вторую, "минусовую" часть. Масштабы по обеим частям выбираются автоматически.
  
  
• Чтобы управлять шириной одного столбика диаграммы, задайте свое значение (в пикселах) в переменной $bwidth до вызова функции DiagramBar();
• Если число строк в подготовленном массиве данных велико и приводит к отрисовке слишком широкой страницы, ширина столбика может быть автоматически понижена. Максимальной допустимой шириной окна при этом считается 1024 пиксела (стандартное разрешение монитора 1024 x 768). Если Вы хотите заблокировать эту функцию "подстройки", найдите и закомментируйте строку в модуле as-diagrams.php, имеющую вид :

    "var $autoshrink = 1024;"
    

  Либо задайте здесь свое значение максимальной ширины "экрана".
  
• Как Вы заметили, ось Y всегда имеет 4 "деления" (в одну сторону от нуля). Каждый "шаг" имеет высоту 60 пикселов (таким образом, общая высота Y-полуоси графика равна 240 px). Файл "bar-bg240.png" используется как фоновый для основной зоны графиков. Если понадобится сменить фон, просто отредактируйте этот файл. Если же нужно изменить "базовую" высоту (240px), придется выполнить больше действий: нарисовать новый файл фона, сохранить его под именем bar-bgNNNN.png (высота картинки должна быть 1/4 от желаемой новой полной высоты), и задать новое значение высоты в переменной $graf_height до вызова DiagramBar():
  $graf_height = NNNN;
  где NNNN - новая высота для полу-оси Y.
  Помните, что если данные содержат и положительные, и отрицательные значения, график может быть выше в два раза.
  
• По умолчанию "столбики" раскрашены "растянутыми" изображениями bar-xxxxx.png. Если нужно расположить картинку фона "плиткой", задайте непустое значение в переменной $btilemode до вызова DiagramBar(): $btilemode=1;
  Вероятно, для этого случая Вам понадобятся свои изображения вместо включенных в дистрибутив.
• Если Вы планируете выводить диаграммы для значений менее 1, точность представления дробной части имеет значение. В этом случае можно задать число дес.знаков в переменной $precision до вызова функции DiagramBar():
  $gtaph->precision = 4;
  Значение по умолчанию 2.

История (версии)

1.0.11 (16.01.2007)