Edge Security Acceleration：Gunakan Fungsi Edge untuk transformasi gambar

Parameter

Berikut adalah daftar parameter pemrosesan gambar yang didukung oleh Fungsi Edge:

• format: Mengonversi format gambar.

• quality: Mengubah kualitas gambar.

• crop: Memotong gambar dengan ukuran tertentu.

• resize: Mengubah ukuran gambar.

• rotate: Memutar gambar berdasarkan parameter orientasi atau searah jarum jam sesuai sudut yang ditentukan.

• colorGrading: Menyesuaikan kecerahan, kontras, dan ketajaman gambar.

• waterMark: Menambahkan watermark gambar atau teks ke gambar.

• info: Meminta informasi gambar, termasuk lebar, tinggi, format, dan kualitas.

Penggunaan

Format pemrosesan gambar adalah sebagai berikut:

• image: menunjukkan bahwa sumber daya gambar yang diambil perlu dikonversi. Ini adalah Array. Anda dapat mengonfigurasi beberapa tindakan pemrosesan.

• action: Tindakan spesifik yang akan dilakukan.

• option: Parameter yang diperlukan untuk tindakan.

  • mode: Beberapa action memiliki mode yang berbeda. Bidang ini menunjukkan mode mana yang diperlukan.

  • param: Parameter pemrosesan yang harus ditentukan.

return fetch(imageUrl, {
  image: [
    {
      action: "xxx",
      option: {
        mode: "xxx",
        param: {
        },
      },
    },
    {
      action: "xxx",
      option: {
        mode: "xxx",
        param: {
        },
      },
    },
  ],
});
}

Contoh

Format

Mentransformasi format gambar.

async function imageFormat() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "format",
        option: {
          param: {
            f: "png",
          },
        },
      },
    ],
  });
}

• action tidak memerlukan penentuan mode.

• param jenis yang didukung.

  • f

    • Hanya format gambar berikut yang didukung: JPEG, PNG, WebP, BMP, GIF, TIFF, dan JPEG 2000.

    • Untuk informasi lebih lanjut tentang format, lihat Konversi format gambar.

Kualitas

Mentransformasi kualitas gambar.

async function imageQuality() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "quality",
        option: {
          param: {
            Q: 5,
          },
        },
      },
    ],
  });
}

• action tidak memerlukan penentuan mode.

• param jenis yang didukung.

  • Q

    • Nilainya harus kelipatan 5 antara 0 dan 100.

    • Untuk informasi lebih lanjut, lihat Sesuaikan kualitas gambar.

  • q

    • Nilainya harus kelipatan 5 antara 0 dan 100.

    • Untuk informasi lebih lanjut, lihat Sesuaikan kualitas gambar.

Potong

Contoh 1: Potongan lingkaran

async function imageCrop() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "crop",
        option: {
          mode: "circle",
          param: {
            r: 100,
          },
        },
      },
    ],
  });
}

Contoh 2: Potongan tengah

async function imageCrop() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "crop",
        option: {
          mode: "mid",
          param: {
            w: 400,
            h: 200,
          },
        },
      },
    ],
  });
}

• action: mode mendukung param berikut. Untuk informasi lebih lanjut, lihat Potong gambar.

  • circle: Potongan lingkaran.

  • sudoku: Potongan sudoku.

  • coordinate: Pemotongan dilakukan berdasarkan koordinat X dan Y.

  • mid: Potongan tengah.

• circle

  • r atau R

    • Nilainya harus bilangan bulat yang lebih besar dari 0.

    • Deskripsi: Menentukan jari-jari garis singgung lingkaran.

• sudoku

  • g

    • Nilai valid: [nw, north, ne, west, center, east, sw, south, se]

    • Deskripsi: Sesuai dengan sembilan posisi dalam sudoku.

  • w

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan lebar pemotongan.

  • h

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan tinggi pemotongan.

• coordinate

  • x

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan koordinat x titik awal pemotongan.

  • y

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan koordinat y titik awal pemotongan.

  • w

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan lebar pemotongan.

  • h

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan tinggi pemotongan.

• mid

  • w

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan lebar pemotongan.

  • h

    • Nilai valid: 0 hingga 16777216.

    • Deskripsi: Menentukan tinggi pemotongan.

Putar

Contoh 1: Rotasi kustom

async function imageRotate() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "rotate",
        option: {
          mode: "custom",
          param: {
            a: 180,
          },
        },
      },
    ],
  });
}

Contoh 2: Rotasi otomatis

async function imageRotate() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "rotate",
        option: {
          mode: "auto",
          param: {
          },
        },
      },
    ],
  });
}

• mode mendukung param berikut. Untuk informasi lebih lanjut, lihat Rotasi gambar.

  • CUSTOM: Rotasi kustom.

  • auto: Rotasi otomatis.

• custom

  • a atau A

    • Nilai valid: 90 , 180, 270

    • Deskripsi: Menentukan sudut rotasi.

• auto: Rotasi otomatis tanpa menentukan parameter.

Ubah Ukuran

Mengubah ukuran gambar.

async function imageResize() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "resize",
        option: {
          mode: "custom",
          param: {
            p: 90,
            // s: 200,
            // l: 200,
            // w: 200,
            // h: 200,
            fw: 200,
            // fh: 200,
          },
        },
      },
    ],
  });
}

• action saat ini hanya mendukung satu mode, yang secara default ditulis sebagai custom. Parameter param berikut didukung:

• custom

  • l, s, w, h, fw, fh

    • Nilai valid: 0 hingga 16777216.

    • Untuk informasi lebih lanjut, lihat Ubah ukuran gambar.

  • p

    • Nilai valid: 0 hingga 100.

    • Untuk informasi lebih lanjut, lihat Ubah ukuran gambar.

Penyesuaian Warna

Menyesuaikan kecerahan, kontras, dan efek ketajaman gambar.

async function imageColorGrading() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "colorGrading",
        option: {
          param: {
            b: -100,
            c: 10,
            s: 50,
          },
        },
      },
    ],
  });
}

• action, Anda tidak perlu menentukan mode. Parameter param berikut didukung. Untuk informasi lebih lanjut, lihat Warna gambar.

• b

  • Nilai valid: -100 hingga 100.

  • Deskripsi: Persentase penyesuaian kecerahan gambar yang diinginkan.

• c

  • Nilai valid: -100 hingga 100.

  • Deskripsi: Persentase penyesuaian kontras gambar yang diinginkan.

• s

  • Nilai valid: 50 hingga 399.

  • Deskripsi: Ketajaman gambar.

Watermark

Menambahkan watermark teks dan watermark gambar.

async function imageWaterMark() {
  return fetch(imageUrl1, {
    image: [
      {
        action: "waterMark",
        option: {
          mode: "text",
          param: {
            text: "bW9jaGVuIHRlc3Q",
            x: 10,
            y: 10,
            rotate: 100,
          },
        },
      },

      {
        action: "waterMark",
        option: {
          mode: "image",
          param: {
            image:
              "aHR0cHM6Ly9jZG4yLmljb25maW5kZXIuY29tL2RhdGEvaWNvbnMvc29jaWFsLW1lZGlhLTIxODkvNDgvMTMtT3BlcmEtMTI4LnBuZw",
            g: 3,
          },
        },
      },
    ],
  });
}