3 /***************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2019 *
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James *
9 * Ce programme est un logiciel libre distribue sous licence GNU/GPL. *
10 * Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne. *
11 \***************************************************************************/
14 * Ce fichier contient les fonctions simples
15 * de traitement d'image.
17 * @package SPIP\Core\Filtres\Images
20 if (!defined('_ECRIRE_INC_VERSION')) {
23 include_spip('inc/filtres_images_lib_mini'); // par precaution
26 * Transforme un code couleur textuel (black, white, green...) et code hexadécimal
28 * @param string $couleur
29 * Le code couleur textuel
31 * Le code hexadécimal de la couleur (sans le #) ou le code couleur textuel si non trouvé
33 function couleur_html_to_hex($couleur) {
34 $couleurs_html = array(
35 'aliceblue' => 'F0F8FF',
36 'antiquewhite' => 'FAEBD7',
38 'aquamarine' => '7FFFD4',
43 'blanchedalmond' => 'FFEBCD',
45 'blueviolet' => '8A2BE2',
47 'burlywood' => 'DEB887',
48 'cadetblue' => '5F9EA0',
49 'chartreuse' => '7FFF00',
50 'chocolate' => 'D2691E',
52 'cornflowerblue' => '6495ED',
53 'cornsilk' => 'FFF8DC',
54 'crimson' => 'DC143C',
56 'darkblue' => '00008B',
57 'darkcyan' => '008B8B',
58 'darkgoldenrod' => 'B8860B',
59 'darkgray' => 'A9A9A9',
60 'darkgreen' => '006400',
61 'darkgrey' => 'A9A9A9',
62 'darkkhaki' => 'BDB76B',
63 'darkmagenta' => '8B008B',
64 'darkolivegreen' => '556B2F',
65 'darkorange' => 'FF8C00',
66 'darkorchid' => '9932CC',
67 'darkred' => '8B0000',
68 'darksalmon' => 'E9967A',
69 'darkseagreen' => '8FBC8F',
70 'darkslateblue' => '483D8B',
71 'darkslategray' => '2F4F4F',
72 'darkslategrey' => '2F4F4F',
73 'darkturquoise' => '00CED1',
74 'darkviolet' => '9400D3',
75 'deeppink' => 'FF1493',
76 'deepskyblue' => '00BFFF',
77 'dimgray' => '696969',
78 'dimgrey' => '696969',
79 'dodgerblue' => '1E90FF',
80 'firebrick' => 'B22222',
81 'floralwhite' => 'FFFAF0',
82 'forestgreen' => '228B22',
83 'fuchsia' => 'FF00FF',
84 'gainsboro' => 'DCDCDC',
85 'ghostwhite' => 'F8F8FF',
87 'goldenrod' => 'DAA520',
90 'greenyellow' => 'ADFF2F',
92 'honeydew' => 'F0FFF0',
93 'hotpink' => 'FF69B4',
94 'indianred' => 'CD5C5C',
98 'lavender' => 'E6E6FA',
99 'lavenderblush' => 'FFF0F5',
100 'lawngreen' => '7CFC00',
101 'lemonchiffon' => 'FFFACD',
102 'lightblue' => 'ADD8E6',
103 'lightcoral' => 'F08080',
104 'lightcyan' => 'E0FFFF',
105 'lightgoldenrodyellow' => 'FAFAD2',
106 'lightgray' => 'D3D3D3',
107 'lightgreen' => '90EE90',
108 'lightgrey' => 'D3D3D3',
109 'lightpink' => 'FFB6C1',
110 'lightsalmon' => 'FFA07A',
111 'lightseagreen' => '20B2AA',
112 'lightskyblue' => '87CEFA',
113 'lightslategray' => '778899',
114 'lightslategrey' => '778899',
115 'lightsteelblue' => 'B0C4DE',
116 'lightyellow' => 'FFFFE0',
118 'limegreen' => '32CD32',
120 'magenta' => 'FF00FF',
121 'maroon' => '800000',
122 'mediumaquamarine' => '66CDAA',
123 'mediumblue' => '0000CD',
124 'mediumorchid' => 'BA55D3',
125 'mediumpurple' => '9370DB',
126 'mediumseagreen' => '3CB371',
127 'mediumslateblue' => '7B68EE',
128 'mediumspringgreen' => '00FA9A',
129 'mediumturquoise' => '48D1CC',
130 'mediumvioletred' => 'C71585',
131 'midnightblue' => '191970',
132 'mintcream' => 'F5FFFA',
133 'mistyrose' => 'FFE4E1',
134 'moccasin' => 'FFE4B5',
135 'navajowhite' => 'FFDEAD',
137 'oldlace' => 'FDF5E6',
139 'olivedrab' => '6B8E23',
140 'orange' => 'FFA500',
141 'orangered' => 'FF4500',
142 'orchid' => 'DA70D6',
143 'palegoldenrod' => 'EEE8AA',
144 'palegreen' => '98FB98',
145 'paleturquoise' => 'AFEEEE',
146 'palevioletred' => 'DB7093',
147 'papayawhip' => 'FFEFD5',
148 'peachpuff' => 'FFDAB9',
152 'powderblue' => 'B0E0E6',
153 'purple' => '800080',
154 'rebeccapurple' => '663399',
156 'rosybrown' => 'BC8F8F',
157 'royalblue' => '4169E1',
158 'saddlebrown' => '8B4513',
159 'salmon' => 'FA8072',
160 'sandybrown' => 'F4A460',
161 'seagreen' => '2E8B57',
162 'seashell' => 'FFF5EE',
163 'sienna' => 'A0522D',
164 'silver' => 'C0C0C0',
165 'skyblue' => '87CEEB',
166 'slateblue' => '6A5ACD',
167 'slategray' => '708090',
168 'slategrey' => '708090',
170 'springgreen' => '00FF7F',
171 'steelblue' => '4682B4',
174 'thistle' => 'D8BFD8',
175 'tomato' => 'FF6347',
176 'turquoise' => '40E0D0',
177 'violet' => 'EE82EE',
180 'whitesmoke' => 'F5F5F5',
181 'yellow' => 'FFFF00',
182 'yellowgreen' => '9ACD32',
184 if (isset($couleurs_html[$lc = strtolower($couleur)])) {
185 return $couleurs_html[$lc];
192 * Rend une couleur (code hexadécimal) plus foncée
194 * @uses _couleur_hex_to_dec() Pour transformer le code hexadécimal en décimal
196 * @param string $couleur
197 * Code hexadécimal d'une couleur
198 * @param float $coeff
199 * Coefficient (de 0 à 1)
201 * Code hexadécimal de la couleur plus foncée
203 function couleur_foncer($couleur, $coeff = 0.5) {
204 $couleurs = _couleur_hex_to_dec($couleur);
206 $red = $couleurs['red'] - round(($couleurs['red']) * $coeff);
207 $green = $couleurs['green'] - round(($couleurs['green']) * $coeff);
208 $blue = $couleurs['blue'] - round(($couleurs['blue']) * $coeff);
210 $couleur = _couleur_dec_to_hex($red, $green, $blue);
216 * Eclaircit une couleur (code hexadécimal)
218 * @uses _couleur_hex_to_dec() Pour transformer le code hexadécimal en décimal
220 * @param string $couleur
221 * Code hexadécimal d'une couleur
222 * @param float $coeff
223 * Coefficient (de 0 à 1)
225 * Code hexadécimal de la couleur éclaircie
227 function couleur_eclaircir($couleur, $coeff = 0.5) {
228 $couleurs = _couleur_hex_to_dec($couleur);
230 $red = $couleurs['red'] +
round((255 - $couleurs['red']) * $coeff);
231 $green = $couleurs['green'] +
round((255 - $couleurs['green']) * $coeff);
232 $blue = $couleurs['blue'] +
round((255 - $couleurs['blue']) * $coeff);
234 $couleur = _couleur_dec_to_hex($red, $green, $blue);
240 * Selectionne les images qui vont subir une transformation sur un critere de taille
242 * Les images exclues sont marquees d'une class filtre_inactif qui bloque les filtres suivants
243 * dans la fonction image_filtrer
246 * Un tag html `<img src=... />`.
247 * @param int $width_min
248 * Largeur minimale de l'image à traiter (0 par défaut)
249 * @param int $height_min
250 * Hauteur minimale de l'image à traiter (0 par défaut)
251 * @param int $width_max
252 * Largeur minimale de l'image à traiter (10000 par défaut)
253 * @param int $height_max
254 * Hauteur minimale de l'image à traiter (10000 par défaut)
256 * Le tag html `<img src=... />` avec une class `filtre_inactif` ou pas
258 function image_select($img, $width_min = 0, $height_min = 0, $width_max = 10000, $height_max = 1000) {
262 list($h, $l) = taille_image($img);
264 if ($l < $width_min or $l > $width_max or $h < $height_min or $h > $height_max) {
268 $class = extraire_attribut($img, 'class');
269 $p = strpos($class, 'filtre_inactif');
270 if (($select == false) and ($p === false)) {
271 $class .= ' filtre_inactif';
272 $img = inserer_attribut($img, 'class', $class);
274 if (($select == true) and ($p !== false)) {
275 // no_image_filtrer : historique, a virer
276 $class = preg_replace(',\s*(filtre_inactif|no_image_filtrer),', '', $class);
277 $img = inserer_attribut($img, 'class', $class);
284 * Réduit les images à une taille maximale (chevauchant un rectangle)
286 * L'image possède un côté réduit dans les dimensions indiquées et
287 * l'autre côté (hauteur ou largeur) de l'image peut être plus grand
288 * que les dimensions du rectangle.
290 * Alors que image_reduire produit la plus petite image tenant dans un
291 * rectangle, image_passe_partout produit la plus grande image qui
292 * remplit ce rectangle.
297 * |image_passe_partout{70,70}
298 * |image_recadre{70,70,center})]
302 * @link http://www.spip.net/4562
303 * @see image_reduire()
304 * @uses taille_image()
305 * @uses ratio_passe_partout()
306 * @uses process_image_reduire()
309 * Chemin de l'image ou code html d'une balise img
310 * @param int $taille_x
311 * - Largeur maximale en pixels désirée
312 * - -1 prend la taille de réduction des vignettes par défaut
313 * - 0 la taille s'adapte à la largeur
314 * @param int $taille_y
315 * - Hauteur maximale en pixels désirée
316 * - -1 pour prendre pareil que la largeur
317 * - 0 la taille s'adapte à la hauteur
319 * @param bool $cherche_image
321 * @param string $process
322 * Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick).
323 * AUTO utilise la librairie sélectionnée dans la configuration.
325 * Code HTML de l'image ou du texte.
327 function image_passe_partout(
332 $cherche_image = false,
338 list($hauteur, $largeur) = taille_image($img);
339 if ($taille_x == -1) {
340 $taille_x = isset($GLOBALS['meta']['taille_preview']) ?
$GLOBALS['meta']['taille_preview'] : 150;
342 if ($taille_y == -1) {
343 $taille_y = $taille_x;
346 if ($taille_x == 0 and $taille_y > 0) {
348 } # {0,300} -> c'est 300 qui compte
349 elseif ($taille_x > 0 and $taille_y == 0) {
351 } # {300,0} -> c'est 300 qui compte
352 elseif ($taille_x == 0 and $taille_y == 0) {
356 list($destWidth, $destHeight, $ratio) = ratio_passe_partout($largeur, $hauteur, $taille_x, $taille_y);
357 $fonction = array('image_passe_partout', func_get_args());
359 return process_image_reduire($fonction, $img, $destWidth, $destHeight, $force, $process);
363 * Réduit les images à une taille maximale (inscrite dans un rectangle)
365 * L'image possède un côté dans les dimensions indiquées et
366 * l'autre côté (hauteur ou largeur) de l'image peut être plus petit
367 * que les dimensions du rectangle.
369 * Peut être utilisé pour réduire toutes les images d'un texte.
373 * [(#LOGO_ARTICLE|image_reduire{130})]
374 * [(#TEXTE|image_reduire{600,0})]
378 * @see image_reduire_par()
379 * @see image_passe_partout()
380 * @uses process_image_reduire()
383 * Chemin de l'image ou code html d'une balise img
385 * - Largeur maximale en pixels désirée
386 * - -1 prend la taille de réduction des vignettes par défaut
387 * - 0 la taille s'adapte à la largeur
388 * @param int $taille_y
389 * - Hauteur maximale en pixels désirée
390 * - -1 pour prendre pareil que la largeur
391 * - 0 la taille s'adapte à la hauteur
393 * @param bool $cherche_image
395 * @param string $process
396 * Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick).
397 * AUTO utilise la librairie sélectionnée dans la configuration.
399 * Code HTML de l'image ou du texte.
401 function image_reduire($img, $taille = -1, $taille_y = -1, $force = false, $cherche_image = false, $process = 'AUTO') {
402 // Determiner la taille x,y maxi
403 // prendre le reglage de previsu par defaut
405 $taille = (isset($GLOBALS['meta']['taille_preview']) and intval($GLOBALS['meta']['taille_preview'])) ?
intval($GLOBALS['meta']['taille_preview']) : 150;
407 if ($taille_y == -1) {
411 if ($taille == 0 and $taille_y > 0) {
413 } # {0,300} -> c'est 300 qui compte
414 elseif ($taille > 0 and $taille_y == 0) {
416 } # {300,0} -> c'est 300 qui compte
417 elseif ($taille == 0 and $taille_y == 0) {
421 $fonction = array('image_reduire', func_get_args());
423 return process_image_reduire($fonction, $img, $taille, $taille_y, $force, $process);
428 * Réduit les images d'un certain facteur
431 * @uses image_reduire()
434 * Chemin de l'image ou code html d'une balise img
436 * Facteur de réduction
439 * Code HTML de l'image ou du texte.
441 function image_reduire_par($img, $val = 1, $force = false) {
442 list($hauteur, $largeur) = taille_image($img);
444 $l = round($largeur / $val);
445 $h = round($hauteur / $val);
453 $img = image_reduire($img, $l, $h, $force);
459 * Modifie la saturation de la couleur transmise
462 * Nécessite le plugin `filtres_images` pour fonctionner.
463 * La couleur d’entrée est retournée tel quelle en cas d'absence.
465 * @see couleur_saturation() du plugin `filtres_images`
466 * @uses couleur_saturation()
468 * @param string $couleur
469 * Couleur en écriture hexadécimale, tel que `ff3300`
471 * Pourcentage désiré (entre 0 et 1)
473 * Couleur en écriture hexadécimale.
475 function filtre_couleur_saturation_dist($couleur, $val) {
476 if (function_exists('couleur_saturation')) {
477 return couleur_saturation($couleur, $val);
483 * Modifie la luminance de la couleur transmise
486 * Nécessite le plugin `filtres_images` pour fonctionner.
487 * La couleur d’entrée est retournée tel quelle en cas d'absence.
489 * @see couleur_luminance() du plugin `filtres_images`
490 * @uses couleur_luminance()
492 * @param string $couleur
493 * Couleur en écriture hexadécimale, tel que `ff3300`
495 * Pourcentage désiré (entre 0 et 1)
497 * Couleur en écriture hexadécimale.
499 function filtre_couleur_luminance_dist($couleur, $val) {
500 if (function_exists('couleur_luminance')) {
501 return couleur_luminance($couleur, $val);