Source for file matrix.php

Documentation is available at matrix.php

  1. <?php
  2. /**
  3. * Booking matrix object for display in a table
  4. *
  5. * @author    Stuart Prescott
  6. * @copyright  Copyright Stuart Prescott
  7. * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  8. * @version    $Id$
  9. * @package    Bumblebee
  10. * @subpackage Bookings
  11. */
  12.  
  13. /** Load ancillary functions */
  14. require_once 'inc/typeinfo.php';
  15. checkValidInclude();
  16.  
  17. /**
  18. * Booking matrix object for display in a table
  19. *
  20. * @package    Bumblebee
  21. * @subpackage Bookings
  22. * @todo //TODO:       documentation
  23. */
  24. class BookingMatrix {
  25.   var $dayStart;
  26.   var $dayStop;
  27.   var $day; 
  28.   var $granularity;
  29.   var $bookings;
  30.   var $numRows;
  31.   var $rows;
  32.   var $_lastnum = 0;
  33.   
  34.   function BookingMatrix($dayStart, $dayStop, $granularity, &$bookings) {
  35.     $this->dayStart    = $dayStart;
  36.     $this->dayStop     = $dayStop;
  37.     $this->granularity = $granularity;
  38.     $this->bookings    = $bookings;
  39.   }
  40.   
  41.   function setDate($date) {
  42.     $this->day = $date;
  43.     $this->rows = array();
  44.   }
  45.   
  46.   function getMatrix() {
  47.     return $this->rows;
  48.   }
  49.  
  50.   function prepareMatrix() {
  51.     $this->numRows = $this->dayStop->subtract($this->dayStart)
  52.                         / $this->granularity;
  53.     $numBookings = count($this->bookings);
  54.  
  55.     #echo "Preparing matrix with $this->numRows rows for date "
  56.         #.$this->day->dateString()."<br/>\n";
  57.  
  58.     // keep track of where we got up to in the calculations (reduces O(n2) to O(n))
  59.     // provides 25% performance boost to this function
  60.     $startnum = ($this->_lastnum - 2 > 0) ? $this->_lastnum : 0;
  61.     $foundFlag = false;
  62.  
  63.     // foreach is much more expensive than for and since this function is called repeatedly,
  64.     // it's best not to do that. (function is 20% faster from this change)
  65.     //foreach ($this->bookings as $booknum => $b) {
  66.     for ($booknum = $startnum; $booknum < $numBookings; $booknum++) {
  67.       $b = $this->bookings[$booknum];
  68.       #echo "Booking $k, ".$b->start->dateTimeString()." - ".$b->stop->dateTimeString()."<br />";
  69.       // the TimeSlot object will cache the dayStart and dayStop calculations.
  70.       // (function is 50% faster with this change)
  71.       $bookDay = clone($this->bookings[$booknum]->dayStart());
  72.       $bookStopDay = clone($this->bookings[$booknum]->dayStop());
  73.       #echo "Checking eligibility for booking: ".$this->day->ticks .'='.$bookDay->ticks.'||'.$bookStopDay->ticks.'<br />';
  74.       if ($bookDay->ticks == $this->day->ticks) {
  75.         $foundFlag = true;
  76.         $bookDayStart = clone($bookDay);
  77.         $mystart = clone( isset($b->displayStart) ? $b->displayStart : $b->start );
  78.         $mystop  = clone( isset($b->displayStop)  ? $b->displayStop  : $b->stop  );
  79.         $bookDayStart->setTime($this->dayStart);
  80.         //$starttime = $b->start->subtract($bookDayStart);
  81.         $starttime = $mystart->subtract($bookDayStart);
  82.         if ($starttime > 0) {
  83.           //then the start of the booking is after the start time of the matrix
  84.           $rowstart = floor($starttime/$this->granularity);
  85.         } else {
  86.           //the booking starts before the matrix; starting row adjusted
  87.           $rowstart = 0;
  88.         }
  89.         $bookDayStop = clone($bookDay);
  90.         $bookDayStop->setTime($this->dayStop);
  91.         //$stoptime = $b->stop->subtract($bookDayStop);
  92.         $stoptime = $mystop->subtract($bookDayStop);
  93.         if ($stoptime < 0) {
  94.           //the stop time is before the stop time of the matrix
  95.           //$stoptimestart = $b->stop->subtract($bookDayStart);
  96.           $stoptimestart = $mystop->subtract($bookDayStart);
  97.           $rowstop = floor($stoptimestart/$this->granularity);
  98.         } else {
  99.           //the stop time is after the stop time of the matrix,
  100.           //adjust the duration
  101.           $rowstop = $this->numRows;
  102.         }
  103.         $rowspan = round($rowstop - $rowstart);
  104.  
  105.         // Only add the cell to the matrix if the cell doesn't already have an entry in it.
  106.         // Otherwise, the second part of a booking that is split across multiple slots would
  107.         // overwrite the earlier part.
  108.         if (! isset($this->rows[$rowstart]) && $rowspan > 0) {
  109.           $cell = new BookingCell($this->bookings[$booknum],$this->bookings[$booknum]->isStart,$rowspan);
  110.           $this->rows[$rowstart] = $cell;
  111.         }
  112.       } else {
  113.         // since the list of bookings should be in date order, once we get a negative match
  114.         // we can return
  115.         if ($foundFlag) {
  116.           $this->_lastnum = $booknum;
  117.           return;
  118.         }
  119.       }
  120.     }
  121.     $this->_lastnum = $booknum;
  122.   }
  123.  
  124. } //class BookingMatrix
  125. ?>

Documentation generated on Tue, 06 Mar 2007 10:01:45 +0000 by phpDocumentor 1.3.0