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:

1. 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.
2. 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.
3. 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');