ST_AsJPEG - PolarDB

Topik ini menjelaskan fungsi ST_AsJPEG, yang mengonversi objek raster menjadi gambar JPEG bertipe BYTEA.

Sintaksis

bytea ST_AsJPEG(raster raster_obj,
                box extent,
                integer pyramidLevel default 0,
                cstring bands default '',
                cstring option default '');

Parameter

Parameter	Deskripsi
raster_obj	Objek raster yang ingin Anda konversi.
extent	Bagian data yang ingin Anda ekstrak. Secara default, bagian data ditentukan berdasarkan sistem koordinat geografis (GCS).
pyramidLevel	Tingkat piramida dari mana Anda ingin mengekstrak data. Nilai valid dimulai dari 0. Nilai default: 0.
bands	Bands yang ingin Anda peroleh. Anda harus mengonfigurasi parameter ini berdasarkan jumlah bands dari gambar JPEG. Daftar berikut menjelaskan aturan konfigurasi: Jumlah bands dari gambar JPEG adalah 3. Anda dapat menentukan rentang band kontinu yang dimulai dari 0 untuk parameter ini. Sebagai contoh, Anda dapat mengatur parameter ini ke `'0-2'` untuk menentukan band 0, 1, dan 2. Anda dapat menentukan nilai yang terdiri dari nomor urutan band untuk parameter ini. Nomor urutan pertama dalam nilai tersebut harus dimulai dari 0. Sebagai contoh, Anda dapat mengatur parameter ini ke `'0,2,4'` untuk menentukan band 0, 2, dan 4. Jika Anda membiarkan parameter ini kosong, tiga band pertama, yaitu 0, 1, dan 2, akan digunakan.
option	Opsi yang digunakan untuk mengonversi string berformat JSON.

Tabel berikut menjelaskan bidang dalam parameter option.

Bidang	Deskripsi	Tipe	Default	Deskripsi
nodata	Menentukan apakah akan memproses nilai NoData.	bool	false	true: Nilai NoData perlu diproses. false: Nilai NoData digunakan sebagai nilai normal.
nodataValue	Nilai NoData dari raster.	integer	0	Jika parameter nodata diatur ke true, Anda juga harus menentukan parameter ini.
rast_coord	Menentukan apakah kotak input ditentukan dengan menggunakan koordinat piksel.	bool	false	Jika koordinat piksel digunakan, koordinat x menentukan nomor kolom piksel dan koordinat y menentukan nomor baris piksel. Baik nomor kolom maupun nomor baris dimulai dari 0.
strength	Menentukan apakah akan menerapkan peningkatan dalam tampilan.	string	none	Nilai valid: none: Peningkatan tidak diterapkan. stats: Peningkatan diterapkan dengan menggunakan peregangan berdasarkan nilai statistik.
quality	Kualitas gambar raster baru setelah kompresi.	integer	75	Nilai valid: 1 hingga 100.

Deskripsi

Fungsi ini mengembalikan gambar JPEG bertipe BYTEA.
Ukuran default cache untuk menyimpan data yang diekstraksi adalah 100 MB. Artinya, hingga 100 MB data yang diekstraksi dapat dikembalikan. Untuk menyesuaikan ukuran data yang diekstraksi, Anda dapat mengubah ukuran cache menggunakan parameter ganos.raster.clip_max_buffer_size.
Berikut adalah nilai valid untuk jumlah band:
- 1: Raster memiliki satu band, yang memungkinkan konversi menjadi gambar skala abu-abu.
- 3: Raster memiliki tiga band, yaitu band R, band G, dan band B.

Contoh

--Tentukan bagian data yang ingin Anda ekstrak. 
SELECT ST_AsJPEG(raster_obj, 
                  '(-180,-90), (0,0)'::Box) 
FROM raster_table    
WHERE id =1;

--Tentukan tingkat piramida dari mana Anda ingin mengekstrak data. 
SELECT ST_AsJPEG(raster_obj, 
                  '(-180,-90), (0,0)'::Box,
                 1) 
FROM raster_table    
WHERE id =1;

--Tentukan ID band dari mana Anda ingin mengekstrak data. 
SELECT ST_AsJPEG(raster_obj, 
                  '(-180,-90), (0,0)'::Box,
                 1,
                 '0-2') 
FROM raster_table    
WHERE id =1;

--Terapkan peningkatan dengan menggunakan peregangan berdasarkan nilai statistik. 
SELECT ST_AsJPEG(rast, 
                  '(-180,-90), (0,0)'::Box, 
                  0, 
                  '', 
                  '{"nodata":"false", "nodatavalue":"0","rast_coord":"false", "strength":"stats", "quality":"75"}')
FROM raster_table    
WHERE id =1;