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