<crop width="[+-]nombre" height="[+-]nombre" position="centered/topleft/topright/bottomleft/bottomright"/>

Cet effet permet de définir quelle portion de l'image de départ sera conservée dans l'image transformée.

Les attributs width et height définisssent respectivement la hauteur et la largeur de la portion à recadrer.

Si vous indiquez + ou - devant le nombre, celui-ci sera ajouté ou retranchée à la taille actuelle.

L'attribut position permet de définir à quel endroit de l'image sera découpée cette portion. Les différentes valeurs possibles pour cet attribut sont :

• centered - portion au centre de l'image
• topleft - portion dans le coin supérieur gauche
• topright - portion dans le coin supérieur droit
• bottomleft - portion dans le coin inférieur gauche
• bottomright - portion dans le coin inférieur droit
• topcenter - portion centrée en haut de l'image
• bottomcenter - portion centrée dans le bas de l'image

Si la taille précisée pour la nouvelle portion est plus grande que la taille actuelle de l'image, celle-ci sera recadrée en comblant les nouveaux espaces créés par ce recadrage avec un fond blanc. Vous pouvez modifier la couleur de ce fond en utilisant l'attribut background-color.

La valeur de background-color est donnée en hexadécimale.

Ex: background-color="#565656"

background-color peut également prendre la valeur "transparent" si l'on souhaite un fond transparent.

Il faut alors que le format soit un format supportant la transparence (png, gif). Utilisez la commande convert avant la commande crop pour convertir votre image dans un format supportant la transparence.