EZ-Components

2026-07-24 10:22:18 +00:00 · 2009-02-17 15:27:43 +00:00
parent 359c3c55c9
commit 0a8e90a8b3
572 changed files with 64490 additions and 0 deletions
@@ -0,0 +1,202 @@
+<?php
+/**
+ * File containing the ezcGraphChartElementBackground class
+ *
+ * @package Graph
+ * @version 1.3
+ * @copyright Copyright (C) 2005-2008 eZ systems as. All rights reserved.
+ * @license http://ez.no/licenses/new_bsd New BSD License
+ */
+/**
+ * Chart element representing the background. In addition to the standard 
+ * background and border for chart elements it can draw an image on the chart 
+ * background, and optionally repeat it. The position will be used for the 
+ * repetition offset.
+ *
+ * <code>
+ *  $chart->background->image = 'background.png';
+ *
+ *  // Image will be repeated horizontal at the top of the background
+ *  $chart->background->repeat = ezcGraph::HORIZONTAL;
+ *  $chart->background->postion = ezcGraph::TOP;
+ *
+ *  // Image will be placed once in the center
+ *  $chart->background->repeat = ezcGraph::NO_REPEAT; // default;
+ *  $chart->background->position = ezcGraph::CENTER | ezcGraph::MIDDLE;
+ *
+ *  // Image will be repeated all over
+ *  $chart->background->repeat = ezcGraph::HORIZONTAL | ezcGraph::VERTICAL;
+ *      // The position is not relevant here.
+ * </code>
+ *
+ * @property string $image
+ *           Filename of the file to use for background
+ * @property int $repeat
+ *           Defines how the background image gets repeated
+ *
+ * @version 1.3
+ * @package Graph
+ * @mainclass
+ */
+class ezcGraphChartElementBackground extends ezcGraphChartElement
+{
+
+    /**
+     * Constructor
+     * 
+     * @param array $options Default option array
+     * @return void
+     * @ignore
+     */
+    public function __construct( array $options = array() )
+    {
+        $this->properties['image'] = false;
+        $this->properties['repeat'] = ezcGraph::NO_REPEAT;
+
+        parent::__construct( $options );
+    }
+
+    /**
+     * __set 
+     * 
+     * @param mixed $propertyName 
+     * @param mixed $propertyValue 
+     * @throws ezcBaseValueException
+     *          If a submitted parameter was out of range or type.
+     * @throws ezcBasePropertyNotFoundException
+     *          If a the value for the property options is not an instance of
+     * @return void
+     * @ignore
+     */
+    public function __set( $propertyName, $propertyValue )
+    {
+        switch ( $propertyName )
+        {
+            case 'image':
+                // Check for existance of file
+                if ( !is_file( $propertyValue ) || !is_readable( $propertyValue ) )
+                {
+                    throw new ezcBaseFileNotFoundException( $propertyValue );
+                }
+
+                // Check for beeing an image file
+                $data = getImageSize( $propertyValue );
+                if ( $data === false )
+                {
+                    throw new ezcGraphInvalidImageFileException( $propertyValue );
+                }
+
+                // SWF files are useless..
+                if ( $data[2] === 4 ) 
+                {
+                    throw new ezcGraphInvalidImageFileException( 'We cant use SWF files like <' . $propertyValue . '>.' );
+                }
+
+                $this->properties['image'] = $propertyValue;
+                break;
+            case 'repeat':
+                if ( ( $propertyValue >= 0 ) && ( $propertyValue <= 3 ) )
+                {
+                    $this->properties['repeat'] = (int) $propertyValue;
+                }
+                else
+                {
+                    throw new ezcBaseValueException( $propertyName, $propertyValue, '0 <= int <= 3' );
+                }
+                break;
+            case 'position':
+                // Overwrite parent position setter, to be able to use 
+                // combination of positions like 
+                //      ezcGraph::TOP | ezcGraph::CENTER
+                if ( is_int( $propertyValue ) )
+                {
+                    $this->properties['position'] = $propertyValue;
+                }
+                else 
+                {
+                    throw new ezcBaseValueException( $propertyName, $propertyValue, 'integer' );
+                }
+                break;
+            case 'color':
+                // Use color as an alias to set background color for background
+                $this->__set( 'background', $propertyValue );
+                break;
+            default:
+                return parent::__set( $propertyName, $propertyValue );
+        }
+    }
+
+    /**
+     * __get 
+     * 
+     * @param mixed $propertyName 
+     * @throws ezcBasePropertyNotFoundException
+     *          If a the value for the property options is not an instance of
+     * @return mixed
+     * @ignore
+     */
+    public function __get( $propertyName )
+    {
+        switch ( $propertyName )
+        {
+            case 'color':
+                // Use color as an alias to set background color for background
+                return $this->properties['background'];
+            default:
+                return parent::__get( $propertyName );
+        }
+    }
+
+    /**
+     * Set colors and border for this element
+     *
+     * Method is overwritten because we do not ant to apply the global padding 
+     * and margin here.
+     * 
+     * @param ezcGraphPalette $palette Palette
+     * @return void
+     */
+    public function setFromPalette( ezcGraphPalette $palette )
+    {
+        $this->border = $palette->chartBorderColor;
+        $this->borderWidth = $palette->chartBorderWidth;
+        $this->background = $palette->chartBackground;
+        $this->padding = 0;
+        $this->margin = 0;
+    }
+
+    /**
+     * Render the background
+     *
+     * @param ezcGraphRenderer $renderer Renderer
+     * @param ezcGraphBoundings $boundings Boundings
+     * @return ezcGraphBoundings Remaining boundings
+     */
+    public function render( ezcGraphRenderer $renderer, ezcGraphBoundings $boundings )
+    {
+        $boundings = $renderer->drawBox(
+            $boundings,
+            $this->background,
+            $this->border,
+            $this->borderWidth,
+            $this->margin,
+            $this->padding
+        );
+
+        if ( $this->image === false )
+        {
+            return $boundings;
+        }
+
+        $renderer->drawBackgroundImage(
+            $boundings,
+            $this->image,
+            $this->position,
+            $this->repeat
+        );
+
+        return $boundings;
+    }
+}
+
+?>