1 | <?php /* |
---|
2 | Plugin Name: Exif View |
---|
3 | Version: 0.2 |
---|
4 | Description: Converts EXIF values to human readable localized values. Corresponds to EXIF specification 2.2, details in http://www.exif.org. Easily extensible. |
---|
5 | Plugin URI: http://www.phpwebgallery.net |
---|
6 | Author: Martin Javorek |
---|
7 | Author URI: mailto:maple@seznam.cz&subject=PWG%20EXIF%20View |
---|
8 | */ |
---|
9 | |
---|
10 | /* |
---|
11 | ------------------------------------------------------------------------------- |
---|
12 | Change log: |
---|
13 | |
---|
14 | 0.2, 23th August 2007 |
---|
15 | - exposurue bias fix, date time original formatting |
---|
16 | |
---|
17 | 0.1, 1st August 2007 |
---|
18 | - initial version |
---|
19 | |
---|
20 | |
---|
21 | ------------------------------------------------------------------------------- |
---|
22 | |
---|
23 | Extend your configuration in /include/config.local.inc.php file - example: |
---|
24 | |
---|
25 | $conf['show_exif_fields'] = array( |
---|
26 | 'Make', |
---|
27 | 'Model', |
---|
28 | 'ExifVersion', |
---|
29 | 'Software', |
---|
30 | 'DateTimeOriginal', |
---|
31 | 'FNumber', |
---|
32 | 'ExposureBiasValue', |
---|
33 | 'FILE;FileSize', |
---|
34 | 'ExposureTime', |
---|
35 | 'Flash', |
---|
36 | 'ISOSpeedRatings', |
---|
37 | 'FocalLength', |
---|
38 | 'FocalLengthIn35mmFilm', |
---|
39 | 'WhiteBalance', |
---|
40 | 'ExposureMode', |
---|
41 | 'MeteringMode', |
---|
42 | 'ExposureProgram', |
---|
43 | 'LightSource', |
---|
44 | 'Contrast', |
---|
45 | 'Saturation', |
---|
46 | 'Sharpness', |
---|
47 | ); |
---|
48 | |
---|
49 | */ |
---|
50 | |
---|
51 | add_event_handler('format_exif_data', 'exif_translation' ); |
---|
52 | |
---|
53 | /** |
---|
54 | * Date and time format. |
---|
55 | * @see http://cz2.php.net/manual/en/function.date.php |
---|
56 | */ |
---|
57 | define('DATE_TIME_FORMAT', 'H:i:s j.n.Y'); |
---|
58 | |
---|
59 | /** |
---|
60 | * Truncates number. |
---|
61 | * |
---|
62 | * @param num number |
---|
63 | * @param digits number of digits, default 0 |
---|
64 | */ |
---|
65 | function truncate($num, $digits = 0) { |
---|
66 | $shift = pow(10 , $digits); |
---|
67 | return ((floor($num * $shift)) / $shift); |
---|
68 | } |
---|
69 | |
---|
70 | /** |
---|
71 | * Format date. |
---|
72 | * |
---|
73 | * @param date given EXIF date |
---|
74 | */ |
---|
75 | function formatDate($date) { |
---|
76 | $dateTime = explode(' ', $date); |
---|
77 | $d = explode(':', $dateTime[0]); |
---|
78 | $t = explode(':', $dateTime[1]); |
---|
79 | // beware of american date format for mktime, it accepts date in M/D/Y ;-) |
---|
80 | return date(DATE_TIME_FORMAT, mktime($t[0], $t[1], $t[2], $d[1], $d[2], $d[0])); |
---|
81 | } |
---|
82 | |
---|
83 | /** |
---|
84 | * EXIF translation. |
---|
85 | * |
---|
86 | * @param $key EXIF key name |
---|
87 | * @param $value EXIF key value |
---|
88 | * @return translated value depending on key meaning and choosed language |
---|
89 | */ |
---|
90 | function exif_key_translation($key, $value) { |
---|
91 | // EXIF |
---|
92 | if (!(strpos($key, 'ExifVersion') === FALSE)) { |
---|
93 | return $value[1].'.'.$value[2]; |
---|
94 | } |
---|
95 | |
---|
96 | // Date Time Original |
---|
97 | if (!(strpos($key, 'DateTimeOriginal') === FALSE)) { |
---|
98 | return formatDate($value); |
---|
99 | } |
---|
100 | |
---|
101 | // exposure time |
---|
102 | if (!(strpos($key, 'ExposureTime') === FALSE)) { |
---|
103 | $tokens = explode('/', $value); |
---|
104 | while ($tokens[0] % 10 == 0) { |
---|
105 | $tokens[0] = $tokens[0] / 10; |
---|
106 | $tokens[1] = $tokens[1] / 10; |
---|
107 | } |
---|
108 | if ($tokens[1] == 1) { |
---|
109 | return $tokens[0].' s'; |
---|
110 | } else { |
---|
111 | return $tokens[0].'/'.$tokens[1].' s'; |
---|
112 | } |
---|
113 | } |
---|
114 | |
---|
115 | // aperture |
---|
116 | if (!(strpos($key, 'FNumber') === FALSE)) { |
---|
117 | $tokens = explode('/', $value); |
---|
118 | return $tokens[0]/$tokens[1]; |
---|
119 | } |
---|
120 | |
---|
121 | // flash |
---|
122 | if (!(strpos($key, 'Flash') === FALSE)) { |
---|
123 | // 1st bit is fired/did not fired |
---|
124 | if (($value & 1) > 0) { |
---|
125 | $retValue = l10n('yes'); |
---|
126 | } else { |
---|
127 | $retValue = l10n('no'); |
---|
128 | } |
---|
129 | // 2nd+3rd bits are return light mode |
---|
130 | $returnLight = $value & (3 << 1); |
---|
131 | switch ($returnLight) { |
---|
132 | case 2 << 1: $retValue .= ', '.l10n('exif_value_flash_return_light_not_detected');break; |
---|
133 | case 3 << 1: $retValue .= ', '.l10n('exif_value_flash_return_light_detected');break; |
---|
134 | } |
---|
135 | // 4th+5th bits are mode |
---|
136 | $mode = $value & (3 << 3); |
---|
137 | switch ($mode) { |
---|
138 | case 0: $retValue .= ', '.l10n('exif_value_flash_mode').': '.l10n('exif_value_flash_mode_unknown');break; |
---|
139 | case 1 << 3: $retValue .= ', '.l10n('exif_value_flash_mode').': '.l10n('exif_value_flash_mode_compulsory');break; |
---|
140 | case 2 << 3: $retValue .= ', '.l10n('exif_value_flash_mode').': '.l10n('exif_value_flash_mode_supress');break; |
---|
141 | case 3 << 3: $retValue .= ', '.l10n('exif_value_flash_mode').': '.l10n('exif_value_flash_mode_auto');break; |
---|
142 | } |
---|
143 | // 6th bit is red eye function |
---|
144 | if (($value & (1 << 6)) > 0) { |
---|
145 | $retValue .= ', '.l10n('exif_value_red_eye'); |
---|
146 | } |
---|
147 | return $retValue; |
---|
148 | } |
---|
149 | |
---|
150 | // exposure bias |
---|
151 | if (!(strpos($key, 'ExposureBiasValue') === FALSE)) { |
---|
152 | $tokens = explode('/', $value); |
---|
153 | $newValue = $tokens[0] / $tokens[1]; |
---|
154 | // max EV range +- |
---|
155 | $maxEV = 5; |
---|
156 | // default value |
---|
157 | $retValue = $newValue; |
---|
158 | $absValue = truncate(abs($newValue), 2); |
---|
159 | $found = FALSE; |
---|
160 | // find through 1/3 |
---|
161 | for ($i = 1; $i <= $maxEV * 3 ; $i++) { |
---|
162 | $ev = floor($i * 1/3.0 * 100) / 100; |
---|
163 | if ($ev == $absValue) { |
---|
164 | if ($i > 3) { |
---|
165 | $retValue = (truncate($i / 3)).' '.($i % 3).'/3'; |
---|
166 | } else { |
---|
167 | $retValue = $i.'/3'; |
---|
168 | } |
---|
169 | $found = TRUE; |
---|
170 | break; |
---|
171 | } |
---|
172 | } |
---|
173 | // find through 1/2 |
---|
174 | if (!$found) { |
---|
175 | for ($i = 1; $i <= $maxEV * 2 ; $i++) { |
---|
176 | $ev = floor($i * 1/2.0 * 100) / 100; |
---|
177 | if ($ev == $absValue) { |
---|
178 | if ($i > 2) { |
---|
179 | $retValue = ($i / 2).' '.($i % 2).'/2'; |
---|
180 | } else { |
---|
181 | $retValue = $i.'/2'; |
---|
182 | } |
---|
183 | $found = TRUE; |
---|
184 | break; |
---|
185 | } |
---|
186 | } |
---|
187 | } |
---|
188 | // signs |
---|
189 | if (($newValue < 0) && $found) { |
---|
190 | $retValue = '- '.$retValue; |
---|
191 | } |
---|
192 | if ($newValue > 0) { |
---|
193 | $retValue = '+ '.$retValue; |
---|
194 | } |
---|
195 | return $retValue.' EV'; |
---|
196 | } |
---|
197 | |
---|
198 | // focal length 35mm |
---|
199 | if (!(strpos($key, 'FocalLengthIn35mmFilm') === FALSE)) { |
---|
200 | return $value.' mm'; |
---|
201 | } |
---|
202 | |
---|
203 | // focal length |
---|
204 | if (!(strpos($key, 'FocalLength') === FALSE)) { |
---|
205 | $tokens = explode('/', $value); |
---|
206 | return ($tokens[0]/$tokens[1]).' mm'; |
---|
207 | } |
---|
208 | |
---|
209 | // digital zoom |
---|
210 | if (!(strpos($key, 'DigitalZoomRatio') === FALSE)) { |
---|
211 | $tokens = explode('/', $value); |
---|
212 | return ($tokens[0]/$tokens[1]); |
---|
213 | } |
---|
214 | |
---|
215 | // white balance |
---|
216 | if (!(strpos($key, 'WhiteBalance') === FALSE)) { |
---|
217 | switch ($value) { |
---|
218 | case 0: return l10n('exif_value_white_balance_auto'); |
---|
219 | case 1: return l10n('exif_value_white_balance_manual'); |
---|
220 | default: return ''; |
---|
221 | } |
---|
222 | } |
---|
223 | |
---|
224 | // exposure mode |
---|
225 | if (!(strpos($key, 'ExposureMode') === FALSE)) { |
---|
226 | switch ($value) { |
---|
227 | case 0: return l10n('exif_value_exposure_mode_auto'); |
---|
228 | case 1: return l10n('exif_value_exposure_mode_manual'); |
---|
229 | case 2: return l10n('exif_value_exposure_mode_auto_bracket'); |
---|
230 | default: return ''; |
---|
231 | } |
---|
232 | } |
---|
233 | |
---|
234 | // exposure metering mode |
---|
235 | if (!(strpos($key, 'MeteringMode') === FALSE)) { |
---|
236 | switch ($value) { |
---|
237 | case 0: return l10n('exif_value_metering_mode_unknown'); |
---|
238 | case 1: return l10n('exif_value_metering_mode_average'); |
---|
239 | case 2: return l10n('exif_value_metering_mode_CenterWeightedAVG'); |
---|
240 | case 3: return l10n('exif_value_metering_mode_spot'); |
---|
241 | case 4: return l10n('exif_value_metering_mode_multispot'); |
---|
242 | case 5: return l10n('exif_value_metering_mode_pattern'); |
---|
243 | case 6: return l10n('exif_value_metering_mode_partial'); |
---|
244 | default: return ''; |
---|
245 | } |
---|
246 | } |
---|
247 | |
---|
248 | // exposure program |
---|
249 | if (!(strpos($key, 'ExposureProgram') === FALSE)) { |
---|
250 | switch ($value) { |
---|
251 | case 0: return l10n('exif_value_exposure_program_not_defined'); |
---|
252 | case 1: return l10n('exif_value_exposure_program_manual'); |
---|
253 | case 2: return l10n('exif_value_exposure_program_normal'); |
---|
254 | case 3: return l10n('exif_value_exposure_program_aperture'); |
---|
255 | case 4: return l10n('exif_value_exposure_program_shutter'); |
---|
256 | case 5: return l10n('exif_value_exposure_program_creative'); |
---|
257 | case 6: return l10n('exif_value_exposure_program_action'); |
---|
258 | case 7: return l10n('exif_value_exposure_program_portrait'); |
---|
259 | case 8: return l10n('exif_value_exposure_program_landscape'); |
---|
260 | default: return ''; |
---|
261 | } |
---|
262 | } |
---|
263 | |
---|
264 | // light source |
---|
265 | if (!(strpos($key, 'LightSource') === FALSE)) { |
---|
266 | switch ($value) { |
---|
267 | case 0: return l10n('exif_value_light_source_unknown'); |
---|
268 | case 1: return l10n('exif_value_light_source_daylight'); |
---|
269 | case 2: return l10n('exif_value_light_source_fluorescent'); |
---|
270 | case 3: return l10n('exif_value_light_source_tungsten'); |
---|
271 | case 4: return l10n('exif_value_light_source_flash'); |
---|
272 | case 9: return l10n('exif_value_light_source_fine_weather'); |
---|
273 | case 10: return l10n('exif_value_light_source_cloudy_weather'); |
---|
274 | case 11: return l10n('exif_value_light_source_shade'); |
---|
275 | case 12: return l10n('exif_value_light_source_daylight_fluorescent_d'); |
---|
276 | case 13: return l10n('exif_value_light_source_daywhite_fluorescent_n'); |
---|
277 | case 14: return l10n('exif_value_light_source_coolwhite_fluorescent_w'); |
---|
278 | case 15: return l10n('exif_value_light_source_white_fluorescent'); |
---|
279 | case 17: return l10n('exif_value_light_source_standard_light_a'); |
---|
280 | case 18: return l10n('exif_value_light_source_standard_light_b'); |
---|
281 | case 19: return l10n('exif_value_light_source_standard_light_c'); |
---|
282 | case 20: return l10n('exif_value_light_source_D55'); |
---|
283 | case 21: return l10n('exif_value_light_source_D65'); |
---|
284 | case 22: return l10n('exif_value_light_source_D75'); |
---|
285 | case 23: return l10n('exif_value_light_source_D50'); |
---|
286 | case 24: return l10n('exif_value_light_source_iso_studio_tungsten'); |
---|
287 | case 255: return l10n('exif_value_light_source_other'); |
---|
288 | default: return ''; |
---|
289 | } |
---|
290 | } |
---|
291 | |
---|
292 | // contrast |
---|
293 | if (!(strpos($key, 'Contrast') === FALSE)) { |
---|
294 | switch ($value) { |
---|
295 | case 0: return l10n('exif_value_contrast_normal'); |
---|
296 | case 1: return l10n('exif_value_contrast_soft'); |
---|
297 | case 2: return l10n('exif_value_contrast_hard'); |
---|
298 | default: return ''; |
---|
299 | } |
---|
300 | } |
---|
301 | |
---|
302 | // sharpness |
---|
303 | if (!(strpos($key, 'Sharpness') === FALSE)) { |
---|
304 | switch ($value) { |
---|
305 | case 0: return l10n('exif_value_sharpness_normal'); |
---|
306 | case 1: return l10n('exif_value_sharpness_soft'); |
---|
307 | case 2: return l10n('exif_value_sharpness_hard'); |
---|
308 | default: return ''; |
---|
309 | } |
---|
310 | } |
---|
311 | |
---|
312 | // saturation |
---|
313 | if (!(strpos($key, 'Saturation') === FALSE)) { |
---|
314 | switch ($value) { |
---|
315 | case 0: return l10n('exif_value_saturation_normal'); |
---|
316 | case 1: return l10n('exif_value_saturation_low'); |
---|
317 | case 2: return l10n('exif_value_saturation_hard'); |
---|
318 | default: return ''; |
---|
319 | } |
---|
320 | } |
---|
321 | |
---|
322 | // return value unchanged |
---|
323 | return $value; |
---|
324 | } |
---|
325 | define('exif_DIR' , basename(dirname(__FILE__))); |
---|
326 | define('exif_PATH' , PHPWG_PLUGINS_PATH . exif_DIR . '/'); |
---|
327 | /** |
---|
328 | * Loads plugin language file. |
---|
329 | */ |
---|
330 | function loadLang() { |
---|
331 | global $lang; |
---|
332 | load_language('lang.exif', exif_PATH); |
---|
333 | } |
---|
334 | |
---|
335 | /** |
---|
336 | * EXIF translation. |
---|
337 | * |
---|
338 | * @param $key EXIF key name |
---|
339 | * @param $value EXIF key value |
---|
340 | * @return translated value dependend on key meaning and choosed language |
---|
341 | */ |
---|
342 | function exif_translation($exif) { |
---|
343 | // translate all exif fields |
---|
344 | if (is_array($exif)) { |
---|
345 | loadLang(); |
---|
346 | foreach ($exif as $key => $value) { |
---|
347 | $exif[$key] = exif_key_translation($key, $value); |
---|
348 | } |
---|
349 | } |
---|
350 | return $exif; |
---|
351 | } |
---|
352 | |
---|
353 | ?> |
---|