SPIP Code

Documentation du code de SPIP et de ses plugins

Images

images_transforme.php

SPIP, Système de publication pour l'internet

Copyright © avec tendresse depuis 2001 Arnaud Martin, Antoine Pitrou, Philippe Rivière, Emmanuel Saint-James

Ce programme est un logiciel libre distribué sous licence GNU/GPL.

Table of Contents

Functions

image_oriente_selon_exif()  : string
Un filtre pour re-orienter automatiquement une image selon son exif - si besoin si pas d'exif ou pas d'orientation, le filtre ne fait rien et renvoie l'image d'origine
image_aplatir()  : mixed
image_format()  : mixed
image_alpha()  : mixed
image_recadre()  : string
Recadre (rogne) une image en indiquant la taille de la découpe souhaitée
image_recadre_mini()  : string
Recadrer une image dans le rectangle le plus petit possible sans perte de pixels non transparent Le recadrage se fait en conservant le centre de l'image : on recadre symétriquement gauche vs droite et haut vs bas TODO : proposer une option pour vraiment recadrer au plus juste, meme si ca decentre l'image
image_flip_vertical()  : string
Flip une image selon un axe de symétrie central et vertical (c'est donc un flip horizontal au sens de GD)
image_flip_horizontal()  : string
Flip une image selon un axe de symétrie central et horizontal (c'est donc un flip vertical au sens de GD)
image_masque()  : mixed
image_nb()  : string
Passage de l'image en noir et blanc un noir & blanc "photo" n'est pas "neutre": les composantes de couleur sont ponderees pour obtenir le niveau de gris on peut ici regler cette ponderation en "pour mille"
image_flou()  : string
Calcul d'un flou sur une image.
dimensions_rotation_image()  : array<string|int, mixed>
Determiner les nouvelles dimensions de l'image apres rotation
image_rotation()  : string
permet de faire tourner une image d'un angle quelconque le flag "crop" permet de recadrer l'image pour conserver sa taille d'origine
image_imagick()  : string
Permet d'appliquer un filtre basé sur une méthode Imagick:: a une image par exemple: [(#LOGO_ARTICLE|image_imagick{waveImage,20,60})] Les arguments suivant le nom de la méthode sont ceux de la méthode
_image_imagick_write()  : bool
Ecriture sur le disque d'une umage générée par Imagick
image_gamma()  : mixed
image_sepia()  : mixed|string
Passe l'image en "sepia" On peut fixer les valeurs RGB de la couleur "complementaire" pour forcer une dominante
image_renforcement()  : string
Renforcer la netteté d'une image
image_fond_transparent()  : mixed|null|string
Transforme la couleur de fond de l'image en transparence Le filtre ne gere pas la notion de contiguite aux bords, et affectera tous les pixels de l'image dans la couleur visee $background_color : couleur cible $tolerance : distance L1 dans l'espace RGB des couleur autour de la couleur $background_color pour lequel la transparence sera appliquee $alpha : transparence a appliquer pour les pixels de la couleur cibles avec la tolerance ci-dessus $coeff_lissage : coeff applique a la tolerance pour determiner la decroissance de la transparence fonction de la distance L1 entre la couleur du pixel et la couleur cible

Functions

image_oriente_selon_exif()

Un filtre pour re-orienter automatiquement une image selon son exif - si besoin si pas d'exif ou pas d'orientation, le filtre ne fait rien et renvoie l'image d'origine

image_oriente_selon_exif(string $img) : string
Parameters
$img : string
Return values
string

image_aplatir()

image_aplatir(mixed $im[, mixed $format = 'jpg' ][, mixed $coul = '000000' ][, mixed $qualite = null ][, mixed $transparence = false ]) : mixed
Parameters
$im : mixed
$format : mixed = 'jpg'
$coul : mixed = '000000'
$qualite : mixed = null
$transparence : mixed = false

image_format()

image_format(mixed $img[, mixed $format = 'png' ]) : mixed
Parameters
$img : mixed
$format : mixed = 'png'

image_alpha()

image_alpha(mixed $im[, mixed $alpha = 63 ]) : mixed
Parameters
$im : mixed
$alpha : mixed = 63

image_recadre()

Recadre (rogne) une image en indiquant la taille de la découpe souhaitée

image_recadre(string $im, string|int $width[, string|int $height = '-' ][, string $position = 'center' ][, string $background_color = 'white' ]) : string

On peut indiquer une proportion ou une taille spécifique, une position de rognage et une couleur de fond, si le rognage est de taille plus grande que l'image d'origine.

Parameters
$im : string

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

$width : string|int

Largeur du recadrage ou ratio sous la forme "16:9"

$height : string|int = '-'

Hauteur du recadrage ou "+" (agrandir) ou "-" (reduire) si un ratio est fourni pour width

$position : string = 'center'

Indication de position de la découpe :

  • center, left, right, top, bottom,
  • ou combinaisons de plusiers top left
  • ou indication en pixels depuis une position top=50 ou composée top=40 left=50
  • ou nom d'une fonction spéciale qui calculera et retournera la position souhaitée
$background_color : string = 'white'

Couleur de fond si on agrandit l'image

Tags
example
  • [(#FICHIER|image_recadre{800, 400})]
  • [(#FICHIER|image_recadre{800, 400, center})]
  • [(#FICHIER|image_recadre{800, 400, center, black})]
  • [(#FICHIER|image_recadre{16:9})]
  • [(#FICHIER|image_recadre{16:9, -})] (- est appliqué par défaut, équivalent à image_passe_partout)
  • [(#FICHIER|image_recadre{16:9, +, center, white})]
  • [(#FICHIER|image_recadre{16:9, -, top left})]
  • [(#FICHIER|image_recadre{16:9, -, top=40 left=20})]
filtre
uses
_image_valeurs_trans()
uses
_image_tag_changer_taille()

si image trop grande pour être traitée

uses
_image_ecrire_tag()
link
https://www.spip.net/5786
Return values
string —

balise image recadrée

image_recadre_mini()

Recadrer une image dans le rectangle le plus petit possible sans perte de pixels non transparent Le recadrage se fait en conservant le centre de l'image : on recadre symétriquement gauche vs droite et haut vs bas TODO : proposer une option pour vraiment recadrer au plus juste, meme si ca decentre l'image

image_recadre_mini(string $im) : string
Parameters
$im : string
Return values
string

image_flip_vertical()

Flip une image selon un axe de symétrie central et vertical (c'est donc un flip horizontal au sens de GD)

image_flip_vertical(string $im) : string
Parameters
$im : string
Return values
string

image_flip_horizontal()

Flip une image selon un axe de symétrie central et horizontal (c'est donc un flip vertical au sens de GD)

image_flip_horizontal(string $im) : string
Parameters
$im : string
Return values
string

image_masque()

image_masque(mixed $im, mixed $masque[, mixed $pos = '' ]) : mixed
Parameters
$im : mixed
$masque : mixed
$pos : mixed = ''

image_nb()

Passage de l'image en noir et blanc un noir & blanc "photo" n'est pas "neutre": les composantes de couleur sont ponderees pour obtenir le niveau de gris on peut ici regler cette ponderation en "pour mille"

image_nb(string $im[, int|null $val_r = null ][, int|null $val_g = null ][, int|null $val_b = null ]) : string

Par défaut, si on ne passe pas de pondération, on utilise le filtre IMG_FILTER_GRAYSCALE de GD beaucoup plus rapide

Parameters
$im : string
$val_r : int|null = null
$val_g : int|null = null
$val_b : int|null = null
Return values
string

image_flou()

Calcul d'un flou sur une image.

image_flou( $im[, int $niveau = 3 ]) : string

On utilise une matrice de convolution pour le niveau 1 et le niveau 2, qu'on repasse autant de fois que nécessaire pour arriver au niveau de flou souhaité qui est appriximativement le rayon du flou Le filtre préserve la transparence

Parameters
$im :
$niveau : int = 3
Return values
string

dimensions_rotation_image()

Determiner les nouvelles dimensions de l'image apres rotation

dimensions_rotation_image(int|float $angle, int $width, int $height[, int $center_x = null ][, int $center_y = null ]) : array<string|int, mixed>
Parameters
$angle : int|float

en degres

$width : int
$height : int
$center_x : int = null
$center_y : int = null
Return values
array<string|int, mixed> —

[int, int]

image_rotation()

permet de faire tourner une image d'un angle quelconque le flag "crop" permet de recadrer l'image pour conserver sa taille d'origine

image_rotation(string $im, float $angle[, bool $crop = false ]) : string
Parameters
$im : string
$angle : float
$crop : bool = false
Return values
string

image_imagick()

Permet d'appliquer un filtre basé sur une méthode Imagick:: a une image par exemple: [(#LOGO_ARTICLE|image_imagick{waveImage,20,60})] Les arguments suivant le nom de la méthode sont ceux de la méthode

image_imagick() : string

Liste des méthodes: https://www.php.net/manual/en/book.imagick.php

Tags
throws
ImagickException
uses
_image_imagick_write()
Return values
string

_image_imagick_write()

Ecriture sur le disque d'une umage générée par Imagick

_image_imagick_write(Imagick $imagick, string $fichier[, mixed $qualite = _IMG_GD_QUALITE ]) : bool
Parameters
$imagick : Imagick
$fichier : string

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

$qualite : mixed = _IMG_GD_QUALITE
Tags
see
image_imagick()
used-by
image_imagick()
Return values
bool —
  • false si l'image créée a une largeur nulle ou n'existe pas ;
  • true si une image est bien retournée.

image_gamma()

image_gamma(mixed $im[, mixed $gamma = 0 ]) : mixed
Parameters
$im : mixed
$gamma : mixed = 0

image_sepia()

Passe l'image en "sepia" On peut fixer les valeurs RGB de la couleur "complementaire" pour forcer une dominante

image_sepia(string $im[, string $rgb = '896f5e' ][, bool $legacy = false ]) : mixed|string

Par defaut, on utilise les fonciton de gd pour un résultat plus rapide mais avec un peu moins de piquant que la méthode historique de SPIP, dont on peut retrouver le résultat en passant $legacy = true en argument

Parameters
$im : string
$rgb : string = '896f5e'
$legacy : bool = false
Return values
mixed|string

image_renforcement()

Renforcer la netteté d'une image

image_renforcement(string $im[, float $k = 0.5 ]) : string
Parameters
$im : string

Code HTML de l'image

$k : float = 0.5

Niveau de renforcement (entre 0 et 1)

Return values
string —

Code HTML de l'image

image_fond_transparent()

Transforme la couleur de fond de l'image en transparence Le filtre ne gere pas la notion de contiguite aux bords, et affectera tous les pixels de l'image dans la couleur visee $background_color : couleur cible $tolerance : distance L1 dans l'espace RGB des couleur autour de la couleur $background_color pour lequel la transparence sera appliquee $alpha : transparence a appliquer pour les pixels de la couleur cibles avec la tolerance ci-dessus $coeff_lissage : coeff applique a la tolerance pour determiner la decroissance de la transparence fonction de la distance L1 entre la couleur du pixel et la couleur cible

image_fond_transparent(string $im, string $background_color[, int $tolerance = 12 ][, int $alpha = 127 ][, int $coeff_lissage = 7 ]) : mixed|null|string
Parameters
$im : string
$background_color : string
$tolerance : int = 12
$alpha : int = 127

alpha = 0: aucune transparence alpha = 127: completement transparent

$coeff_lissage : int = 7
Return values
mixed|null|string 

        

        
    




    

    

                                

                

                            
    

        On this page

        
    


                

                            

            

    

        

            
Search results