conjure (script MSL)

Ejemplos de uso • Resumen de opciones • Magick Scripting Language (MSL)

El programa conjure le permite realizar tareas de procesamiento de imágenes personalizadas a partir de un script escrito en el Magick Scripting Language (MSL). MSL está basado en XML y se compone de sentencias de acción con atributos. Las acciones incluyen leer una imagen, procesar una imagen, obtener atributos de una imagen, escribir una imagen y más. Un atributo es un par clave/valor que modifica el comportamiento de una acción. Consulte Procesamiento de la línea de comandos para obtener consejos sobre cómo estructurar su comando conjure, o vea a continuación ejemplos de uso del comando.

Ejemplos de uso

Aquí enumeramos algunos ejemplos del comando conjure para ilustrar su utilidad y facilidad de uso. Para empezar, este es un comando conjure sencillo:

magick conjure -dimensions 400x400 msl:incantation.msl

El script MSL incantation.msl usado arriba es el siguiente:

<?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>

En este ejemplo, una familia se quedó en casa durante sus vacaciones, pero por lo que respecta a sus amigos se fueron a una hermosa playa del Caribe:

<?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>

Aquí mostramos el ancho en píxeles del texto para una fuente y un tamaño de punto concretos.

<?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 etiqueta query-font-metrics admite estas propiedades:

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 admite la mayoría de los métodos y atributos descritos en la API Perl de ImageMagick.

Además, MSL admite el elemento swap con un único elemento indexes.

Resumen de opciones

El comando conjure reconoce estas opciones. Haga clic en una opción para obtener más detalles sobre cómo funciona.

Magick Scripting Language

El comando conjure reconoce estos elementos MSL. Cualquier elemento tachado todavía no está soportado.