Opsi baris perintah -define menambahkan pengaturan global tertentu yang umumnya digunakan untuk mengendalikan coder dan operasi pemrosesan gambar.

Opsi ini membuat satu atau beberapa definisi yang digunakan oleh coder dan decoder saat membaca dan menulis data gambar. Definisi ini umumnya digunakan untuk mengendalikan modul coder format file gambar, serta operasi pemrosesan gambar, melampaui apa yang disediakan oleh cara normal. Pengaturan yang telah didefinisikan dicantumkan dalam informasi -verbose (format output "info:") sebagai "Artifacts".

Jika value tidak diberikan untuk definisi, definisi flag bernilai kosong dibuat dengan nama tersebut. Ini digunakan untuk mengendalikan opsi on/off. Gunakan -define keys untuk menghapus definisi yang sudah dibuat sebelumnya. Gunakan +define "*" untuk menghapus semua definisi yang ada.

Pengaturan 'artifact' yang sama juga dapat didefinisikan menggunakan opsi -set "option:key" "value", yang juga memungkinkan penggunaan Memformat dan mencetak properti gambar dalam value yang didefinisikan.

option dan key tidak case-sensitive (keduanya dikonversi ke huruf kecil untuk digunakan di dalam decoder), sedangkan value bersifat case-sensitive.

Pengaturan semacam ini cakupannya bersifat global, dan memengaruhi semua gambar serta operasi.

magick bilevel.tif -define ps:imagemask eps3:stencil.ps
magick arrow.tga -set colorspace:auto-grayscale=off myArrow.tga

Mengatur atribut registry gambar dengan memberi awalan registry: pada value. Misalnya, untuk mengatur path sementara tempat menyimpan file kerja, gunakan:

-define registry:temporary-path=/data/tmp

Berikut adalah daftar define yang dikenali:

Definisi Baris Perintah

FORMAT GAMBAR

-define png:include-chunk=none,gAMA

Sebagai kasus khusus, jika chunk sRGB tidak dikecualikan dan PNG encoder mengenali bahwa gambar berisi profil ICC sRGB, PNG encoder akan menulis chunk sRGB alih-alih seluruh profil ICC. Untuk memaksa PNG encoder menulis profil sRGB sebagai chunk iCCP pada output PNG alih-alih chunk sRGB, kecualikan chunk sRGB. Chunk PNG kritis IHDR, PLTE, IDAT, dan IEND tidak dapat dikecualikan. Entri semacam itu yang muncul dalam daftar akan diabaikan. Jika chunk ancillary PNG tRNS dikecualikan dan gambar memiliki transparansi, colortype PNG dipaksa menjadi 4 atau 6 (GRAY_ALPHA atau RGBA). Jika gambar tidak transparan, maka chunk tRNS tetap tidak ditulis, dan tidak ada pengaruh pada colortype PNG gambar output. Opsi -strip melakukan hal yang setara dengan berikut ini untuk output PNG:

-define png:exclude-chunk=EXIF,iCCP,iTXt,sRGB,tEXt,zCCP,zTXt,date

Perilaku default adalah menyertakan semua chunk ancillary PNG yang dikenal ditambah chunk privat vpAg ("virtual page") milik ImageMagick, dan mengecualikan semua chunk PNG yang tidak dikenal oleh ImageMagick, terlepas dari status "copy-safe" PNG-nya sebagaimana dijelaskan dalam spesifikasi PNG. Nama chunk apa pun yang tidak dikenal oleh ImageMagick akan diabaikan jika muncul dalam daftar "include-chunk" maupun "exclude-chunk". Chunk ancillary yang saat ini dikenal oleh ImageMagick adalah bKGD, cHRM, gAMA, iCCP, oFFs, orNT, pHYs, sRGB, tEXt, tRNS, vpAg, dan zTXt. Anda juga dapat menambahkan date pada daftar untuk menyertakan atau mengecualikan chunk teks "Date:create" dan "Date:modify" yang biasanya disisipkan ImageMagick pada output PNG.
png:ignore-crc[=true] | Jika Anda tahu gambar Anda tidak memiliki error CRC atau ADLER32, ini dapat mempercepat decoding. Ini juga membantu saat men-debug laporan bug dari "fuzzer".
png:preserve-colormap[=true] | Menggunakan image->colormap yang sudah ada. Biasanya PNG encoder akan mencoba mengoptimalkan palet, menghilangkan entri yang tidak digunakan dan menempatkan warna transparan di awal. Jika flag ini diatur, perilaku tersebut ditekan.
png:preserve-iCCP[=true] | Secara default, PNG decoder dan encoder memeriksa profil ICC apa pun yang ada, baik dari chunk iCCP pada input PNG maupun yang diberikan melalui suatu opsi, dan jika profil tersebut dikenali sebagai profil sRGB, mengonversinya menjadi chunk sRGB. Anda dapat menggunakan -define png:preserve-iCCP untuk mencegah hal ini terjadi; dalam kasus tersebut chunk iCCP akan dibaca atau ditulis dan tidak ada chunk sRGB yang ditulis. Ada beberapa profil ICC yang mengklaim sebagai sRGB tetapi memiliki berbagai error sehingga ditolak oleh libpng16; profil semacam itu tetap dikenali dan dikonversi menjadi chunk sRGB, tetapi ditolak jika -define png:preserve-iCCP disertakan. Perlu dicatat bahwa tidak semua profil ICC "sRGB" sudah dikenali; kami akan menambahkannya ke daftar seiring ditemukan.
png:swap-bytes[=true] | Spesifikasi PNG mensyaratkan bahwa integer multi-byte disimpan dalam network byte order (endian MSB-LSB). Opsi ini memungkinkan Anda memperbaiki file PNG tidak valid yang menyimpan sampel 16-bit secara salah dalam urutan little-endian (LSB-MSB). Opsi "-define png:swap-bytes" harus muncul sebelum nama file input pada baris perintah. Penukaran ini dilakukan selama operasi decoding libpng.
ps:imagemask | Jika flag ps:imagemask didefinisikan, coder PS3 dan EPS3 akan membuat file Postscript yang me-render gambar bilevel dengan operator imagemask Postscript, bukan operator image.
psd:additional-info=all|selective | Opsi ini hanya boleh digunakan saat mengonversi dari file PSD ke file PSD lain. Opsi ini harus ditempatkan setelah gambar dibaca. Kedua opsinya adalah 'all' dan 'selective'. Opsi 'selective' akan mempertahankan semua informasi tambahan yang tidak terkait dengan geometri gambar. Opsi 'all' hanya boleh digunakan jika geometri gambar tidak berubah. Opsi ini berguna saat memindahkan layer yang tidak sederhana, seperti adjustment layer, dari file PSD input ke file PSD output. Jika opsi ini tidak digunakan, informasi tambahan tidak akan dipertahankan. Define ini tersedia sejak Imagemagick versi 6.9.5-8.
psd:alpha-unblend=off | Menonaktifkan un-blending otomatis baru dari transparansi dengan gambar dasar untuk layer 0 yang telah di-flatten, sebelum menambahkan kanal alpha ke gambar output. Define ini harus ditempatkan sebelum gambar psd input. (Tersedia sejak IM 6.9.2.5). Un-blending otomatis ini baru di IM 6.9.2.5 dan mencegah transparansi diterapkan dua kali pada gambar output. Opsi ini harus diatur sebelum gambar dibaca.
psd:preserve-opacity-mask=true | Opsi ini hanya boleh digunakan saat mengonversi dari file PSD ke file PSD lain. Opsi ini akan mempertahankan opacity mask sebuah layer dan menambahkannya kembali ke layer tersebut saat gambar disimpan. Mengatur opsi ini ke 'true' akan mengaktifkan fitur ini. Define ini tersedia sejak Imagemagick versi 6.9.5-10.
psd:write-layers=false | Opsi ini dapat digunakan untuk menonaktifkan penulisan layer pada file PSD.
psd:replicate-profile=true | Opsi ini dapat digunakan untuk menyalin profil gambar ke semua gambar, bukan hanya ke gambar pertama yang dikembalikan.
ptif:pyramid=min-basexlevels | Menentukan min-base dan jumlah level piramida, misalnya, 64x4.
svg:parse-huge=true | Mengaktifkan rendering SVG yang sangat besar, untuk sumber yang Anda percaya.
svg:substitute-entities=true | Mengaktifkan substitusi entitas jika Anda percaya sumbernya.
tga:preserve-orientation=true | Mempertahankan orientasi gambar.
tga:write-footer=true | Mengaktifkan penulisan footer opsional yang kosong.
tiff:alpha=associated|unassociated|unspecified | Menentukan extra sample alpha sebagai associated, unassociated, atau unspecified.
tiff:assume-alpha=true|false | Menganggap kanal ekstra yang tidak dideklarasikan sebagai alpha.
tiff:endian=msb|lsb |
tiff:exif-properties=false | Menonaktifkan pembacaan properti EXIF.
tiff:fill-order=msb|lsb |
tiff:peg-tables-mode=0-3 | Mengatur TIFFTAG_JPEGTABLESMODE saat file tiff ditulis dengan kompresi jpeg
tiff:gps-properties=false | Menonaktifkan pembacaan properti GPS.
tiff:ignore-layers=true | Mengabaikan layer Photoshop.
tiff:ignore-tags=comma-separate-list-of-tag-IDs | Mengizinkan satu atau beberapa nilai tag ID diabaikan.
tiff:predictor=[1, 2 or 3] | Operator matematis yang diterapkan pada data gambar sebelum skema pengodean diterapkan. Gagasan umumnya adalah piksel-piksel berurutan pada suatu gambar saling menyerupai. Karena itu, mengurangkan informasi dari suatu piksel yang sudah terkandung pada piksel sebelumnya cenderung mengurangi densitas informasinya secara signifikan dan membantu kompresi selanjutnya. 1 = Tidak ada skema prediksi yang digunakan sebelum pengodean. 2 = Differencing horizontal. 3 = Differencing horizontal floating point.
tiff:preserve-compression=true | Mempertahankan kompresi gambar sumber.
tiff:rows-per-strip=value | Mengatur jumlah baris per strip.
tiff:tile-geometry=WxH | Mengatur ukuran tile untuk tiff piramida. Memerlukan sufiks PTIF: sebelum nama output.
uhdr:gainmap-gamma=value | Mengatur gamma encoding gambar gainmap. Harus lebih besar dari 0.0. Digunakan selama encoding. Opsional. Nilai defaultnya adalah 1.0.
uhdr:gainmap-quality=value | Mengatur faktor kualitas encoding gambar gainmap. Rentang yang valid adalah 1 hingga 100, dengan 1 menandakan kualitas gambar terendah atau kompresi tertinggi, dan 100 menandakan kualitas terbaik atau kompresi paling tidak efektif. Digunakan selama encoding. Opsional. Nilai defaultnya adalah 95.
uhdr:gainmap-max-content-boost=value | Menentukan rasio maksimum yang diizinkan dari luminansi linear rendisi HDR target relatif terhadap (dibagi dengan) luminansi gambar SDR, pada suatu piksel tertentu. Dengan kata lain, ini menentukan seberapa terang suatu piksel dapat menjadi, ketika ditampilkan pada layar HDR, relatif terhadap rendisi SDR. Harus lebih besar dari 0.0. Digunakan selama encoding. Opsional. Jika tidak dikonfigurasi, nilai ini dihitung secara dinamis berdasarkan input.
uhdr:gainmap-min-content-boost=value | Menentukan rasio minimum yang diizinkan dari luminansi linear rendisi HDR target relatif terhadap (dibagi dengan) luminansi gambar SDR, pada suatu piksel tertentu. Dengan kata lain, ini menentukan seberapa gelap suatu piksel dapat menjadi, ketika ditampilkan pada layar HDR, relatif terhadap rendisi SDR. Harus lebih besar dari 0.0. Digunakan selama encoding. Opsional. Jika tidak dikonfigurasi, nilai ini dihitung secara dinamis berdasarkan input.
uhdr:hdr-color-gamut={bt709|display_p3|bt2100} | Mengatur gamut warna intent HDR input. Digunakan selama encoding. Wajib.
uhdr:hdr-color-transfer={hlg|pq|linear} | Mengatur color transfer intent HDR input. Digunakan selama encoding. Wajib.
uhdr:output-color-transfer={hlg|pq|linear|srgb} | Mengatur karakteristik transfer layar target tempat gambar ultrahdr dirender. Digunakan selama decoding. Wajib. Jika srgb, hanya intent sdr yang di-decode dan dikirim sebagai output; jika tidak, intent sdr dan gainmap di-decode, digabungkan menjadi gambar hdr, dan dikirim sebagai output.
uhdr:sdr-color-gamut={bt709|display_p3|bt2100} | Mengatur gamut warna intent SDR input. Digunakan selama encoding. Wajib.
uhdr:uhdr:target-display-peak-brightness=value | Peak brightness mengacu pada level kecerahan maksimum yang dapat dicapai suatu layar. Ini penting untuk merepresentasikan highlight terang secara akurat pada konten HDR.
video:intermediate-format={pam,webp} | Mengatur opsi format perantara video pada ffmpeg.
video:pixel-format=value | Mengatur opsi format piksel pada ffmpeg.
video:vsync=value | Mengatur opsi vsync pada ffmpeg.
FORMAT PSEUDO-GAMBAR
caption:max-pointsize=pointsize | Membatasi ukuran poin (point size) maksimum
caption:split=boolean | memecah teks jika diperlukan agar caption pas pada kanvas
gradient:angle=angle (in degrees) | Untuk gradien linear, ini menentukan arah gradien dari color1 ke color2 secara positif searah jarum jam relatif terhadap utara (atas). Untuk gradien radial, ini menentukan rotasi gradien secara positif searah jarum jam dari orientasi X-Y normalnya. Didukung di Imagemagick 6.9.2-5.
gradient:bounding-box=WxH+X+Y | Membatasi gradien ke region yang lebih besar atau lebih kecil daripada dimensi gambar. Jika region yang didefinisikan oleh bounding box lebih kecil dari gambar, maka color1 akan menjadi warna latar belakang. Didukung di Imagemagick 6.9.2-5.
gradient:center=x,y | Menentukan koordinat titik pusat untuk gradien radial. Defaultnya adalah pusat gambar. Didukung di Imagemagick 6.9.2-5.
gradient:direction=value | Menentukan arah gradien linear menuju atas/bawah/kiri/kanan atau sudut diagonal. Pilihannya adalah: NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast. Didukung di Imagemagick 6.9.2-5.
gradient:extent=value | Menentukan bentuk gradien radial yang berpusat pada gambar. Pilihannya adalah: Circle, Diagonal, Ellipse, Maximum, Minimum. Circle dan Maximum menggambar gradien radial melingkar, bahkan untuk gambar berbentuk persegi panjang, dengan radius sama dengan nilai yang lebih besar antara setengah lebar dan setengah tinggi gambar. Opsi Circle dan Maximum keduanya setara dengan gradien radial default. Opsi Minimum menggambar gradien radial melingkar, bahkan untuk gambar berbentuk persegi panjang, dengan radius sama dengan nilai yang lebih kecil antara setengah lebar dan setengah tinggi gambar. Opsi Diagonal menggambar gradien radial melingkar, bahkan untuk gambar berbentuk persegi panjang, dengan radius sama dengan setengah diagonal gambar. Opsi Ellipse menggambar gradien radial elips untuk gambar berbentuk persegi panjang dengan radius sama dengan setengah lebar dan setengah tinggi gambar. Didukung di Imagemagick 6.9.2-5.
gradient:radii=x,y | Menentukan radius x dan y gradien. Jika radius x dan radius y sama, bentuk gradien radial akan berupa lingkaran. Jika berbeda, bentuknya akan berupa elips. Nilai defaultnya adalah nilai maksimum antara setengah lebar dan setengah tinggi gambar. Didukung di Imagemagick 6.9.2-5.
gradient:vector=x1,y1,x2,y2 | Menentukan arah gradien linear dari vector1 (x1,y1) ke vector2 (x2,y2). Color1 (fromColor) akan berada pada posisi vektor x1,y1 dan color2 (toColor) akan berada pada posisi vektor x2,y2. Didukung di Imagemagick 6.9.2-5.
histogram:unique-colors=false | Menekan pencantuman teks warna unik gambar.
pango:align=left|center|right |
pango:auto-dir=true|false |
pango:ellipsize=start|middle|end |
pango:gravity-hint=natural|strong|line |
pango:hinting=none|auto|full |
pango:indent=points |
pango:justify=true|false |
pango:language=en_US|others |
pango:markup=true|false |
pango:single-paragraph=true|false |
pango:wrap=word|char|word-char |
pixel:compliance=value | Mengatur format output "pixel:" sesuai beberapa standar. Pilihannya adalah SVG, None, Undefined, MVG, X11, XPM. Secara default nilai warna (s)RGB dicantumkan dalam bentuk (s)rgb(r,g,b) atau (s)rgba(r,g,b,a). Nama warna tidak lagi ditampilkan. Untuk warna sRGB atau RGB, opsi SVG, X11, XPM, dan None mencantumkan nama warna, jika ada. Opsi MVG dan Undefined mencantumkan nilai heksadesimal. Ketika warna disajikan atau dikonversi ke ruang warna berbasis hue, nilai yang dicantumkan akan berupa integer untuk hue dan persen untuk dua komponen lainnya. Untuk ruang warna lain, nilai dapat dicantumkan sebagai persen atau nilai pecahan. Mengatur depth ke 8 akan membatasi nilai ke rentang 8-bit, kecuali untuk warna berbasis hue.
txt:compliance=value | Mengatur format "txt:" untuk nilai dalam tanda kurung sesuai beberapa standar. Pilihannya adalah svg, none, undefined, mvg, x11, xpm. Secara default nilai warna (s)RGB dicantumkan dalam rentang quantum. Opsi SVG, X11, XPM, MVG, dan None mencantumkan nilai dalam rentang 8-bit untuk semua kompilasi Q-level. Opsi undefined juga mencantumkan nilai dalam rentang quantum. Ketika warna disajikan atau dikonversi ke ruang warna berbasis hue, nilai yang dicantumkan akan berupa integer untuk hue dan persen untuk dua komponen lainnya. Untuk ruang warna lain, nilai dapat dicantumkan sebagai persen atau nilai pecahan. Mengatur depth ke 8 akan membatasi nilai ke rentang 8-bit, kecuali untuk warna berbasis hue.
webp:tag=value | WebP memiliki banyak sekali define yang dijelaskan secara rinci pada halaman ini.
xmp:validate={true,false} | Secara default, ImageMagick memvalidasi profil XMP mana pun yang tersemat dalam gambar.