Fichier ecrire/inc/filtres_images_lib_mini.php

Ce fichier contient les fonctions utilisées par les fonctions-filtres de traitement d'image.

Source

Proposer une amélioration

Liste des constantes

Valeur

  • 'convert'

Package

Valeur

  • 'pnmscale'

Package

Valeur

  • _CONVERT_COMMAND . ' -quality ' . _IMG_CONVERT_QUALITE . ' -resize %xx%y! %src %dest'

Package

Liste des fonctions

string _couleur_dec_to_hex( integer $red , integer $green , integer $blue )

Paramètres

  1. integer $red

    Valeur du rouge de 0 à 255.

  2. integer $green

    Valeur du vert de 0 à 255.

  3. integer $blue

    Valeur du bleu de 0 à 255.

Retour

  • string

    Le code de la couleur en hexadécimal.

Package

Proposer une amélioration
array _couleur_hex_to_dec( string $couleur )

Paramètres

  1. string $couleur

    Code couleur en hexa (#000000 à #FFFFFF).

Retour

  • array

    Un tableau des 3 éléments : rouge, vert, bleu.

Package

Proposer une amélioration
array | null _image_creer_vignette( array $valeurs , integer $maxWidth , integer $maxHeight , string $process = 'AUTO' , boolean $force = false )

Paramètres

  1. array $valeurs

    Description de l'image, telle que retournée par _image_valeurs_trans()

  2. integer $maxWidth

    Largeur maximum en px de la miniature à réaliser

  3. integer $maxHeight

    Hauteur maximum en px de la miniateure à réaliser

  4. string $process = 'AUTO'

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

  5. boolean $force = false

Retour

  • array | null

    Description de l'image, sinon null.

Voir également

Utilise

Package

Proposer une amélioration

Reprend le tag initial et surcharge les attributs modifiés

string _image_ecrire_tag( array $valeurs , array $surcharge = array() )

Paramètres

  1. array $valeurs

    Description de l'image tel que retourné par _image_valeurs_trans()

  2. array $surcharge = array()

    Permet de surcharger certaines descriptions présentes dans $valeurs tel que 'style', 'width', 'height'

Retour

  • string

    Retourne le code HTML de l'image

Voir également

Package

Proposer une amélioration

Crée un fichier_image temporaire .src ou vérifie que le fichier_image définitif a bien été créé.

boolean _image_gd_output( \ressource $img , array $valeurs , integer $qualite = _IMG_GD_QUALITE )

Paramètres

  1. \ressource $img

    Une ressource de type Image GD.

  2. array $valeurs

    Un tableau des informations (tailles, traitement, path...) accompagnant l'image.

  3. integer $qualite = _IMG_GD_QUALITE

    N'est utilisé que pour les images jpg. Le niveau de qualité du fichier résultant : de 0 (pire qualité, petit fichier) à 100 (meilleure qualité, gros fichier). Par défaut, prend la valeur (85) de la constante _IMG_GD_QUALITE (modifiable depuis mes_options.php).

Retour

  • boolean
    • true si le traitement GD s'est bien finalisé ;
    • false sinon.

Package

Proposer une amélioration

Utilise les fonctions spécifiques GD.

boolean _image_imagegif( \ressource $img , string $fichier )

Paramètres

  1. \ressource $img

    Une ressource de type Image GD.

  2. string $fichier

    Le path vers l'image (ex : local/cache-vignettes/L180xH51/image.gif).

Retour

  • boolean
    • false si l'image créée a une largeur nulle ou n'existe pas ;
    • true si une image est bien retournée.

Package

Proposer une amélioration

Utilise les fonctions de la classe phpthumb_functions.

boolean _image_imageico( \ressource $img , string $fichier )

Paramètres

  1. \ressource $img

    Une ressource de type Image GD.

  2. string $fichier

    Le path vers l'image (ex : local/cache-vignettes/L180xH51/image.jpg).

Retour

  • boolean

    true si le fichier a bien été créé ; false sinon.

Utilise

Package

Proposer une amélioration

Utilise les fonctions spécifiques GD.

boolean _image_imagejpg( \ressource $img , string $fichier , integer $qualite = _IMG_GD_QUALITE )

Paramètres

  1. \ressource $img

    Une ressource de type Image GD.

  2. string $fichier

    Le path vers l'image (ex : local/cache-vignettes/L180xH51/image.jpg).

  3. integer $qualite = _IMG_GD_QUALITE

    Le niveau de qualité du fichier résultant : de 0 (pire qualité, petit fichier) à 100 (meilleure qualité, gros fichier). Par défaut, prend la valeur (85) de la constante _IMG_GD_QUALITE (modifiable depuis mes_options.php).

Retour

  • boolean
    • false si l'image créée a une largeur nulle ou n'existe pas ;
    • true si une image est bien retournée.

Package

Proposer une amélioration

Utilise les fonctions spécifiques GD.

boolean _image_imagepng( \ressource $img , string $fichier )

Paramètres

  1. \ressource $img

    Une ressource de type Image GD.

  2. string $fichier

    Le path vers l'image (ex : local/cache-vignettes/L180xH51/image.png).

Retour

  • boolean
    • false si l'image créée a une largeur nulle ou n'existe pas ;
    • true si une image est bien retournée.

Package

Proposer une amélioration

Réduit des dimensions (hauteur, largeur) pour qu'elles soient incluses dans une hauteur et largeur maximum fournies en respectant la proportion d'origine

array _image_ratio( integer $srcWidth , integer $srcHeight , integer $maxWidth , integer $maxHeight )

Paramètres

  1. integer $srcWidth

    Largeur de l'image source

  2. integer $srcHeight

    Hauteur de l'image source

  3. integer $maxWidth

    Largeur maximum souhaitée

  4. integer $maxHeight

    Hauteur maximum souhaitée

Retour

  • array

    Liste [ largeur, hauteur, ratio de réduction ]

Exemples

  • image_ratio(1000, 1000 , 100, 10) donne array(10, 10, 100)

Package

Proposer une amélioration

Utilisé avec des balises <img> tout particulièrement.

Modifie l'attribut style s'il était renseigné, en enlevant les informations éventuelles width / height dedans.

string _image_tag_changer_taille( string $tag , integer $width , integer $height , boolean | string $style = false )

Paramètres

  1. string $tag

    Code html de la balise

  2. integer $width

    Hauteur

  3. integer $height

    Largeur

  4. boolean | string $style = false

    Attribut html style à appliquer. False extrait celui présent dans la balise

Retour

  • string

    Code html modifié de la balise.

Package

Proposer une amélioration

Uniquement pour GD2.

boolean | string | array _image_valeurs_trans( string $img , string $effet , boolean | string $forcer_format = false , array $fonction_creation = null , boolean $find_in_path = false )

Paramètres

  1. string $img

    Chemin de l'image ou balise html <img src=... />.

  2. string $effet

    Les nom et paramètres de l'effet à apporter sur l'image (par exemple : reduire-300-200).

  3. boolean | string $forcer_format = false

    Un nom d'extension spécifique demandé (par exemple : jpg, png, txt...). Par défaut false : GD se débrouille seule).

  4. array $fonction_creation = null

    Un tableau à 2 éléments : 1) string : indique le nom du filtre de traitement demandé (par exemple : image_reduire) ; 2) array : tableau reprenant la valeur de $img et chacun des arguments passés au filtre utilisé.

  5. boolean $find_in_path = false

    false (par défaut) indique que l'on travaille sur un fichier temporaire (.src) ; true, sur un fichier définitif déjà existant.

Retour

  • boolean | string | array
    • false si pas de tag <img,
      • si l'extension n'existe pas,
      • si le fichier source n'existe pas,
      • si les dimensions de la source ne sont pas accessibles,
      • si le fichier temporaire n'existe pas,
      • si la fonction _imagecreatefrom{extension} n'existe pas ;
    • "" (chaîne vide) si le fichier source est distant et n'a pas réussi à être copié sur le serveur ;

    • array : tableau décrivant de l'image

Appelle le pipeline

Package

Proposer une amélioration

Utilise les fonctions spécifiques GD.

\ressource _imagecreatefromgif( string $filename )

Paramètres

  1. string $filename

    Le path vers l'image à traiter (par exemple : IMG/distant/gif/image.gif ou local/cache-vignettes/L180xH51/image.gif).

Retour

  • \ressource

    Une ressource de type Image GD.

Package

Proposer une amélioration

Utilise les fonctions spécifiques GD.

\ressource _imagecreatefromjpeg( string $filename )

Paramètres

  1. string $filename

    Le path vers l'image à traiter (par exemple : IMG/distant/jpg/image.jpg ou local/cache-vignettes/L180xH51/image.jpg).

Retour

  • \ressource

    Une ressource de type Image GD.

Package

Proposer une amélioration

Utilise les fonctions spécifiques GD.

\ressource _imagecreatefrompng( string $filename )

Paramètres

  1. string $filename

    Le path vers l'image à traiter (par exemple : IMG/distant/png/image.png ou local/cache-vignettes/L180xH51/image.png).

Retour

  • \ressource

    Une ressource de type Image GD.

Package

Proposer une amélioration

Ce filtre est automatiquement appelé à la fin d'une série de filtres d'images dans un squelette.

string image_graver( string $img )

Paramètres

  1. string $img

    Code HTML de l'image

Retour

  • string

    Code HTML de l'image

Appelle le pipeline

Package

Filtre

  • image_graver
Proposer une amélioration
boolean imagepalettetotruecolor( \ressource & $img )

Paramètres

  1. \ressource & $img

Retour

  • boolean
    • true si l'image est déjà en vrai RGB ou peut être transformée
    • false si la transformation ne peut être faite.

Package

Note

  • Pour compatibilité avec PHP < 5.5
Proposer une amélioration
string process_image_reduire( array $fonction , string $img , integer $taille , integer $taille_y , boolean $force , string $process = 'AUTO' )

Paramètres

  1. array $fonction

    Un tableau à 2 éléments : 1) string : indique le nom du filtre de traitement demandé (par exemple : image_reduire) ; 2) array : tableau reprenant la valeur de $img et chacun des arguments passés au filtre utilisé.

  2. string $img

    Chemin de l'image ou texte contenant une balise img

  3. integer $taille

    Largeur désirée

  4. integer $taille_y

    Hauteur désirée

  5. boolean $force
  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 la balise img produite

Package

Proposer une amélioration

Permet de rendre une image définitive et de supprimer les images intermédiaires à son calcul.

Supprime le fichier de contrôle de l’image cible (le $fichier.src) ce qui indique que l'image est définitive.

Remonte ensuite la chaîne des fichiers de contrôle pour supprimer les images temporaires (mais laisse les fichiers de contrôle permettant de les reconstruire).

void ramasse_miettes( string $fichier )

Paramètres

  1. string $fichier

    Chemin du fichier d'image calculé

Package

Proposer une amélioration

Réduit des dimensions (hauteur, largeur) pour qu'elles soient incluses dans la plus grande hauteur ou largeur maximum fournie en respectant la proportion d'origine

array ratio_passe_partout( integer $srcWidth , integer $srcHeight , integer $maxWidth , integer $maxHeight )

Paramètres

  1. integer $srcWidth

    Largeur de l'image source

  2. integer $srcHeight

    Hauteur de l'image source

  3. integer $maxWidth

    Largeur maximum souhaitée

  4. integer $maxHeight

    Hauteur maximum souhaitée

Retour

  • array

    Liste [ largeur, hauteur, ratio de réduction ]

Exemples

  • ratio_passe_partout(1000, 1000 , 100, 10) donne array(100, 100, 10)

Utilisé par

Package

Proposer une amélioration
void reconstruire_image_intermediaire( string $fichier_manquant )

Paramètres

  1. string $fichier_manquant

    Chemin vers le fichier manquant

Package

Proposer une amélioration

Un appel PHP direct aux fonctions de filtre d'image produira ainsi une image permanente (gravée) ; un appel généré par le compilateur via filtrer('image_xx, ...) effacera automatiquement le fichier-image temporaire.

boolean statut_effacer_images_temporaires( boolean | string $stat )

Paramètres

  1. boolean | string $stat

    true, false ou le statut déjà défini si traitements enchaînés.

Retour

  • boolean

    true si il faut supprimer le fichier temporaire ; false sinon.

Utilisé par

Package

Proposer une amélioration

Liste des classes

NomDescription
phpthumb_functions

Produire des fichiers au format .ico

Liste des marqueurs

Type Ligne Description
TODO 317 si une image png est nommee .jpg, le reconnaitre avec le bon $f