ST_Raster.buildPyramid
Definition
Mit der ST_Raster.buildPyramid-Funktion werden die Pyramiden des ST_Raster-Objekts erstellt. Diese Funktion ist nur für SQL-UPDATE-Anweisungen vorgesehen. Wenn sie in einer SELECT-Anweisung verwendet wird, wird ein Datenbankfehler zurückgegeben.
Syntax
Oracle
buildPyramid () RETURN ST_RASTER buildPyramid (parameter_list IN VARCHAR2) RETURN ST_RASTER
PostgreSQL
buildPyramid (raster IN ST_Raster) buildPyramid (raster IN ST_Raster, parameter_list IN TEXT)
SQL Server
buildPyramid (parameter_list IN NVARCHAR)
Rückgaben
ST_Raster
Parameter
parameter_list - Eine kommagetrennte Liste mit Parametern, in einfache Anführungszeichen eingeschlossen; wenn die Parameterliste nicht bereitgestellt wird, wird die Ebene auf 0 (vorhandene Pyramiden werden gelöscht) festgelegt. Die Parameterliste kann die folgenden Parameter umfassen:
- level <Wert> - Die oberste zu erstellende Pyramidenebene; die Standardeinstellung ist "-1", wodurch die Funktion angewiesen wird, die maximale Pyramidenstufe automatisch zu ermitteln. Stellen Sie für diesen Parameter 0 ein, um die Pyramide zu entfernen.
- skipLevel1 - Weist die Funktion an, die erste Pyramidenebene nicht zu speichern.
- nearest | bilinear | bicubic - Der zum Erstellen der Pyramide verwendete Interpolationsalgorithmus; der Standardwert ist "nearest".
- quality <Wert> - Wenn der Komprimierungstyp des Basis-Layers JPEG oder JPEG 2000 ist, wird die Komprimierungsqualität der Pyramiden durch die Einstellung dieses Parameters gesteuert. Die standardmäßige Komprimierung für JPEG ist "75", während die standardmäßige Komprimierung für JPEG 2000 "0" ist.
- bitrate <Wert> - Die Bitrate für JPEG 2000-Komprimierung.
- log <Protokolldateiname> - In der Protokolldatei werden die Ergebnisse der buildPyramid-Funktion aufgezeichnet.
Beispiele
In diesen Beispielen wird Folgendes veranschaulicht:
- Das erste Beispiel veranschaulicht eine Anweisung, mit der Raster-Pyramiden für alle ST_Raster-Objekte in einer benutzerdefinierten Tabelle mit bilinearer Interpolation und der standardmäßigen automatischen Pyramidenebene erstellt werden.
- Im zweiten Beispiel werden die Raster-Pyramiden für alle ST_Raster-Objekte in der Tabelle "nova" entfernt, indem die Pyramidenebene auf 0 eingestellt wird.
- Im letzten Beispiel wird die erste Pyramidenebene nicht gespeichert, sondern nur die zweite und höheren Ebenen. Darüber hinaus wird die Pyramid anhand von bilinearer Interpolation, und nicht mit der Standardeinstellung "Nächster Nachbar" erstellt.
Oracle
UPDATE NOVA n SET image = n.image.buildPyramid('bilinear');
UPDATE NOVA n SET image = n.image.buildPyramid('level=0');
UPDATE NOVA n SET image = n.image.buildPyramid('skipLevel1,bilinear');
PostgreSQL
UPDATE nova SET image = buildPyramid(image,'bilinear');
UPDATE nova SET image = buildPyramid(image,'level=0');
UPDATE nova SET image = buildPyramid(image,'skipLevel1,bilinear');
SQL Server
UPDATE nova SET image = image.buildPyramid('bilinear');
UPDATE nova SET image = image.buildPyramid('level=0');
UPDATE nova SET image = image.buildPyramid('skipLevel1,bilinear');
7/10/2012