Fichier ecrire/inc/filtres_images_lib_mini.php
Ce fichier contient les fonctions utilisées par les fonctions-filtres de traitement d'image.
Source
Liste des constantes
Valeur
-
_CONVERT_COMMAND . ' -quality ' . _IMG_CONVERT_QUALITE . ' -resize %xx%y! %src %dest'
Source
Liste des fonctions
Paramètres
-
integer $red
Valeur du rouge de 0 à 255.
-
integer $green
Valeur du vert de 0 à 255.
-
integer $blue
Valeur du bleu de 0 à 255.
Retour
-
string
Le code de la couleur en hexadécimal.
Utilisé par
Source
Paramètres
-
string $couleur
Code couleur en hexa (#000000 à #FFFFFF).
Retour
-
array
Un tableau des 3 éléments : rouge, vert, bleu.
Source
Paramètres
-
array $valeurs
Description de l'image, telle que retournée par
_image_valeurs_trans()
-
integer $maxWidth
Largeur maximum en px de la miniature à réaliser
-
integer $maxHeight
Hauteur maximum en px de la miniateure à réaliser
-
string $process = 'AUTO'
Librairie graphique à utiliser (gd1, gd2, netpbm, convert, imagick). AUTO utilise la librairie sélectionnée dans la configuration.
-
boolean $force = false
Retour
-
array | null
Description de l'image, sinon null.
Voir également
Utilise
Utilisé par
Source
Reprend le tag initial et surcharge les attributs modifiés
Paramètres
-
array $valeurs
Description de l'image tel que retourné par
_image_valeurs_trans()
-
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
Utilisé par
Appelle le pipeline
Source
Crée un fichier_image temporaire .src ou vérifie que le fichier_image définitif a bien été créé.
Paramètres
-
resource | string $img
Une ressource de type Image GD (ou une string pour un SVG)
-
array $valeurs
Un tableau des informations (tailles, traitement, path...) accompagnant l'image.
-
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.
Source
Utilise les fonctions spécifiques GD.
Paramètres
-
\ressource $img
Une ressource de type Image GD.
-
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.
Source
Utilise les fonctions de la classe phpthumb_functions.
Paramètres
-
\ressource $img
Une ressource de type Image GD.
-
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
Source
Utilise les fonctions spécifiques GD.
Paramètres
-
\ressource $img
Une ressource de type Image GD.
-
string $fichier
Le path vers l'image (ex : local/cache-vignettes/L180xH51/image.jpg).
-
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.
Source
Utilise les fonctions spécifiques GD.
Paramètres
-
\ressource $img
Une ressource de type Image GD.
-
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.
Source
- N'UTILISE PAS GD - C'est une fonction derogatoire pour faciliter le traitement des SVG
Paramètres
-
string $img
contenu du SVG ou chemin vers le SVG source (et c'est alors une copie)
-
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.
Source
Réduit des dimensions (hauteur, largeur) pour qu'elles soient incluses dans une hauteur et largeur maximum fournies en respectant la proportion d'origine
Paramètres
-
integer $srcWidth
Largeur de l'image source
-
integer $srcHeight
Hauteur de l'image source
-
integer $maxWidth
Largeur maximum souhaitée
-
integer $maxHeight
Hauteur maximum souhaitée
Retour
-
array
Liste [ largeur, hauteur, ratio de réduction ]
Exemples
-
image_ratio(1000, 1000 , 100, 10)
donnearray(10, 10, 100)
Voir également
Source
Utilisé avec des balises <img>
tout particulièrement.
Modifie l'attribut style s'il était renseigné, en enlevant les informations éventuelles width / height dedans.
Paramètres
-
string $tag
Code html de la balise
-
integer $width
Hauteur
-
integer $height
Largeur
-
boolean | string $style = false
Attribut html style à appliquer. False extrait celui présent dans la balise
Retour
-
string
Code html modifié de la balise.
Utilise
Utilisé par
Source
Paramètres
-
string $path
Retour
-
string
Source
Paramètres
-
string $path
Retour
-
string
Extension, dans le format attendu par les fonctions 'gd' ('jpeg' pour les .jpg par exemple)
Source
Uniquement pour GD2.
Paramètres
-
string $img
Chemin de l'image ou balise html
<img src=... />
. -
string $effet
Les nom et paramètres de l'effet à apporter sur l'image (par exemple : reduire-300-200).
-
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).
-
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é. -
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.
-
boolean $support_svg = false
false (par defaut) indique que le filtre ne sait pas traiter le cas particulier du SVG on lui substitue un filtre generique qui ne fait rien pour ne pas briser la chaine des filtres images true si le filtre appelant sait traiter les SVG
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
-
Utilise
Utilisé par
Appelle le pipeline
Source
Utilise les fonctions spécifiques GD.
Paramètres
-
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.
Source
Utilise les fonctions spécifiques GD.
Paramètres
-
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.
Source
Utilise les fonctions spécifiques GD.
Paramètres
-
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.
Source
Ce filtre est automatiquement appelé à la fin d'une série de filtres d'images dans un squelette.
Paramètres
-
string $img
Code HTML de l'image
Retour
-
string
Code HTML de l'image
Utilise
Appelle le pipeline
Filtre
-
image_graver
Source
Paramètres
-
\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.
Documentation externe
Note
-
Pour compatibilité avec PHP < 5.5
Source
Paramètres
-
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é. -
string $img
Chemin de l'image ou texte contenant une balise img
-
integer $taille
Largeur désirée
-
integer $taille_y
Hauteur désirée
-
boolean $force
-
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
Utilise
Utilisé par
Source
Paramètres
-
array $image
tableau des valeurs crees par _image_valeurs_trans
Retour
-
string
Source
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).
Paramètres
-
string $fichier
Chemin du fichier d'image calculé
Utilisé par
Source
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
Paramètres
-
integer $srcWidth
Largeur de l'image source
-
integer $srcHeight
Hauteur de l'image source
-
integer $maxWidth
Largeur maximum souhaitée
-
integer $maxHeight
Hauteur maximum souhaitée
Retour
-
array
Liste [ largeur, hauteur, ratio de réduction ]
Exemples
-
ratio_passe_partout(1000, 1000 , 100, 10)
donnearray(100, 100, 10)
Voir également
Utilisé par
Source
Paramètres
-
string $fichier_manquant
Chemin vers le fichier manquant
Utilise
Utilisé par
Source
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.
Paramètres
-
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
Source
Liste des classes
Nom | Description |
---|---|
phpthumb_functions |
Produire des fichiers au format .ico |