conjure (script MSL)

Exemples d'utilisation • Récapitulatif des options • Magick Scripting Language (MSL)

Le programme conjure vous permet d'effectuer des tâches de traitement d'image personnalisées à partir d'un script écrit en Magick Scripting Language (MSL). MSL est basé sur XML et se compose d'instructions d'action accompagnées d'attributs. Les actions comprennent la lecture d'une image, le traitement d'une image, l'obtention des attributs d'une image, l'écriture d'une image, et plus encore. Un attribut est une paire clé/valeur qui modifie le comportement d'une action. Consultez le Traitement en ligne de commande pour des conseils sur la façon de structurer votre commande conjure, ou voyez ci-dessous des exemples d'utilisation de la commande.

Exemples d'utilisation

Nous présentons ici quelques exemples de la commande conjure pour illustrer son utilité et sa simplicité. Pour commencer, voici une commande conjure simple :

magick conjure -dimensions 400x400 msl:incantation.msl

Le script MSL incantation.msl utilisé ci-dessus est le suivant :

<?xml version="1.0" encoding="UTF-8"?>
<image>
  <read filename="image.gif" />
  <get width="base-width" height="base-height" />
  <resize geometry="%[dimensions]" />
  <get width="resize-width" height="resize-height" />
  <print output="Image sized from %[base-width]x%[base-height] to %[resize-width]x%[resize-height].\n" />
  <write filename="image.png" />
</image>

Dans cet exemple, une famille est restée chez elle pendant ses vacances, mais pour ses amis elle est allée sur une belle plage des Caraïbes :

<?xml version="1.0" encoding="UTF-8"?>
<group>
    <image id="family">
        <read filename="family.gif"/>
        <resize geometry="300x300"/>
    </image>
    <image id="palm-trees">
        <read filename="palm-trees.gif"/>
        <resize geometry="300x100"/>
    </image>
    <image>
        <read filename="beach.jpg"/>
        <composite image="family" geometry="+30+40"/>
        <composite image="palm-trees" geometry="+320+90"/>
    </image>
    <write filename="family-vacation.png"/>
</group>

Ici, nous affichons en pixels la largeur d'un texte pour une police et une taille de point données.

<?xml version="1.0" encoding="UTF-8"?>
<image>
  <query-font-metrics text="ImageMagick" font="helvetica" pointsize="48" />
  <print output="Text width is %[msl:font-metrics.width] pixels.\n" />
</image>

La balise query-font-metrics prend en charge ces propriétés :

msl:font-metrics.pixels_per_em.x
msl:font-metrics.pixels_per_em.y
msl:font-metrics.ascent
msl:font-metrics.descent
msl:font-metrics.width
msl:font-metrics.height
msl:font-metrics.max_advance
msl:font-metrics.bounds.x1
msl:font-metrics.bounds.y1
msl:font-metrics.bounds.x2
msl:font-metrics.bounds.y2
msl:font-metrics.origin.x
msl:font-metrics.origin.y

MSL prend en charge la plupart des méthodes et attributs décrits dans l'API Perl pour ImageMagick.

De plus, MSL prend en charge l'élément swap avec un unique élément indexes.

Récapitulatif des options

La commande conjure reconnaît ces options. Cliquez sur une option pour obtenir plus de détails sur son fonctionnement.

Magick Scripting Language

La commande conjure reconnaît ces éléments MSL. Tout élément barré n'est pas encore pris en charge.