1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
<?php defined('SYSPATH') OR die('No direct access allowed.');
/**
* Image API driver.
*
* $Id: Image.php 3769 2008-12-15 00:48:56Z zombor $
*
* @package Image
* @author Kohana Team
* @copyright (c) 2007-2008 Kohana Team
* @license http://kohanaphp.com/license.html
*/
abstract class Image_Driver {
// Reference to the current image
protected $image;
// Reference to the temporary processing image
protected $tmp_image;
// Processing errors
protected $errors = array();
/**
* Executes a set of actions, defined in pairs.
*
* @param array actions
* @return boolean
*/
public function execute($actions)
{
foreach ($actions as $func => $args)
{
if ( ! $this->$func($args))
return FALSE;
}
return TRUE;
}
/**
* Sanitize and normalize a geometry array based on the temporary image
* width and height. Valid properties are: width, height, top, left.
*
* @param array geometry properties
* @return void
*/
protected function sanitize_geometry( & $geometry)
{
list($width, $height) = $this->properties();
// Turn off error reporting
$reporting = error_reporting(0);
// Width and height cannot exceed current image size
$geometry['width'] = min($geometry['width'], $width);
$geometry['height'] = min($geometry['height'], $height);
// Set standard coordinates if given, otherwise use pixel values
if ($geometry['top'] === 'center')
{
$geometry['top'] = floor(($height / 2) - ($geometry['height'] / 2));
}
elseif ($geometry['top'] === 'top')
{
$geometry['top'] = 0;
}
elseif ($geometry['top'] === 'bottom')
{
$geometry['top'] = $height - $geometry['height'];
}
// Set standard coordinates if given, otherwise use pixel values
if ($geometry['left'] === 'center')
{
$geometry['left'] = floor(($width / 2) - ($geometry['width'] / 2));
}
elseif ($geometry['left'] === 'left')
{
$geometry['left'] = 0;
}
elseif ($geometry['left'] === 'right')
{
$geometry['left'] = $width - $geometry['height'];
}
// Restore error reporting
error_reporting($reporting);
}
/**
* Return the current width and height of the temporary image. This is mainly
* needed for sanitizing the geometry.
*
* @return array width, height
*/
abstract protected function properties();
/**
* Process an image with a set of actions.
*
* @param string image filename
* @param array actions to execute
* @param string destination directory path
* @param string destination filename
* @return boolean
*/
abstract public function process($image, $actions, $dir, $file);
/**
* Flip an image. Valid directions are horizontal and vertical.
*
* @param integer direction to flip
* @return boolean
*/
abstract function flip($direction);
/**
* Crop an image. Valid properties are: width, height, top, left.
*
* @param array new properties
* @return boolean
*/
abstract function crop($properties);
/**
* Resize an image. Valid properties are: width, height, and master.
*
* @param array new properties
* @return boolean
*/
abstract public function resize($properties);
/**
* Rotate an image. Valid amounts are -180 to 180.
*
* @param integer amount to rotate
* @return boolean
*/
abstract public function rotate($amount);
/**
* Sharpen and image. Valid amounts are 1 to 100.
*
* @param integer amount to sharpen
* @return boolean
*/
abstract public function sharpen($amount);
/**
* Overlay a second image. Valid properties are: overlay_file, mime, x, y and transparency.
*
* @return boolean
*/
abstract public function composite($properties);
} // End Image Driver
|
