ST_PixelData.getValue

Definition

Mit der ST_PixelData.getValue-Funktion wird der Wert eines einzelnen Pixels anhand der Position dieses Pixels im ST_PixelData-Objekt zurückgegeben. Die Position kann entweder in Pixelkoordinaten oder in geographischen Koordinaten angegeben werden. Die Funktion gibt einen Fehler zurück, wenn sich die angegebene Position außerhalb der Raster-Pixeldimension oder geographischen Ausdehnung befindet. ST_PixelData.getValue gibt NULL zurück, wenn der Pixelwert an der angegebenen Position "NoData" ist.

Syntax

Oracle

getValue (band INTEGER, 
          level INTEGER, 
          x INTEGER, 
          y INTEGER)

getValue (band INTEGER, 
          level INTEGER, 
          point SE_COORD)

PostgreSQL

getValue (data IN ST_PIXELDATA, 
          band IN INT, 
          x IN INT, 
          y IN INT)

getValue (data IN ST_PIXELDATA, 
          band IN INT, 
          point IN SE_COORD)

SQL Server

getValue (band IN INT, 
          x IN INT, 
          y IN INT)

getValueByLoc (band IN INT, 
               x IN double, 
               y IN double)

Rückgaben

Oracle

Zahl

PostgreSQL

Ganzzahl

SQL Server

Double

Parameter

Parameter	Beschreibung
Band	Die Bandnummer des Pixels (beginnend bei 1)
Ebene	Die Pyramidenebene des Pixels
X	Die X-Koordinate des Pixels
y	Die Y-Koordinate des Pixels
Punkt	Die geographische Koordinate des Pixels

Beispiele

Mit dem folgenden Code wird der Wert eines einzelnen Pixels anhand der Position dieses Pixels im ST_PixelData-Objekt zurückgegeben.

Oracle

DECLARE
  	  p sde.ST_PixelData;
        pixelvalue NUMBER;
BEGIN
  	  SELECT image.getPixelData() INTO p FROM MOAB;
  	  pixelvalue := p.getvalue(1,0,1,1);
        pixelvalue := p.getvalue(1,0,SE_COORD(34.057, 117.171));
      END; 
      /

PostgreSQL

CREATE OR REPLACE FUNCTION get_pixel_value() 
RETURNS integer AS '
DECLARE
  	  p ST_PIXELDATA;
        pixelvalue NUMBER;
BEGIN
  	  SELECT getPixelData(image) INTO p FROM moab;
  	  pixelvalue := getvalue(p,1,1,1);
        pixelvalue := getvalue(p,1,SE_COORD(34.057, 117.171));
      END;' 
      LANGUAGE plpgsql; 

      SELECT get_pixel_data();

	DROP FUNCTION IF EXISTS get_pixel_data();

SQL Server

DECLARE
@p ST_Pixeldata;
 @pixelvalue double;
SET @p = (SELECT image.getPixelData()
 FROM moab );
SET @pixelvalue = @p.getValue(1,1,1);
 SET @pixelvalue = @p.getValueByLoc(1, 34.057, 117.171);