Sintaxe, parâmetros e exemplos de ST_AsJPEG - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Converte um objeto raster em um fluxo binário JPEG.

Sintaxe

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

Parâmetros

Parâmetro	Descrição
raster_obj	Objeto raster a ser processado.
extent	Extensão da imagem. Por padrão, o sistema utiliza coordenadas geográficas.
pyramidLevel	Nível da pirâmide de imagem. A numeração começa em 0. O valor padrão é 0.
bands	Lista de bandas a obter. Configure a lista de bandas conforme a quantidade de bandas na imagem JPEG. As regras de configuração são: Imagens JPEG possuem 3 bandas. Especifique um intervalo contínuo de bandas iniciando em 0. Por exemplo, defina este parâmetro como `'0-2'` para configurar as bandas 0, 1 e 2. Indique números ordinais individuais das bandas, começando em 0. Por exemplo, defina este parâmetro como `'0,2,4'` para configurar as bandas 0, 2 e 4. Se você não configurar este parâmetro, o sistema usará as três primeiras bandas (0, 1 e 2).
option	Opções de conversão em uma string JSON.

A tabela a seguir descreve os campos do parâmetro option.

Nome do parâmetro	Descrição	Tipo	Valor padrão	Descrição
nodata	Define se o sistema deve processar valores nodata.	bool	false	true: Processa os valores nodata. false: Trata os valores nodata como valores normais.
nodataValue	Valor de nodata.	integer	0	Se nodata estiver definido como true, especifique um valor para este parâmetro.
rast_coord	Indica se a caixa de entrada usa coordenadas de pixel.	bool	false	Ao usar coordenadas de pixel, a coordenada x representa o número da coluna e a coordenada y representa o número da linha. Ambas as numerações começam em 0.
strength	Define se o sistema aplica realce.	string	none	Método de realce de exibição. Valores válidos: none: Não aplica realce. stats: Aplica estiramento com base em valores estatísticos.
quality	Qualidade da compressão.	integer	75	O valor varia de 1 a 100.

Descrição

A função retorna uma imagem no formato bytea.
O cache de recorte padrão é de 100 MB, que define o tamanho máximo dos dados resultantes. Para ajustar esse limite, defina o tamanho do cache usando o parâmetro ganos.raster.clip_max_buffer_size.
A quantidade de bandas segue a descrição abaixo:
- 1: Banda única para imagens em escala de cinza.
- 3: Três bandas correspondentes a R, G e B.

Exemplos

--Use a clipping extent.
SELECT ST_AsJPEG(raster_obj, 
                  '(-180,-90), (0,0)'::Box) 
FROM raster_table    
WHERE id =1;

--Specify a pyramid level.
SELECT ST_AsJPEG(raster_obj, 
                  '(-180,-90), (0,0)'::Box,
                 1) 
FROM raster_table    
WHERE id =1;

--Specify bands and a clipping extent.
SELECT ST_AsJPEG(raster_obj, 
                  '(-180,-90), (0,0)'::Box,
                 1,
                 '0-2') 
FROM raster_table    
WHERE id =1;

--Use stretching based on statistical values.
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;