Operasi yang didukung

Bagian ini mencantumkan operasi yang didukung oleh pengoptimalan gambar Cloud CDN. Tabel ini mencakup parameter, seperti operasi, sintaksis, atribut, deskripsi, dan contoh, yang membantu Anda membuat kueri imop.

Pengoptimalan gambar Cloud CDN mendukung serangkaian operasi yang memungkinkan Anda mengubah gambar, seperti mengubah ukuran, memangkas, dan menskalakan. Setiap operasi memiliki sintaksis, atribut, dan batasan yang didukung.

Halaman ini mencantumkan operasi yang didukung oleh pengoptimalan gambar Cloud CDN dengan contoh yang membantu Anda membuat kueri imop.

Operasi Sintaksis dan contoh Atribut Deskripsi

Resize

?imop=Resize,width=<resized_width>,height=<resized_height>

https://www.example.com/image.jpg?imop=Resize,width=250,height=125
  • Jenis width: Integer (Rentang: 1–8192)
  • Jenis height: Integer (Rentang: 1–8192)

maksimum width * height tidak boleh melebihi 67 mpx (67.108.864 piksel).

  • Jenis penskalaan (opsional): enum, nilai: proporsional, peregangan.
    		•

    Operasi ini tidak mempertahankan rasio aspek saat Anda menentukan parameter lebar dan tinggi. Jika Anda menghilangkan salah satu dimensi, pengoptimalan gambar Cloud CDN akan menghitung dimensi lainnya untuk mempertahankan rasio aspek.

    Secara default, pengoptimalan gambar menerapkan strategi penurunan skala yang ketat. Menentukan parameter scaling=stretch akan mengaktifkan peningkatan skala, tetapi sistem tidak mengizinkan hal ini jika Anda menentukan satu parameter ukuran.

    Scale

    ?imop=Scale,ratio=<scale_ratio>

    https://www.example.com/image.jpg?imop=Scale,ratio=0.5

    		 ratio
    • Jenis: Float (terbatas hingga 2 digit desimal)
    • Batasan: 0 < value

    Operasi ini menskalakan gambar dengan faktor tertentu dan hanya menerapkan penurunan skala. Tidak dapat muncul bersamaan dengan operasi Resize dan Crop.

    Jika Anda menyertakan operasi Scale dengan operasi Resize atau Crop dalam satu permintaan, sistem akan menampilkan error.

    Crop

    ?imop=Crop,shape=<shape>,left=<left>,right=<right>,top=<top&lgt;,bottom=<bottom>,snap_to_x=<snap_x>,snap_to_y=<snap_y>

    https://www.example.com/image.jpg?imop=Crop,shape=rectangle,left=0.5,snap_to_x=512

    		 shape
    • Jenis: String (rectangle, circle)
    • Default: rectangle
    • Dependensi: harus digunakan dengan parameter crop. Nilai yang tidak valid akan menampilkan HTTP 400.
    left, right, top, bottom
    • Jenis: Float
    • Rentang: 0,0 hingga 1,0, maks. 3 tempat desimal
    • Default: 0.0, 1.0, 0.0, 1.0
    snap_to_x, snap_to_y
    • Jenis: Integer
    • Rentang: 0 atau lebih besar
    • Default: 0
    • Batasan: wajib menyertakan setidaknya salah satu dari: left, right, top, bottom.

    Operasi ini memangkas gambar berdasarkan penanda regional. Jika Anda menentukan nilai yang tidak valid untuk parameter shape, sistem akan menampilkan HTTP 400 Bad Request.

    Koordinat pangkas otomatis dipaskan ke kelipatan terdekat dari nilai snap_to_x atau snap_to_y yang ditentukan.

    Canvas

    ?imop=Canvas,width=<canvas_width>,height=<canva_height>,background_color=<color>,gravity=<gravity>

    https://www.example.com/image.jpg?imop=Canvas,width=250,height=125,background_color=FFF,gravity=center

    		 width, height
    • Jenis: Integer
    • Rentang: 1–8192
    • Lebar x tinggi maksimum tidak boleh melebihi 67.108.864 piksel.
    gravity
    • Jenis: String
    • Nilai: center, left, right, top, bottom, top_left, top_right, bottom_left, bottom_right
    • Default: center
    background_color
    • Jenis: String
    • Format: Kode hex 3 digit, 4 digit, atau 6 digit
    • Default: 000000 (hitam).

    Operasi ini meningkatkan kualitas gambar dengan menambahkan tata letak latar belakang dengan dimensi dan warna yang ditentukan. Parameter gravity menentukan penempatan gambar dalam pada kanvas latar belakang ini.

    Rotate

    ?imop=Rotate,degrees=<rotate_degrees>

    https://www.example.com/image.jpg?imop=Rotate,degrees=90

    		 degrees
    • Jenis: Integer
    • Nilai yang diizinkan: 90, 180, 270.

    Operasi ini memutar gambar target searah jarum jam.

    Mirror

    ?imop=Mirror,flip=<flip>

    https://www.example.com/image.jpg?imop=Mirror,flip=h

    		 flip
    • Jenis: String
    • Nilai yang diizinkan: h (horizontal), v (vertikal), hv (horizontal &vertikal).

    Operasi ini mencerminkan gambar secara horizontal, vertikal, atau keduanya.

    Compress

    ?imop=Compress,strength=<value>

    https://www.example.com/image.jpg?imop=Compress,strength=medium

    		 strength
    • Jenis: String
    • Nilai yang diizinkan: very_weak, weak, medium, strong, very_strong.
    • Batasan: hanya didukung untuk jpeg, avif, dan webp. Nilai di luar rentang ini akan menampilkan HTTP 400.

    Operasi ini mengompresi gambar dengan mengurangi kualitas gambar target. Parameter strength memungkinkan Anda mengontrol tingkat kompresi gambar aktif.

    Convert

    ?imop=Convert,format=<format>

    https://www.example.com/image.jpg?imop=Convert,format=webp

    		 format
    • Jenis: String.
    • Nilai yang diizinkan: jpeg, png, webp, avif, gif
    • Batasan: Nilai lain yang tidak tercantum akan menyebabkan error pemrosesan.

    Operasi ini mengubah format penayangan akhir gambar. Jika ada konflik pemrosesan dengan spesifikasi header ACCEPT masuk browser, sistem akan menampilkan error HTTP 406 Not Acceptable.

    Metadata

    ?imop=Metadata,preserve=<preserve>

    https://www.example.com/image.jpg?imop=Metadata,preserve=none

    		 preserve
    • Jenis: String
    • Nilai yang diizinkan: none, copyright, max
    • Default: copyright

    Operasi ini mengontrol cara properti metadata gambar ditangani selama eksekusi:

    none: Menghapus semua properti metadata.

    max: mempertahankan semua kolom kecuali orientasi EXIF dan profil warna yang diterapkan pada transformasi

    .

    copyright: hanya menyimpan kolom Author, Copyright, dan Caption.

    Tone

    ?imop=tone,brightness=<brightness>,contrast=<contrast_level>, saturation=<saturation>

    https://www.example.com/image.jpg?imop=tone,brightness=50,contrast=50,saturation=50
    • brightness
      • Jenis: Integer
      • Rentang: -100 hingga 100
    • contrast
      • Jenis: Integer
      • Rentang: -100 hingga 100
    • saturation
      • Jenis: Integer
      • Rentang: -100 hingga 100

    Operasi ini mengubah tingkat brightness, contrast, dan saturation gambar secara dinamis. Jika Anda menghilangkan parameter tertentu atau menetapkannya ke 0, sistem tidak akan mengubah atribut tersebut. Menetapkan saturasi ke -100 akan memaksa konversi skala abu-abu.

    Sharpen

    ?imop=Sharpen,strength=<sharpness>

    https://www.example.com/image.jpg?imop=Sharpen,strength=50

    		 strength
    • Jenis: Integer
    • Rentang: 0 hingga 100

    Operasi ini meningkatkan ketajaman gambar.

    Blur

    ?imop=Blur,strength=<blur_size>

    https://www.example.com/image.jpg?imop=Blur,strength=50

    		 strength
    • Jenis: Integer
    • Rentang: 0 hingga 100

    Operasi ini menerapkan filter blur lokal di seluruh gambar.

    Freeze

    ?imop=freeze,frame=<frame>

    https://www.example.com/image.gif?imop=freeze,frame=0

    		 frame
    • Jenis: Integer
    • Rentang: 0 hingga 100.

    Operasi ini mengekstrak satu frame statis dari urutan gambar animasi , seperti GIF animasi. Parameter frame menentukan indeks frame yang tepat untuk diekstrak.

    Langkah berikutnya