Gradien gambar menciptakan perpaduan bertahap antara dua warna yang berbentuk linier, melingkar, atau elips.
Untuk gradien linier, operatornya adalah salah satu dari berikut:
gradient:
gradient:_fromColor_
gradient:_fromColor_ -_toColor_
Secara default, fromcolor adalah putih dan toColor adalah hitam kecuali ditimpa, misalnya gradient:gray menghasilkan gradien dari abu-abu ke hitam.
Untuk gradien radial, operatornya adalah salah satu dari berikut (Catatan penerjemah: naskah asli tertulis "The for a radial gradient", seharusnya "For a radial gradient"):
radial-gradient:
radial-gradient:_fromColor_ -_toColor_
Secara default, gradien linier menempatkan fromColor di bagian atas gambar dan toColor di bagian bawah gambar. Demikian pula, secara default, gradien radial menempatkan fromColor di tengah gambar dan toColor di batas gambar.
Warna gradien dapat berupa warna valid apa pun yang didefinisikan sesuai https://imagemagick.org/color/. Warna bernama black/white/grayXX dan gray(XX[%]) merupakan abu-abu non-linier. Pada sistem Linux, apit warna rgb(a) dan heksadesimal dengan tanda kutip. Gunakan tanda kutip ganda jika menggunakan variabel untuk nilai-nilainya.
Berikut contoh gradien linier (bukan radial):
magick -size 256x256 gradient: linear_gradient.png
magick -size 256x256 gradient:white-black linear_gradient.png

Jika Anda ingin gradien radial, coba:
magick -size 256x256 radial-gradient: radial_gradient.png
magick -size 256x256 radial-gradient:white-black radial_gradient.png

Jika Anda ingin gradien grayscale non-linier, tambahkan -colorspace RGB -colorspace gray sebelum menyimpan output. Contohnya:
magick -size 256x256 gradient: linear_gradient.png
magick -size 256x256 gradient:white-black -colorspace RGB -colorspace gray linear_linear_gradient.png
magick -size 256x256 radial-gradient: radial_gradient.png
magick -size 256x256 radial-gradient:white-black -colorspace RGB -colorspace gray linea_radial_gradient.png
Gradien dipengaruhi oleh define berikut:
| -define gradient:vector=x1,y1, x2,y2 | Menentukan arah gradien linier dari vector1 (x1,y1) ke vector2 (x2,y2). fromColor berada pada posisi vektor x1,y1 dan toColor berada pada posisi vektor x2,y2. |
|---|---|
| -define gradient:center=x,y | Menentukan koordinat titik pusat untuk gradien radial. Nilai default adalah pusat gambar. |
| -define 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 default adalah nilai maksimum antara setengah lebar dan setengah tinggi gambar. |
| -define gradient:angle=angle in degrees | Untuk gradien linier, ini menentukan arah gradien dari fromColor ke toColor searah jarum jam (positif) relatif terhadap utara (atas). Untuk gradien radial, ini menentukan rotasi gradien searah jarum jam (positif) dari orientasi X-Y normalnya. |
| -define gradient:bounding-box=widthxheight+x+y | Membatasi gradien ke wilayah yang lebih besar atau lebih kecil daripada dimensi gambar. Jika wilayah yang ditentukan oleh kotak pembatas lebih kecil daripada gambar, fromColor menjadi warna latar belakang. |
Kami juga mendukung dua define praktis untuk mengatur arah gradien linier dan bentuk gradien radial.
| -define gradient:direction={NorthWest, North, Northeast, West, East, SouthWest, South, SouthEast} | Menentukan arah gradien linier ke arah atas/bawah/kiri/kanan atau sudut diagonal. |
|---|---|
| -define gradient:extent={Circle, Diagonal, Ellipse, Maximum, Minimum} | Menentukan bentuk gradien radial yang berpusat pada gambar. 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. |
Contoh
Gradien linier default juga dapat dihasilkan dengan salah satu cara berikut (atau dengan membalik arah serta menukar fromColor dan toColor):
magick -size 256x128 -define gradient:direction=north gradient:black-white linear_gradient_default.png
magick -size 256x128 -define gradient:angle=0 gradient:black-white linear_gradient_default.png

Padanan dari
magick -size 128x256 gradient: -rotate 90 linear_gradient_east.png
dapat dihasilkan dengan salah satu cara berikut (atau dengan membalik arah serta menukar fromColor dan toColor):
magick -size 256x128 -define gradient:direction=east gradient:black-white linear_gradient_east.png
magick -size 256x128 -define gradient:angle=90 gradient:black-white linear_gradient_east.png

Berikut adalah contoh gradien radial dari hitam di tengah ke putih di batas, untuk kasus "maximum/circle/default", "minimum", "diagonal", "ellipse", dan elips yang dirotasi 45 derajat, secara berurutan.
magick -size 256x128 radial-gradient:black-white radial_gradient_maximum.png
magick -size 256x128 -define gradient:radii=128,128 radial-gradient:black-white radial_gradient_maximum.png

magick -size 256x128 -define gradient:extent=minimum radial-gradient:black-white radial_gradient_minimum.png
magick -size 256x128 -define gradient:radii=64,64 radial-gradient:black-white radial_gradient_minimum.png

magick -size 256x128 -define gradient:extent=diagonal radial-gradient:black-white radial_gradient_diagonal.png

magick -size 256x128 -define gradient:extent=ellipse radial-gradient:black-white radial_gradient_ellipse.png
magick -size 256x128 -define gradient:radii=128,64 radial-gradient:black-white radial_gradient_ellipse.png

magick -size 256x256 -define gradient:radii=128,64 -define gradient:angle=45 radial-gradient:black-white radial_gradient_ellipse_angle45.png
