ST_AsPNG
Prev  11.11. Ausgabe von Rastern  Next

Name

ST_AsPNG — Gibt die ausgewählten Bänder der Rasterkachel als einzelnes, übertragbares Netzwerkgraphik (PNG) Bild (Byte-Feld) aus. Wenn der Raster 1,3 oder 4 Bänder hat und keine Bänder angegeben sind, dann werden alle Bänder verwendet. Wenn der Raster 2 oder mehr als 4 Bänder hat und keine Bänder angegeben sind, dann wird nur Band 1 verwendet. Die Bänder werden in den RGB- oder den RGBA-Raum abgebildet.

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);

Beschreibung

Gibt die ausgewählten Bänder des Raster als einzelnes Bild im Format "Portable Network Graphics Image" (PNG) aus. Sie können ST_AsGDALRaster verwenden, wenn Sie in weniger gebräuchliche Rasterformate exportieren wollen. Wenn kein Band angegeben ist, werden die ersten 3 Bänder exportiert. Wenn SRID nicht angegeben ist, wird die SRID des Ausgangsraster verwendet. Die Funktion hat viele Varianten mit vielen Optionen. Diese sind unterhalb angeführt:

  • nband für den Export einzelner Bänder.

  • nbands Ein Feld mit den Bändern die exportiert werden sollen (bei PNG maximal 4). Die Reihenfolge der Bänder ist RBGA; z.B. ARRAY[3,2,1] bedutet, dass Band 3 auf Rot, Band 2 auf Grün und Band 1 auf Blau abgebildet wird.

  • compression Eine Zahl zwischen 1 und 9. Umso höher die Zahl umso größer die Komprimierung.

  • options Ein Textfeld mit GDAL Optionen für PNG (siehe "create_options" für PNG unter ST_GDALDrivers). Für PNG gibt es nur eine gültige Option "ZLEVEL" (wieviel Zeit für die Komprimierung aufgewendet werden soll - die Standardeinstellung ist 6); z.B.: ARRAY['ZLEVEL=9']. Ein WORLDFILE ist nicht erlaubt, da die Funktion sonst zwei Ausgaben machen müsste. Siehe GDAL Raster format options für weitere Details.

Verfügbarkeit: 2.0.0 - GDAL >= 1.6.0.

Beispiele

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;