ST_Raster.crop

Definition

Mit der ST_Raster.crop-Funktion wird ein vorhandenes ST_Raster-Objekt auf die angegebene Ausdehnung zugeschnitten. Die Ausdehnung kann entweder in Pixelkoordinaten oder in geographischen Koordinaten angegeben werden. Die Funktion kann nur in einer SQL-UPDATE-Anweisung angewendet werden. Wenn sie an anderer Stelle, zum Beispiel in einer SELECT-Anweisung oder einer WHERE-Klausel, verwendet wird, wird ein Datenbankfehler zurückgegeben. Weitere Informationen darüber, wie Sie die gleichen Funktionen in der Auswahlliste der SQL-SELECT-Anweisung erhalten, finden Sie unter der ST_Raster.subset-Funktion.

Syntax

Oracle

crop (extent IN VARCHAR2) RETURN ST_RASTER

crop (extent IN VARCHAR2, 
      unit IN VARCHAR2) RETURN ST_RASTER

PostgreSQL

crop (raster IN ST_RASTER, 
      extent IN TEXT) RETURN ST_RASTER

crop (raster IN ST_RASTER, 
      extent IN TEXT, 
      unit IN TEXT) RETURN ST_RASTER

SQL Server

crop (extent IN NVARCHAR, 
      unit IN NVARCHAR) RETURN ST_RASTER

Rückgaben

ST_Raster

Parameter

Parameter	Beschreibung
extent <minx,miny,maxx,maxy>	Die Ausdehnung des zuzuschneidenden ST_Raster, in geographischen Koordinaten.
Raster	Der zuzuschneidende ST_Raster-Wert.
unit <'pixel'>	Wenn das Schlüsselwort "pixel" einbezogen wurde, wird die Ausdehnung als Pixelkoordinaten eingegeben. Wenn das Pixelargument ausgelassen wird, weist dies darauf hin, dass die Ausdehnung als geographische Koordinaten eingegeben werden muss.

Beispiele

In den folgenden Beispielen wird das vorhandene Raster mit der angegebenen Zuschneideregion von (0,0,100,100) zugeschnitten:

Oracle

UPDATE IMAGE2 i 
SET image = i.image.crop ('0,0,100,100', 'pixel');

PostgreSQL

UPDATE image2 
SET image = crop (image, '0,0,100,100', 'pixel');

SQL Server

UPDATE image2 
SET image = image.crop ('0,0,100,100', 'pixel');