www/ecrire/inc/filtres_images_mini.php

   1 <?php
   2
   3 /***************************************************************************\
   4  *  SPIP, Systeme de publication pour l'internet                           *
   5  *                                                                         *
   6  *  Copyright (c) 2001-2019                                                *
   7  *  Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James  *
   8  *                                                                         *
   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 \***************************************************************************/
  12
  13 /**
  14  * Ce fichier contient les fonctions simples
  15  * de traitement d'image.
  16  *
  17  * @package SPIP\Core\Filtres\Images
  18  */
  19
  20 if (!defined('_ECRIRE_INC_VERSION')) {
  21         return;
  22 }
  23 include_spip('inc/filtres_images_lib_mini'); // par precaution
  24
  25 /**
  26  * Transforme un code couleur textuel (black, white, green...) et code hexadécimal
  27  *
  28  * @param string $couleur
  29  *    Le code couleur textuel
  30  * @return string
  31  *    Le code hexadécimal de la couleur (sans le #) ou le code couleur textuel si non trouvé
  32  */
  33 function couleur_html_to_hex($couleur) {
  34         $couleurs_html = array(
  35                 'aliceblue' => 'F0F8FF',
  36                 'antiquewhite' => 'FAEBD7',
  37                 'aqua' => '00FFFF',
  38                 'aquamarine' => '7FFFD4',
  39                 'azure' => 'F0FFFF',
  40                 'beige' => 'F5F5DC',
  41                 'bisque' => 'FFE4C4',
  42                 'black' => '000000',
  43                 'blanchedalmond' => 'FFEBCD',
  44                 'blue' => '0000FF',
  45                 'blueviolet' => '8A2BE2',
  46                 'brown' => 'A52A2A',
  47                 'burlywood' => 'DEB887',
  48                 'cadetblue' => '5F9EA0',
  49                 'chartreuse' => '7FFF00',
  50                 'chocolate' => 'D2691E',
  51                 'coral' => 'FF7F50',
  52                 'cornflowerblue' => '6495ED',
  53                 'cornsilk' => 'FFF8DC',
  54                 'crimson' => 'DC143C',
  55                 'cyan' => '00FFFF',
  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',
  86                 'gold' => 'FFD700',
  87                 'goldenrod' => 'DAA520',
  88                 'gray' => '808080',
  89                 'green' => '008000',
  90                 'greenyellow' => 'ADFF2F',
  91                 'grey' => '808080',
  92                 'honeydew' => 'F0FFF0',
  93                 'hotpink' => 'FF69B4',
  94                 'indianred' => 'CD5C5C',
  95                 'indigo' => '4B0082',
  96                 'ivory' => 'FFFFF0',
  97                 'khaki' => 'F0E68C',
  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',
 117                 'lime' => '00FF00',
 118                 'limegreen' => '32CD32',
 119                 'linen' => 'FAF0E6',
 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',
 136                 'navy' => '000080',
 137                 'oldlace' => 'FDF5E6',
 138                 'olive' => '808000',
 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',
 149                 'peru' => 'CD853F',
 150                 'pink' => 'FFC0CB',
 151                 'plum' => 'DDA0DD',
 152                 'powderblue' => 'B0E0E6',
 153                 'purple' => '800080',
 154                 'rebeccapurple' => '663399',
 155                 'red' => 'FF0000',
 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',
 169                 'snow' => 'FFFAFA',
 170                 'springgreen' => '00FF7F',
 171                 'steelblue' => '4682B4',
 172                 'tan' => 'D2B48C',
 173                 'teal' => '008080',
 174                 'thistle' => 'D8BFD8',
 175                 'tomato' => 'FF6347',
 176                 'turquoise' => '40E0D0',
 177                 'violet' => 'EE82EE',
 178                 'wheat' => 'F5DEB3',
 179                 'white' => 'FFFFFF',
 180                 'whitesmoke' => 'F5F5F5',
 181                 'yellow' => 'FFFF00',
 182                 'yellowgreen' => '9ACD32',
 183         );
 184         if (isset($couleurs_html[$lc = strtolower($couleur)])) {
 185                 return $couleurs_html[$lc];
 186         }
 187
 188         return $couleur;
 189 }
 190
 191 /**
 192  * Rend une couleur (code hexadécimal) plus foncée
 193  *
 194  * @uses _couleur_hex_to_dec() Pour transformer le code hexadécimal en décimal
 195  *
 196  * @param string $couleur
 197  *    Code hexadécimal d'une couleur
 198  * @param float $coeff
 199  *    Coefficient (de 0 à 1)
 200  * @return string
 201  *    Code hexadécimal de la couleur plus foncée
 202  */
 203 function couleur_foncer($couleur, $coeff = 0.5) {
 204         $couleurs = _couleur_hex_to_dec($couleur);
 205
 206         $red = $couleurs['red'] - round(($couleurs['red']) * $coeff);
 207         $green = $couleurs['green'] - round(($couleurs['green']) * $coeff);
 208         $blue = $couleurs['blue'] - round(($couleurs['blue']) * $coeff);
 209
 210         $couleur = _couleur_dec_to_hex($red, $green, $blue);
 211
 212         return $couleur;
 213 }
 214
 215 /**
 216  * Eclaircit une couleur (code hexadécimal)
 217  *
 218  * @uses _couleur_hex_to_dec() Pour transformer le code hexadécimal en décimal
 219  *
 220  * @param string $couleur
 221  *    Code hexadécimal d'une couleur
 222  * @param float $coeff
 223  *    Coefficient (de 0 à 1)
 224  * @return string
 225  *    Code hexadécimal de la couleur éclaircie
 226  */
 227 function couleur_eclaircir($couleur, $coeff = 0.5) {
 228         $couleurs = _couleur_hex_to_dec($couleur);
 229
 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);
 233
 234         $couleur = _couleur_dec_to_hex($red, $green, $blue);
 235
 236         return $couleur;
 237 }
 238
 239 /**
 240  * Selectionne les images qui vont subir une transformation sur un critere de taille
 241  *
 242  * Les images exclues sont marquees d'une class filtre_inactif qui bloque les filtres suivants
 243  * dans la fonction image_filtrer
 244  *
 245  * @param string $img
 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)
 255  * @return
 256  *    Le tag html `<img src=... />` avec une class `filtre_inactif` ou pas
 257  */
 258 function image_select($img, $width_min = 0, $height_min = 0, $width_max = 10000, $height_max = 1000) {
 259         if (!$img) {
 260                 return $img;
 261         }
 262         list($h, $l) = taille_image($img);
 263         $select = true;
 264         if ($l < $width_min or $l > $width_max or $h < $height_min or $h > $height_max) {
 265                 $select = false;
 266         }
 267
 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);
 273         }
 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);
 278         }
 279
 280         return $img;
 281 }
 282
 283 /**
 284  * Réduit les images à une taille maximale (chevauchant un rectangle)
 285  *
 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.
 289  *
 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.
 293  *
 294  * @example
 295  *     ```
 296  *     [(#FICHIER
 297  *       |image_passe_partout{70,70}
 298  *       |image_recadre{70,70,center})]
 299  *     ```
 300  *
 301  * @filtre
 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()
 307  *
 308  * @param string $img
 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
 318  * @param bool $force
 319  * @param bool $cherche_image
 320  *     Inutilisé
 321  * @param string $process
 322  *     Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick).
 323  *     AUTO utilise la librairie sélectionnée dans la configuration.
 324  * @return string
 325  *     Code HTML de l'image ou du texte.
 326  **/
 327 function image_passe_partout(
 328         $img,
 329         $taille_x = -1,
 330         $taille_y = -1,
 331         $force = false,
 332         $cherche_image = false,
 333         $process = 'AUTO'
 334 ) {
 335         if (!$img) {
 336                 return '';
 337         }
 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;
 341         }
 342         if ($taille_y == -1) {
 343                 $taille_y = $taille_x;
 344         }
 345
 346         if ($taille_x == 0 and $taille_y > 0) {
 347                 $taille_x = 1;
 348         } # {0,300} -> c'est 300 qui compte
 349         elseif ($taille_x > 0 and $taille_y == 0) {
 350                 $taille_y = 1;
 351         } # {300,0} -> c'est 300 qui compte
 352         elseif ($taille_x == 0 and $taille_y == 0) {
 353                 return '';
 354         }
 355
 356         list($destWidth, $destHeight, $ratio) = ratio_passe_partout($largeur, $hauteur, $taille_x, $taille_y);
 357         $fonction = array('image_passe_partout', func_get_args());
 358
 359         return process_image_reduire($fonction, $img, $destWidth, $destHeight, $force, $process);
 360 }
 361
 362 /**
 363  * Réduit les images à une taille maximale (inscrite dans un rectangle)
 364  *
 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.
 368  *
 369  * Peut être utilisé pour réduire toutes les images d'un texte.
 370  *
 371  * @example
 372  *     ```
 373  *     [(#LOGO_ARTICLE|image_reduire{130})]
 374  *     [(#TEXTE|image_reduire{600,0})]
 375  *     ```
 376  *
 377  * @filtre
 378  * @see  image_reduire_par()
 379  * @see  image_passe_partout()
 380  * @uses process_image_reduire()
 381  *
 382  * @param string $img
 383  *     Chemin de l'image ou code html d'une balise img
 384  * @param int $taille
 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
 392  * @param bool $force
 393  * @param bool $cherche_image
 394  *     Inutilisé
 395  * @param string $process
 396  *     Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick).
 397  *     AUTO utilise la librairie sélectionnée dans la configuration.
 398  * @return string
 399  *     Code HTML de l'image ou du texte.
 400  **/
 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
 404         if ($taille == -1) {
 405                 $taille = (isset($GLOBALS['meta']['taille_preview']) and intval($GLOBALS['meta']['taille_preview'])) ? intval($GLOBALS['meta']['taille_preview']) : 150;
 406         }
 407         if ($taille_y == -1) {
 408                 $taille_y = $taille;
 409         }
 410
 411         if ($taille == 0 and $taille_y > 0) {
 412                 $taille = 10000;
 413         } # {0,300} -> c'est 300 qui compte
 414         elseif ($taille > 0 and $taille_y == 0) {
 415                 $taille_y = 10000;
 416         } # {300,0} -> c'est 300 qui compte
 417         elseif ($taille == 0 and $taille_y == 0) {
 418                 return '';
 419         }
 420
 421         $fonction = array('image_reduire', func_get_args());
 422
 423         return process_image_reduire($fonction, $img, $taille, $taille_y, $force, $process);
 424 }
 425
 426
 427 /**
 428  * Réduit les images d'un certain facteur
 429  *
 430  * @filtre
 431  * @uses image_reduire()
 432  *
 433  * @param string $img
 434  *     Chemin de l'image ou code html d'une balise img
 435  * @param int $val
 436  *     Facteur de réduction
 437  * @param bool $force
 438  * @return string
 439  *     Code HTML de l'image ou du texte.
 440  **/
 441 function image_reduire_par($img, $val = 1, $force = false) {
 442         list($hauteur, $largeur) = taille_image($img);
 443
 444         $l = round($largeur / $val);
 445         $h = round($hauteur / $val);
 446
 447         if ($l > $h) {
 448                 $h = 0;
 449         } else {
 450                 $l = 0;
 451         }
 452
 453         $img = image_reduire($img, $l, $h, $force);
 454
 455         return $img;
 456 }
 457
 458 /**
 459  * Modifie la saturation de la couleur transmise
 460  *
 461  * @note
 462  *     Nécessite le plugin `filtres_images` pour fonctionner.
 463  *     La couleur d’entrée est retournée tel quelle en cas d'absence.
 464  *
 465  * @see couleur_saturation() du plugin `filtres_images`
 466  * @uses couleur_saturation()
 467  *
 468  * @param string $couleur
 469  *      Couleur en écriture hexadécimale, tel que `ff3300`
 470  * @param float $val
 471  *      Pourcentage désiré (entre 0 et 1)
 472  * @return string
 473  *      Couleur en écriture hexadécimale.
 474 **/
 475 function filtre_couleur_saturation_dist($couleur, $val) {
 476         if (function_exists('couleur_saturation')) {
 477                 return couleur_saturation($couleur, $val);
 478         }
 479         return $couleur;
 480 }
 481
 482 /**
 483  * Modifie la luminance de la couleur transmise
 484  *
 485  * @note
 486  *     Nécessite le plugin `filtres_images` pour fonctionner.
 487  *     La couleur d’entrée est retournée tel quelle en cas d'absence.
 488  *
 489  * @see couleur_luminance() du plugin `filtres_images`
 490  * @uses couleur_luminance()
 491  *
 492  * @param string $couleur
 493  *      Couleur en écriture hexadécimale, tel que `ff3300`
 494  * @param float $val
 495  *      Pourcentage désiré (entre 0 et 1)
 496  * @return string
 497  *      Couleur en écriture hexadécimale.
 498 **/
 499 function filtre_couleur_luminance_dist($couleur, $val) {
 500         if (function_exists('couleur_luminance')) {
 501                 return couleur_luminance($couleur, $val);
 502         }
 503         return $couleur;
 504 }