| 1 | <?php
 | 
|---|
| 2 | //=======================================================================
 | 
|---|
| 3 | // File:        JPGRAPH_TEXT.INC.PHP
 | 
|---|
| 4 | // Description: Class to handle text as object in the graph.
 | 
|---|
| 5 | //              The low level text layout engine is handled by the GD class
 | 
|---|
| 6 | // Created:     2001-01-08 (Refactored to separate file 2008-08-01)
 | 
|---|
| 7 | // Ver:         $Id: jpgraph_text.inc.php 1844 2009-09-26 17:05:31Z ljp $
 | 
|---|
| 8 | //
 | 
|---|
| 9 | // Copyright (c) Asial Corporation. All rights reserved.
 | 
|---|
| 10 | //========================================================================
 | 
|---|
| 11 | 
 | 
|---|
| 12 | 
 | 
|---|
| 13 | //===================================================
 | 
|---|
| 14 | // CLASS Text
 | 
|---|
| 15 | // Description: Arbitrary text object that can be added to the graph
 | 
|---|
| 16 | //===================================================
 | 
|---|
| 17 | class Text {
 | 
|---|
| 18 |     public $t;
 | 
|---|
| 19 |     public $x=0,$y=0,$halign="left",$valign="top",$color=array(0,0,0);
 | 
|---|
| 20 |     public $hide=false, $dir=0;
 | 
|---|
| 21 |     public $iScalePosY=null,$iScalePosX=null;
 | 
|---|
| 22 |     public $iWordwrap=0;
 | 
|---|
| 23 |     public $font_family=FF_DEFAULT,$font_style=FS_NORMAL; // old. FF_FONT1
 | 
|---|
| 24 |     protected $boxed=false; // Should the text be boxed
 | 
|---|
| 25 |     protected $paragraph_align="left";
 | 
|---|
| 26 |     protected $icornerradius=0,$ishadowwidth=3;
 | 
|---|
| 27 |     protected $fcolor='white',$bcolor='black',$shadow=false;
 | 
|---|
| 28 |     protected $iCSIMarea='',$iCSIMalt='',$iCSIMtarget='',$iCSIMWinTarget='';
 | 
|---|
| 29 |     private $iBoxType = 1; // Which variant of filled box around text we want
 | 
|---|
| 30 | 
 | 
|---|
| 31 |     // for __get, __set
 | 
|---|
| 32 |     private $_margin;
 | 
|---|
| 33 |     private $_font_size=8; // old. 12
 | 
|---|
| 34 | 
 | 
|---|
| 35 |     //---------------
 | 
|---|
| 36 |     // CONSTRUCTOR
 | 
|---|
| 37 | 
 | 
|---|
| 38 |     // Create new text at absolute pixel coordinates
 | 
|---|
| 39 |     function __construct($aTxt="",$aXAbsPos=0,$aYAbsPos=0) {
 | 
|---|
| 40 |         if( ! is_string($aTxt) ) {
 | 
|---|
| 41 |             JpGraphError::RaiseL(25050);//('First argument to Text::Text() must be s atring.');
 | 
|---|
| 42 |         }
 | 
|---|
| 43 |         $this->t = $aTxt;
 | 
|---|
| 44 |         $this->x = round($aXAbsPos);
 | 
|---|
| 45 |         $this->y = round($aYAbsPos);
 | 
|---|
| 46 |         $this->margin = 0;
 | 
|---|
| 47 |     }
 | 
|---|
| 48 |     //---------------
 | 
|---|
| 49 |     // PUBLIC METHODS
 | 
|---|
| 50 |     // Set the string in the text object
 | 
|---|
| 51 |     function Set($aTxt) {
 | 
|---|
| 52 |         $this->t = $aTxt;
 | 
|---|
| 53 |     }
 | 
|---|
| 54 | 
 | 
|---|
| 55 |     // Alias for Pos()
 | 
|---|
| 56 |     function SetPos($aXAbsPos=0,$aYAbsPos=0,$aHAlign="left",$aVAlign="top") {
 | 
|---|
| 57 |     //$this->Pos($aXAbsPos,$aYAbsPos,$aHAlign,$aVAlign);
 | 
|---|
| 58 |         $this->x = $aXAbsPos;
 | 
|---|
| 59 |         $this->y = $aYAbsPos;
 | 
|---|
| 60 |         $this->halign = $aHAlign;
 | 
|---|
| 61 |         $this->valign = $aVAlign;
 | 
|---|
| 62 |     }
 | 
|---|
| 63 | 
 | 
|---|
| 64 |     function SetScalePos($aX,$aY) {
 | 
|---|
| 65 |         $this->iScalePosX = $aX;
 | 
|---|
| 66 |         $this->iScalePosY = $aY;
 | 
|---|
| 67 |     }
 | 
|---|
| 68 | 
 | 
|---|
| 69 |     // Specify alignment for the text
 | 
|---|
| 70 |     function Align($aHAlign,$aVAlign="top",$aParagraphAlign="") {
 | 
|---|
| 71 |         $this->halign = $aHAlign;
 | 
|---|
| 72 |         $this->valign = $aVAlign;
 | 
|---|
| 73 |         if( $aParagraphAlign != "" )
 | 
|---|
| 74 |             $this->paragraph_align = $aParagraphAlign;
 | 
|---|
| 75 |     }
 | 
|---|
| 76 | 
 | 
|---|
| 77 |     // Alias
 | 
|---|
| 78 |     function SetAlign($aHAlign,$aVAlign="top",$aParagraphAlign="") {
 | 
|---|
| 79 |         $this->Align($aHAlign,$aVAlign,$aParagraphAlign);
 | 
|---|
| 80 |     }
 | 
|---|
| 81 | 
 | 
|---|
| 82 |     // Specifies the alignment for a multi line text
 | 
|---|
| 83 |     function ParagraphAlign($aAlign) {
 | 
|---|
| 84 |         $this->paragraph_align = $aAlign;
 | 
|---|
| 85 |     }
 | 
|---|
| 86 | 
 | 
|---|
| 87 |     // Specifies the alignment for a multi line text
 | 
|---|
| 88 |     function SetParagraphAlign($aAlign) {
 | 
|---|
| 89 |         $this->paragraph_align = $aAlign;
 | 
|---|
| 90 |     }
 | 
|---|
| 91 | 
 | 
|---|
| 92 |     function SetShadow($aShadowColor='gray',$aShadowWidth=3) {
 | 
|---|
| 93 |         $this->ishadowwidth=$aShadowWidth;
 | 
|---|
| 94 |         $this->shadow=$aShadowColor;
 | 
|---|
| 95 |         $this->boxed=true;
 | 
|---|
| 96 |     }
 | 
|---|
| 97 | 
 | 
|---|
| 98 |     function SetWordWrap($aCol) {
 | 
|---|
| 99 |         $this->iWordwrap = $aCol ;
 | 
|---|
| 100 |     }
 | 
|---|
| 101 | 
 | 
|---|
| 102 |     // Specify that the text should be boxed. fcolor=frame color, bcolor=border color,
 | 
|---|
| 103 |     // $shadow=drop shadow should be added around the text.
 | 
|---|
| 104 |     function SetBox($aFrameColor=array(255,255,255),$aBorderColor=array(0,0,0),$aShadowColor=false,$aCornerRadius=4,$aShadowWidth=3) {
 | 
|---|
| 105 |         if( $aFrameColor === false ) {
 | 
|---|
| 106 |             $this->boxed=false;
 | 
|---|
| 107 |         }
 | 
|---|
| 108 |         else {
 | 
|---|
| 109 |             $this->boxed=true;
 | 
|---|
| 110 |         }
 | 
|---|
| 111 |         $this->fcolor=$aFrameColor;
 | 
|---|
| 112 |         $this->bcolor=$aBorderColor;
 | 
|---|
| 113 |         // For backwards compatibility when shadow was just true or false
 | 
|---|
| 114 |         if( $aShadowColor === true ) {
 | 
|---|
| 115 |             $aShadowColor = 'gray';
 | 
|---|
| 116 |         }
 | 
|---|
| 117 |         $this->shadow=$aShadowColor;
 | 
|---|
| 118 |         $this->icornerradius=$aCornerRadius;
 | 
|---|
| 119 |         $this->ishadowwidth=$aShadowWidth;
 | 
|---|
| 120 |     }
 | 
|---|
| 121 | 
 | 
|---|
| 122 |     function SetBox2($aFrameColor=array(255,255,255),$aBorderColor=array(0,0,0),$aShadowColor=false,$aCornerRadius=4,$aShadowWidth=3) {
 | 
|---|
| 123 |         $this->iBoxType=2;
 | 
|---|
| 124 |         $this->SetBox($aFrameColor,$aBorderColor,$aShadowColor,$aCornerRadius,$aShadowWidth);
 | 
|---|
| 125 |     }
 | 
|---|
| 126 | 
 | 
|---|
| 127 |     // Hide the text
 | 
|---|
| 128 |     function Hide($aHide=true) {
 | 
|---|
| 129 |         $this->hide=$aHide;
 | 
|---|
| 130 |     }
 | 
|---|
| 131 | 
 | 
|---|
| 132 |     // This looks ugly since it's not a very orthogonal design
 | 
|---|
| 133 |     // but I added this "inverse" of Hide() to harmonize
 | 
|---|
| 134 |     // with some classes which I designed more recently (especially)
 | 
|---|
| 135 |     // jpgraph_gantt
 | 
|---|
| 136 |     function Show($aShow=true) {
 | 
|---|
| 137 |         $this->hide=!$aShow;
 | 
|---|
| 138 |     }
 | 
|---|
| 139 | 
 | 
|---|
| 140 |     // Specify font
 | 
|---|
| 141 |     function SetFont($aFamily,$aStyle=FS_NORMAL,$aSize=10) {
 | 
|---|
| 142 |         $this->font_family=$aFamily;
 | 
|---|
| 143 |         $this->font_style=$aStyle;
 | 
|---|
| 144 |         $this->font_size=$aSize;
 | 
|---|
| 145 |     }
 | 
|---|
| 146 | 
 | 
|---|
| 147 |     // Center the text between $left and $right coordinates
 | 
|---|
| 148 |     function Center($aLeft,$aRight,$aYAbsPos=false) {
 | 
|---|
| 149 |         $this->x = $aLeft + ($aRight-$aLeft )/2;
 | 
|---|
| 150 |         $this->halign = "center";
 | 
|---|
| 151 |         if( is_numeric($aYAbsPos) )
 | 
|---|
| 152 |             $this->y = $aYAbsPos;
 | 
|---|
| 153 |     }
 | 
|---|
| 154 | 
 | 
|---|
| 155 |     // Set text color
 | 
|---|
| 156 |     function SetColor($aColor) {
 | 
|---|
| 157 |         $this->color = $aColor;
 | 
|---|
| 158 |     }
 | 
|---|
| 159 | 
 | 
|---|
| 160 |     function SetAngle($aAngle) {
 | 
|---|
| 161 |         $this->SetOrientation($aAngle);
 | 
|---|
| 162 |     }
 | 
|---|
| 163 | 
 | 
|---|
| 164 |     // Orientation of text. Note only TTF fonts can have an arbitrary angle
 | 
|---|
| 165 |     function SetOrientation($aDirection=0) {
 | 
|---|
| 166 |         if( is_numeric($aDirection) )
 | 
|---|
| 167 |             $this->dir=$aDirection;
 | 
|---|
| 168 |         elseif( $aDirection=="h" )
 | 
|---|
| 169 |             $this->dir = 0;
 | 
|---|
| 170 |         elseif( $aDirection=="v" )
 | 
|---|
| 171 |             $this->dir = 90;
 | 
|---|
| 172 |         else
 | 
|---|
| 173 |             JpGraphError::RaiseL(25051);//(" Invalid direction specified for text.");
 | 
|---|
| 174 |     }
 | 
|---|
| 175 | 
 | 
|---|
| 176 |     // Total width of text
 | 
|---|
| 177 |     function GetWidth($aImg) {
 | 
|---|
| 178 |         $aImg->SetFont($this->font_family,$this->font_style,$this->raw_font_size);
 | 
|---|
| 179 |         $w = $aImg->GetTextWidth($this->t,$this->dir);
 | 
|---|
| 180 |         return $w;
 | 
|---|
| 181 |     }
 | 
|---|
| 182 | 
 | 
|---|
| 183 |     // Hight of font
 | 
|---|
| 184 |     function GetFontHeight($aImg) {
 | 
|---|
| 185 |         $aImg->SetFont($this->font_family,$this->font_style,$this->raw_font_size);
 | 
|---|
| 186 |         $h = $aImg->GetFontHeight();
 | 
|---|
| 187 |         return $h;
 | 
|---|
| 188 | 
 | 
|---|
| 189 |     }
 | 
|---|
| 190 | 
 | 
|---|
| 191 |     function GetTextHeight($aImg) {
 | 
|---|
| 192 |         $aImg->SetFont($this->font_family,$this->font_style,$this->raw_font_size);
 | 
|---|
| 193 |         $h = $aImg->GetTextHeight($this->t,$this->dir);
 | 
|---|
| 194 |         return $h;
 | 
|---|
| 195 |     }
 | 
|---|
| 196 | 
 | 
|---|
| 197 |     function GetHeight($aImg) {
 | 
|---|
| 198 |     // Synonym for GetTextHeight()
 | 
|---|
| 199 |         $aImg->SetFont($this->font_family,$this->font_style,$this->raw_font_size);
 | 
|---|
| 200 |         $h = $aImg->GetTextHeight($this->t,$this->dir);
 | 
|---|
| 201 |         return $h;
 | 
|---|
| 202 |     }
 | 
|---|
| 203 | 
 | 
|---|
| 204 |     // Set the margin which will be interpretated differently depending
 | 
|---|
| 205 |     // on the context.
 | 
|---|
| 206 |     function SetMargin($aMarg) {
 | 
|---|
| 207 |         $this->margin = $aMarg;
 | 
|---|
| 208 |     }
 | 
|---|
| 209 | 
 | 
|---|
| 210 |     function StrokeWithScale($aImg,$axscale,$ayscale) {
 | 
|---|
| 211 |         if( $this->iScalePosX === null || $this->iScalePosY === null ) {
 | 
|---|
| 212 |             $this->Stroke($aImg);
 | 
|---|
| 213 |         }
 | 
|---|
| 214 |         else {
 | 
|---|
| 215 |             $this->Stroke($aImg,
 | 
|---|
| 216 |                 round($axscale->Translate($this->iScalePosX)),
 | 
|---|
| 217 |                 round($ayscale->Translate($this->iScalePosY)));
 | 
|---|
| 218 |         }
 | 
|---|
| 219 |     }
 | 
|---|
| 220 | 
 | 
|---|
| 221 |     function SetCSIMTarget($aURITarget,$aAlt='',$aWinTarget='') {
 | 
|---|
| 222 |         $this->iCSIMtarget = $aURITarget;
 | 
|---|
| 223 |         $this->iCSIMalt = $aAlt;
 | 
|---|
| 224 |         $this->iCSIMWinTarget = $aWinTarget;
 | 
|---|
| 225 |     }
 | 
|---|
| 226 | 
 | 
|---|
| 227 |     function GetCSIMareas() {
 | 
|---|
| 228 |         if( $this->iCSIMtarget !== '' ) {
 | 
|---|
| 229 |             return $this->iCSIMarea;
 | 
|---|
| 230 |         }
 | 
|---|
| 231 |         else {
 | 
|---|
| 232 |             return '';
 | 
|---|
| 233 |         }
 | 
|---|
| 234 |     }
 | 
|---|
| 235 | 
 | 
|---|
| 236 |     // Display text in image
 | 
|---|
| 237 |     function Stroke($aImg,$x=null,$y=null) {
 | 
|---|
| 238 | 
 | 
|---|
| 239 |         if( $x !== null ) $this->x = round($x);
 | 
|---|
| 240 |         if( $y !== null ) $this->y = round($y);
 | 
|---|
| 241 | 
 | 
|---|
| 242 |         // Insert newlines
 | 
|---|
| 243 |         if( $this->iWordwrap > 0 ) {
 | 
|---|
| 244 |             $this->t = wordwrap($this->t,$this->iWordwrap,"\n");
 | 
|---|
| 245 |         }
 | 
|---|
| 246 | 
 | 
|---|
| 247 |         // If position been given as a fraction of the image size
 | 
|---|
| 248 |         // calculate the absolute position
 | 
|---|
| 249 |         if( $this->x < 1 && $this->x > 0 ) $this->x *= $aImg->width;
 | 
|---|
| 250 |         if( $this->y < 1 && $this->y > 0 ) $this->y *= $aImg->height;
 | 
|---|
| 251 | 
 | 
|---|
| 252 |         $aImg->PushColor($this->color);
 | 
|---|
| 253 |         $aImg->SetFont($this->font_family,$this->font_style,$this->raw_font_size);
 | 
|---|
| 254 |         $aImg->SetTextAlign($this->halign,$this->valign);
 | 
|---|
| 255 | 
 | 
|---|
| 256 |         if( $this->boxed ) {
 | 
|---|
| 257 |             if( $this->fcolor=="nofill" ) {
 | 
|---|
| 258 |                 $this->fcolor=false;
 | 
|---|
| 259 |             }
 | 
|---|
| 260 | 
 | 
|---|
| 261 |             $oldweight=$aImg->SetLineWeight(1);
 | 
|---|
| 262 | 
 | 
|---|
| 263 |             if( $this->iBoxType == 2 && $this->font_family > FF_FONT2+2 ) {
 | 
|---|
| 264 | 
 | 
|---|
| 265 |                 $bbox = $aImg->StrokeBoxedText2($this->x, $this->y,
 | 
|---|
| 266 |                                                 $this->t, $this->dir,
 | 
|---|
| 267 |                                                 $this->fcolor,
 | 
|---|
| 268 |                                                 $this->bcolor,
 | 
|---|
| 269 |                                                 $this->shadow,
 | 
|---|
| 270 |                                                 $this->paragraph_align,
 | 
|---|
| 271 |                                                 2,4,
 | 
|---|
| 272 |                                                 $this->icornerradius,
 | 
|---|
| 273 |                                                 $this->ishadowwidth);
 | 
|---|
| 274 |             }
 | 
|---|
| 275 |             else {
 | 
|---|
| 276 |                 $bbox = $aImg->StrokeBoxedText($this->x,$this->y,$this->t,
 | 
|---|
| 277 |                     $this->dir,$this->fcolor,$this->bcolor,$this->shadow,
 | 
|---|
| 278 |                     $this->paragraph_align,3,3,$this->icornerradius,
 | 
|---|
| 279 |                     $this->ishadowwidth);
 | 
|---|
| 280 |             }
 | 
|---|
| 281 | 
 | 
|---|
| 282 |             $aImg->SetLineWeight($oldweight);
 | 
|---|
| 283 |         }
 | 
|---|
| 284 |         else {
 | 
|---|
| 285 |             $debug=false;
 | 
|---|
| 286 |             $bbox = $aImg->StrokeText($this->x,$this->y,$this->t,$this->dir,$this->paragraph_align,$debug);
 | 
|---|
| 287 |         }
 | 
|---|
| 288 | 
 | 
|---|
| 289 |         // Create CSIM targets
 | 
|---|
| 290 |         $coords = $bbox[0].','.$bbox[1].','.$bbox[2].','.$bbox[3].','.$bbox[4].','.$bbox[5].','.$bbox[6].','.$bbox[7];
 | 
|---|
| 291 |         $this->iCSIMarea = "<area shape=\"poly\" coords=\"$coords\" href=\"".htmlentities($this->iCSIMtarget)."\" ";
 | 
|---|
| 292 |         if( trim($this->iCSIMalt) != '' ) {
 | 
|---|
| 293 |             $this->iCSIMarea .= " alt=\"".$this->iCSIMalt."\" ";
 | 
|---|
| 294 |             $this->iCSIMarea .= " title=\"".$this->iCSIMalt."\" ";
 | 
|---|
| 295 |         }
 | 
|---|
| 296 |         if( trim($this->iCSIMWinTarget) != '' ) {
 | 
|---|
| 297 |             $this->iCSIMarea .= " target=\"".$this->iCSIMWinTarget."\" ";
 | 
|---|
| 298 |         }
 | 
|---|
| 299 |         $this->iCSIMarea .= " />\n";
 | 
|---|
| 300 | 
 | 
|---|
| 301 |         $aImg->PopColor($this->color);
 | 
|---|
| 302 |     }
 | 
|---|
| 303 | 
 | 
|---|
| 304 |     function __get($name) {
 | 
|---|
| 305 | 
 | 
|---|
| 306 |         if (strpos($name, 'raw_') !== false) {
 | 
|---|
| 307 |             // if $name == 'raw_left_margin' , return $this->_left_margin;
 | 
|---|
| 308 |             $variable_name = '_' . str_replace('raw_', '', $name);
 | 
|---|
| 309 |             return $this->$variable_name;
 | 
|---|
| 310 |         }
 | 
|---|
| 311 | 
 | 
|---|
| 312 |         $variable_name = '_' . $name; 
 | 
|---|
| 313 | 
 | 
|---|
| 314 |         if (isset($this->$variable_name)) {
 | 
|---|
| 315 |             return $this->$variable_name * SUPERSAMPLING_SCALE;
 | 
|---|
| 316 |         } else {
 | 
|---|
| 317 |             JpGraphError::RaiseL('25132', $name);
 | 
|---|
| 318 |         } 
 | 
|---|
| 319 |     }
 | 
|---|
| 320 | 
 | 
|---|
| 321 |     function __set($name, $value) {
 | 
|---|
| 322 |         $this->{'_'.$name} = $value;
 | 
|---|
| 323 |     }
 | 
|---|
| 324 | } // Class
 | 
|---|
| 325 | 
 | 
|---|
| 326 | 
 | 
|---|
| 327 | ?>
 | 
|---|