| <?php |
| /** |
| * File containing the ezcGraphDriverOption class |
| * |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, |
| * software distributed under the License is distributed on an |
| * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| * KIND, either express or implied. See the License for the |
| * specific language governing permissions and limitations |
| * under the License. |
| * |
| * @package Graph |
| * @version //autogentag// |
| * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0 |
| */ |
| /** |
| * Class containing the basic driver options. |
| * |
| * Most of the options of the driver class, like the width, height and font are |
| * set internally by the driver and not really relevant to the user of driver |
| * classes. You can configure how strings are automatically shortened, together |
| * with the postfix, which is appended to shortened strings, like the following |
| * example shows. |
| * |
| * Configuration options, which special to the actual drivers are configured in |
| * the driver specific extensions of this option class. |
| * |
| * <code> |
| * require_once 'tutorial_autoload.php'; |
| * |
| * $graph = new ezcGraphPieChart(); |
| * $graph->palette = new ezcGraphPaletteEzBlue(); |
| * $graph->title = 'Access statistics'; |
| * |
| * $graph->data['Access statistics'] = new ezcGraphArrayDataSet( array( |
| * 'Mozilla' => 19113, |
| * 'Explorer' => 10917, |
| * 'Opera' => 1464, |
| * 'Safari' => 652, |
| * 'Konqueror' => 474, |
| * ) ); |
| * |
| * // Do not shorten strings automatically if they do not fit in the assigned |
| * // space with the minimum font size. |
| * $graph->driver->options->autoShortenString = false; |
| * |
| * $graph->render( 400, 150, 'tutorial_chart_title.svg' ); |
| * </code> |
| * |
| * @property int $width |
| * Width of the chart. |
| * @property int $height |
| * Height of the chart. |
| * @property float $shadeCircularArc |
| * Percent to darken circular arcs at the sides |
| * @property float $lineSpacing |
| * Percent of font size used for line spacing |
| * @property int $font |
| * Font used in the graph. |
| * @property bool $autoShortenString |
| * Automatically shorten string if it do not fit into the available |
| * space, even with the minimum font size used. Deactivating this |
| * setting will result in ezcGraphFontRenderingException exceptions, |
| * informing you about the actual string which did not fit. |
| * @property string $autoShortenStringPostFix |
| * String to append to shortened strings, if there is enough space |
| * left for the postfix. |
| * |
| * @version //autogentag// |
| * @package Graph |
| */ |
| abstract class ezcGraphDriverOptions extends ezcBaseOptions |
| { |
| /** |
| * Constructor |
| * |
| * @param array $options Default option array |
| * @return void |
| * @ignore |
| */ |
| public function __construct( array $options = array() ) |
| { |
| $this->properties['width'] = null; |
| $this->properties['height'] = null; |
| |
| $this->properties['lineSpacing'] = .1; |
| $this->properties['shadeCircularArc'] = .5; |
| $this->properties['font'] = new ezcGraphFontOptions(); |
| $this->properties['font']->color = ezcGraphColor::fromHex( '#000000' ); |
| |
| $this->properties['autoShortenString'] = true; |
| $this->properties['autoShortenStringPostFix'] = '..'; |
| |
| parent::__construct( $options ); |
| } |
| |
| /** |
| * Set an option value |
| * |
| * @param string $propertyName |
| * @param mixed $propertyValue |
| * @throws ezcBasePropertyNotFoundException |
| * If a property is not defined in this class |
| * @return void |
| */ |
| public function __set( $propertyName, $propertyValue ) |
| { |
| switch ( $propertyName ) |
| { |
| case 'width': |
| if ( !is_numeric( $propertyValue ) || |
| ( $propertyValue < 1 ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'int >= 1' ); |
| } |
| |
| $this->properties['width'] = (int) $propertyValue; |
| break; |
| case 'height': |
| if ( !is_numeric( $propertyValue ) || |
| ( $propertyValue < 1 ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'int >= 1' ); |
| } |
| |
| $this->properties['height'] = (int) $propertyValue; |
| break; |
| case 'lineSpacing': |
| if ( !is_numeric( $propertyValue ) || |
| ( $propertyValue < 0 ) || |
| ( $propertyValue > 1 ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, '0 <= float <= 1' ); |
| } |
| |
| $this->properties['lineSpacing'] = (float) $propertyValue; |
| break; |
| case 'shadeCircularArc': |
| if ( !is_numeric( $propertyValue ) || |
| ( $propertyValue < 0 ) || |
| ( $propertyValue > 1 ) ) |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, '0 <= float <= 1' ); |
| } |
| |
| $this->properties['shadeCircularArc'] = (float) $propertyValue; |
| break; |
| case 'font': |
| if ( $propertyValue instanceof ezcGraphFontOptions ) |
| { |
| $this->properties['font'] = $propertyValue; |
| } |
| else |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'ezcGraphFontOptions' ); |
| } |
| break; |
| case 'autoShortenString': |
| if ( is_bool( $propertyValue ) ) |
| { |
| $this->properties['autoShortenString'] = $propertyValue; |
| } |
| else |
| { |
| throw new ezcBaseValueException( $propertyName, $propertyValue, 'boolean' ); |
| } |
| break; |
| case 'autoShortenStringPostFix': |
| $this->properties['autoShortenStringPostFix'] = (string) $propertyValue; |
| break; |
| default: |
| throw new ezcBasePropertyNotFoundException( $propertyName ); |
| break; |
| } |
| } |
| } |
| |
| ?> |