/**
* Renders the background for the given box object using an output driver
*
* @param OutputDriver $driver Output driver to be used
* @param GenericFormattedBox $box Box the background is rendered for
*
* @uses GenericFormattedBox
* @uses OutputDriver
*/
function show(&$driver, &$box)
{
/**
* Fill box with background color
*
* @see Color::apply
* @see OutputDriver::moveto
* @see OutputDriver::lineto
* @see OutputDriver::closepath
* @see OutputDriver::fill
*/
if (!$this->_color->transparent) {
$this->_color->apply($driver);
$driver->moveto($box->get_left_padding(), $box->get_top_padding());
$driver->lineto($box->get_right_padding(), $box->get_top_padding());
$driver->lineto($box->get_right_padding(), $box->get_bottom_padding());
$driver->lineto($box->get_left_padding(), $box->get_bottom_padding());
$driver->closepath();
$driver->fill();
}
/**
* Render background image
*
* @see BackgroundImage::show
*/
$this->_image->show($driver, $box, $this->_repeat, $this->_position);
}
/**
* Renders the backgroung image using the specified output driver.
*
* @param OutputDriver $driver an output driver object
* @param GenericFormattedBox $box an box owning this background image
* @param int $repeat the 'background-repeat' value
* @param BackgroundPosition $position the 'background-position' value
*
* @uses BackgroundPosition
* @uses OutputDriver
*/
function show(&$driver, $box, $repeat, $position)
{
/**
* If no image should be rendered, just return
* @see BackgroundImage::$_url
*/
if ($this->_url == null) {
return;
}
if (is_null($this->_image)) {
return;
}
/**
* Setup clipping region for padding area. Note that background image is drawn in the padding
* area which in generic case is greater than content area.
*
* @see OutputDriver::clip()
*
* @link http://www.w3.org/TR/CSS21/box.html#box-padding-area CSS 2.1 definition of padding area
*/
$driver->save();
$driver->moveto($box->get_left_padding(), $box->get_top_padding());
$driver->lineto($box->get_right_padding(), $box->get_top_padding());
$driver->lineto($box->get_right_padding(), $box->get_bottom_padding());
$driver->lineto($box->get_left_padding(), $box->get_bottom_padding());
$driver->closepath();
$driver->clip();
/**
* get real image size in device points
*
* @see pt2pt()
* @see px2pt()
*/
$image_height = px2pt(imagesy($this->_image));
$image_width = px2pt(imagesx($this->_image));
/**
* Get dimensions of the rectangle to be filled with the background image
*/
$padding_width = $box->get_width() + $box->get_padding_left() + $box->get_padding_right();
$padding_height = $box->get_height() + $box->get_padding_top() + $box->get_padding_bottom();
/**
* Calculate the vertical offset from the top padding edge to the background image top edge using current
* 'background-position' value.
*
* @link file:///C:/docs/css/colors.html#propdef-background-position CSS 2 'background-position' description
*/
if ($position->x_percentage) {
$x_offset = ($padding_width - $image_width) * $position->x / 100;
} else {
$x_offset = $position->x;
}
/**
* Calculate the horizontal offset from the left padding edge to the background image left edge using current
* 'background-position' value
*
* @link file:///C:/docs/css/colors.html#propdef-background-position CSS 2 'background-position' description
*/
if ($position->y_percentage) {
$y_offset = ($padding_height - $image_height) * $position->y / 100;
} else {
$y_offset = $position->y;
}
/**
* Output the image (probably tiling it; depends on current value of 'background-repeat') using
* current output driver's tiled image output functions. Note that px2pt(1) is an image scaling factor; as all
* page element are scaled to fit the media, background images should be scaled too!
*
* @see OutputDriver::image()
* @see OutputDriver::image_rx()
* @see OutputDriver::image_ry()
* @see OutputDriver::image_rxry()
*
* @link file:///C:/docs/css/colors.html#propdef-background-repeat CSS 2.1 'background-repeat' property description
*/
switch ($repeat) {
case BR_NO_REPEAT:
/**
* 'background-repeat: no-repeat' case; no tiling at all
*/
$driver->image($this->_image, $box->get_left_padding() + $x_offset, $box->get_top_padding() - $image_height - $y_offset, px2pt(1));
break;
case BR_REPEAT_X:
/**
* 'background-repeat: repeat-x' case; horizontal tiling
*/
$driver->image_rx($this->_image, $box->get_left_padding() + $x_offset, $box->get_top_padding() - $image_height - $y_offset, $image_width, $box->get_right_padding(), $x_offset, $y_offset, px2pt(1));
break;
case BR_REPEAT_Y:
/**
* 'background-repeat: repeat-y' case; vertical tiling
*/
$driver->image_ry($this->_image, $box->get_left_padding() + $x_offset, $box->get_top_padding() - $image_height - $y_offset, $image_height, $box->get_bottom_padding(), $x_offset, $y_offset, px2pt(1));
break;
case BR_REPEAT:
/**
* 'background-repeat: repeat' case; full tiling
*/
$driver->image_rx_ry($this->_image, $box->get_left_padding() + $x_offset, $box->get_top_padding() - $image_height + $y_offset, $image_width, $image_height, $box->get_right_padding(), $box->get_bottom_padding(), $x_offset, $y_offset, px2pt(1));
break;
}
/**
* Restore the previous clipping area
*
* @see OutputDriver::clip()
* @see OutputDriver::restore()
*/
$driver->restore();
}