menambahkan watermark teks dan watermark gambar ke gambar - Edge Security Acceleration

Anda dapat menambahkan watermark ke gambar untuk promosi merek dan publisitas. Ini membantu melindungi hak cipta gambar serta mencegah penggunaan tanpa izin. Edge Security Acceleration (ESA) memungkinkan Anda menambahkan watermark teks atau gambar pada bagian tertentu dari gambar, serta menyesuaikan transparansi watermark agar baik watermark maupun konten gambar tetap terlihat jelas.

Parameter

image_process=watermark

Parameter Dasar (Posisi Watermark)

Parameter	Deskripsi	Rentang Nilai
t	Tingkat opasitas watermark teks atau gambar.	`[0,100]` Nilai default: `100`. Nilai 100 berarti watermark tidak transparan.
g	Posisi watermark pada gambar.	nw: kiri atas north: tengah atas ne: kanan atas west: tengah kiri center: tengah east: tengah kanan sw: kiri bawah south: tengah bawah se: kanan bawah
x	Margin horizontal yang menentukan jarak horizontal antara watermark dan tepi gambar. Parameter ini hanya berlaku jika watermark berada di kiri atas, tengah kiri, kiri bawah, kanan atas, tengah kanan, atau kanan bawah gambar.	`[0,4096]` Nilai default: `10`. Satuan: `px`.
y	Margin vertikal yang menentukan jarak vertikal antara watermark dan tepi gambar. Parameter ini hanya berlaku jika watermark berada di kiri atas, tengah atas, kanan atas, kiri bawah, tengah bawah, atau kanan bawah gambar.	`[0,4096]` Nilai default: `10`. Satuan: `px`.

Catatan

Anda dapat menggunakan x, y, dan offset untuk menyesuaikan posisi watermark pada gambar. Parameter ini juga dapat digunakan untuk mengatur tata letak watermark ketika gambar memiliki beberapa watermark.

Parameter Watermark Gambar

Parameter

Deskripsi

Rentang nilai

image

URL watermark yang dapat diakses melalui Internet. Jika autentikasi atau izin diperlukan untuk mengakses URL yang ditentukan, ESA mungkin gagal mengambil URL watermark.

URL watermark harus dikodekan dalam Base64. Untuk informasi lebih lanjut, lihat Kodekan watermark.

String yang dikodekan dalam Base64

Parameter Watermark Teks

Parameter	Deskripsi	Rentang Nilai
text	Konten watermark teks. Konten teks harus dikodekan dalam Base64. Untuk informasi lebih lanjut, lihat Kodekan Watermark.	String yang dikodekan dalam Base64 dengan panjang maksimal 60 karakter.
type	Jenis font watermark teks. Nama font harus dikodekan dalam Base64. Untuk informasi lebih lanjut, lihat Kodekan Watermark.	Anda dapat menentukan hingga 10 jenis font. Untuk informasi tentang font dan pengkodeannya, lihat Pengaturan Type dan Pengkodean.
color	Warna watermark teks. Nilai valid untuk parameter ini adalah nilai warna RGB.	Contohnya, 000000 menentukan hitam, dan FFFFFF menentukan putih. Nilai default: `000000`.
rotate	Derajat rotasi watermark teks searah jarum jam.	`[0,360]` Nilai default: `0`. Nilai 0 berarti watermark teks tidak diputar. Satuan: °.
fill	Menentukan apakah akan mengisi gambar dasar dengan watermark teks.	Nilai valid: `0` dan `1`. Nilai default: `0`. 0: tidak mengisi gambar dasar dengan watermark teks. 1: mengisi gambar dasar dengan watermark teks.
size	Ukuran watermark teks.	`[1,1000]` Nilai default: `40`. Satuan: `px`.

Pengaturan Type dan Pengkodean

Font teks	Deskripsi	Nilai terkode
alihyaihei	Font tebal. Ini adalah font default.	YWxpaHlhaWhlaQ
hysong	Variasi font Songti.	aHlzb25n
hyhei	Variasi font Heiti.	aHloZWk
hyshuangxian	Font garis ganda.	aHlzaHVhbmd4aWFu
fzltzhk	Variasi font Heiti.	ZnpsdHpoaw
fzshengsks	Font skrip reguler.	ZnpzaGVuZ3Nrcw
fzqusongjian	Variasi font Songti.	ZnpxdXNvbmdqaWFu
zzgfxingyan	Font artistik.	enpnZnhpbmd5YW4
comfortaa	Comfortaa	Y29tZm9ydGFh
notosans	NotoSans	bm90b3NhbnM

Catatan

Jika Anda menggunakan font yang tidak termasuk dalam 10 font tersebut, font tersebut akan dikenali sebagai font default alihyaihei.

Kodekan watermark

Saat menambahkan watermark, Anda harus mengkodekan konten dan font dari teks atau URL dari watermark gambar dalam Base64 menggunakan karakter yang diizinkan dalam URL. Untuk mengkodekan watermark, ikuti langkah-langkah berikut:

Kodekan konten watermark dalam Base64.

Catatan

Kami merekomendasikan Anda menggunakan alat pengkodean Base64 yang aman untuk URL untuk mengkodekan konten dan font dari watermark teks serta URL dari watermark gambar. Konten watermark yang dikodekan dalam Base64 hanya berlaku untuk parameter spesifik watermark. Jangan sertakan konten watermark yang dikodekan dalam string tanda tangan.

Ganti karakter dalam konten watermark yang dikodekan dalam Base64 berdasarkan aturan berikut:
- Ganti tanda plus (+) dengan tanda hubung (-).
- Ganti garis miring maju (/) dengan garis bawah (_).
- Hilangkan tanda sama dengan (=) di akhir konten watermark yang dikodekan dalam Base64.

Contoh

Tambahkan watermark teks "Hello World".

Kodekan watermark teks Hello World dalam Base64 menggunakan karakter yang diizinkan dalam URL. Untuk informasi lebih lanjut, lihat Kodekan Watermark. Hasil pengkodean dari watermark teks adalah SGVsbG8gV29ybGQ. Hasil pengkodean dari font hysong adalah aHlzb25n. URL pemrosesan gambar adalah http(s)://example.com/image01.png?image_process=watermark,text_SGVsbG8gV29ybGQ,type_aHlzb25n.

Tambahkan watermark teks dan gambar.
- Kodekan watermark teks "Happy New Year" dalam Base64 menjadi string 5paw5bm05b-r5LmQ menggunakan karakter yang diizinkan dalam URL. Atur posisi watermark teks ke kanan bawah, margin horizontal ke 10 piksel, dan offset vertikal dari garis tengah ke 10 piksel menggunakan g_se,x_10,y_10.
- Kodekan URL watermark gambar http://example-test.oss-ap-southeast-1.aliyuncs.com/image/shuiyin.png dalam Base64 menjadi string aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n menggunakan karakter yang diizinkan dalam URL. Atur posisi watermark gambar ke kiri atas, margin horizontal ke 10 piksel, dan offset vertikal dari garis tengah ke 10 piksel menggunakan g_nw,x_10,y_10.
- Tentukan URL pemrosesan gambar sebagai http(s)://example.com/image01.png?image_process=watermark,text_5paw5bm05b-r5LmQ,g_se,x_10,y_10/watermark,image_aHR0cDovL2V4YW1wbGUtdGVzdC5vc3MtYXAtc291dGhlYXN0LTEuYWxpeXVuY3MuY29tL2ltYWdlL3NodWl5aW4ucG5n,g_nw,x_10,y_10.