Sommaire
Utilisations
Ce filtre s’applique aussi bien sur
- le chemin de l’image (balise #FICHIER)
- une balise html
`<img src=... />`
(Voir Les balises #LOGO_XXX ou encore le filtre |balise_img)
Recadrer selon des dimensions absolues
Les arguments sont :
|image_recadre{largeur, hauteur, position, couleur de fond}
- largeur ;
- hauteur ;
- position (optionnel) :
- `center`, `left`, `right`, `top`, `bottom` ;
- ou combinaisons de plusieurs `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.
- couleur de fond (optionnel), argument est utile si on agrandit l’image.
Exemples avec dimensions absolues
[(#FICHIER|image_recadre{800, 400})]
[(#LOGO_ARTICLE|image_recadre{800, 400, center})]
[(#LOGO_RUBRIQUE|image_recadre{800, 400, center, black})]
[(#FICHIER|image_recadre{90,90,center})]

recadre l’image originale en un carré de 90 px de largeur et hauteur en se basant sur le centre de l’image.
|image_recadre
permet également d’agrandir un fichier image, le fond est alors spécifié par une couleur ou ’transparent’ en 4e argument :
[(#FICHIER|image_recadre{500,300,'top left','#663399'})]

Recadrer selon des proportions
(Depuis SPIP 3.0.19 )
Les arguments sont :
|image_recadre{proportions, +|-, position, couleur de fond}
- proportions : ratio largeur:hauteur demandé ;
- +|- : ’+’ pour agrandir avec des bandes, ’-’ pour réduire. (si ’-’ est appliqué, c’est l’équivalent de |image_passe_partout) ;
- position (optionnel) : Indication de position de la découpe :
- `center`, `left`, `right`, `top`, `bottom` ;
- ou combinaisons de plusieurs `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.
- couleur de fond (optionnel) : couleur de fond si on agrandit l’image
Exemples avec des proportions
[(#FICHIER|image_recadre{16:9, '-'})]
[(#LOGO_BREVE|image_recadre{1:1, '-', center})]
[(#FICHIER|image_recadre{16:9, -, top left})]
[(#FICHIER|image_recadre{16:9, -, top=40 left=20})]
[(#FICHIER|image_recadre{16:9, +, center, white})]

Permet d’avoir un logo au format 16:9 en recadrant l’image le moins possible.
Cela permet de conserver l’image la plus grande possible qui respecte une proportion.
Exemple
[(#LOGO_ARTICLE|image_recadre{1:1,-,center top})]

Voir aussi
Les filtres
L’article sur le Traitement automatisé des images, détaillant également de nombreux autres filtres image.