Fichier ecrire/inc/filtres_images_mini.php

Ce fichier contient les fonctions simples de traitement d'image.

Source

Liste des fonctions

couleur_eclaircir()

Eclaircit une couleur (code hexadécimal)
string couleur_eclaircir( string $couleur , float $coeff = 0.5 )

Paramètres

  1. string $couleur

    Code hexadécimal d'une couleur

  2. float $coeff = 0.5

    Coefficient (de 0 à 1)

Retour

  • string

    Code hexadécimal de la couleur éclaircie

Utilise

Package

Source

couleur_foncer()

Rend une couleur (code hexadécimal) plus foncée
string couleur_foncer( string $couleur , float $coeff = 0.5 )

Paramètres

  1. string $couleur

    Code hexadécimal d'une couleur

  2. float $coeff = 0.5

    Coefficient (de 0 à 1)

Retour

  • string

    Code hexadécimal de la couleur plus foncée

Utilise

Package

Source

couleur_hex_to_hsl()

Retourne une couleur hsl a partir d'une couleur hex
string couleur_hex_to_hsl( string $couleur , string | null $format = null )

Paramètres

  1. string $couleur
  2. string | null $format = null

    Si précisé, remplace h, s ou l par sa valeur dans la chaine passée.

Retour

  • string

    Couleur tel que "hsl(200, 40%, 34%)" ou valeur formattée

Exemples

  • couleur_hex_to_hsl("#ffccaa");
  • couleur_hex_to_hsl("#ffccaa", "h");
  • couleur_hex_to_hsl("#ffccaa", "h, s, l");

Package

Filtre

  • couleur_hex_to_hsl

Source

couleur_hex_to_rgb()

Retourne une couleur rgb a partir d'une couleur hex
string couleur_hex_to_rgb( string $couleur , string | null $format = null )

Paramètres

  1. string $couleur
  2. string | null $format = null

    Si précisé, remplace r, g ou b par sa valeur dans la chaine passée.

Retour

  • string

    Couleur tel que "rgb(200, 40, 84)" ou valeur formattée

Exemples

  • couleur_hex_to_rgb("#ffccaa");
  • couleur_hex_to_rgb("#ffccaa", "r");
  • couleur_hex_to_rgb("#ffccaa", "r, g, b");

Package

Filtre

  • couleur_hex_to_rgb

Source

couleur_html_to_hex()

Transforme un code couleur textuel (black, white, green.

..) et code hexadécimal

string couleur_html_to_hex( string $couleur )

Paramètres

  1. string $couleur

    Le code couleur textuel

Retour

  • string

    Le code hexadécimal de la couleur (sans le #) ou le code couleur textuel si non trouvé

Package

Source

filtre_couleur_luminance_dist()

Modifie la luminance de la couleur transmise
string filtre_couleur_luminance_dist( string $couleur , float $val )

Paramètres

  1. string $couleur

    Couleur en écriture hexadécimale, tel que ff3300

  2. float $val

    Pourcentage désiré (entre 0 et 1)

Retour

  • string

    Couleur en écriture hexadécimale.

Voir également

Utilise

Package

Note

  • Nécessite le plugin filtres_images pour fonctionner. La couleur d’entrée est retournée tel quelle en cas d'absence.

Source

Filtre

  • couleur_luminance
filtre_couleur_saturation_dist()

Modifie la saturation de la couleur transmise
string filtre_couleur_saturation_dist( string $couleur , float $val , boolean | string $strict = false )

Paramètres

  1. string $couleur

    Couleur en écriture hexadécimale, tel que ff3300

  2. float $val

    Pourcentage désiré (entre 0 et 1)

  3. boolean | string $strict = false

    Si true, ne change vraiment que la saturation, sans toucher à la luminosité

Retour

  • string

    Couleur en écriture hexadécimale.

Voir également

Utilise

Package

Note

  • Nécessite le plugin filtres_images pour fonctionner. La couleur d’entrée est retournée tel quelle en cas d'absence.

Source

Filtre

  • couleur_saturation
image_passe_partout()

Réduit les images à une taille maximale (chevauchant un rectangle)

L'image possède un côté réduit dans les dimensions indiquées et l'autre côté (hauteur ou largeur) de l'image peut être plus grand que les dimensions du rectangle.

Alors que image_reduire produit la plus petite image tenant dans un rectangle, image_passe_partout produit la plus grande image qui remplit ce rectangle.

string image_passe_partout( string $img , integer $taille_x = -1 , integer $taille_y = -1 , boolean $force = false , boolean $cherche_image = false , string $process = 'AUTO' )

Paramètres

  1. string $img

    Chemin de l'image ou code html d'une balise img

  2. integer $taille_x = -1
    • Largeur maximale en pixels désirée
    • -1 prend la taille de réduction des vignettes par défaut
    • 0 la taille s'adapte à la largeur
  3. integer $taille_y = -1
    • Hauteur maximale en pixels désirée
    • -1 pour prendre pareil que la largeur
    • 0 la taille s'adapte à la hauteur
  4. boolean $force = false
  5. boolean $cherche_image = false

    Inutilisé

  6. string $process = 'AUTO'

    Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick). AUTO utilise la librairie sélectionnée dans la configuration.

Retour

  • string

    Code HTML de l'image ou du texte.

Exemples

  • [(#FICHIER
  |image_passe_partout{70,70}
  |image_recadre{70,70,center})]

Documentation externe

Voir également

Utilise

Package

Filtre

  • image_passe_partout

Source

image_recadre_avec_fallback()

Usage espace privé: recadre une image uniquement si GD2 et image_recadre (plugin activé) existe sinon retourne le image_passe_partout usuel
void image_recadre_avec_fallback( $im , $width , $height = '-' , $position = 'focus' , $background_color = 'white' )

Paramètres

  1. $im
  2. $width
  3. $height = '-'
  4. $position = 'focus'
  5. $background_color = 'white'

Package

Source

image_reduire()

Réduit les images à une taille maximale (inscrite dans un rectangle)

L'image possède un côté dans les dimensions indiquées et l'autre côté (hauteur ou largeur) de l'image peut être plus petit que les dimensions du rectangle.

Peut être utilisé pour réduire toutes les images d'un texte.

string image_reduire( string $img , integer $taille = -1 , integer $taille_y = -1 , boolean $force = false , boolean $cherche_image = false , string $process = 'AUTO' )

Paramètres

  1. string $img

    Chemin de l'image ou code html d'une balise img

  2. integer $taille = -1
    • Largeur maximale en pixels désirée
    • -1 prend la taille de réduction des vignettes par défaut
    • 0 la taille s'adapte à la largeur
  3. integer $taille_y = -1
    • Hauteur maximale en pixels désirée
    • -1 pour prendre pareil que la largeur
    • 0 la taille s'adapte à la hauteur
  4. boolean $force = false
  5. boolean $cherche_image = false

    Inutilisé

  6. string $process = 'AUTO'

    Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick). AUTO utilise la librairie sélectionnée dans la configuration.

Retour

  • string

    Code HTML de l'image ou du texte.

Exemples

  • [(#LOGO_ARTICLE|image_reduire{130})]
[(#TEXTE|image_reduire{600,0})]

Voir également

Utilise

Utilisé par

Package

Filtre

  • image_reduire

Source

image_reduire_par()

Réduit les images d'un certain facteur
string image_reduire_par( string $img , integer $val = 1 , boolean $force = false )

Paramètres

  1. string $img

    Chemin de l'image ou code html d'une balise img

  2. integer $val = 1

    Facteur de réduction

  3. boolean $force = false

Retour

  • string

    Code HTML de l'image ou du texte.

Utilise

Package

Filtre

  • image_reduire_par

Source

image_select()

Selectionne les images qui vont subir une transformation sur un critere de taille

Les images exclues sont marquees d'une class filtre_inactif qui bloque les filtres suivants dans la fonction image_filtrer

\Le image_select( string $img , integer $width_min , integer $height_min , integer $width_max = 10000 , integer $height_max = 1000 )

Paramètres

  1. string $img

    Un tag html <img src=... />.

  2. integer $width_min

    Largeur minimale de l'image à traiter (0 par défaut)

  3. integer $height_min

    Hauteur minimale de l'image à traiter (0 par défaut)

  4. integer $width_max = 10000

    Largeur minimale de l'image à traiter (10000 par défaut)

  5. integer $height_max = 1000

    Hauteur minimale de l'image à traiter (10000 par défaut)

Retour

  • \Le

    tag html <img src=... /> avec une class filtre_inactif ou pas

Package

Source

Liste des erreurs

GravitéLigneDescription
Notice 378
  • Référence de @uses introuvable dans image_passe_partout : \taille_image()
Erreur 507
  • Argument $im is missing from the Docblock of image_recadre_avec_fallback
  • Argument $width is missing from the Docblock of image_recadre_avec_fallback
  • Argument $height is missing from the Docblock of image_recadre_avec_fallback
  • Argument $position is missing from the Docblock of image_recadre_avec_fallback
  • Argument $background_color is missing from the Docblock of image_recadre_avec_fallback