ST_MakeEmptyRaster
Indietro  11.3. Raster Constructors  Avanti

Nome

ST_MakeEmptyRaster — Restituisce un raster vuoto (senza bande) di dimensioni date (larghezza & altezza), X e Y in alto a sinistra, dimensioni dei pixel e rotazione (scalex, scaley, skewx & skewy) e sistema di riferimento (srid). Se viene passato un raster, restituisce un nuovo raster con le stesse dimensioni, allineamento e SRID. Se srid viene omesso, il sistema di riferimento spaziale viene impostato su sconosciuto (0).

Sinossi

raster ST_MakeEmptyRaster(raster rast);

raster ST_MakeEmptyRaster(integer width, integer height, float8 upperleftx, float8 upperlefty, float8 scalex, float8 scaley, float8 skewx, float8 skewy, integer srid=unknown);

raster ST_MakeEmptyRaster(integer width, integer height, float8 upperleftx, float8 upperlefty, float8 pixelsize);

Description

Restituisce un raster vuoto (senza banda) di dimensioni date (larghezza & altezza) e georeferenziato in coordinate spaziali (o mondiali) con X superiore sinistro (upperleftx), Y superiore sinistro (upperlefty), dimensioni dei pixel e rotazione (scalex, scaley, skewx & skewy) e sistema di riferimento (srid).

L'ultima versione utilizza un singolo parametro per specificare la dimensione del pixel (pixelsize). scalex è impostato su questo argomento e scaley è impostato sul valore negativo di questo argomento. skewx e skewy sono impostati a 0.

Se viene passato un raster esistente, viene restituito un nuovo raster con le stesse impostazioni dei metadati (senza le bande).

Se non viene specificata alcuna srid, l'impostazione predefinita è 0. Dopo aver creato un raster vuoto, probabilmente si desidera aggiungervi delle bande e forse modificarlo. Fare riferimento a ST_AddBand per definire le bande e a ST_SetValue per impostare i valori iniziali dei pixel.

Esempi

Use an existing raster as a template and output metadata of the rasters we added.

Code
INSERT INTO dummy_rast(rid, rast)
VALUES(3, ST_MakeEmptyRaster(100, 100, 0.0005, 0.0005, 1, 1, 0, 0, 4326) );
INSERT INTO dummy_rast(rid, rast)
SELECT 4, ST_MakeEmptyRaster(rast)
FROM dummy_rast WHERE rid = 3;
SELECT
    rid,
    (md).width,
    (md).height,
    (md).scalex,
    (md).scaley,
    (md).srid
FROM (
    SELECT rid, ST_MetaData(rast) AS md
    FROM dummy_rast
    WHERE rid IN (3, 4)
) AS foo
ORDER BY rid;
Output
rid | width | height | scalex | scaley | srid
-----+-------+--------+--------+--------+------
   3 |   100 |    100 |      1 |      1 | 4326
   4 |   100 |    100 |      1 |      1 | 4326