aktifkan transformasi citra

Edge Security Acceleration (ESA) menyediakan fitur transformasi citra. Anda dapat menggunakan fitur ini untuk mengubah format dan kualitas citra dari origin server, serta memotong, mengubah ukuran, dan menyimpannya dalam cache. Proses ini mempercepat pengambilan citra dan mengurangi lalu lintas ke origin.

Batasan

Batasan berikut berlaku untuk fitur pengeditan citra.

Batasan citra sumber:

Format yang didukung: JPEG, JPG, PNG, WebP, BMP, GIF, TIFF, dan JPEG 2000.
Ukuran citra sumber tidak boleh melebihi 10 MB.
Lebar × tinggi citra sumber tidak boleh melebihi 16.777.216 piksel.
Catatan
Jika citra dalam format GIF, lebar × tingginya adalah jumlah total semua framenya. Anda dapat menggunakan tool seperti ImageMagick untuk melihat informasi frame citra GIF tersebut.

Batasan untuk citra yang telah diproses:

Jumlah total piksel dalam citra (lebar × tinggi) tidak boleh melebihi 16.777.216.
Saat mengubah citra ke format WebP, jumlah total pikselnya (lebar × tinggi) tidak boleh melebihi 16.777.216, dan baik lebar maupun tinggi citra tidak boleh melebihi 16.384 piksel. Jika citra sumber merupakan citra animasi, citra tersebut akan diubah menjadi citra statis saat ditransformasi ke format WebP.

Batasan prefetch cache:

Fitur transformasi citra tidak berlaku untuk konten yang diprefetch. Saat titik kehadiran (POP) ESA melakukan prefetch konten, hanya file citra asli yang diambil dari origin tanpa transformasi citra.

Di Konsol ESA, buka Websites. Pada kolom Website, klik situs target.
Di panel navigasi sebelah kiri, pilih Speed and Network > Optimize.
Buka tab Speed Optimization dan aktifkan sakelar Image Transformations. Anda kemudian dapat menambahkan parameter pengeditan citra ke URL permintaan untuk menjalankan berbagai operasi pengeditan citra.
Sebagai contoh, dalam JavaScript, Anda dapat menulis metode pemrosesan URL untuk mengubah citra ke format lain.
```
function updateImageUrl(format) {
  let baseUrl = "https://example.com/image_01";
  let newUrl = `${baseUrl}.png?image_process=format,${format}`;
  document.getElementById('imageElement').src = newUrl;
}

// Contoh: Ubah citra ke format BMP.
updateImageUrl("bmp");

// Untuk mengubah citra ke format lain, seperti JPG:
// updateImageUrl("jpg");
```
Dalam kode tersebut, image_process=format,${format} adalah konfigurasi parameter pengeditan citra. Untuk informasi selengkapnya mengenai parameter yang didukung beserta rentang nilainya, lihat Metode pengeditan citra yang didukung.

Verifikasi hasil

Permintaan asli

Meminta example.com/bb.jpeg mengembalikan resource citra dalam format .jpeg dengan orientasi normal.

Permintaan yang ditransformasi

Transformasi format: Misalnya, untuk mengubah citra .jpeg ke format .png, ubah URL permintaan menjadi example.com/bb.jpeg?image_process=format,png. Responsnya adalah citra dalam format .png.
Rotasi citra: Misalnya, untuk memutar citra 90 derajat searah jarum jam, ubah URL permintaan menjadi example.com/bb.jpeg?image_process=rotate,90. Responsnya adalah citra yang telah diputar 90 derajat searah jarum jam.

Metode pengeditan citra yang didukung

ESA mendukung satu atau beberapa parameter transformasi untuk mengedit citra. Tabel berikut menjelaskan parameter yang didukung.

Metode pengeditan citra	Parameter	Deskripsi
Transformasi format	format	Mengubah format citra.
Transformasi kualitas	quality	Menyesuaikan kualitas citra.
Pemotongan citra	crop	Memotong citra sesuai ukuran yang ditentukan.
Penskalaan citra	resize	Mengubah ukuran citra sesuai ukuran yang ditentukan. Anda hanya dapat mengecilkan citra. Pembesaran tidak didukung.
Rotasi citra	Rotasi otomatis: auto-orient Rotasi tertentu: rotate	Memutar citra secara otomatis berdasarkan parameter orientasinya atau memutarnya searah jarum jam dengan sudut tertentu.
Warna citra	Kecerahan: bright Kontras: contrast Ketajaman: sharpen	Menyesuaikan kecerahan, kontras, dan ketajaman citra.
Tambahkan watermark	watermark	Menambahkan watermark berupa citra atau teks ke dalam citra.
Dapatkan informasi	info	Mendapatkan informasi citra, seperti panjang, lebar, tinggi, format, dan kualitasnya.