Name

ST_AsPNG — Retorna as bandas tile raster selecionadas como um gráfico de rede portátil (PNG) imagem (byte array). Se as bandas raster 1, 3 ou 4 e nenhum banda for especificado, então todas as bandas são usadas. Se mais 2 ou mais que 4 bandas e nenhuma banda forem especificadas, então somente a banda 1 é usada. As bandas são mapeadas para espeço RGB ou RGBA.

Synopsis

bytea ST_AsPNG(raster rast, text[] options=NULL);

bytea ST_AsPNG(raster rast, integer nband, integer compression);

bytea ST_AsPNG(raster rast, integer nband, text[] options=NULL);

bytea ST_AsPNG(raster rast, integer[] nbands, integer compression);

bytea ST_AsPNG(raster rast, integer[] nbands, text[] options=NULL);

Descrição

Retorna as bandas selecionadas do raster como uma única Portable Network Graphics Image (PNG). Use ST_AsGDALRaster se precisar exportar como os tipo de raster menos comuns. Se nenhuma banda for especificada, então as 3 primeiras bandas serão exportadas. Existem muitas variantes da função com várias opções. Se nenhum sridfor especificado, o srid do raster é usado. Eles estão listados abaixo:

  • nband é para exportação de uma única banda.

  • nbands é um arranjo para exportar (note que o máximo é 4 para JPEG) e a ordem das bandas é RGB. ex.: ARRAY[3,2,1] significa mapa banda 3 para Vermelho, banda 2 para verde e banda 1 para azul.

  • compression número de 1 a 9. Quanto maior o número melhor a compressão.

  • options opções de textos do Arranjo do GDAL como definidas para PNG (veja em create_options para PNG da ST_GDALDrivers). Para PNG válido é somente ZLEVEL (porção de tempo para gastar na comprensão -- padrão 6) ex.: ARRAY['ZLEVEL=9']. WORLDFILE não é permitido já que a função teria que gerar duas saídas. Recorra a GDAL Raster format options para mais detalhes.

Disponibilidade: 2.0.0 - requer GDAL >= 1.6.0.

Exemplos

SELECT ST_AsPNG(rast) As rastpng
FROM dummy_rast WHERE rid=2;

-- export the first 3 bands and map band 3 to Red, band 1 to Green, band 2 to blue
SELECT ST_AsPNG(rast, ARRAY[3,1,2]) As rastpng
FROM dummy_rast WHERE rid=2;