Contoh penggunaan • Spesifikasi model warna • Daftar nama warna

Sejumlah opsi dan metode ImageMagick menerima warna sebagai argumen. Warna tersebut dapat diberikan sebagai nama warna (jumlahnya terbatas tetapi cukup banyak; lihat di bawah) atau sebagai sekumpulan angka (desimal atau heksadesimal), yang masing-masing berhubungan dengan satu kanal dalam model warna RGB atau RGBA. Model warna HSL, HSLA, HSB, HSBA, CMYK, atau CMYKA juga dapat ditentukan. Topik-topik ini dijelaskan secara singkat pada bagian-bagian di bawah ini.

Gunakan Color Converter untuk memasukkan spesifikasi warna ImageMagick yang valid seperti dijelaskan di bawah ini, agar Anda dapat melihat contoh warna tersebut dan mengonversinya ke semua model warna lainnya.

Contoh penggunaan

Setiap perintah berikut menghasilkan batas berwarna lime yang sama di sekeliling gambar. (Gunakan "tanda kutip ganda" untuk Windows.)

magick -bordercolor lime -border 10 image.jpg image.png
magick -bordercolor '#0f0' -border 10 image.jpg image.png
magick -bordercolor '#00ff00' -border 10 image.jpg image.png
magick -bordercolor 'rgb(0,255,0)' -border 10 image.jpg image.png
magick -bordercolor 'rgb(0,100%,0)' -border 10 image.jpg image.png

Daftar nama warna yang dikenali (misalnya aqua, black, blue, fuchsia, gray, green, lime, maroon, navy, olive, purple, red, silver, teal, white, yellow, dan lainnya) ditampilkan dalam tabel di bawah ini.

Spesifikasi model warna

Model warna sRGB, CMYK, HSL, dan HSB digunakan dalam spesifikasi warna numerik. Semua contoh berikut menentukan warna sRGB merah yang sama:

#f00                       4-bit  #rgb
#ff0000                    8-bit  #rrggbb
#ff0000ff                  8-bit  #rrggbbaa
#fff000000                12-bit  #rrrgggbbb
#ffff00000000             16-bit  #rrrrggggbbbb
#ffff00000000ffff         16-bit  #rrrrggggbbbbaaaa
#ffffffff0000000000000000ffffffff
                          32-bit  #rrrrrrrrggggggggbbbbbbbbaaaaaaaa
rgb(255, 0, 0)            bilangan bulat pada rentang 0—255 untuk setiap komponen
rgb(100.0%, 0.0%, 0.0%)   float pada rentang 0—100% untuk setiap komponen

Format nilai sRGB dalam notasi heksadesimal adalah tanda '#' yang langsung diikuti oleh 3-32 karakter heksadesimal. Notasi sRGB tiga digit (#rgb) diubah menjadi bentuk enam digit (#rrggbb) dengan menduplikasi digit, bukan dengan menambahkan nol. Misalnya, #fb0 diperluas menjadi #ffbb00. Hal ini memastikan bahwa putih (#ffffff) dapat ditentukan dengan notasi singkat (#fff) dan menghilangkan ketergantungan pada kedalaman warna gambar. Gunakan notasi heksadesimal setiap kali performa menjadi masalah. ImageMagick tidak perlu memuat tabel warna yang besar untuk menafsirkan warna heksadesimal, misalnya #000000, tetapi hal itu diperlukan jika black digunakan sebagai gantinya.

Format nilai sRGB dalam notasi fungsional adalah 'rgb(r,g,b)', dengan r, g, dan b berupa tiga nilai bilangan bulat atau float pada rentang 0—255, atau tiga nilai persentase bilangan bulat atau float pada rentang 0—100%. Nilai 255 setara dengan 100%, dan dengan #F atau #FF dalam notasi heksadesimal: rgb(255, 255, 255) = rgb(100%, 100%, 100%) = #FFF = #FFFFFF. Perlu dicatat, sejak ImageMagick 7.0.10-53, koma tidak lagi diperlukan dan garis miring dapat mendahului nilai alpha, misalnya rgb(255 128 0 / 50%).

Karakter spasi diperbolehkan di sekitar nilai numerik, setidaknya jika seluruh argumen warna diapit oleh tanda kutip ('tanda kutip tunggal' untuk sistem mirip Linux, "tanda kutip ganda" untuk Windows).

Model warna sRGB diperluas dalam spesifikasi ini untuk menyertakan alpha, sehingga transparansi suatu warna dapat ditentukan. Semua contoh berikut menentukan warna yang sama:

rgb(255, 0, 0)                 rentang 0 - 255
rgba(255, 0, 0, 1.0)           sama, dengan nilai alpha eksplisit
rgb(100%, 0%, 0%)              rentang 0.0% - 100.0%
rgba(100%, 0%, 0%, 1.0)        sama, dengan nilai alpha eksplisit

Format nilai RGBA dalam notasi fungsional adalah 'rgba(r,g,b,a)', dengan r, g, dan b seperti dijelaskan di atas untuk notasi fungsional RGB, dan nilai alpha a berkisar dari 0.0 (sepenuhnya transparan) hingga 1.0 (sepenuhnya opak).

Ada juga warna bernama 'none' yang sepenuhnya transparan. Warna ini merupakan singkatan dari rgba(0, 0, 0, 0.0).

Nilai abu-abu nonlinier dapat ditentukan dengan mudah menggunakan nama, satu nilai intensitas, atau nilai intensitas beserta nilai alpha:

gray50            mendekati abu-abu menengah
gray(127)         mendekati abu-abu menengah
gray(50%)         abu-abu menengah
graya(50%, 0.5)   abu-abu menengah semi-transparan

Untuk nilai abu-abu linier, tambahkan -colorspace RGB -colorspace Gray atau -colorspace LinearGray saat membuat warna abu-abu. Opsi yang disebutkan terakhir baru tersedia sejak Imagemagick 6.9.9-29 dan 7.0.7-17.

Model warna ImageMagick juga mendukung warna rona-saturasi-kecerahan (HSL) dan rona-saturasi-kecerlangan (HSB) sebagai pelengkap warna sRGB numerik. Warna HSL dikodekan sebagai tiga nilai (rona, saturasi, kecerahan). Begitu pula, warna HSB dikodekan sebagai tiga nilai (rona, saturasi, kecerlangan). Tiga nilai HSL atau HSB berupa nilai langsung (rona 0—360, saturasi 0—255, kecerahan atau kecerlangan 0—255) atau dengan S, L, B sebagai nilai persentase relatif terhadap rentang tersebut.

Sistem warna HSB direpresentasikan secara geometris sebagai kerucut dengan puncaknya menghadap ke bawah. Rona diukur mengelilingi keliling kerucut. Saturasi diukur dari sumbu ke arah luar. Kecerlangan diukur dari puncak ke atas.

Sistem warna HSL direpresentasikan secara geometris sebagai dua kerucut yang ditumpuk, dengan satu puncak menghadap ke bawah dan puncak lainnya menghadap ke atas. Ujung terlebar kedua kerucut ditumpuk satu di atas yang lain. Rona diukur mengelilingi keliling kerucut. Saturasi diukur dari sumbu ke arah luar. Kecerahan diukur dari puncak bawah ke atas.

Lihat http://en.wikipedia.org/wiki/HSL_and_HSV untuk detail lebih lanjut tentang sistem warna HSL dan HSB.

Rona direpresentasikan sebagai sudut warna di sekeliling keliling melingkar kerucut (yaitu pelangi yang direpresentasikan dalam bentuk lingkaran). Nilai rona berupa bilangan bulat atau float pada rentang 0—360. Menurut definisinya, red=0=360, dan warna-warna lain tersebar mengelilingi lingkaran, sehingga green=120, blue=240, dan seterusnya. Sebagai sudut, nilainya melingkar secara implisit sehingga -120=240 dan 480=120, misalnya. (Mahasiswa trigonometri akan mengatakan bahwa "sudut koterminal adalah ekuivalen" di sini; sudut θ dapat distandarkan dengan menghitung sudut ekuivalennya, yaitu θ mod 360.)

Saturasi diukur ke arah luar dari sumbu pusat kerucut menuju keliling kerucut. Saturasi dapat dinyatakan sebagai bilangan bulat atau float pada rentang 0—255, atau sebagai persentase bilangan bulat atau float pada rentang 0—100. Saturasi dapat dipahami sebagai ketiadaan warna "putih" yang bercampur dengan warna dasar. Dengan demikian, 255 atau 100% adalah saturasi penuh dan berhubungan dengan titik pada permukaan luar kerucut (HSB) atau kerucut ganda (HSL). Itu akan menjadi wilayah yang paling "berwarna". 0 atau 0% berarti tidak ada saturasi, yang menghasilkan sejenis corak abu-abu. Hal ini terjadi di sepanjang sumbu pusat kerucut atau kerucut ganda, dengan hitam di puncak bawah dan putih di bagian atas.

Kecerlangan (Brightness) dan kecerahan (Lightness) juga dapat direpresentasikan sebagai bilangan bulat atau float pada rentang 0—255, atau sebagai persentase bilangan bulat atau float pada rentang 0—100%. Kecerlangan dan kecerahan diukur dari puncak bawah ke atas hingga bagian atas kerucut atau kerucut ganda, di sepanjang sumbu pusat kerucut. 0 atau 0% berhubungan dengan puncak bawah, dan 255 atau 100% berhubungan dengan bagian atas tengah kerucut untuk kecerlangan, dan dengan puncak atas kerucut ganda untuk kecerahan.

Sistem warna HSB sedikit lebih mudah dipahami dibandingkan sistem warna HSL. Dalam sistem warna HSB, hitam berada di puncak bawah dan putih berada di bagian atas tengah kerucut pada sumbu pusat. Warna yang paling berwarna atau paling jenuh kemudian akan berada di tepi luar bagian atas kerucut, pada bagian yang paling lebar. Dengan demikian, pada Saturasi=100% dan Kecerlangan=100%

hsb(0,   100%,  100%)    or    hsb(0,   255,   255)       merah penuh
hsb(120, 100%,  100%)    or    hsb(120, 255,   255)       hijau penuh
hsb(120, 100%,  75%)     or    hsb(120, 255,   191.25)    hijau sedang
hsb(120, 100%,  50%)     or    hsb(120, 255,   127.5)     hijau gelap
hsb(120, 100%,  25%)     or    hsb(120, 255,   63.75)     hijau sangat gelap
hsb(120, 50%,   50%)     or    hsb(120, 127.5, 127.5)     hijau pastel

Dalam sistem warna HSL, hitam berada di puncak bawah dan putih berada di puncak atas. Namun, saturasi paling besar berada di tengah kerucut ganda pada keliling luarnya, sehingga pada nilai kecerahan 50%. Warna yang paling berwarna atau paling jenuh kemudian akan berada di tepi luar kerucut ganda, pada bagian yang paling lebar. Dengan demikian, pada Saturasi=100% dan Kecerlangan=50%

hsl(0,   100%,  50%)     or    hsl(0,   255,   127.5)     merah penuh
hsl(120, 100%,  100%)    or    hsl(120, 255,   255)       putih
hsl(120, 100%,  75%)     or    hsl(120, 255,   191.25)    hijau pastel
hsl(120, 100%,  50%)     or    hsl(120, 255,   127.5)     hijau penuh
hsl(120, 100%,  25%)     or    hsl(120, 255,   63.75)     hijau gelap
hsl(120, 50%,   50%)     or    hsl(120, 127.5, 127.5)     hijau sedang

Salah satu keunggulan HSB atau HSL dibandingkan RGB adalah sifatnya yang lebih intuitif: Anda dapat menebak warna yang diinginkan, lalu menyesuaikannya. Membuat kumpulan warna yang serasi juga menjadi lebih mudah (misalnya dengan menjaga rona tetap sama sambil mengubah kecerlangan atau kecerahan dan saturasi).

Sebagaimana notasi fungsional 'rgb()' memiliki padanan alpha 'rgba()', notasi fungsional 'hsl()' dan 'hsb()' memiliki padanan alpha 'hsla()' dan 'hsba()'. Contoh-contoh berikut menentukan warna yang sama:

hsb(120, 100%,  100%)              hijau penuh dalam hsb
hsba(120, 100%,  100%,  1.0)       sama, dengan nilai alpha 1.0
hsb(120, 255,  255)                hijau penuh dalam hsb
hsba(120, 255,  255,  1.0)         sama, dengan nilai alpha 1.0

hsl(120, 100%,  50%)               hijau penuh dalam hsl
hsla(120, 100%,  50%,  1.0)        sama, dengan nilai alpha 1.0
hsl(120, 255,  127.5)              hijau penuh dalam hsl
hsla(120, 255,  127.5,  1.0)       sama, dengan nilai alpha 1.0

Untuk ImageMagick antara versi 6.5.6-6 dan 6.9.2-0, HSL (HSB) hanya dapat ditentukan dengan Rona sebagai persen pada rentang 0—100%, ketika Saturasi dan Kecerahan (Kecerlangan) juga ditentukan sebagai persen pada rentang 0—100%.

Tentukan warna Lab seperti berikut:

cielab(62.253188, 23.950124, 48.410653)

Perlu dicatat, komponen a dan b dari warna Lab mana pun yang Anda tentukan diberi bias secara internal sebesar 50% untuk memastikannya sesuai dengan rentang kuantum (biasanya 0 hingga 65535). Bias ini dipertahankan saat menulis ke format gambar TIFF dan MIFF. Namun, format TXT mendukung nilai piksel negatif sehingga bias tersebut dihilangkan saat menulis ke format ini:

$ magick xc:cyan -colorspace LAB txt:
# ImageMagick pixel enumeration: 1,1,65535,cielab
0,0: (59711,20409.5,-3632.9)  #E93F4FBA71CF  cielab(91.1132,-48.0855,-14.1358)

$ magick -size 100x100 xc:"cielab(91.1132,-48.0855,-14.1358)" -colorspace sRGB cyan.png

Atau tentukan warna secara generik dengan kata kunci icc-color, misalnya:

icc-color(cmyk, 0.11, 0.48, 0.83, 0.00)  cymk
icc-color(rgb, 1, 0, 0)                  rgb linier
icc-color(rgb, red)                      rgb linier
icc-color(lineargray, 0.5)               abu-abu linier
icc-color(srgb, 1, 0, 0)                 rgb nonlinier
icc-color(srgb, red)                     rgb nonlinier
icc-color(gray, 0.5)                     abu-abu nonlinier

Atau tentukan warna perangkat yang belum dikalibrasi dengan kata kunci device-, misalnya:

device-gray(0.5)
device-rgb(0.5, 1.0, 0.0)
device-cmyk(0.11, 0.48, 0.83, 0.00)

ImageMagick juga mendukung warna gamut lebar seperti Lab, LCH, dan Display-P3.

Daftar nama warna

Tabel di bawah ini menyediakan daftar warna bernama yang dikenali oleh ImageMagick: