Changes between Version 56 and Version 57 of WKTRaster/SpecificationWorking02


Ignore:
Timestamp:
Mar 10, 2011, 4:09:53 PM (9 years ago)
Author:
pracine
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WKTRaster/SpecificationWorking02

    v56 v57  
    182182'''ST_SetValues'''
    183183
    184  TBD
     184 Set a set of pixel to a value.
     185
     186 '''Variants'''
     187
     188 The first series of variant set a defined area of the raster to a value.
     189
     190  1) ST_SetValues(rast raster, band int, x int, y int, width int, height int, val float8, keepdestnodata boolean)
     191
     192  2) ST_SetValues(rast raster, x int, y int, width int, height int, val float8, keepdestnodata boolean)
     193
     194  3) ST_SetValues(rast raster, x int, y int, width int, height int, val float8)
     195
     196  4) ST_SetValues(rast raster, band int, x int, y int, width int, height int, val float8)
     197
     198 The second series of variant set a defined area of the raster to corresponding values of another raster.
     199
     200  5) ST_SetValues(rast1 raster, band1 int, x int, y int, width int, height int, rast2 raster, band2 int, keepdestnodata boolean, keepsourcenodata boolean)
     201
     202  6) ST_SetValues(rast1 raster, x int, y int, width int, height int, rast2 raster, keepdestnodata boolean, keepsourcenodata boolean)
     203
     204  7) ST_SetValues(rast1 raster, x int, y int, width int, height int, rast2 raster)
     205
     206 x, y, width & height define the area of the raster to be edited. x & y are the raster coordinates of the upper left corner of this are. When x, y, width or height are out of the raster range, only the part of the range intersecting with the raster is set to the new value.
     207
     208 val is the new value to be set.
     209
     210 When keepdestnodata is TRUE, destination nodata value pixels are not set. Default is FALSE so that nodata value pixels are set.
     211
     212 When keepsourcenodata is TRUE, source nodata value pixels are not copied. Default is FALSE so that nodata value pixels are copied.
     213
     214 Variant 2 assume band to be 1.
     215
     216 Variant 3 assume band to be 1 and keepdestnodata to be FALSE.
     217
     218 Variant 4 assume only keepdestnodata to be FALSE.
     219
     220 Variant 6 assume both bands to be 1.
     221
     222 Variant 7 assume both bands to be 1, keepdestnodata to be FALSE and keepsourcenodata to be FALSE.
     223
     224 '''Implementation details'''
     225 
     226 PL/pgSQL prototypes can be found in http://trac.osgeo.org/postgis/browser/trunk/raster/scripts/plpgsql/st_setvalues.sql
    185227
    186228'''ST_Clip'''