Name

ST_AsJPEG — Gibt die ausgewählten Bänder der Rasterkachel als einzelnes Bild (Byte-Array) im Format "Joint Photographic Exports Group" (JPEG) aus. Wenn kein Band angegeben ist und 1 oder mehr als 3 Bänder ausgewählt wurden, dann wird nur das erste Band verwendet. Wenn 3 Bänder ausgewählt wurden, werden alle 3 Bänder verwendet und auf RGB abgebildet.

Synopsis

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

bytea ST_AsJPEG(raster rast, integer nband, integer quality);

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

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

bytea ST_AsJPEG(raster rast, integer[] nbands, integer quality);

Beschreibung

Gibt die ausgewählten Bänder der Rasterkachel als einzelnes Bild im Format "Joint Photographic Exports Group" (JPEG) aus. Sie können ST_AsGDALRaster verwenden, wenn Sie in weniger gebräuchliche Rasterformate exportieren wollen. Wenn kein Band angegeben ist und 1 oder mehr als 3 Bänder ausgewählt wurden, dann wird nur das erste Band verwendet. Wenn 3 Bänder ausgewählt wurden, werden alle 3 Bänder 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 JPEG maximal 3). Die Reihenfolge der Bänder ist RBG; z.B. ARRAY[3,2,1] bedutet, dass Band 3 auf Rot, Band 2 auf Grün und Band 1 auf Blau abgebildet wird.

  • quality Eine Zahl zwischen 0 und 100. Umso höher die Zahl ist, umso schärfer ist das Bild.

  • options Ein Textfeld mit GDAL Optionen für JPEG (siehe "create_options" für JPEG unter ST_GDALDrivers). Gültige Optionen für JPEG sind PROGRESSIVE ON oder OFF und QUALITY zwischen 0 und 100 mit dem Standardwert 75. Siehe GDAL Raster format options für weitere Details.

Verfügbarkeit: 2.0.0 - GDAL >= 1.6.0.

Beispiele: Ausgabe

-- output first 3 bands 75% quality
SELECT ST_AsJPEG(rast) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- output only first band as 90% quality
SELECT ST_AsJPEG(rast,1,90) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- output first 3 bands (but make band 2 Red, band 1 green, and band 3 blue, progressive and 90% quality
SELECT ST_AsJPEG(rast,ARRAY[2,1,3],ARRAY['QUALITY=90','PROGRESSIVE=ON']) As rastjpg
    FROM dummy_rast WHERE rid=2;

Siehe auch

Section 9.3, “Eigene Anwendungen mit PostGIS Raster erstellen”, ST_GDALDrivers, ST_AsGDALRaster, ST_AsPNG, ST_AsTIFF