Contoh penggunaan • Ringkasan opsi • Magick Scripting Language (MSL)

Program conjure memungkinkan Anda menjalankan tugas pemrosesan gambar kustom dari sebuah skrip yang ditulis dalam Magick Scripting Language (MSL). MSL berbasis XML dan terdiri dari pernyataan aksi (action statement) beserta atributnya. Aksi tersebut mencakup membaca gambar, memproses gambar, mengambil atribut gambar, menulis gambar, dan masih banyak lagi. Atribut adalah pasangan key/value yang mengubah perilaku suatu aksi. Lihat Pemrosesan baris perintah untuk saran cara menyusun perintah conjure Anda, atau lihat contoh penggunaan perintah ini di bawah.

Contoh penggunaan

Berikut beberapa contoh perintah conjure untuk mengilustrasikan kegunaan dan kemudahan penggunaannya. Untuk memulai, berikut contoh perintah conjure yang sederhana:

magick conjure -dimensions 400x400 msl:incantation.msl

Skrip MSL incantation.msl yang digunakan di atas adalah sebagai berikut:

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

Dalam contoh ini, satu keluarga tetap di rumah selama liburan mereka, tetapi bagi teman-teman mereka, seolah-olah mereka pergi ke pantai indah di Karibia:

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

Di sini kita menampilkan lebar teks dalam piksel untuk font dan pointsize tertentu.

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

Tag query-font-metrics mendukung properti berikut:

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 mendukung sebagian besar metode dan atribut yang dibahas dalam Perl API untuk ImageMagick.

Selain itu, MSL mendukung elemen swap dengan satu elemen indexes.

Ringkasan opsi

Perintah conjure mengenali opsi-opsi berikut. Klik salah satu opsi untuk melihat detail lebih lanjut tentang cara kerjanya.

Magick Scripting Language

Perintah conjure mengenali elemen-elemen MSL berikut. Elemen dengan coretan (strike-thru) belum didukung.